Obtenir les détails d'une table

L'affichage des détails d'une table permet d'exposer 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 de courte durée pour interagir de manière sécurisée avec les fichiers Cloud Storage sous-jacents sans nécessiter d'autorisations IAM de stockage directes.

Vous pouvez inspecter les détails des tables à l'aide de la console Google Cloud , des commandes SQL DESCRIBE dans Spark et Trino, ou de l'API REST.

Avant de commencer

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

  2. Activez l'API BigLake.

    Rôles requis pour activer les API

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

    Activer l'API

  3. Configurez le catalogue d'environnements d'exécution Lakehouse avec le point de terminaison du catalogue REST Apache Iceberg.

Rôles requis

Pour obtenir les autorisations nécessaires pour afficher les détails d'une 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.

Fonctionnalités et compatibilité des tableaux

Lorsque vous utilisez des tables dans le catalogue Lakehouse Runtime, il est utile de comprendre les différents types de tables et leurs fonctionnalités d'activation. Pour en savoir plus sur l'utilisation des tables Apache Iceberg, consultez Présentation des tables Apache Iceberg.

Tables Iceberg compatibles

Seules les tables Apache Iceberg V2 (disponibilité générale) et V3 (bêta) sont acceptées. Les tables Iceberg V1 ne sont pas acceptées. Pour mettre à niveau les tables V1 existantes, consultez Mettre à niveau les tables Iceberg V1 vers V2.

Obtenir les détails d'une table

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

Console

  1. Dans la console Google Cloud , 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 Détails de l'espace de noms, cliquez sur le nom de la table que vous souhaitez inspecter.

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

Spark 

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

Pour activer l'interopérabilité en lecture/écriture et la gestion des tables (aperçu), ajoutez les propriétés à la clause TBLPROPERTIES :

TBLPROPERTIES (
  'gcp.biglake.bigquery-dml.enabled' = true,
  'gcp.biglake.table-management.enabled' = true
)

Trino 

DESCRIBE SCHEMA_NAME.TABLE_NAME;

Pour activer l'interopérabilité en lecture/écriture et la gestion des tables (aperçu), ajoutez ces propriétés à la clause WITH :

WITH (
  "gcp.biglake.bigquery-dml.enabled" = 'true',
  "gcp.biglake.table-management.enabled" = 'true'
)

gcloud

Pour décrire une table à l'aide de gcloud, exécutez la commande gcloud biglake iceberg tables describe.

gcloud biglake iceberg tables describe TABLE_NAME \
    --project="PROJECT_ID" \
    --catalog="CATALOG_ID" \
    --namespace="NAMESPACE_NAME"

Remplacez les éléments suivants :

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

BigQuery

Pour afficher les détails et les propriétés de métadonnées d'une table Apache Iceberg dans le catalogue du runtime Lakehouse de BigQuery, vous pouvez examiner les détails de la table dans la console BigQuery ou utiliser la commande bq show.

REST

Pour récupérer les métadonnées d'une 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 projet Google Cloud .
  • 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.

Étapes suivantes