Obtenir les détails d'une table

L'affichage des détails d'une table expose le schéma sous-jacent, les propriétés de la table et les métadonnées de configuration d'une table Apache Iceberg dans le catalogue d'exécution Lakehouse.

En mode de distribution d'identifiants, les moteurs de requête récupèrent également des identifiants d'accès éphémères pour interagir en toute sécurité avec les fichiers Cloud Storage sous-jacents sans nécessiter d'autorisations de stockage IAM directes.

Vous pouvez inspecter les détails de la table à l'aide de la Google Cloud console, des commandes SQL describe dans Spark et Trino, ou de la spécification de l'API REST du catalogue Iceberg Open Source.

Avant de commencer

Consultez la présentation des tables pour comprendre les différents types de tables et les implications de leur utilisation.

  1. Vérifiez que la facturation est activée pour votre Google Cloud projet.

  2. Activez l'API BigLake.

    Rôles requis pour activer les API

    Pour activer les API, vous avez besoin du rôle IAM Administrateur d'utilisation du service (roles/serviceusage.serviceUsageAdmin), qui contient l'autorisation serviceusage.services.enable. Découvrez comment attribuer des rôles.

    Activer l'API

Rôles requis

Pour obtenir les autorisations nécessaires pour afficher les détails de la table, demandez à votre administrateur de vous accorder les rôles IAM suivants sur votre projet :

  • Tous : Lecteur BigLake (roles/biglake.viewer) – 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 de la table

Inspectez le schéma et les propriétés de la table.

Console

  1. Dans la Google Cloud console, accédez à Lakehouse.

    Accéder à Lakehouse

  2. Sélectionnez un catalogue existant ou créez-en un si vous n'en avez pas.

  3. Dans le tableau Namespace details (Détails de l'espace de noms), cliquez sur le nom de la table que vous souhaitez inspecter.

  4. Sur la page Table details (Détails de la table), explorez le schéma, la spécification de partition et les propriétés des métadonnées de la table.

Spark 

spark.sql("DESCRIBE EXTENDED NAMESPACE_NAME.TABLE_NAME").show()

Trino 

DESCRIBE SCHEMA_NAME.TABLE_NAME;

REST

Pour récupérer les métadonnées de la table à l'aide de l'API REST, envoyez une requête GET au point de terminaison GetIcebergTable :

GET /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces/NAMESPACE_NAME/tables/TABLE_NAME

Pour charger des identifiants de table éphémères en mode de distribution d'identifiants, envoyez une requête GET au point de terminaison LoadIcebergTableCredentials :

GET /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces/NAMESPACE_NAME/tables/TABLE_NAME/credentials

Remplacez les éléments suivants :

  • PROJECT_ID: ID de votre Google Cloud projet.
  • CATALOG_ID : ID de votre catalogue d'exécution Lakehouse.
  • NAMESPACE_NAME : nom de l'espace de noms de votre catalogue.
  • TABLE_NAME : nom de votre table Iceberg.

Étape suivante