• Memorizzare le credenziali di storage degli oggetti in Autonomous Database
• Creare un database link o utilizzare un database link esistente
• Esegui MOUNT del database link come catalogo

• Nome del database link
• Credenziali cloud necessarie per accedere ai dati

1. Endpoint Iceberg: impostare Polaris o Unity Catalog utilizzando l'API REST di Iceberg. Ciò implica la specifica del tipo di catalogo, dell'URI e della posizione del warehouse. Sarà necessario l'endpoint REST per il catalogo Iceberg esterno. Questo è l'URL che fornisce l'accesso ai metadati Iceberg.

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

2. Endpoint token: l'endpoint /v1/oauth/tokens viene fornito dai cataloghi REST di Iceberg per eseguire il token Bearer.
3. ID client e segreto client: si tratta delle credenziali fornite dal server OAuth per identificare l'applicazione (in questo caso, l'integrazione di Unity e Polaris Catalog). Queste credenziali verranno utilizzate per generare il token del servizio di trasporto.
4. Token Bearer: per autenticare le richieste all'endpoint REST Iceberg, verrà utilizzato OAuth con le credenziali client. Lo strumento Catalogo richiama l'endpoint del token per ricevere il token del portatore.
5. Spazio di nomi: uno spazio di nomi è equivalente a uno schema in un database. Questa posizione fungerà da repository per le tabelle Iceberg all'interno del catalogo. I cataloghi Iceberg raggruppano le tabelle in spazi dei nomi, che possono essere nidificati in altri spazi dei nomi. La specifica Iceberg supporta livelli arbitrari di nidificazione.

   Ad esempio, è possibile definire una tabella SALES all'interno di uno spazio di nomi STORES, definito in uno spazio di nomi RETAIL, definito a sua volta all'interno di uno spazio di nomi CORPORATE. La posizione di Iceberg di una tale tabella sarebbe 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. Nella pagina Catalogo selezionare Gestisci catalogo. Fare clic su +Add.
2. Nella finestra di dialogo Aggiungi catalogo, selezionare Catalogo Iceberg dalla scheda Origine catalogo.
   
   
   
   Descrizione dell'immagine add-catalog-iceberg.png
   
   

   Successivo.

3. Specificare i seguenti valori di campo nella scheda Origine catalogo della finestra di dialogo Aggiungi catalogo:

   • Nome catalogo: immettere il nome del catalogo con cui si desidera eseguire il MOUNT del catalogo Iceberg.

     Ad esempio, Polaris.

   • Tipo di catalogo Iceberg: selezionare Polaris dal campo a discesa.

   • Endpoint del catalogo Iceberg: specifica l'URL dell'account Polaris Catalog. L'endpoint per il catalogo Polaris di Snowflake è in genere nel formato https://<account_locator>.snowflakecomputing.com/polaris/api/catalog. Per ulteriori informazioni sui formati degli identificatori di conto, consultare la documentazione Snowflake.
   • Credenziale catalogo Iceberg: selezionare una credenziale dall'elenco delle credenziali disponibili nell'elenco a discesa. Se non si dispone di una credenziale, è possibile crearne una. Selezionare Crea credenziale. Nella finestra di dialogo Crea credenziale, specificare i seguenti valori di campo:
     • Nome credenziale: immettere il nome della credenziale. Ad esempio, POLARIS_CRED.
       In Recupera nuovo token servizio di trasporto,

       • Endpoint token di accesso: immettere l'endpoint della specifica REST Iceberg. Questo genera il token di accesso utilizzando OAuth2 definito come /v1/oauth/tokens.

         Questo endpoint è stato progettato per facilitare l'autenticazione mediante lo scambio di credenziali client (ID client e segreto) per un token di accesso.

         Nota
         
         L'endpoint /v1/oauth/tokens non è più valido in Iceberg versione 1.6.0 e verrà rimosso nella versione 2.0. Si consiglia di affidarsi invece a provider OAuth2 esterni. Per ulteriori informazioni, vedere OAuth Autenticazione.
       • Tipo di privilegio: selezionare Credenziali client.
       • ID client: specificare l'ID client.
       • Segreto client: specificare il segreto client.
       • Ambito: PRINCIPAL_ROLE:ALL.

         Fare clic su Ottieni token.

         Il campo Token del portatore viene popolato.

       Fare clic su Crea credenziale.

       POLARIS_CRED viene visualizzato come credenziale del catalogo Iceberg.

       
       
       
       Descrizione dell'immagine create-credential-polaris.png
       
       
       Nota
       
       

       Le credenziali vengono memorizzate utilizzando la procedura DBMS_CLOUD.CREATE_CREDENTIAL nel backend.

       Per l'esempio di esempio fornito in precedenza, la procedura è la seguente:

       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;

     
     
     
     Descrizione dell'immagine add-polaris-catalog-source.png
     
     

     Questa credenziale consente a Oracle Autonomous Database di accedere alla tabella Iceberg.

   • Credenziali bucket: questa credenziale memorizza un volume di storage cloud per memorizzare le tabelle Iceberg in formato Parquet. Questo campo è obbligatorio per i cataloghi Polaris.

     Fare clic su Successivo per passare alla scheda Catalogo Iceberg.

4. Nella scheda Catalogo Iceberg è possibile specificare i seguenti valori di campo:

   • Spazi dei nomi del catalogo Iceberg: in questo campo viene visualizzata l'organizzazione gerarchica delle tabelle. L'endpoint del catalogo Iceberg è costituito dallo spazio di nomi radice. Selezionare lo spazio di nomi su cui si desidera eseguire il MOUNT del catalogo.
   • Stile separatore spazio di nomi: selezionare Stile Polaris. Si tratta del valore predefinito. Selezionare qualsiasi valore in base alla configurazione del catalogo.
     Nota
     
     È preferibile conservare il valore predefinito.
   • Area bucket: immettere l'area del bucket. ad esempio us-west-2.

     Gli endpoint del catalogo Iceberg fungono da interfacce per la gestione delle tabelle Iceberg memorizzate nello storage cloud come S3. L'area del bucket si riferisce alla posizione geografica in cui è ospitato il bucket S3.

     Campo obbligatorio per i cataloghi Polaris.

     
     
     
     Descrizione dell'immagine namespace-polaris.png
     
     

   Fare clic su Aggiungi.

   Dopo aver eseguito correttamente il MOUNT di un nuovo catalogo su un catalogo Iceberg, è possibile visualizzare il catalogo Polaris nella pagina Gestisci cataloghi. È possibile disabilitare ed eliminare il catalogo da questa pagina.

   
   
   
   Descrizione dell'immagine manage-polaris-catalogs.png
   
   

1. Nello strumento Catalogo fare clic su Seleziona cataloghi....
2. Fare clic sul filtro _CATALOG_POLARIS in Cataloghi e schemi per visualizzare i cataloghi POLARIS_CATALOG.
3. Fare clic su Applica per visualizzare i risultati nella pagina Catalogo.
   
   
   
   Descrizione dell'immagine catalogs-schemas-polaris-catalog.png
   
   

1. Nella pagina Catalogo selezionare Gestisci catalogo. Fare clic su +Add.
2. Nella finestra di dialogo Aggiungi catalogo, selezionare Catalogo Iceberg.
   
   
   
   Descrizione dell'immagine add-catalog-iceberg.png
   
   
3. Successivo.
4. Specificare i seguenti valori di campo nella scheda Origine catalogo della finestra di dialogo Aggiungi catalogo:
   • Nome catalogo: immettere il nome del catalogo con cui si desidera eseguire il MOUNT del catalogo Iceberg.

     Ad esempio, Unità.

   • Tipo di catalogo Iceberg: selezionare Unità dal campo a discesa.
   • Endpoint del catalogo Iceberg:

     Per Unity Catalog, in genere si utilizza l'API REST Databricks. L'endpoint per l'accesso alle tabelle Iceberg tramite Unity Catalog è in genere nel formato https://<databricks-instance-url>/api/2.1/unity-catalog/iceberg.

     Nota
     
     Per ulteriori informazioni, vedere https://docs.databricks.com/aws/en/external-access/iceberg.
   • Credenziale catalogo Iceberg: selezionare una credenziale dall'elenco delle credenziali disponibili nell'elenco a discesa. Se non si dispone di una credenziale, è possibile crearne una. Selezionare Crea credenziale.
     Nella finestra di dialogo Crea credenziale specificare i valori riportati di seguito.

     • Nome credenziale: immettere il nome della credenziale. Ad esempio, UNITY_CRED.
     • Token Bearer: consente di incollare il valore del token Bearer.

       Selezionare Crea credenziale.

       UNITY_CRED viene visualizzato come credenziale del catalogo Iceberg.

     
     
     
     Descrizione dell'immagine add-unity-catalog.png
     
     

     Fare clic su Successivo per passare alla scheda Catalogo Iceberg.

     Nella scheda Catalogo Iceberg è possibile specificare i seguenti valori di campo:

   • Spazi dei nomi del catalogo Iceberg: selezionare uno qualsiasi degli schemi a cui è necessario accedere.
   • Stile separatore spazio di nomi: lo stile separatore spazio di nomi si riferisce in genere al modo in cui gli spazi di nomi sono strutturati e separati all'interno del catalogo. Per impostazione predefinita, è selezionato Stile databricks.
   • Area Periodo fisso: questo campo non è obbligatorio.
     
     
     
     Descrizione dell'immagine iceberg-unity-catalog.png
     
     

     Fare clic su Aggiungi.

     
     
     
     Descrizione dell'immagine manage-unity-catalogs.png
     
     

   Dopo aver eseguito correttamente il MOUNT di un nuovo catalogo su un catalogo Iceberg, è possibile visualizzare il catalogo Unity nella pagina Gestisci cataloghi. È possibile disabilitare ed eliminare il catalogo da questa pagina.

1. Nello strumento Catalogo fare clic su Seleziona cataloghi....
2. Fare clic sul filtro UNITY _CATALOG nella procedura guidata Cataloghi e schemi per visualizzare i cataloghi UNITY_CATALOG.
   
   
   
   Descrizione dell'immagine catalogs-schemas-unity-catalog.png
   
   
3. Fare clic su Applica per visualizzare i risultati nella pagina Catalogo.
   
   
   
   Descrizione dell'immagine manage-catalogs-unity.png