Répertorier des tables

Lister les tables vous permet d'afficher toutes les entités de table enregistrées dans un espace de noms du catalogue du runtime Lakehouse.

Les moteurs de requête peuvent lister les tables à l'aide de commandes SQL standard, et les clients REST peuvent récupérer les identifiants de table directement via la spécification de l'API Iceberg REST Catalog Open Source (GET /v1/{prefix}/namespaces/{namespace}/tables).

Avant de commencer

Consultez l'aperçu des tableaux pour comprendre les différents types de tableaux et les implications de leur utilisation.

  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

Rôles requis

Pour obtenir les autorisations nécessaires pour lister les tables, 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.

Répertorier des tables

Répertoriez les tables.

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.

Vos tables s'affichent sur la page Détails de l'espace de noms.

Spark 

spark.sql("SHOW TABLES").show()

Trino 

SHOW TABLES;

REST

Pour lister les identifiants de table dans un espace de noms à l'aide de l'API REST, envoyez une requête GET au point de terminaison ListIcebergTableIdentifiers :

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

La réponse contient un tableau JSON d'identifiants de table enregistrés sous l'espace de noms spécifié.

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.

Étapes suivantes