Gestisci cataloghi

• 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 databaselink
• Credenziali cloud necessarie per accedere ai dati

1. Endpoint Iceberg: impostare Polaris o Unity Catalog utilizzando l'API REST Iceberg. Ciò comporta la specifica del tipo di catalogo, dell'URI e della posizione del warehouse. Avrai bisogno dell'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 Iceberg per l'emissione del 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 Bearer.
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 Bearer.
5. Spazio di nomi: uno spazio di nomi equivale a uno schema in un database. Questa posizione servirà come repository per le tabelle Iceberg all'interno del catalogo. Iceberg cataloga le tabelle in spazi di nomi, che possono essere nidificati all'interno di altri spazi di 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 dell'iceberg di 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'illustrazione add-catalog-iceberg.png
   
   

   Fare clic su Avanti.

3. Specificare i valori di campo riportati di seguito nella scheda Origine catalogo della finestra di dialogo Aggiungi catalogo.

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

     Ad esempio, Polaris.

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

   • Endpoint del catalogo Iceberg: specifica l'URL dell'account del catalogo Polaris. 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 account, consultare la documentazione di 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 Ottieni nuovo token Bearer,

       • 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 nella versione 1.6.0 di Iceberg e verrà rimosso nella versione 2.0. Si consiglia di affidarsi invece a provider OAuth2 esterni. Per ulteriori informazioni, vedere OAuth Authentication.
       • Tipo di concessione: selezionare Credenziali client.
       • ID client: specificare l'ID client.
       • Segreto client: specificare il segreto client.
       • Ambito: PRINCIPAL_ROLE:ALL.

         Fare clic su Recupera token.

         Il campo Token Bearer viene popolato.

       Fare clic su Crea credenziale.

       POLARIS_CRED viene visualizzato come credenziale del catalogo Iceberg.

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

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

       Per l'esempio di cui sopra, la procedura sarebbe 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'illustrazione 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 Avanti per passare alla scheda Catalogo Iceberg.

4. Nella scheda Catalogo Iceberg è possibile specificare i valori di campo riportati di seguito.

   • Spazi di nomi del catalogo Iceberg: in questo campo viene visualizzata l'organizzazione gerarchica delle tabelle. L'endpoint del catalogo Iceberg è costituito dallo spazio di nomi root. Selezionare lo spazio di nomi su cui si desidera attivare il catalogo.
   • Stile separatore spazio di nomi: selezionare Stile Polaris. Si tratta del valore predefinito. Selezionare un valore qualsiasi in base alla configurazione del catalogo.
     Nota
     
     È preferibile conservare il valore predefinito.
   • Area periodo fisso: immettere l'area del periodo fisso. 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'illustrazione 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'illustrazione manage-polaris-catalogs.png
   
   

1. Nello strumento Catalogo fare clic su Seleziona cataloghi....
2. Fare clic sul filtro POLARIS _CATALOG in Cataloghi e schemi per visualizzare i cataloghi POLARIS_CATALOG.
3. Fare clic su Applica per visualizzare i risultati nella pagina Catalogo.
   
   
   
   Descrizione dell'illustrazione 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'illustrazione add-catalog-iceberg.png
   
   
3. Fare clic su Avanti.
4. Specificare i valori di campo riportati di seguito nella scheda Origine catalogo della finestra di dialogo Aggiungi catalogo.
   • Nome catalogo: immettere il nome del catalogo con cui si desidera montare il catalogo Iceberg.

     Ad esempio, Unità.

   • Tipo di catalogo Iceberg: selezionare Unità dal campo a discesa.
   • Endpoint 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: incollare il valore del token Bearer.

       Selezionare Crea credenziale.

       UNITY_CRED viene visualizzato come Credenziale catalogo Iceberg.

     
     
     
     Descrizione dell'illustrazione add-unity-catalog.png
     
     

     Fare clic su Successivo per passare alla scheda Catalogo Iceberg.

     Nella scheda Catalogo Iceberg è possibile specificare i valori di campo riportati di seguito.

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

     Fare clic su Aggiungi.

     
     
     
     Descrizione dell'illustrazione 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 CATALOG_UNITY nella procedura guidata Cataloghi e schemi per visualizzare i cataloghi UNITY_CATALOG.
   
   
   
   Descrizione dell'illustrazione catalogs-schemas-unity-catalog.png
   
   
3. Fare clic su Applica per visualizzare i risultati nella pagina Catalogo.
   
   
   
   Descrizione dell'illustrazione manage-catalogs-unity.png