Anfang des Inhaltsbereichs

Syntaxdokumentation IMPORT SCHEMA-Kommando Dokument im Navigationsbaum lokalisieren

Mit den IMPORT SCHEMA-Kommando des Loader können Sie die Daten, die zur Anwendung des angegebenen Schemas gehören, importieren.

Voraussetzungen

Das IMPORT SCHEMA-Kommando kann nur vom Eigentümer des Schemas ausgeführt werden.

Sie haben die erforderlichen Daten mit dem korrespondieren EXPORT-Kommando exportiert.

Syntax

<import_schema_command>           ::= IMPORT SCHEMA <schema_name>
                                     [<duplicates_clause>]
                                     [<map_schema_spec>]
                                     [<configuration_spec>]
                                      <catalog_data_instream_part_spec>
                                     [<package_spec>] [<restart_spec>]

<catalog_data_instream_part_spec> ::= <catalog_instream_spec>
                                    | <data_instream_part_spec>
                                    | <catalog_instream_spec> <data_instream_part_spec>

IMPORT SCHEMA <schema_name>
  
[<duplicates_clause>]
  
[<map_schema_spec>]
  [<configuration_spec>]
  <catalog_instream_spec>
  <data_instream_part_spec>
  [<package_spec>]

  [<restart_spec>]

Import der Daten, die zur Anwendung des angegebenen Schemas gehören (Datenbankkatalog und Anwendungsdaten)

IMPORT SCHEMA <schema_name>
  [<map_schema_spec>]
  <catalog_instream_spec>
  [<package_spec>]

  [<restart_spec>]

Import der Datenbankkataloginformationen, die zur Anwendung des angegebenen Schemas gehören

IMPORT SCHEMA <schema_name>
  
[<duplicates_clause>]
  [<map_schema_spec>]
  [<configuration_spec>]
  <data_instream_part_spec>
  [<package_spec>]

  [<restart_spec>]

Import der Anwendungsdaten des angegebenen Schemas

 

 

<schema_name>

Schemaname

Wenn der Name des Schemas mit einem Schlüsselwort identisch oder die Groß- und Kleinschreibung von Bedeutung ist, muss der Name in Anführungszeichen eingeschlossen werden.

<schema_name> ::= <identifier>

siehe auch: SQL-Referenzhandbuch, StrukturlinkSchemaname (schema_name)

<duplicates_clause>

  REJECT DUPLICATES
| I
GNORE DUPLICATES
| UPDATE DUPLICATES

Vorschlagwert: REJECT DUPLICATES

<map_schema_spec>

MAP SCHEMA [<schema_map_name> | <schema_to_schema>,...]

<schema_map_name>  ::= <identifier>
<schema_to_schema> ::= <schema_name> TO <schema_name>

siehe auch: USE SCHEMAMAP-Kommando

<configuration_spec>

CONFIGURATION <instream_csv_spec>

<catalog_instream_spec>

CATALOG <instream_ddl_spec>

<data_instream_part_spec>

DATA <instream_tableformat_spec>

<package_spec>

PACKAGE <outstream_csv_spec>

<instream_csv_spec>
<instream_ddl_spec>
<instream_tableformat_spec>
<outstream_spec>

Datenstrom

<restart_spec>

RESTART <package_guid>
<package_guid> ::= <unsigned_integer>

unsigned_integer: ID, die zur Laufzeit vom Loader für jedes Kommando erzeugt wird. Diese ganze Zahl ist immer 24 Bytes lang.

siehe auch: SQL-Referenzhandbuch, StrukturlinkGanze Zahl ohne Vorzeichen (unsigned_integer)

Beispiele

Loader-Tutorial, StrukturlinkIMPORT SCHEMA

Erläuterung

<duplicates_clause>

Mit der DUPLICATES-Regel legen Sie fest, wie beim Importieren von Daten aus einem Datenstrom verfahren werden soll, wenn eine Zeile mit dem Schlüssel der einzufügenden Zeile in der Tabelle bereits existiert. Diese Regel wird nicht ausgewertet, wenn die Daten im Format PAGES in die Datenbank importiert werden.

REJECT DUPLICATES

Die einzufügende Zeile wird mit einer Fehlermeldung abgelehnt.

IGNORE DUPLICATES

Die neue Zeile wird nicht eingefügt.

UPDATE DUPLICATES

Die existierende Zeile wird mit der neuen Zeile überschrieben.

<catalog_instream_spec>, <data_instream_part_spec>

Beim Import sind je nachdem, ob Datenbankkatalog- und/oder Anwendungsdaten importiert werden, folgende Datenströme erforderlich:

     Datenstrom mit den Datenbankkatalogdefinitionen CATALOG <instream_ddl_spec>

     Datenstrom mit den Anwendungsdaten DATA <instream_tableformat_spec>

Für den Datenstrom der Anwendungsdaten instream_tableformat_spec ist nur eines der Formate PAGES oder RECORDS möglich.

Siehe auch:

Datenstrom

<configuration_spec>

Sie können Tabellen vom Import ausschließen.

     Ohne Angabe eines Datenstroms mittels CONFIGURATION <instream_csv_spec> werden die gesamten Anwendungsdaten importiert.

     Durch die Angabe eines Datenstroms mittels CONFIGURATION <instream_spec> können aus den Anwendungsdaten <instream_tableformat_spec> die Anwendungsdaten ausgewählter Tabellen vom Import ausgeschlossen werden. Die Tabellen müssen durch die Angabe ihres Schemas und des Tabellennamens im Datenstrom spezifiziert sein.
Die Angabe, welche Tabellen nicht importiert werden sollen, wird in den Systemtabellen abgelegt. Eine Möglichkeit der Anzeige dieser Informationen ist die Anzeige der Systemtabelle SYSLOADER.TRANSFORMATIONMODEL. Die vom Import der Anwendungsdaten ausgeschlossenen Tabellen besitzen in der Spalte EXCLUDE den Wert TRUE.

Die Datenbankkatalogeinträge CATALOG <instream_ddl_spec> aller Tabellen werden unabhängig von den mittels CONFIGURATION <instream_csv_spec> gemachten Einschränkungen immer importiert.

<map_schema_spec>

Sie können Daten, die in einem Schema exportiert wurden, in ein anderes Schema importieren. Dazu können Sie für eine Loader-Sitzung ein Schema-Map mit dem USE SCHEMAMAP-Kommando festlegen. Sie können aber auch im IMPORT SCHEMA-Kommando das Syntaxelement map_schema_spec verwenden, um entweder ein vorhandenes Schema-Map schema_map_name anzugeben, das die gewünschte Schema-Abbildung enthält oder die gewünschte Schema-Abbildung mittels <schema_name> TO <schema_name> direkt festzulegen.

Siehe auch:

CREATE/DROP SCHEMAMAP-Anweisung

<package_spec>

Sie können die Systemtabelle SYSLOADER.TRANSFORMATIONMODEL exportieren.

     Durch die Angabe eines Datenstroms mittels PACKAGE <outstream_csv_spec> werden alle Einträge der Tabelle SYSLOADER.TRANSFORMATIONMODEL in diesen Datenstrom exportiert. Sie sollten diese Möglichkeit nutzen, um den Importvorgang gut zu protokollieren.

     Ohne Angabe eines Datenstroms mittels PACKAGE <outstream_csv_spec> wird die Systemtabelle SYSLOADER.TRANSFORMATIONMODEL nicht exportiert.

Siehe auch:

Zusätzliche Protokollfunktionalität (package_spec)

<restart_spec>

Sie können den Import wiederaufsetzen.

Der Benutzer kann die package_guid des entsprechenden Import-Kommandos aus der Tabelle SYSLOADER.TRANSFORMATIONMODEL oder der Protokolldatei ermitteln. Unter Verwendung des Syntaxelements restart_spec können Sie das Kommando mit der entsprechenden package_guidwiederaufsetzen.

Siehe auch:

Wiederaufsetzen

Ergebnis

Die Anwendungsdaten und/oder der Datenbankkatalog werden in die Datenströme data_instream_part_spec und catalog_instream_spec importiert.

Gegebenenfalls werden alle Einträge der Tabelle SYSLOADER.TRANSFORMATIONMODEL in den Datenstrom package_spec exportiert.

Fehlerfall

Der Import kann nicht erfolgreich beendet werden. In diesem Fall protokolliert der Loader die Fehlerursache in der Protokolldatei.

Die Werte PACKAGEGUID und CLIENTNODE werden ebenfalls in die Protokolldatei geschrieben. Die PACKAGEGUID ist für ein eventuelles Wiederaufsetzen des Imports erforderlich.

Siehe auch:

Importieren: Kommandos

EXPORT SCHEMA-Kommando

Protokolldatei

Systemtabellen

Ende des Inhaltsbereichs