La récupération des propriétés de configuration expose les métadonnées de Lakehouse pour Apache Iceberg.
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 Apache Iceberg REST, 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
- 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.
- 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 theresourcemanager.projects.createpermission. Learn how to grant roles. - 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 theresourcemanager.projects.createpermission. Learn how to grant roles.
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
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.
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
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.
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 :
-
Tous :
- Administrateur BigLake (
roles/biglake.admin) - Administrateur de l'espace de stockage (
roles/storage.admin)
- Administrateur BigLake (
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 d'un catalogue
Examinez la configuration et les propriétés du catalogue.
Console
Dans la console Google Cloud , ouvrez la page Lakehouse.
Cliquez sur le nom d'un catalogue.
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.
gcloud
Pour décrire un catalogue à l'aide de gcloud, 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 du 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.