• Stockez vos informations d'identification de stockage d'objet dans votre instance Autonomous Database
• Créer un lien de base de données ou utiliser un lien de base de données existant
• Monter le lien de base de données en tant que catalogue

• Nom du lien de base de données
• Informations d'identification cloud requises pour accéder aux données

1. Adresse Iceberg : configurez Polaris ou Unity Catalog à l'aide de l'API REST Iceberg. Cela implique de spécifier le type de catalogue, l'URI et l'emplacement de l'entrepôt. Vous aurez besoin de l'adresse REST pour votre catalogue Iceberg externe. Il s'agit de l'URL qui permet d'accéder aux métadonnées de l'iceberg.

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

2. Adresse de jeton : l'adresse /v1/oauth/tokens est fournie par les catalogues REST Iceberg pour émettre un jeton de porteur.
3. ID client et clé secrète client : informations d'identification fournies par le serveur OAuth pour identifier votre application (dans ce cas, l'intégration Unity et Polaris Catalog). Vous utiliserez ces informations d'identification pour générer un jeton de porteur.
4. Jeton de porteur : pour authentifier les demandes auprès de l'adresse REST Iceberg, vous devez utiliser OAuth avec les informations d'identification client. L'outil Catalogue appelle l'adresse de jeton pour recevoir le jeton de porteur.
5. Espace de noms : un espace de noms est équivalent à un schéma dans une base de données. Cet emplacement servira de référentiel pour vos tables Iceberg dans le catalogue. Iceberg catalogue les tables de groupe dans des espaces de noms, qui peuvent être imbriqués dans d'autres espaces de noms. La spécification Iceberg prend en charge des niveaux arbitraires d'imbrication.

   Par exemple, une table SALES peut être définie dans un espace de noms STORES, qui est défini dans un espace de noms RETAIL, qui est lui-même défini dans un espace de noms CORPORATE. L'emplacement de l'iceberg d'une telle table serait 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. Sur la page Catalogue, sélectionnez Gérer le catalogue. Cliquez sur +Add.
2. Dans la boîte de dialogue Ajouter un catalogue, sélectionnez Catalogue Iceberg dans l'onglet Source de catalogue.
   
   
   
   Description de l'image add-catalog-iceberg.png
   
   

   Cliquez sur Suivant.

3. Indiquez les valeurs de champ suivantes dans l'onglet source Catalogue de la boîte de dialogue Ajouter un catalogue :

   • Nom du catalogue : entrez le nom du catalogue sous lequel monter le catalogue Iceberg.

     Par exemple, Polaris.

   • Type de catalogue Iceberg : sélectionnez Polaris dans le champ déroulant.

   • Adresse de catalogue Iceberg : indique l'URL de votre compte de catalogue Polaris. L'adresse du catalogue Polaris de Snowflake est généralement au format https ://<account_locator>.snowflakecomputing.com/polaris/api/catalog. Pour plus d'informations sur les formats d'identificateur de compte, reportez-vous à la documentation Snowflake.
   • Informations d'identification de catalogue Iceberg : sélectionnez des informations d'identification dans la liste déroulante. Si vous n'avez pas d'informations d'identification, vous pouvez en créer une. Sélectionnez Créer des informations d'identification. Dans la boîte de dialogue Créer des informations d'identification, indiquez les valeurs de champ suivantes :
     • Nom des informations d'identification : Entrez le nom des informations d'identification. Par exemple, POLARIS_CRED.
       Sous Obtenir un nouveau jeton Bearer,

       • Adresse de jeton d'accès : entrez l'adresse de spécification REST Iceberg. Cela génère un jeton d'accès à l'aide de OAuth2 défini en tant que /v1/oauth/tokens.

         Cette adresse a été conçue pour faciliter l'authentification en échangeant des informations d'identification client (ID client et clé secrète) pour un jeton d'accès.

         Remarque
         
         L'adresse /v1/oauth/tokens est en phase d'abandon dans la version 1.6.0 d'Iceberg et sera enlevée dans la version 2.0. Nous vous encourageons plutôt à vous fier à des fournisseurs OAuth2 externes. Pour plus d'informations, reportez-vous à OAuth Authentication.
       • Type d'octroi : sélectionnez Informations d'identification client.
       • ID client : indiquez l'ID client.
       • Clé secrète client : indiquez la clé secrète client.
       • Portée : PRINCIPAL_ROLE:ALL.

         Cliquez sur Obtenir le jeton.

         Le champ Jeton de porteur est renseigné.

       Cliquez sur Créer des informations d'identification.

       POLARIS_CRED est affiché en tant qu'informations d'identification de catalogue Iceberg.

       
       
       
       Description de l'image create-credential-polaris.png
       
       
       Remarque
       
       

       Les informations d'identification sont stockées à l'aide de la procédure DBMS_CLOUD.CREATE_CREDENTIAL dans le back-end.

       Pour l'exemple donné ci-dessus, la procédure serait la suivante :

       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;

     
     
     
     Description de l'image add-polaris-catalog-source.png
     
     

     Ces informations d'identification permettent à Oracle Autonomous Database d'accéder à la table Iceberg.

   • Informations d'identification de bucket : ces informations d'identification stockent un volume de stockage cloud pour stocker les tables Iceberg au format Parquet. Ce champ est obligatoire pour les catalogues Polaris.

     Cliquez sur Suivant pour passer à l'onglet Catalogue Iceberg.

4. Dans l'onglet Catalogue Iceberg, vous pouvez indiquer les valeurs de champ suivantes :

   • Espaces de noms de catalogue Iceberg : ce champ affiche l'organisation hiérarchique des tables. L'adresse de catalogue Iceberg est constituée de l'espace de noms racine. Sélectionnez l'espace de noms sur lequel le catalogue doit être monté.
   • Style de séparateur d'espace de noms : sélectionnez Style Polaris. Il s'agit de la valeur par défaut. Sélectionnez n'importe quelle valeur en fonction de la configuration de votre catalogue.
     Remarque
     
     Nous vous recommandons de conserver la valeur par défaut.
   • Région de bucket : entrez la région de bucket. Par exemple : us-west-2.

     Les adresses de catalogue Iceberg servent d'interfaces pour la gestion des tables Iceberg stockées dans le stockage cloud, comme S3. La région de bucket fait référence à l'emplacement géographique où le bucket S3 est hébergé.

     Ce champ est obligatoire pour les catalogues Polaris.

     
     
     
     Description de l'image namespace-polaris.png
     
     

   Cliquez sur Ajouter.

   Une fois que vous avez monté un nouveau catalogue sur un catalogue Iceberg, vous pouvez visualiser le catalogue Polaris sur la page Gérer les catalogues. Vous pouvez désactiver et supprimer le catalogue de cette page.

   
   
   
   Description de l'image manage-polaris-catalogs.png
   
   

1. Dans l'outil Catalogue, cliquez sur Sélectionner des catalogues....
2. Cliquez sur le filtre POLARIS _CATALOG dans l'assistant Catalogues et schémas pour afficher les catalogues POLARIS_CATALOG.
3. Cliquez sur Appliquer pour afficher les résultats sur la page Catalogue.
   
   
   
   Description de l'image catalogs-schemas-polaris-catalog.png
   
   

1. Sur la page Catalogue, sélectionnez Gérer le catalogue. Cliquez sur +Add.
2. Dans la boîte de dialogue Ajouter un catalogue, sélectionnez Catalogue Iceberg.
   
   
   
   Description de l'image add-catalog-iceberg.png
   
   
3. Cliquez sur Suivant.
4. Indiquez les valeurs de champ suivantes dans l'onglet source Catalogue de la boîte de dialogue Ajouter un catalogue :
   • Nom du catalogue : entrez le nom du catalogue sous lequel monter le catalogue Iceberg.

     Par exemple, Unité.

   • Type de catalogue Iceberg : sélectionnez Unité dans le champ déroulant.
   • Adresse de catalogue Iceberg :

     Pour Unity Catalog, vous utilisez généralement l'API REST Databricks. L'adresse permettant d'accéder aux tables Iceberg via Unity Catalog est généralement au format https ://<databricks-instance-url>/api/2.1/unity-catalog/iceberg.

     Remarque
     
     Pour plus d'informations, reportez-vous à https://docs.databricks.com/aws/en/external-access/iceberg.
   • Informations d'identification de catalogue Iceberg : sélectionnez des informations d'identification dans la liste déroulante. Si vous n'avez pas d'informations d'identification, vous pouvez en créer une. Sélectionnez Créer des informations d'identification.
     Dans la boîte de dialogue Créer des informations d'identification, indiquez les valeurs suivantes :

     • Nom des informations d'identification : entrez le nom des informations d'identification. Par exemple, UNITY_CRED.
     • Jeton de porteur : collez la valeur du jeton de porteur.

       Sélectionnez Créer des informations d'identification.

       UNITY_CRED est affiché en tant qu'informations d'identification de catalogue Iceberg.

     
     
     
     Description de l'image add-unity-catalog.png
     
     

     Cliquez sur Suivant pour passer à l'onglet Catalogue Iceberg.

     Dans l'onglet Catalogue Iceberg, vous pouvez indiquer les valeurs de champ suivantes :

   • Espaces de noms de catalogue Iceberg : sélectionnez l'un des schémas auxquels vous avez besoin d'accéder.
   • Style de séparateur d'espace de noms : le style de séparateur d'espace de noms fait généralement référence à la façon dont les espaces de noms sont structurés et séparés dans le catalogue. Par défaut, l'option Style Databricks est sélectionnée.
   • Région de bucket : ce champ n'est pas obligatoire.
     
     
     
     Description de l'image iceberg-unity-catalog.png
     
     

     Cliquez sur Ajouter.

     
     
     
     Description de l'image manage-unity-catalogs.png
     
     

   Une fois que vous avez monté un nouveau catalogue sur un catalogue Iceberg, vous pouvez visualiser le catalogue Unity sur la page Gérer les catalogues. Vous pouvez désactiver et supprimer le catalogue de cette page.

1. Dans l'outil Catalogue, cliquez sur Sélectionner des catalogues....
2. Cliquez sur le filtre UNITY _CATALOG dans l'assistant Catalogues et schémas pour afficher les catalogues UNITY_CATALOG.
   
   
   
   Description de l'image catalogs-schemas-unity-catalog.png
   
   
3. Cliquez sur Appliquer pour afficher les résultats sur la page Catalogue.
   
   
   
   Description de l'image manage-catalogs-unity.png