Übersicht über DBMS_DCAT-Unterprogramme

In dieser Tabelle werden die DBMS_DCAT-Packageprozeduren aufgeführt, mit denen Data Catalog-Verbindungen erstellt, abgefragt und gelöscht werden.

Unterprogramm Beschreibung
Prozedur SET_DATA_CATALOG_CREDENTIAL Zugangsdaten für den Datenkatalogzugriff festlegen, die von einer bestimmten Verbindung zum Datenkatalog verwendet werden
Prozedur SET_OBJECT_STORE_CREDENTIAL Zugangsdaten festlegen, die von der angegebenen eindeutigen Verbindungs-ID für den Zugriff auf den Objektspeicher verwendet werden
Prozedur SET_DATA_CATALOG_CONN Verbindung zum angegebenen Datenkatalog erstellen
Prozedur UNSET_DATA_CATALOG_CONN Vorhandene Data Catalog-Verbindung entfernen

Prozedur SET_DATA_CATALOG_CREDENTIAL

Mit dieser Prozedur werden die Zugangsdaten für den Data Catalog-Zugriff festgelegt, die von einer bestimmten Verbindung zum Data Catalog verwendet werden.

Syntax

PROCEDURE DBMS_DCAT.SET_DATA_CATALOG_CREDENTIAL(
    credential_name VARCHAR2(128) DEFAULT NULL,
    dcat_con_id     VARCHAR2 DEFAULT NULL
  );

Parameter

Parameter Beschreibung
credential_name Die Zugangsdaten für den Zugriff auf den Datenkatalog.
dcat_con_id Die eindeutige Data Catalog-Verbindungs-ID. Diese Zugangsdaten werden für die Verbindung verwendet, die mit dcat_con_id identifiziert wird. Die Standardeinstellung ist Null.

Diese Zugangsdaten müssen über die Berechtigung "Datenkatalog verwalten" verfügen. Siehe Data Catalog-Policys.

Prozedur SET_OBJECT_STORE_CREDENTIAL

Diese Prozedur legt die Zugangsdaten fest, die von der angegebenen eindeutigen Verbindungs-ID für den Zugriff auf den Objektspeicher verwendet werden. Wenn Sie die Zugriffszugangsdaten für den Objektspeicher ändern, werden alle vorhandenen synchronisierten Tabellen geändert, um die neuen Zugangsdaten zu verwenden.

Syntax

PROCEDURE DBMS_DCAT.SET_OBJECT_STORE_CREDENTIAL(
    credential_name  VARCHAR2(128),
    dcat_con_id      IN VARCHAR2 DEFAULT NULL
  );

Parameter

Parameter Beschreibung
credential_name Die Zugangsdaten, die von externen Tabellen für den Zugriff auf den Objektspeicher verwendet werden.
dcat_con_id Die eindeutige Data Catalog-Verbindungs-ID. Der Standardwert ist NULL.

Prozedur SET_DATA_CATALOG_CONN

Mit dieser Prozedur wird eine Verbindung zum angegebenen Data Catalog hergestellt. Die Verbindung ist erforderlich, um Metadaten mit Data Catalog zu synchronisieren. Eine autonome KI-Datenbankinstanz kann eine Verbindung zu mehreren Data Catalog-Instanzen herstellen und unterstützt die Verbindung zu OCI Data Catalogs und AWS Glue Data Catalogs.

Syntax

PROCEDURE DBMS_DCAT.SET_DATA_CATALOG_CONN (
   region         VARCHAR2 DEFAULT NULL,
   endpoint       VARCHAR2 DEFAULT NULL,
   catalog_id     VARCHAR2 DEFAULT NULL,
   dcat_con_id    VARCHAR2 DEFAULT NULL,
   catalog_type   VARCHAR2 DEFAULT NULL,
   token_endpoint VARCHAR2 DEFAULT Null
 );

Parameter

Parameter Beschreibung
region Der Bereich "Data Catalog". Wenn endpoint angegeben ist, ist region optional. Wenn sowohl endpoint als auch region angegeben sind, hat endpoint Vorrang. Der Standardwert ist NULL.
endpoint Der Data Catalog-Endpunkt. Wenn region angegeben ist, ist endpoint optional. Wenn sowohl endpoint als auch region angegeben sind, hat endpoint Vorrang. Standardwert ist NULL.
catalog_id Die eindeutige Oracle Cloud-ID (OCID) für die Data Catalog-Instanz. Beim Herstellen einer Verbindung zu AWS Glue Data Catalogs ist catalog_id optional.
dcat_con_id Eine eindeutige Data Catalog-Verbindungs-ID. Diese ID ist beim Herstellen einer Verbindung zu mehreren Datenkatalogen erforderlich und bei nur einer Verbindung optional. Wird verwendet, um die Data Catalog-Verbindung bei nachfolgenden Aufrufen oder beim Abfragen von Ansichten zu referenzieren. Wenn kein Bezeichner angegeben ist, generiert diese Prozedur einen NULL-Verbindungsbezeichner. Für dcat_con_id gelten folgende Einschränkungen:
  • Sie muss innerhalb der Instanz der autonomen KI-Datenbank eindeutig sein.
  • Er muss mit einem Buchstaben beginnen.
  • Er kann alphanumerische Zeichen, Unterstriche (_), Dollarzeichen ($) und Nummernzeichen (#) enthalten.
  • Sie muss mindestens 16 Zeichen umfassen.
catalog_type Der Typ des zu verbindenden Datenkatalogs. Zulässige Werte
  • OCI_DCAT - OCI Data Catalog
  • AWS_GLUE - AWS Glue-Datenkatalog
  • NULL: Der Katalogtyp wird automatisch aus der angegebenen Region oder dem angegebenen Endpunkt ermittelt.
token_endpoint Der Zugriffstokenendpunkt für die OAuth-Authentifizierung. Standardwert ist NULL.

Verwendung

Sie müssen diese Prozedur nur einmal aufrufen, um die Verbindung festzulegen. Im Rahmen des Verbindungsprozesses fügt Autonomous AI Database benutzerdefinierte Eigenschaften zu Data Catalog hinzu. Auf diese benutzerdefinierten Eigenschaften können Data Catalog-Benutzer zugreifen und Standardnamen (für Schemas, Tabellen und Spalten) und Spaltendatentypen außer Kraft setzen.

Vor dem Erstellen einer Verbindung müssen Zugangsdaten erstellt und festgelegt werden. Eine Beschreibung des Verbindungsprozesses finden Sie unter Typischer Workflow mit Data Catalog für OCI Data Catalogs und Benutzerworkflow für die Abfrage mit AWS Glue Data Catalog für AWS Glue Data Catalogs.

Beispiele

Beispiel: Verbindung mit einer bekannten OCID herstellen

In diesem Beispiel stellt die autonome KI-Datenbank eine Verbindung zu Data Catalog in der Region uk-london-1 her. Der Parameter catalog_id verwendet die Oracle Cloud-ID (ocid) für die Data Catalog-Instanz. Der Typ des Datenkatalogs wird automatisch bestimmt: AWS Glue Data Catalog oder OCI Data Catalog.

BEGIN
  DBMS_DCAT.SET_DATA_CATALOG_CONN(
    region=>'uk-london-1',
    catalog_id=>'ocid1.datacatalog.oc1.uk-london-1...');
END;
/

Beispiel: Verbindung zu einem AWS Glue Data Catalog herstellen

Eine Verbindung ist die Verknüpfung zwischen einer autonomen KI-Datenbankinstanz und einem AWS Glue Data Catalog. Nach einer erfolgreichen Verbindung kann die Autonomous AI Database-Instanz mit AWS Glue synchronisiert werden. Jeder AWS-Account verfügt über einen AWS Glue Data Catalog pro Region, und jeder Katalog kann über den entsprechenden Serviceendpunkt für jede Region aufgerufen werden. Eine autonome AI-Datenbankinstanz kann mit einem AWS Glue Data Catalog verknüpft werden, indem die API DBMS_DCAT.SET_DATA_CATALOG_CONN aufgerufen und der Endpunkt für die Region angegeben wird, in der sich der Katalog befindet.

Siehe AWS Glue-Endpunkte und -Quotas.

In diesem Beispiel stellt die autonome KI-Datenbank eine Verbindung zu einem AWS Glue Data Catalog in der Region uk-london-1 her. Da es sich um eine AWS Glue Data Catalog-Verbindung handelt, ist der Parameter catalog_id nicht erforderlich.

BEGIN
  DBMS_DCAT.SET_DATA_CATALOG_CONN(
    region=>'uk-london-1',
    catalog_type=>'AWS_GLUE'
END;
/

Prozedur UNSET_DATA_CATALOG_CONN

Mit diesem Verfahren wird eine vorhandene Data Catalog-Verbindung entfernt.

Syntax

Hinweis: Wenn Sie diese Prozedur aufrufen, werden alle geschützten Schemas und externen Tabellen gelöscht, die im Rahmen vorheriger Synchronisierungen erstellt wurden. Sie wirkt sich nicht auf die Metadaten in Data Catalog aus.

PROCEDURE DBMS_DCAT.UNSET_DATA_CATALOG_CONN (
    dcat_con_id IN VARCHAR2 DEFAULT NULL
);

Parameter

Parameter Beschreibung
dcat_con_id Die eindeutige Data Catalog-Verbindungs-ID. Der Standardwert ist Null.

Synchronisierungsunterprogramme

Mit den in dieser Tabelle aufgeführten Prozeduren können Sie eine Synchronisierung ausführen, einen Synchronisierungsjob erstellen und löschen sowie synchronisierte Schemas löschen.

Hinweis: Am 4. April 2022 wurden die Parameter sync_option und grant_read der Prozedur DBMS_DCAT.RUN_SYNC hinzugefügt. Um die korrekte Performance von geplanten Synchronisierungsjobs sicherzustellen, die vor diesem Datum erstellt wurden, müssen Sie die geplanten Synchronisierungsjobs löschen und neu erstellen. Siehe Prozedur DROP_SYNC_JOB und Prozedur CREATE_SYNC_JOB.

Unterprogramm Beschreibung
CREATE_SYNC_JOB - Prozedur Scheduler-Job erstellen, um RUN_SYNC regelmäßig aufzurufen
DROP_SYNC_JOB - Prozedur Vorhandenen Synchronisierungsjob für die angegebene eindeutige Verbindungs-ID löschen
Prozedur DROP_SYNCED_SCHEMAS Alle zuvor synchronisierten Schemas für die angegebene eindeutige Verbindungs-ID löschen
Prozedur RUN_SYNC Synchronisierungsvorgang ausführen

Prozedur RUN_SYNC

Diese Prozedur führt einen Synchronisierungsvorgang aus und ist der Einstiegspunkt für die Synchronisierung. Als Eingabe werden Listen ausgewählter Datenkatalogassets, -ordner und -entitys erstellt, gelöscht und geändert.

Der Parameter sync_option gibt an, welchen Vorgang die Prozedur RUN_SYNC ausführt: SYNC, DELETE oder REPLACE. Der Vorgang wird über Entitys im Geltungsbereich des Parameters synced_objects ausgeführt.

Jeder Aufruf der Prozedur RUN_SYNC gibt eine eindeutige operation_id zurück, mit der die View USER_LOAD_OPERATIONS abgefragt werden kann, um Informationen zum Status der Synchronisierung und der entsprechenden log_table abzurufen. Die Ansicht DBMS_DCAT$SYNC_LOG kann abgefragt werden, um einfachen Zugriff auf die log_table für den letzten vom aktuellen Benutzer ausgeführten Synchronisierungsvorgang zu erhalten. Weitere Informationen finden Sie unter DBMS_DCAT$SYNC_LOG View.

Hinweis: Am 4. April 2022 wurden die Parameter sync_option und grant_read der Prozedur DBMS_DCAT.RUN_SYNC hinzugefügt. Um die korrekte Performance von geplanten Synchronisierungsjobs sicherzustellen, die vor diesem Datum erstellt wurden, müssen Sie die geplanten Synchronisierungsjobs löschen und neu erstellen. Siehe Prozedur DROP_SYNC_JOB und Prozedur CREATE_SYNC_JOB.

Partitionierte logische Entitys oder Glue-Tabellen synchronisieren

Die Prozedur RUN_SYNC erstellt eine partitionierte externe Tabelle für jede logische Entity oder Glue-Tabelle, wenn alle drei der folgenden Befehle angewendet werden:

  1. Die logische Entity oder Glue-Tabelle des OCI-Datenkatalogs weist mindestens ein partitioniertes Attribut auf.

  2. Bei OCI-Datenkatalogen wird die logische Entity aus einem präfixbasierten Dateinamensmuster abgeleitet. Partitionierte logische Entitys, die von regex-basierten Mustern abgeleitet werden, werden nicht unterstützt.

  3. Bei OCI-Datenkatalogen basiert die logische Entity auf partitionierten Daten, die dem Ordnerformat "hive-style" oder "non-hive" folgen. Logische Entitys, die auf partitionierten Daten basieren, die dem Nicht-Hive-Format unter Verwendung von Objektnamen folgen, werden nicht unterstützt.

    • Beispiel 1. Logische Entitys basierend auf durch Harvesting erstellten Objekten, die dem Partitionierungsformat im Hive-Stil mit präfixbasierten Dateinamensmustern folgen.

      Betrachten Sie die folgenden Objekte:

      Bucket: MYBUCKET
cluster1/db1.db/sales/country=USA/year=2020/month=01/sales1.csv
cluster1/db1.db/sales/country=USA/year=2020/month=01/sales2.csv
cluster1/db1.db/sales/country=USA/year=2020/month=02/sales1.csv

      Beim Harvesting des Buckets mit einem Dateinamensmuster mit dem Startordnerpräfix cluster1/db1.db wird eine logische Entity namens SALES mit drei Partitionsattributen generiert: country, year und month. Der Typ für partitionierte Attribute ist Partition, während der Typ für nicht partitionierte Attribute Primitive ist.

    • Beispiel 2. Logische Entitys basierend auf durch Harvesting erstellten Objekten, die dem Partitionierungsformat im Nicht-Hive-Stil mit präfixbasierten Dateinamensmustern folgen.

      Betrachten Sie die folgenden Objekte:

      Bucket: MYBUCKET
cluster2/db2.db/sales/USA/2020/01/sales1.csv
cluster2/db2.db/sales/USA/2020/01/sales2.csv
cluster2/db2.db/sales/USA/2020/02/sales1.csv

      Beim Harvesting des Buckets mit einem Dateinamensmuster mit dem Startordnerpräfix cluster2/db2.db wird eine logische Entity namens SALES mit drei Partitionsattributen generiert: name0, name1 und name2. Der einzige Unterschied zwischen der generierten logischen Entity und Beispiel 1 besteht darin, dass die Namen der partitionierten Attribute automatisch generiert werden, während sie in Beispiel 1 aus der URL extrahiert werden (country, year und month).

Ein vollständiges End-to-End-Beispiel für die Synchronisierung partitionierter logischer Entitys finden Sie in Beispiel: Ein partitioniertes Datenszenario.

Inkrementelle Synchronisierung von partitionierten logischen Entitys/Glue-Tabellen

Jeder Aufruf der Prozedur RUN_SYNC gibt eine Gruppe logischer OCI Data Catalog-Entitys oder AWS Glue-Tabellen an, die mit der Datenbank synchronisiert werden sollen. Wenn eine logische Entity oder Glue-Tabelle in zwei RUN_SYNC-Aufrufen vorhanden ist, behält der zweite Aufruf vorhandene externe Tabellen bei und ändert sie möglicherweise. Die folgende Tabelle zeigt, welche Änderungen der logischen Entity oder Glue-Tabelle unterstützt werden, wenn die logische Entity oder Glue-Tabelle partitioniert ist:

Änderung der logischen Entity oder Glue-Tabelle Aktion
Hinzufügen, Entfernen oder Aktualisieren einer Partition Alle Partitionen der externen partitionierten Tabelle werden aktualisiert, unabhängig davon, ob eine Änderung vom Datenkatalog erkannt wurde.
Hinzufügen eines partitionierten Attributs Das Hinzufügen einer partitionierten Spalte zu einer externen partitionierten Tabelle wird nicht unterstützt. Eine Ausnahme wird ausgelöst.
Löschen eines Partitionsattributs Das Löschen einer partitionierten Spalte aus einer externen partitionierten Tabelle wird nicht unterstützt. Eine Ausnahme wird ausgelöst.
Umbenennen eines partitionierten Attributs Das Umbenennen einer partitionierten Spalte in einer externen partitionierten Tabelle wird nicht unterstützt. Eine Ausnahme wird ausgelöst.

Syntax

PROCEDURE DBMS_DCAT.RUN_SYNC (
    synced_objects   IN  CLOB,
    sync_option      IN VARCHAR2 DEFAULT 'SYNC',
    error_semantics  IN VARCHAR2 DEFAULT 'SKIP_ERRORS',
    log_level        IN VARCHAR2 DEFAULT 'INFO',
    grant_read       IN VARCHAR2 DEFAULT NULL,
    dcat_con_id      IN VARCHAR2 DEFAULT NULL
 );
PROCEDURE DBMS_DCAT.RUN_SYNC (
    synced_objects   IN  CLOB,
    sync_option      IN VARCHAR2 DEFAULT 'SYNC',
    error_semantics  IN VARCHAR2 DEFAULT 'SKIP_ERRORS',
    log_level        IN VARCHAR2 DEFAULT 'INFO',
    grant_read       IN VARCHAR2 DEFAULT NULL,
    operation_id     OUT NOCOPY NUMBER,
    dcat_con_id      IN VARCHAR2 DEFAULT NULL
 );

Parameter

Parameter Beschreibung
synced_objects

Dieser Parameter ist ein JSON-Dokument, das die zu synchronisierenden Datenkatalogobjekte angibt.

Für OCI Data Catalogs gibt das JSON-Dokument eine Gruppe von Entitys mit mehreren Granularitäten an: Datenassets, Ordner (Objektspeicher-Buckets) oder logische Entitys. Es enthält eine asset_list, die entweder ein Array von Assetobjekten oder ein Array mit einer einzelnen "*"-Zeichenfolge ist, die für "Alle (Objektspeicher-)Datenassets im Katalog synchronisieren" steht.

Für AWS Glue Data Catalogs gibt das JSON-Dokument eine Liste von Tabellen mit mehreren Granularitäten an: Datenbanken, Tabellen. Das Dokument gibt eine Liste von Datenbanken an. Benutzer können die Gruppe der zu synchronisierenden Tabellen einschränken, indem sie einzelne Tabellen innerhalb einer Datenbank angeben.
sync_option (Optional) Es stehen drei Optionen zur Verfügung:
  • SYNC (Standard) - Diese Option stellt sicher, dass das, was sich im Datenkatalog über den Geltungsbereich synced_objects befindet, in der autonomen KI-Datenbank dargestellt wird. Wenn eine logische Entity oder Glue-Tabelle seit dem letzten Synchronisierungsvorgang aus dem Datenkatalog gelöscht wurde, wird sie in der autonomen KI-Datenbank gelöscht. Die folgenden Vorgänge werden über den Geltungsbereich synced_objects ausgeführt:
    • Fügt Tabellen für neue Datenkatalogentitys hinzu
    • Entfernt Tabellen für gelöschte Datenkatalogentitys
    • Aktualisiert Eigenschaften (wie Name, Spalten und Datentypen) für vorhandene Tabellen
  • DELETE: Löscht Tabellen im Geltungsbereich synced_objects.
  • REPLACE: Ersetzt alle aktuell synchronisierten Objekte durch die Objekte im Geltungsbereich synced_objects.
error_semantics (Optional) Dieser Parameter gibt das Fehlerverhalten an. Wenn dieser Wert auf SKIP_ERRORS gesetzt ist, versucht die Synchronisierung trotz aufgetretener Fehler für einzelne Entitys fortzusetzen. Wenn dieser Wert auf STOP_ON_ERROR gesetzt ist, verläuft die Prozedur bei dem ersten aufgetretenen Fehler nicht erfolgreich. Der Standardwert ist SKIP_ERRORS.
log_level (Optional) Dieser Parameter gibt die folgenden Werte bei der Erhöhung der Loggingdetails an: (OFF, FATAL, ERROR, WARN, INFO, DEBUG, TRACE, ALL). Der Standardwert ist INFO.
grant_read (Optional) Dieser Parameter ist eine Liste von Benutzern/Rollen, denen automatisch READ-Berechtigungen für alle externen Tabellen erteilt werden, die durch diesen Aufruf von RUN_SYNC verarbeitet werden. Alle Benutzer/Rollen in der Liste grant_read erhalten READ-Berechtigungen für alle neuen oder bereits vorhandenen externen Tabellen, die den mit dem Parameter synced_objects angegebenen Entitys entsprechen. Die Prozedur RUN_SYNC behält bereits erteilte Berechtigungen für synchronisierte externe Tabellen bei.
operation_id

(Optional) Dieser Parameter wird verwendet, um den entsprechenden Eintrag in USER_LOAD_OPERATIONS für die Synchronisierung zu suchen und den Namen der Logtabelle zu bestimmen.

Hinweis: Eine Version von RUN_SYNC, die keine operation_id zurückgibt, ist verfügbar, sodass Benutzer USER_LOAD_OPERATIONS nach der letzten Synchronisierung abfragen können.

dcat_con_id Dieser Parameter ist die eindeutige Data Catalog-Verbindungs-ID, die beim Erstellen der Verbindung zum Data Catalog angegeben wurde. Siehe Prozedur SET_DATA_CATALOG_CONN. Dieser Parameter gibt an, welche Verbindung für die Synchronisierung verwendet wird, und wird Teil des abgeleiteten Schemanamens. Eine Beschreibung der Ableitung des Schemanamens finden Sie unter Synchronisierungszuordnung. Der Standardwert des Parameters ist NULL.

Beispiele

Beispiel: Synchronisieren Sie alle OCI Data Catalog-Entitys.

Im folgenden Beispiel werden alle Data Catalog-Entitys synchronisiert.

EXEC DBMS_DCAT.RUN_SYNC(synced_objects=>'{"asset_list":["*"]}');

Beispiel: Parameter synced_objects zum Synchronisieren aller OCI Data Catalog-Datenassets.

Im Folgenden finden Sie einen Beispielparameter synced_objects zum Synchronisieren aller (Object Storage-)Datenassets im Data Catalog.

{"asset_list" : ["*"]}

Beispiel: Parameter synced_objects zum Synchronisieren bestimmter OCI Data Catalog-Datenassets.

Im Folgenden finden Sie einen Beispielparameter synced_objects zum Synchronisieren von zwei Datenassets.

{"asset_list": [
        {
            "asset_id":"...-9e2e7f78fd5f"
        },
        {
            "asset_id":"...-9e2e7f74523"
        }
    ]}

Beispiel: Parameter synced_objects zum Synchronisieren bestimmter OCI Data Catalog-Entitys in einem Datenasset.

Im Folgenden ist ein Beispiel für den Parameter synced_objects zum Synchronisieren von zwei Entitys innerhalb des Datenassets dargestellt.

{"asset_list": [
        {
            "asset_id":"...-9e2e7f78fd5f",
            "folder_list":[
                "f1",
                "f2"
           ]
        }
    ]}

Beispiel: Parameter synced_objects zum Synchronisieren bestimmter OCI Data Catalog-Ordner und -Entitys in einem Datenasset.

Im Folgenden ist ein Beispiel für den Parameter synced_objects zum Synchronisieren von zwei Ordnern und zwei Entitys innerhalb des Datenassets dargestellt.

{"asset_list":[
        {
            "asset_id":"...-9e2e7f78fd5f",
            "entity_list": [
                "entity1",
                "entity2"
            ],
             "folder_list": [
                "f1",
                "f2"
            ]
        }
    ]}

Beispiel: synced_objects Parameter für die Synchronisierung aller AWS Glue Data Catalog-Datenbanken.

Im Folgenden wird ein Beispiel für den Parameter synced_objects für die Synchronisierung aller Datenbanken im AWS Glue Data Catalog gezeigt.

{"database_list":["*"]}

Beispiel: synced_objects-Parameter zum Synchronisieren von zwei AWS Glue Data Catalog-Datenbanken.

Im Folgenden ist ein Beispiel für den Parameter synced_objects zum Synchronisieren von zwei AWS Glue Data Catalog-Datenbanken dargestellt.

{"database_list":[
    {"database":"tpcdscsv"},
    {"database":"tpcdsparquet"} ]}

Beispiel: synced_objects Parameter für die Synchronisierung von drei AWS Glue Data Catalog-Datenbanken.

Im Folgenden ist ein Beispiel für den Parameter synced_objects zum Synchronisieren von drei Tabellen aus einer AWS Glue Data Catalog-Datenbank dargestellt.

{"database_list":[
 {"database":"tpcdsparquet",
     "table_list": [ "tpcdsparquet_customer",
                     "tpcdsparquet_item",
                     "tpcdsparquet_web_sales" ] } ]}

CREATE_SYNC_JOB - Prozedur

Mit dieser Prozedur wird ein Scheduler-Job erstellt, um RUN_SYNC regelmäßig aufzurufen

Als Eingabe werden die Gruppe der zu synchronisierenden Objekte, die Fehlersemantik, die Logebene und ein Wiederholungsintervall verwendet. Weitere Informationen zur Funktionsweise der Synchronisierung finden Sie unter Prozedur RUN_SYNC.

Es kann nur ein einzelner Synchronisierungsjob vorhanden sein. Die Prozedur CREATE_SYNC_JOB ist nicht erfolgreich, wenn bereits ein anderer Job angegeben ist, es sei denn, der Force-Parameter ist auf TRUE gesetzt. Wenn Force auf TRUE gesetzt ist, wird der vorherige Job gelöscht.

Wenn ein Scheduler-Job versucht, während eine andere Synchronisierung ausgeführt wird, verläuft der Scheduler-Job nicht erfolgreich.

Hinweis: Am 4. April 2022 wurden die Parameter sync_option und grant_read der Prozedur DBMS_DCAT.RUN_SYNC hinzugefügt. Um die korrekte Performance von geplanten Synchronisierungsjobs sicherzustellen, die vor diesem Datum erstellt wurden, müssen Sie die geplanten Synchronisierungsjobs löschen und neu erstellen. Siehe Prozedur DROP_SYNC_JOB und Prozedur CREATE_SYNC_JOB.

Syntax

PROCEDURE DBMS_DCAT.CREATE_SYNC_JOB (
    synced_objects   IN CLOB,
    error_semantics  IN VARCHAR2 DEFAULT 'SKIP_ERRORS',
    log_level        IN VARCHAR2 DEFAULT 'INFO',
    repeat_interval  IN VARCHAR2,
    force            IN VARCHAR2 DEFAULT 'FALSE',
    grant_read       IN VARCHAR2 DEFAULT NULL,
    sync_option      IN VARCHAR2 DEFAULT 'SYNC',
    dcat_con_id      IN VARCHAR2 DEFAULT NULL
);

Parameter

Parameter Beschreibung
synced_objects Ein JSON-Objekt, das die zu synchronisierenden Objekte angibt, wie in der Prozedur RUN_SYNC beschrieben. Siehe Prozedur RUN_SYNC.
error_semantics (Optional) Fehlerverhalten, wie für RUN_SYNC angegeben. Der Standardwert ist SKIP_ERRORS.
log_level (Optional) Logging-Ebene, wie für RUN_SYNC angegeben. Der Standardwert ist INFO.
repeat_interval Wiederholungsintervall für den Job mit derselben Semantik wie der Wiederholungsintervallparameter der Prozedur DBMS_SCHEDULER.CREATE_JOB. Details zur repeat_interval finden Sie unter Überblick über das Erstellen von Jobs.
force (Optional) Wenn TRUE, werden vorhandene Synchronisierungsjobs zuerst gelöscht. Wenn FALSE vorhanden ist, verläuft die Prozedur CREATE_SYNC_JOB nicht erfolgreich, wenn bereits ein Synchronisierungsjob vorhanden ist. Der Standardwert ist FALSE.
grant_read (Optional) Liste der Benutzer/Rollen, denen READ in den synchronisierten externen Tabellen erteilt werden soll, wie unter RUN_SYNC beschrieben. Siehe Prozedur RUN_SYNC.
sync_option (Optional) Verhalten in Bezug auf Entitys, die bereits mit einem vorherigen RUN_SYNC-Vorgang synchronisiert wurden, wie in Prozedur RUN_SYNC beschrieben. Siehe Prozedur RUN_SYNC.
dcat_con_id Dieser Parameter ist die eindeutige Data Catalog-Verbindungs-ID, die beim Erstellen der Verbindung zu Data Catalog angegeben wurde. Siehe Prozedur SET_DATA_CATALOG_CONN. Dieser Parameter gibt an, welche Verbindung für die Synchronisierung verwendet wird, und wird Teil des abgeleiteten Schemanamens. Eine Beschreibung der Ableitung des Schemanamens finden Sie unter Synchronisierungszuordnung. Der Standardwert des Parameters ist NULL.

DROP_SYNC_JOB - Prozedur

Bei dieser Prozedur wird ein vorhandener Synchronisierungsjob für die angegebene eindeutige Verbindungs-ID gelöscht.

Syntax

PROCEDURE DBMS_DCAT.DROP_SYNC_JOB (
    dcat_con_id IN VARCHAR2 DEFAULT NULL
  );

Parameter

Parameter Beschreibung
dcat_con_id Die eindeutige Data Catalog-Verbindungs-ID. Der Standardwert ist NULL.

Prozedur DROP_SYNCED_SCHEMAS

Bei diesem Verfahren werden alle zuvor synchronisierten Schemas für die angegebene eindeutige Verbindungs-ID gelöscht.

Syntax

PROCEDURE DBMS_DCAT.DROP_SYNCED_SCHEMAS (
    dcat_con_id IN VARCHAR2 DEFAULT NULL
  );

Parameter

Parameter Beschreibung
dcat_con_id Die eindeutige Data Catalog-Verbindungs-ID. Der Standardwert ist NULL.