Entering content frame

Syntax documentation TABLEEXTRACT Command Locate the document in its SAP Library structure

With this Loader command, you can control the unloading of database tables.

Syntax

<tableextract_statement> ::=
TABLEEXTRACT <
part_spec > [<configurationstream_spec >] <dataoutstream_spec > [<packagestream_spec >] [<restart>]

You can also use the keywords EXTRACT TABLE instead of the keyword DATAEXTRACT.

Prerequisites

When you use TABLEEXTRACT TABLE, the source table must exist in the database instance.
THE command TABLEEXTRACT ALL can only be executed by the SYSDBA user.

Use

·        You can unload the application data (including LONG values) of the specified database tables in data streams. The format of the data stream must be PAGES in each case.

·        You can unload the application data (including LONG values) and the database catalog definitions of the specified database tables to data streams. The format of the data stream must be RECORDS in each case.

You must not change the data streams.

Tables are write-protected while they are unloaded to the data stream.

<part_spec>

·        TABLEEXTRACT ALL
The data stream
<dataoutstream_spec> contains the application data of all tables.

·        TABLEEXTRACT USER
The data stream
<dataoutstream_spec> contains the application data of the tables that belong to the specified user.

·        TABLEEXTRACT TABLE
The specified table is a base table.
The user is the owner of this table.
The data stream <dataoutstream_spec> contains the application data of the specified table.

Data Stream: <dataoutstream_spec>

The data streams <dataoutstream_spec> are created during unloading.

When it processes the commands TABLEEXTRACT ALL and TABLEEXTRACT USER, the Loader creates one or more data streams (depending on the size of the tables it is unloading), each of which can contain the application data from one or more tables. The Loader specifies the maximum size of a single data stream as 1 GB.

The media names for the data streams are created using the name specified in the command, in that  a four digit extension of the format 0001 is added to the name. The maximum number of media for each TABLEEXTRACT is therefore set at 9999.

The system table TRANSFORMATIONMODEL and other system tables are filled.

Exclude Tables from Unload: <configurationstream_spec>

·        Unless you specify the data stream <configurationstream_spec>, all specified tables are unloaded.

·        By specifying a data stream <configurationstream_spec>, you can exclude the application data of selected tables from the application data being unloaded<dataoutstream_spec>.  The tables must be specified in the data stream by the specification of their owner and the table name.
The information about which tables are not to be unloaded is stored in the system tables. You can display this information by displaying the system table TRANSFORMATIONPACKAGES. The tables excluded from the unload of the application data have the value TRUE in the column EXCLUDE.

Unloading the System Table TRANSFORMATIONPACKAGES: <packagestream_spec>

·        When you specify a data stream <packagestream_spec>, all entries of the table TRANSFORMATIONPACKAGES are unloaded to this data stream. Use this option to make a log of the unload process.

·        If you do not specify the data stream <packagestream_spec>, the system table TRANSFORMATIONPACKAGES is not unloaded.

Result

The specified tables are unloaded to the data streams <dataoutstream_spec>.

If specified, all entries of the table TRANSFORMATIONPACKAGES are unloaded in the data stream <packagestream_spec>.

You can reload the tables using the corresponding TABLELOAD command.

Errors

The unload process cannot be successfully completed. In this case, the Loader logs the cause of the error in the  log file.

The values PACKAGEGUID and CLIENTNODE are both written to the log file. The PACKAGEGUID is required if you want to restart the unload process.

 

Leaving content frame