Oracle Cloud Infrastructure-Dokumentation

DBMS_CLOUD_IMPORT-Package

DBMS_CLOUD_IMPORT erleichtert den Import von Daten aus Oracle-Datenbanken sowie aus Nicht-Oracle-Datenbanken, indem das Oracle Heterogeneous Gateway in Autonomous AI Database verwendet wird. Während des Importprozesses werden Quelldatentypen in Oracle-kompatible Datentypen konvertiert. Daher gelten alle Einschränkungen und Einschränkungen von Oracle Heterogeneous Gateway auch für Vorgänge, die über dieses Package ausgeführt werden.

Übergeordnetes Thema: Von autonomer KI-Datenbank bereitgestellte Packagereferenz

Übersicht über DBMS_CLOUD_IMPORT-Unterprogramme

In dieser Tabelle werden die Unterprogramme zusammengefasst, die DBMS_CLOUD_IMPORT im Package enthalten sind.

Unterprogramm Beschreibung

Prozedur ADD_BY_LIKE

Erstellt eine Importaufgabe für den Import von Daten aus einer angegebenen Quelle in Oracle mit optionaler Filterung nach Schema oder Tabelle und konfigurierbaren Planungsoptionen.

Prozedur ADD_FILE

Unterbricht eine laufende Importaufgabe vorübergehend, damit sie später fortgesetzt werden kann.

Prozedur ADD_LATEST_FILES

Startet eine zuvor unterbrochene Importaufgabe neu und setzt die Verarbeitung ab dem Zeitpunkt fort, an dem sie unterbrochen wurde.

Prozedur ADD_TABLE

Löscht eine Importaufgabe und entfernt die zugehörige Aufgabendefinition und Metadaten.
  • Prozedur CREATE_IMPORT_TASK
    Die Prozedur DBMS_CLOUD_IMPORT.CREATE_IMPORT_TASK erstellt und konfiguriert einen Importjob, um Daten aus einem angegebenen Quellsystem in eine autonome KI-Datenbank zu importieren.
  • Prozedur SUSPEND_IMPORT_TASK
    Mit der Prozedur DBMS_CLOUD_IMPORT.SUSPEND_IMPORT_TASK wird eine ausgeführte Importaufgabe vorübergehend angehalten, sodass sie später fortgesetzt werden kann.
  • Prozedur RESUME_IMPORT_TASK
    Die Prozedur DBMS_CLOUD_IMPORT.RESUME_IMPORT_TASK nimmt eine Importaufgabe wieder auf, die zuvor unterbrochen wurde. Die Aufgabenausführung für die angegebene task_name wird neu gestartet, und der Importvorgang wird ab dem Zeitpunkt fortgesetzt, an dem er unterbrochen wurde.
  • Prozedur DROP_IMPORT_TASK
    Die Prozedur DBMS_CLOUD_IMPORT.DROP_IMPORT_TASK löscht eine Importaufgabe und entfernt die zugehörige Aufgabendefinition und Metadaten.

Übergeordnetes Thema: Package DBMS_CLOUD_IMPORT

Prozedur CREATE_IMPORT_TASK

Die Prozedur DBMS_CLOUD_IMPORT.CREATE_IMPORT_TASK erstellt und konfiguriert einen Importjob, um Daten aus einem angegebenen Quellsystem in eine autonome KI-Datenbank zu importieren.

Sie müssen als Benutzer ADMIN angemeldet sein, um diese Prozedur ausführen zu können.

Syntax

DBMS_CLOUD_IMPORT.CREATE_IMPORT_TASK(
    task_name          IN VARCHAR2,
    hostname           IN VARCHAR2,
    port               IN VARCHAR2,
    service_name       IN VARCHAR2,
    credential_name    IN VARCHAR2,
    directory_name     IN VARCHAR2,
    ssl_server_cert_dn IN VARCHAR2 DEFAULT NULL,
    gateway_params     IN VARCHAR2 DEFAULT NULL,
    schema_list        IN CLOB     DEFAULT NULL,
    table_list         IN CLOB     DEFAULT NULL
);

Parameter

Parameter Beschreibung

task_name

Eindeutige Kennzeichnung der Importaufgabe. Dies ist der Name, der der Migrationsaufgabe zugewiesen ist. Wird zur Identifizierung der Aufgabe und des zugehörigen Scheduler-Jobs verwendet.

hostname

Der Hostname für die Zieldatenbank.

Die Angabe von localhost für hostname ist nicht zulässig.

port

Gibt den Port für die Verbindungen zur Zieldatenbank an.

Wenn Sie eine Verbindung mit einer von Oracle verwalteten heterogenen Konnektivität mit dem Parameter gateway_params angeben, legen Sie den Port basierend auf dem Wert db_type fest.

Weitere Informationen finden Sie unter Von Oracle verwaltete heterogene Konnektivitätsdatenbanktypen und -ports.

service_name

Die service_name für die zu verknüpfende Datenbank. Suchen Sie den Servicenamen für eine autonome Zieldatenbank mit einer der folgenden Methoden:

  • Suchen Sie in der Datei tnsnames.ora in der Datei wallet.zip, die Sie aus einer autonomen KI-Datenbank für Ihre Verbindung herunterladen.

  • Klicken Sie in der Oracle Cloud Infrastructure-Konsole auf Datenbankverbindung. Im Bereich Verbindungszeichenfolgen enthält jede Verbindungszeichenfolge einen Eintrag service_name mit der Verbindungszeichenfolge für den entsprechenden Service. Wenn sowohl gegenseitige TLS-(mTLS-) als auch TLS-Verbindungen zulässig sind, wählen Sie unter TLS-Authentifizierung die Option TLS aus, um die TNS-Namen und Verbindungszeichenfolgen für Verbindungen mit TLS-Authentifizierung anzuzeigen. Weitere Informationen finden Sie unter TNS-Namen und Verbindungszeichenfolgen für eine autonome KI-Datenbankinstanz anzeigen.

  • Abfrageansicht V$SERVICES. Beispiel: 

    SELECT name FROM V$SERVICES;

    Wenn Sie mit dem Parameter gateway_params eine Verbindung zu einer von Oracle verwalteten heterogenen Konnektivität angeben, ist service_name der Datenbankname der Nicht-Oracle-Datenbank.

credential_name

Der Name der gespeicherten Zugangsdaten, die mit DBMS_CLOUD.CREATE_CREDENTIAL erstellt wurden. Dies sind die Zugangsdaten für den Zugriff auf die Quelldatenbank.

directory_name

Das Verzeichnis für die Datei cwallet.sso. Der Standardwert für diesen Parameter ist 'data_pump_dir'.

Die von Oracle verwaltete heterogene Konnektivität ist mit einem Wallet vorkonfiguriert, das die meisten gängigen vertrauenswürdigen Root- und Zwischen-SSL-Zertifikate enthält. Der Parameter directory_name ist nicht erforderlich, wenn Sie den Parameter gateway_params angeben.

ssl_server_cert_dn

Der im Serverzertifikat gefundene DN-Wert.

Die von Oracle verwaltete heterogene Konnektivität ist mit einem Wallet vorkonfiguriert, das die meisten gängigen vertrauenswürdigen Root- und Zwischen-SSL-Zertifikate enthält. ssl_server_cert_dn muss NULL sein, wenn Sie den Parameter gateway_params angeben, oder den Parameter ssl_server_cert_dn nicht einschließen (der Standardwert ist NULL).

gateway_params

Gibt Verbindungs- und Quelltypeinstellungen an, die für heterogene Migrationen verwendet werden (d.h. wenn die Quelle eine Nicht-Oracle-Datenbank ist).

Es wird als JSON-Objekt übergeben und enthält Werte wie den Quelldatenbanktyp. Beispiel: gateway_params => JSON_OBJECT('db_type' VALUE 'mysql').

Diese Parameter geben dem Migrationsjob an, welches Gateway- oder Treiberverhalten beim Herstellen einer Verbindung zu Daten und Importieren aus dem Quellsystem verwendet werden soll. Dieser Parameter ist optional und standardmäßig NULL.

schema_list

Liste der Schemas, die in den Import aufgenommen werden sollen.

Dieser Parameter ist optional. Wenn Sie keinen Wert angeben, lautet der Standardwert NULL. Alle Schemas in der Quelldatenbank werden migriert.

table_list

Gibt die Tabellen an, die als JSON-Array mit '[{"schema_name":"public","table_name":"sales_data"}]'-Einträgen migriert werden sollen.

Verwenden Sie table_list, um eine (teilweise) Migration auf Tabellenebene durchzuführen. Nur die angegebenen Tabellen werden migriert.

Geben Sie keine sich überschneidenden Objekte in schema_list und table_list an. Dieser Parameter wird nur unterstützt, wenn die Quelldatenbank Oracle ist.

Dieser Parameter ist optional und standardmäßig NULL.

Beispiel

BEGIN
  DBMS_CLOUD_IMPORT.CREATE_IMPORT_TASK(
    task_name          => 'orcl_import_job',
    hostname           => '<remote_db_hostname>',
    port               => '<remote_db_port>',
    service_name       => '<remote_db_service_name>',
    ssl_server_cert_dn => '<cn=remote_db_cn_name>',
    directory_name     => '<walletdb>',
    credential_name    => 'db1_cred',
    schema_list        => '["admin"]'
  );
END;
/

Prozedur SUSPEND_IMPORT_TASK

Mit der Prozedur DBMS_CLOUD_IMPORT.SUSPEND_IMPORT_TASK wird eine ausgeführte Importaufgabe vorübergehend angehalten, sodass sie später fortgesetzt werden kann.

Syntax

DBMS_CLOUD_IMPORT.SUSPEND_IMPORT_TASK(
   task_name IN VARCHAR2 );

Parameter

Parameter Beschreibung

task_name

Eindeutige Kennzeichnung der Importaufgabe.

Beispiel

BEGIN
  DBMS_CLOUD_IMPORT.SUSPEND_IMPORT_TASK(
   task_name => 'SALES_IMPORT_JOB1'
);
END;
/

Prozedur RESUME_IMPORT_TASK

Die Prozedur DBMS_CLOUD_IMPORT.RESUME_IMPORT_TASK setzt eine Importaufgabe fort, die zuvor unterbrochen wurde. Die Aufgabenausführung für die angegebene task_name wird neu gestartet, und der Importvorgang wird ab dem Zeitpunkt fortgesetzt, an dem er unterbrochen wurde.

Sie müssen als Benutzer ADMIN angemeldet sein, um diese Prozedur ausführen zu können.

Syntax

DBMS_CLOUD_IMPORT.RESUME_IMPORT_TASK(
   task_name IN VARCHAR2 );

Parameter

Parameter Beschreibung

task_name

Eindeutige Kennzeichnung der Importaufgabe.

Beispiel

BEGIN
  DBMS_CLOUD_IMPORT.RESUME_IMPORT_TASK(
   task_name => 'SALES_IMPORT_JOB1'
  );
 END;
/

Prozedur DROP_IMPORT_TASK

Die Prozedur DBMS_CLOUD_IMPORT.DROP_IMPORT_TASK löscht eine Importaufgabe und entfernt die zugehörige Aufgabendefinition und Metadaten.

Sie müssen als Benutzer ADMIN angemeldet sein, um diese Prozedur ausführen zu können.

Syntax

DBMS_CLOUD_IMPORT.DROP_IMPORT_TASK(
   task_name IN VARCHAR2 );

Parameter

Parameter Beschreibung

task_name

Eindeutige Kennzeichnung der Importaufgabe.

Beispiel

BEGIN
  DBMS_CLOUD_IMPORT.DROP_IMPORT_TASK(
   task_name => 'SALES_IMPORT_JOB1'
  );
 END;
/