Obtenir les détails d'une vue

Vous pouvez inspecter le schéma, les commentaires de colonne, les propriétés et la définition SQL d'une vue Apache Iceberg enregistrée dans le catalogue d'environnements d'exécution Lakehouse à l'aide de Spark ou du point de terminaison du catalogue REST Apache Iceberg.

Avant de commencer

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

  2. Activez l'API BigLake si ce n'est pas déjà fait.

    Rôles requis pour activer les API

    Pour activer des API, vous devez disposer de l'autorisation serviceusage.services.enable. Si vous avez créé le projet, vous disposez probablement déjà de cette autorisation via le rôle Propriétaire (roles/owner). Sinon, vous pouvez l'obtenir via le rôle Administrateur Service Usage (roles/serviceusage.serviceUsageAdmin). 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.
  4. Consultez les limites des vues Iceberg.
  5. Créer une vue

Rôles requis

Pour obtenir les autorisations nécessaires pour afficher les détails d'une vue, demandez à votre administrateur de vous accorder les rôles IAM suivants sur votre projet et votre bucket de stockage :

  • Obtenir les détails d'une vue : Lecteur BigLake (roles/biglake.viewer) - votre projet
  • Lire les fichiers de métadonnées de vue en mode d'identifiants de l'utilisateur final : lecteur d'objets Storage (roles/storage.objectViewer) – bucket Cloud Storage

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Ces rôles prédéfinis contiennent les autorisations requises pour obtenir les détails de la vue. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Vous devez disposer des autorisations suivantes pour obtenir les détails d'une vue :

  • Obtenir les détails de la vue : biglake.views.get sur la vue
  • Lire les fichiers de métadonnées de vue en mode Identifiants de l'utilisateur final : storage.objects.get sur le bucket Cloud Storage

Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.

Pour obtenir la liste complète des autorisations d'affichage, consultez Rôles et autorisations requis.

Obtenir les détails d'une vue

Inspecter une vue

Spark

Affichez le schéma de la vue, les commentaires de colonne et les propriétés de la vue :

DESCRIBE EXTENDED NAMESPACE_NAME.VIEW_NAME;

Affichez l'instruction SQL qui définit la vue :

SHOW CREATE TABLE NAMESPACE_NAME.VIEW_NAME;

Afficher uniquement les propriétés de la vue :

SHOW TBLPROPERTIES NAMESPACE_NAME.VIEW_NAME;

Remplacez les éléments suivants :

  • NAMESPACE_NAME : nom de votre espace de noms.
  • VIEW_NAME : nom de votre vue.

REST

Pour charger les métadonnées actuelles d'une vue à l'aide de l'API REST, envoyez une requête GET au point de terminaison GetIcebergView :

GET /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces/NAMESPACE_NAME/views/VIEW_NAME

La réponse contient les éléments metadata-location et metadata de la vue.

Pour vérifier si une vue existe sans charger ses métadonnées, envoyez une requête HEAD au même chemin d'accès. Le point de terminaison CheckIcebergViewExists renvoie 204 No Content si la vue existe, ou 404 Not Found si elle n'existe pas.

Remplacez les éléments suivants :

  • 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.
  • VIEW_NAME : nom de votre vue.

Étapes suivantes