Gérer les catalogues

• Stocker vos données d'identification pour le stockage d'objets dans votre base de données Autonomous AI 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
• Données d'identification en nuage requises pour accéder aux données

1. Point d'extrémité Iceberg : Configurez Polaris ou Unity Catalog à l'aide de l'API REST Iceberg. Il s'agit de spécifier le type de catalogue, l'URI et l'emplacement de l'entrepôt avec lac de données. Vous aurez besoin du point d'extrémité REST pour votre catalogue Iceberg externe. Il s'agit de l'URL qui donne accès aux métadonnées Iceberg.

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

2. Point d'extrémité de jeton : Le point d'extrémité /v1/oauth/tokens est fourni par les catalogues REST Iceberg pour émettre un jeton de porteur.
3. ID client et clé secrète client : Il s'agit des données d'identification fournies par le serveur OAuth pour identifier votre application (dans ce cas, l'intégration du catalogue Unity et Polaris). Vous utiliserez ces données d'identification pour générer un jeton de porteur.
4. Jeton de porteur : Pour authentifier les demandes vers le point d'extrémité REST Iceberg, vous utiliserez OAuth avec les données d'identification de client. L'outil Catalogue appelle le point d'extrémité du jeton pour recevoir le jeton du 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. Les catalogues Iceberg regroupent les tables en espaces de noms, qui peuvent être imbriqués dans d'autres espaces de noms. La spécification Iceberg prend en charge des niveaux arbitraires de nidification.

   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_lakehouse_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. Dans 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'illustration add-catalog-iceberg.png
   
   

   Cliquez sur Suivant.

3. Spécifiez les valeurs de champ suivantes dans l'onglet Source du catalogue de la boîte de dialogue Ajouter un catalogue :

   • Nom du catalogue : Entrez le nom du catalogue dans lequel vous voulez monter le catalogue Iceberg.

     Par exemple, Polaris.

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

   • Point d'extrémité du catalogue Iceberg : Il spécifie l'URL de votre compte du catalogue Polaris. Le point d'extrémité 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, consultez la documentation de Snowflake.
   • Données d'identification du catalogue Iceberg : Sélectionnez des données d'identification dans la liste déroulante des données d'identification disponibles. Si vous n'avez pas de données d'identification, vous pouvez en créer une. Sélectionnez Créer des données d'identification. Dans la boîte de dialogue Create Credential, spécifiez les valeurs de champ suivantes :
     • Nom des données d'identification : Entrez le nom de vos données d'identification. Par exemple, POLARIS_CRED.
       Sous Obtenir un nouveau jeton de porteur,

       • Point d'extrémité de jeton d'accès : Entrez le point d'extrémité de spécification REST Iceberg. Cela génère un jeton d'accès à l'aide de OAuth2 défini comme /v1/oauth/tokens.

         Ce point d'extrémité a été conçu pour faciliter l'authentification en échangeant les données d'identification du client (ID client et clé secrète client) pour un jeton d'accès.

         Note
         
         Le point d'extrémité /v1/oauth/tokens est obsolète dans Iceberg version 1.6.0 et sera supprimé dans la version 2.0. Nous vous encourageons à vous fier plutôt à des fournisseurs OAuth2 externes. Pour plus de détails, voir Authentification OAuth.
       • Type d'octroi : Sélectionnez Données d'identification du client.
       • ID client : Spécifiez l'ID client.
       • Clé secrète client : Spécifiez la clé secrète client.
       • Portée : PRINCIPAL_ROLE:ALL.

         Cliquez sur Obtenir le jeton.

         Le champ Jeton du porteur est alimenté.

       Cliquez sur Créer des données d'identification.

       POLARIS_CRED est affiché en tant que données d'identification du catalogue Iceberg.

       
       
       
       Description de l'illustration create-credential-polaris.png
       
       
       Note
       
       

       Les données d'identification sont stockées à l'aide de la procédure DBMS_CLOUD.CREATE_CREDENTIAL dans le serveur dorsal.

       Pour l'exemple fourni 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'illustration add-polaris-catalog-source.png
     
     

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

   • Données d'identification de seau : Ces données d'identification stockent un volume de stockage en nuage pour stocker vos 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 spécifier les valeurs de champ suivantes :

   • Espaces de noms de catalogue Iceberg : Ce champ affiche l'organisation hiérarchique des tables. Le point d'extrémité du catalogue Iceberg se compose 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 une valeur en fonction de la configuration de votre catalogue.
     Note
     
     Il est préférable de conserver la valeur par défaut.
   • Région du seau : Entrez la région du seau. Par exemple, us-west-2.

     Les points d'extrémité du catalogue Iceberg servent d'interfaces pour la gestion des tables Iceberg stockées dans le stockage en nuage comme S3. La région du seau fait référence à l'emplacement géographique où le seau S3 est hébergé.

     Ce champ est obligatoire pour les catalogues Polaris.

     
     
     
     Description de l'illustration namespace-polaris.png
     
     

   Cliquez sur Ajouter.

   Après avoir monté avec succès un nouveau catalogue sur un catalogue Iceberg, vous pouvez voir le catalogue Polaris dans la page Gérer les catalogues. Vous pouvez désactiver et supprimer le catalogue à partir de cette page.

   
   
   
   Description de l'illustration 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 Catalogs and Schemas pour afficher les catalogues POLARIS_CATALOG.
3. Cliquez sur Appliquer pour voir les résultats dans la page Catalogue.
   
   
   
   Description de l'illustration catalogs-schemas-polaris-catalog.png
   
   

1. Dans la page Catalogue, sélectionnez Gérer le catalogue. Cliquez sur +Add.
2. Dans la boîte de dialogue Ajouter un catalogue, sélectionnez Iceberg Catalog.
   
   
   
   Description de l'illustration add-catalog-iceberg.png
   
   
3. Cliquez sur Suivant.
4. Spécifiez les valeurs de champ suivantes dans l'onglet Source du catalogue de la boîte de dialogue Ajouter un catalogue :
   • Nom du catalogue : Entrez le nom du catalogue dans lequel vous voulez monter le catalogue Iceberg.

     Par exemple, Unité.

   • Type de catalogue Iceberg : Sélectionnez Unité dans le champ déroulant.
   • Point d'extrémité du catalogue Iceberg :

     Pour Unity Catalog, vous utilisez généralement l'API REST Databricks. Le point d'extrémité pour accéder aux tables Iceberg au moyen du catalogue Unity est généralement au format https ://<databricks-instance-url>/api/2.1/unity-catalog/iceberg.

     Note
     
     Pour plus d'informations, voir https://docs.databricks.com/aws/en/external-access/iceberg.
   • Données d'identification du catalogue Iceberg : Sélectionnez des données d'identification dans la liste déroulante des données d'identification disponibles. Si vous n'avez pas de données d'identification, vous pouvez en créer une. Sélectionnez Créer des données d'identification.
     Dans la boîte de dialogue Create Credential, indiquez les valeurs suivantes :

     • Nom des données d'identification : Entrez le nom de vos données d'identification. Par exemple, UNITY_CRED.
     • Jeton du porteur : Collez la valeur du jeton du porteur.

       Sélectionnez Créer des données d'identification.

       UNITY_CRED est affiché sous Données d'identification du catalogue Iceberg.

     
     
     
     Description de l'illustration add-unité-catalog.png
     
     

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

     Dans l'onglet Catalogue Iceberg, vous pouvez spécifier les valeurs de champ suivantes :

   • Espaces de noms de catalogue Iceberg : Sélectionnez l'un des schémas auxquels vous devez 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, Style des liens de données est sélectionné.
   • Région de seau : Ce champ n'est pas obligatoire.
     
     
     
     Description de l'illustration iceberg-unité-catalog.png
     
     

     Cliquez sur Ajouter.

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

   Après avoir monté avec succès un nouveau catalogue sur un catalogue Iceberg, vous pouvez voir le catalogue Unity dans la page Gérer les catalogues. Vous pouvez désactiver et supprimer le catalogue à partir de cette page.

1. Dans l'outil Catalogue, cliquez sur Sélectionner des catalogues….
2. Cliquez sur le filtre UNITY _CATALOG de l'assistant Catalogs and Schemas pour afficher les catalogues UNITY_CATALOG.
   
   
   
   Description de l'illustration catalogs-schemas-unité-catalog.png
   
   
3. Cliquez sur Appliquer pour voir les résultats dans la page Catalogue.
   
   
   
   Description de l'illustration manage-catalogs-unity.png