Répertorier des tables

La liste des tables vous permet d'afficher toutes les entités de table enregistrées dans un espace de noms du catalogue d'exécution Lakehouse.

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

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 répertorier les tables, demandez à votre administrateur de vous attribuer 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épertorier des tables

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.

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 répertorier les identifiants de table dans un espace de noms à l'aide de l'API REST, envoyez une GET requête au ListIcebergTableIdentifiers point de terminaison :

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 Google Cloud projet.
  • CATALOG_ID : ID de votre catalogue d'exécution Lakehouse.
  • NAMESPACE_NAME : nom de l'espace de noms de votre catalogue.

Étape suivante