DBMS_CATALOG-Package

Das DBMS_CATALOG-Package enthält eine Vielzahl von Unterprogrammen für die Katalogverwaltung, gruppiert nach Funktionalität.

• Katalog-Mounting und -Unmounting:

  Sie können Ihrer autonomen KI-Datenbank einen neuen Katalog hinzufügen, indem Sie entweder eine vorhandene Verbindung (z.B. einen vorhandenen Datenbanklink) mounten oder eine neue Verbindung hinzufügen und das externe System als neuen Katalog registrieren.

  Sie können einen Katalog aktivieren oder deaktivieren.

  Hinweis
  
  Deaktivierte Kataloge behalten Verbindungsdetails und aktuelle Metadaten bei, werden jedoch nicht aktualisiert und sind weder über UIs noch über APIs zugänglich.

  Entfernen oder trennen Sie einen Katalog von Ihrer autonomen KI-Datenbank.

• Catalog Property Management:
  Mit den hier genannten Unterprogrammen können Sie verschiedene Eigenschaften von Katalogen, Schemas und Tabellen in Ihrem System abrufen und aktualisieren. Sie bietet Funktionen für:

  • Ruft den Wert einer Eigenschaft für einen Katalog, ein Schema oder eine Tabelle ab, einschließlich Optionen zur Verarbeitung großer Textwerte über das CLOB-Format.

  • Aktualisieren Sie den Wert der Eigenschaften für Kataloge, Schemas oder Tabellen mit Unterstützung für reguläre und CLOB-Datentypen.

• Zugangsdatenverwaltung:
  Ein gemounteter Katalog hat null oder mehr erforderliche Zugangsdaten. Dies sind Zugangsdaten, die angegeben werden müssen, bevor der Katalog verwendet werden kann. Iceberg-Kataloge haben beispielsweise in der Regel zwei erforderliche Zugangsdaten.

  • ICEBERG_CREDENTIAL: Zugangsdaten zum Aufrufen der Iceberg-REST-Katalogendpunkte. Dies ist in der Regel ein Bearer-Token-Zugangsdaten.
  • DATA_STORAGE_CREDENTIAL: Zugangsdaten für den Zugriff auf die Iceberg-Dateien im Bucket.
  Sie können sich erforderliche Zugangsdaten als Parameter vorstellen, der angegeben werden muss. Ein lokale Zugangsdaten ist ein tatsächliches CREDENTIAL-Objekt im Schema des Benutzers, das die Rolle eines der erforderlichen Zugangsdaten spielt. Sie können die lokalen Zugangsdaten angeben, wenn Sie den Katalog mounten, indem Sie Argumente wie catalog_credential und data_storage_credential in DBMS_CATALOG.MOUNT_ICEBERG verwenden. Sie können sie auch später angeben, indem Sie SET_LOCAL_CREDENTIAL aufrufen.

  BEGIN
    -- Create a new credential
    DBMS_CLOUD.CREATE_CREDENTIAL('BUCKET_CREDENTIAL', ...);
  
    -- Make the new credential play the role of the required 'DATA_STORAGE_CREDENTIAL'
    DBMS_CATALOG.SET_LOCAL_CREDENTIAL(
      catalog_name => 'iceberg_cat',
      required_credential => 'DATA_STORAGE_CREDENTIAL',
      local_credential => 'BUCKET_CREDENTIAL');
  END;    

  Die aktuelle Zuordnung zwischen den Zugangsdaten erforderlich und lokal wird mit der Funktion GET_LOCAL_CREDENTIAL_MAP angezeigt.

  SELECT
     JSON_QUERY(dbms_catalog.get_local_credential_map('iceberg_cat'), '$' PRETTY)
  FROM dual;
    2    3  
  JSON_QUERY(DBMS_CATALOG.GET_LOCAL_CREDENTIAL_MAP('ICEBERG_CAT'),'$'PRETTY)
  ------------------------------------------------------------------------------------------------------------------------
  {
    "DATA_STORAGE_CREDENTIAL" : "BUCKET_CREDENTIAL",
    "ICEBERG_CREDENTIAL" : "UNITY_CRED"
  }

• Katalogentityverwaltung:
  Die hier aufgeführten Unterprogramme beziehen sich auf die Verwaltung verschiedener Entitys innerhalb eines Katalogs, einschließlich Erstellen, Abrufen und Löschen von Speicher-Links, Schemas, Tabellen und anderen Katalogobjekten. Es bietet Funktionen für:

  • Mit Katalogen verknüpfte Cloud-Speicherlinks erstellen und löschen

  • Externe Tabellen in Katalogen erstellen und löschen

  • Erstellen und löschen Sie Schemas und deren Inhalte.

  • Rufen Sie Listen mit Tabellen, Schemas und anderen Katalogobjekten mit optionaler Filterung ab.

• Datenzugriff und Caching:
  Dieser Abschnitt umfasst Funktionen zum Abfragen von Daten, zum Verwalten von Ergebnis-Cursorn und zum Steuern des Metadaten-Caches in Katalogen. Es umfasst Funktionen für:

  • SELECT-Anweisungen für logische Tabellen mit anpassbaren Optionen generieren

  • Öffnen Sie Cursor, um Daten aus logischen Tabellen abzurufen.

  • Leeren Sie den Metadatencache für Kataloge, und füllen Sie ihn vor, um die Daten auf dem neuesten Stand zu halten.

• Synchronisierung und Freigabe:
  In diesem Abschnitt werden Unterprogramme mit Funktionen beschrieben, die das Verwalten und Verwalten konsistenter, aktueller Kataloge und Schemas über verschiedene Systeme oder Umgebungen hinweg ermöglichen. Es stellt die folgenden Funktionen bereit:

  • CREATE_SYNCHRONIZED_SCHEMAS: Erstellt lokale Schemas in der Datenbank, die mit Remotekatalogdefinitionen synchronisiert werden, um sicherzustellen, dass die lokale Umgebung die Remotequelle widerspiegelt.
  • DROP_SYNCHRONIZED_SCHEMAS: Entfernt mindestens ein Schema, das zuvor synchronisiert wurde.
  • UPDATE_SYNCHRONIZED_SCHEMA_PROPERTY: Ändert Eigenschaften von synchronisierten Schemas, wie Änderungsverfolgung oder Synchronisierungsverhalten, indem Eigenschaften mit neuen Werten im CLOB-Format aktualisiert werden.
  • GRANT_TO_RECIPIENT & REVOKE_FROM_RECIPIENT: Verwalten Sie Zugriffsberechtigungen, indem Sie bestimmten Freigabeempfängern Zugriff auf Kataloge erteilen oder entziehen und steuern, wer die Katalogdaten anzeigen oder ändern kann.

  ​