Obtenir les détails d'un catalogue

La récupération des propriétés de configuration expose les métadonnées pour Lakehouse sans bordure.

Dans le catalogue d'environnements d'exécution Lakehouse, l'inspection d'un catalogue existant (tel qu'un catalogue REST Apache Iceberg ou un catalogue Apache Hive) révèle ses détails. Pour les catalogues REST Apache Iceberg, cela inclut l'URI du catalogue REST requis pour les connexions client, la méthode d'authentification et le compte de service associé.

Avant de commencer

  1. Consultez À propos du catalogue d'environnements d'exécution Lakehouse pour comprendre comment il fonctionne et quelles sont les limites du service.
    2. Connectez-vous à votre Google Cloud compte. 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.

    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.

    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 du 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 la page Gérer l'accès aux projets, aux dossiers et aux organisations.

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

Obtenir les détails du catalogue

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

Console

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

    Accéder à Lakehouse

  2. Cliquez sur le nom d'un catalogue.

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

gcloud

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

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 Google Cloud projet.

REST

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

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 Google Cloud projet.
  • CATALOG_ID : ID de votre catalogue.