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.
Übersicht über DBMS_CLOUD_IMPORT-Unterprogramme
In dieser Tabelle werden die Unterprogramme zusammengefasst, die im Package DBMS_CLOUD_IMPORT enthalten sind.
| Unterprogramm | Beschreibung |
|---|---|
| Prozedur CREATE_IMPORT_TASK | 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 SUSPEND_IMPORT_TASK | Unterbricht eine laufende Importaufgabe vorübergehend, damit sie später fortgesetzt werden kann. |
| Prozedur RESUME_IMPORT_TASK | Startet eine zuvor unterbrochene Importaufgabe neu und setzt die Verarbeitung ab dem Zeitpunkt fort, an dem sie unterbrochen wurde. |
| Prozedur DROP_IMPORT_TASK | 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.
Sie müssen als ADMIN-Benutzer 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 für eine autonome KI-Zieldatenbank den Servicenamen in der Datei tnsnames.ora im Wallet, in den Verbindungszeichenfolgen in der Oracle Cloud Infrastructure-Konsole oder durch Abfragen der Ansicht V$SERVICES. Weitere Informationen finden Sie unter TNS-Namen und Verbindungszeichenfolgen für eine autonome KI-Datenbankinstanz anzeigen. 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. Die 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, 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 Teilmigration auf Tabellenebene auszufü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 ADMIN-Benutzer 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 ADMIN-Benutzer 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;
/