• Speichern Sie Ihre Objektspeicherzugangsdaten in Autonomous Database
• Datenbanklink erstellen oder vorhandenen Datenbanklink verwenden
• Datenbanklink als Katalog mounten

• Name des Datenbanklinks
• Cloud-Zugangsdaten für den Zugriff auf die Daten

1. Iceberg-Endpunkt: Richten Sie Polaris oder Unity Catalog mit der Iceberg-REST-API ein. Dazu müssen Katalogtyp, URI und Warehouse-Speicherort angegeben werden. Sie benötigen den REST-Endpunkt für Ihren externen Iceberg-Katalog. Diese URL ermöglicht den Zugriff auf die Iceberg-Metadaten.

   Beispiel: https://your-iceberg-catalog.com/api/v1/iceberg

2. Tokenendpunkt: Der Endpunkt /v1/oauth/tokens wird von Iceberg-REST-Katalogen bereitgestellt, um das Bearer Token auszugeben.
3. Client-ID und Client Secret: Dies sind Zugangsdaten, die vom OAuth-Server zur Identifizierung Ihrer Anwendung bereitgestellt werden (in diesem Fall die Integration von Unity und Polaris Catalog). Sie verwenden diese Zugangsdaten, um Bearer-Token zu generieren.
4. Bearer-Token: Um Anforderungen am Iceberg-REST-Endpunkt zu authentifizieren, verwenden Sie OAuth mit den Clientzugangsdaten. Das Katalogtool ruft den Tokenendpunkt auf, um Bearer Token zu empfangen.
5. Namespace: Ein Namespace entspricht einem Schema in einer Datenbank. Dieser Speicherort dient als Repository für Ihre Iceberg-Tabellen im Katalog. Iceberg katalogisiert Tabellen in Namespaces, die in anderen Namespaces verschachtelt werden können. Die Iceberg-Spezifikation unterstützt beliebige Niststufen.

   Beispiel: Eine SALES-Tabelle kann in einem STORES-Namespace definiert werden, der in einem RETAIL-Namespace definiert ist, der selbst in einem CORPORATE-Namespace definiert ist. Der Iceberg-Standort einer solchen Tabelle wäre CORPORATE.RETAIL.STORES.SALES.

CREATE OR REPLACE CATALOG INTEGRATION tabular_catalog_int
  CATALOG_SOURCE = ICEBERG_REST
  TABLE_FORMAT = ICEBERG
  CATALOG_NAMESPACE = 'default'
  REST_CONFIG = (
    CATALOG_URI = 'https://api.tabular.io/ws'
    CATALOG_NAME = '<tabular_warehouse_name>'
  )
  REST_AUTHENTICATION = (
    TYPE = OAUTH
    OAUTH_TOKEN_URI = 'https://api.tabular.io/ws/v1/oauth/tokens'
    OAUTH_CLIENT_ID = '<oauth_client_id>'
    OAUTH_CLIENT_SECRET = '<oauth_secret>'
    OAUTH_ALLOWED_SCOPES = ('catalog')
  )
  ENABLED = TRUE;

1. Wählen Sie auf der Seite "Katalog" die Option Katalog verwalten aus. Klicken Sie auf +Add.
2. Wählen Sie im Dialogfeld Katalog hinzufügen auf der Registerkarte Katalogquelle die Option Iceberg-Katalog aus.
   
   
   
   Beschreibung der Abbildung add-catalog-iceberg.png
   
   

   Klicken Sie auf Weiter.

3. Geben Sie im Dialogfeld "Katalog hinzufügen" auf der Registerkarte "Katalogquelle" die folgenden Feldwerte an:

   • Katalogname: Geben Sie den Namen des Katalogs ein, unter dem Sie den Iceberg-Katalog mounten möchten.

     Beispiel: Polaris.

   • Iceberg-Katalogtyp: Wählen Sie im Dropdown-Feld Polaris aus.

   • Iceberg-Katalogendpunkt: Gibt die URL Ihres Polaris Catalog-Accounts an. Der Endpunkt für den Polaris-Katalog von Snowflake hat normalerweise das Format https://<account_locator>.snowflakecomputing.com/polaris/api/catalog. Weitere Informationen zu Kontokennungsformaten finden Sie in der Snowflake-Dokumentation.
   • Iceberg-Katalogzugangsdaten: Wählen Sie Zugangsdaten aus der Liste der verfügbaren Zugangsdaten in der Dropdown-Liste aus. Wenn Sie über keine Zugangsdaten verfügen, können Sie einen erstellen. Wählen Sie Zugangsdaten erstellen aus. Geben Sie im Dialogfeld "Zugangsdaten erstellen" die folgenden Feldwerte an:
     • Zugangsdatenname: Geben Sie den Namen der Zugangsdaten ein. Beispiel: POLARIS_CRED.
       Unter Neuen Bearer-Token abrufen,

       • Endpunkt für Zugriffstoken: Geben Sie den Iceberg-REST-Spezifikationsendpunkt ein. Dadurch wird das Zugriffstoken mit OAuth2 generiert, das als /v1/oauth/tokens definiert ist.

         Dieser Endpunkt wurde entwickelt, um die Authentifizierung zu erleichtern, indem Clientzugangsdaten (Client-ID und Secret) gegen ein Zugriffstoken ausgetauscht werden.

         Hinweis
         
         Der Endpunkt /v1/oauth/tokens ist in Iceberg Version 1.6.0 veraltet und wird in Version 2.0 entfernt. Stattdessen sollten Sie sich auf externe OAuth2-Provider verlassen. Weitere Informationen finden Sie unter OAuth-Authentifizierung.
       • Berechtigungstyp: Wählen Sie Clientzugangsdaten aus.
       • Client-ID: Geben Sie die Client-ID an.
       • Client Secret: Geben Sie das Client Secret an.
       • Geltungsbereich: PRINCIPAL_ROLE:ALL.

         Klicken Sie auf Token abrufen.

         Das Feld Bearer-Token wird aufgefüllt.

       Klicken Sie auf Zugangsdaten erstellen.

       POLARIS_CRED wird als Iceberg-Katalogzugangsdaten angezeigt.

       
       
       
       Beschreibung der Abbildung create-credential-polaris.png
       
       
       Hinweis
       
       

       Die Zugangsdaten werden mit der Prozedur DBMS_CLOUD.CREATE_CREDENTIAL im Backend gespeichert.

       Für das oben angegebene Beispiel wäre das Verfahren wie folgt:

       BEGIN
         dbms_cloud.create_credential( 
           credential_name  =>  'POLARIS_CRED',
           username         =>  'BEARER_TOKEN',
           password         =>  '<BEARER_TOKEN_VALUE This is generated using token endpoint, client id, client secret>'
         );
       END;

     
     
     
     Beschreibung der Abbildung add-polaris-catalog-source.png
     
     

     Mit diesen Zugangsdaten kann Oracle Autonomous Database auf die Iceberg-Tabelle zugreifen.

   • Bucket-Zugangsdaten: Diese Zugangsdaten speichern ein Cloud-Speicher-Volume zur Speicherung Ihrer Iceberg-Tabellen im Parquet-Format. Dieses Feld ist für Polaris-Kataloge erforderlich.

     Klicken Sie auf Weiter, um zur Registerkarte Iceberg-Katalog zu gelangen.

4. Auf der Registerkarte Iceberg-Katalog können Sie die folgenden Feldwerte angeben:

   • Iceberg-Katalog-Namespaces: In diesem Feld wird die hierarchische Organisation von Tabellen angezeigt. Der Iceberg-Katalogendpunkt besteht aus dem Root-Namespace. Wählen Sie den Namespace aus, in dem der Katalog gemountet werden soll.
   • Namespace-Trennzeichenformat: Wählen Sie Polaris-Format aus. Dies ist das Standardverhalten. Wählen Sie einen beliebigen Wert basierend auf der Konfiguration Ihres Katalogs aus.
     Hinweis
     
     Sie sollten den Standardwert beibehalten.
   • Bereich "Bucket": Geben Sie den Bereich "Bucket" ein. Zum Beispiel, us-west-2.

     Iceberg-Katalogendpunkte dienen als Schnittstellen für die Verwaltung von Iceberg-Tabellen, die im Cloud-Speicher wie S3 gespeichert sind. Die Bucket-Region bezieht sich auf den geografischen Standort, an dem der Bucket S3 gehostet wird.

     Dies ist ein Pflichtfeld für Polaris-Kataloge.

     
     
     
     Beschreibung der Abbildung namespace-polaris.png
     
     

   Klicken Sie auf Hinzufügen.

   Nachdem Sie einen neuen Katalog erfolgreich über einen Iceberg-Katalog gemountet haben, können Sie den Polaris-Katalog auf der Seite Kataloge verwalten anzeigen. Sie können den Katalog auf dieser Seite deaktivieren und löschen.

   
   
   
   Beschreibung der Abbildung manage-polaris-catalogs.png
   
   

1. Klicken Sie im Katalogtool auf Kataloge auswählen....
2. Klicken Sie auf den Filter POLARIS _CATALOG im Assistenten Kataloge und Schemas, um die Kataloge POLARIS_CATALOG anzuzeigen.
3. Klicken Sie auf Anwenden, um die Ergebnisse auf der Seite "Katalog" anzuzeigen.
   
   
   
   Beschreibung der Abbildung catalogs-schemas-polaris-catalog.png
   
   

1. Wählen Sie auf der Seite "Katalog" die Option Katalog verwalten aus. Klicken Sie auf +Add.
2. Wählen Sie im Dialogfeld "Katalog hinzufügen" die Option Iceberg-Katalog aus.
   
   
   
   Beschreibung der Abbildung add-catalog-iceberg.png
   
   
3. Klicken Sie auf Weiter.
4. Geben Sie im Dialogfeld "Katalog hinzufügen" auf der Registerkarte "Katalogquelle" die folgenden Feldwerte an:
   • Katalogname: Geben Sie den Namen des Katalogs ein, unter dem Sie den Iceberg-Katalog mounten möchten.

     Beispiel: Unity.

   • Iceberg-Katalogtyp: Wählen Sie im Dropdown-Feld die Option Einheit aus.
   • Iceberg-Katalogendpunkt:

     Für Unity Catalog verwenden Sie in der Regel die Databricks-REST-API. Der Endpunkt für den Zugriff auf Iceberg-Tabellen über Unity Catalog hat in der Regel das Format https://<databricks-instance-url>/api/2.1/unity-catalog/iceberg.

     Hinweis
     
     Weitere Informationen finden Sie unter https://docs.databricks.com/aws/en/external-access/iceberg.
   • Iceberg-Katalogzugangsdaten: Wählen Sie Zugangsdaten aus der Liste der verfügbaren Zugangsdaten in der Dropdown-Liste aus. Wenn Sie über keine Zugangsdaten verfügen, können Sie einen erstellen. Wählen Sie Zugangsdaten erstellen aus.
     Geben Sie im Dialogfeld "Zugangsdaten erstellen" die folgenden Werte an:

     • Zugangsdatenname: Geben Sie den Namen der Zugangsdaten ein. Beispiel: UNITY_CRED.
     • Bearer-Token: Fügen Sie den Bearer-Tokenwert ein.

       Wählen Sie Zugangsdaten erstellen aus.

       UNITY_CRED wird als Iceberg-Katalogzugangsdaten angezeigt.

     
     
     
     Beschreibung der Abbildung add-unity-catalog.png
     
     

     Klicken Sie auf Weiter, um zur Registerkarte Iceberg-Katalog zu gelangen.

     Auf der Registerkarte Iceberg-Katalog können Sie die folgenden Feldwerte angeben:

   • Iceberg-Katalog-Namespaces: Wählen Sie eines der Schemas aus, auf das Sie Zugriff benötigen.
   • Namespace-Trennzeichenstil: Der Namespace-Trennzeichenstil bezieht sich in der Regel auf die Strukturierung und Trennung von Namespaces im Katalog. Standardmäßig ist Databricks-Stil ausgewählt.
   • Teilsektor "Zeitraum": Dieses Feld ist nicht erforderlich.
     
     
     
     Beschreibung der Abbildung iceberg-unity-catalog.png
     
     

     Klicken Sie auf Hinzufügen.

     
     
     
     Beschreibung der Abbildung manage-unity-catalogs.png
     
     

   Nachdem Sie einen neuen Katalog erfolgreich über einen Iceberg-Katalog gemountet haben, können Sie den Unity-Katalog auf der Seite Kataloge verwalten anzeigen. Sie können den Katalog auf dieser Seite deaktivieren und löschen.

1. Klicken Sie im Katalogtool auf Kataloge auswählen....
2. Klicken Sie im Assistenten Kataloge und Schemas auf den Filter UNITY _CATALOG, um die Kataloge UNITY_CATALOG anzuzeigen.
   
   
   
   Beschreibung der Abbildung catalogs-schemas-unity-catalog.png
   
   
3. Klicken Sie auf Anwenden, um die Ergebnisse auf der Seite "Katalog" anzuzeigen.
   
   
   
   Beschreibung der Abbildung manage-catalogs-unity.png