Obtenir les détails du point de terminaison du catalogue

Le catalogue d'environnements d'exécution Lakehouse vous permet d'inspecter la configuration et les métadonnées des points de terminaison du catalogue dans Lakehouse sans frontières. Pour les points de terminaison du catalogue REST Apache Iceberg, vous pouvez récupérer l'URI du catalogue REST requis pour les connexions client, la méthode d'authentification et le compte de service associé. Pour en savoir plus sur les points de terminaison de catalogue, consultez Types de catalogues et configuration des points de terminaison.

Avant de commencer

  1. Consultez À propos du catalogue d'environnements d'exécution Lakehouse pour comprendre le fonctionnement du catalogue d'environnements d'exécution Lakehouse et les limites du service.
  2. Connectez-vous à votre compte Google Cloud . Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits sans frais pour exécuter, tester et déployer des charges de travail.

    In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

    Verify that billing is enabled for your Google Cloud project.

    Enable the BigLake API, if it is not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the API

    In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

    Verify that billing is enabled for your Google Cloud project.

    Enable the BigLake API, if it is not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the API

Rôles requis

Pour obtenir les autorisations nécessaires pour afficher les détails d'un point de terminaison de catalogue, demandez à votre administrateur de vous accorder les rôles IAM suivants sur votre projet :

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.

Obtenir les détails du point de terminaison du catalogue

Inspectez la configuration et les propriétés du point de terminaison du catalogue.

Console

  1. Dans la console Google Cloud , ouvrez la page Lakehouse.

    Accéder à Lakehouse

  2. Cliquez sur le nom d'un catalogue.

  3. Sur la page Détails du catalogue, explorez les informations sur le catalogue, telles que l'ID du catalogue, le code temporel de création, l'URI du catalogue REST, la méthode d'authentification et le compte de service.

    Pour les catalogues fédérés, la page Détails du catalogue affiche également les propriétés suivantes lorsqu'elles sont configurées :

    • Mode d'identité : affiche Service identity ou User identity federation pour les connexions Databricks Unity Catalog.
    • Nom de l'Annuaire des services : affiche le nom de la ressource de service de l'Annuaire des services configurée pour le transport de requêtes privées sur les connexions AWS Glue, Snowflake Horizon Catalog et Databricks Unity Catalog.
    • Nom de l'Annuaire des services de métadonnées : affiche le nom de la ressource de service de l'Annuaire des services configurée pour l'actualisation privée des métadonnées en arrière-plan sur les connexions AWS Glue, Snowflake Horizon Catalog et Databricks Unity Catalog.

gcloud

Pour décrire un point de terminaison de catalogue à l'aide de la Google Cloud CLI, exécutez la commande gcloud biglake iceberg catalogs describe.

gcloud biglake iceberg catalogs describe CATALOG_ID \
    --project="PROJECT_ID"

Remplacez les éléments suivants :

  • CATALOG_ID : ID de votre catalogue.
  • PROJECT_ID : ID de votre projet Google Cloud .

REST

Pour récupérer les détails et la configuration d'un point de terminaison de catalogue à l'aide de l'API REST, envoyez une requête GET au point de terminaison GetIcebergCatalog :

GET /iceberg/v1/restcatalog/extensions/projects/PROJECT_ID/catalogs/CATALOG_ID

La réponse contient un objet JSON IcebergCatalog décrivant la configuration du catalogue.

Remplacez les éléments suivants :

  • PROJECT_ID : ID de votre projet Google Cloud .
  • CATALOG_ID : ID de votre catalogue.