Interroger une vue

L'interrogation d'une vue Apache Iceberg vous permet de lire des résultats sélectionnés sans copie à partir des tables Iceberg sous-jacentes en exécutant la définition SQL stockée dans le catalogue d'environnements d'exécution Lakehouse. Votre moteur de calcul charge la définition de la vue à partir du catalogue, résout chaque table et vue imbriquée référencée, puis lit les fichiers de données dans Cloud Storage.

Vous ne pouvez interroger les vues Iceberg qu'à partir de moteurs Open Source compatibles avec Iceberg, tels que Spark et Trino. BigQuery n'est pas compatible avec l'interrogation des vues 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

Étant donné que votre moteur de calcul évalue les vues côté client, vous devez disposer d'autorisations sur la vue, ainsi que sur chaque table et vue imbriquée auxquelles la vue fait référence.

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

  • Lire la vue et les tables référencées en mode de distribution des identifiants : Lecteur BigLake (roles/biglake.viewer) - votre projet
  • Lisez la vue et les tables référencées en mode d'identifiants de l'utilisateur final :
    • Lecteur BigLake (roles/biglake.viewer) - votre projet
    • Lecteur des objets Storage (roles/storage.objectViewer) : le 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 interroger une vue. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Vous devez disposer des autorisations suivantes pour interroger une vue :

  • Interroger une vue :
    • biglake.views.get sur la vue et toutes les vues imbriquées
    • biglake.tables.get sur chaque table Iceberg référencée par la vue
  • Lire les données de la table en mode de distribution des identifiants : biglake.tables.getData sur chaque table Iceberg référencée par la vue
  • Lire les métadonnées de la vue et les données de la table en mode d'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.

Interroger une vue

Sélectionnez toutes les données d'une vue :

Spark

SELECT * FROM NAMESPACE_NAME.VIEW_NAME;

Remplacez les éléments suivants :

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

Vous pouvez interroger de la même manière les vues contenant des jointures, des agrégations, des CTE et des vues imbriquées. Par exemple, les requêtes suivantes utilisent les vues de la section Créer une vue :

SELECT * FROM my_ns.eng_employees ORDER BY emp_id;
SELECT * FROM my_ns.employee_directory ORDER BY id;
SELECT * FROM my_ns.top_eng_employees;

Fonctionnalité temporelle et vues

Vous ne pouvez pas appliquer une clause de voyage temporel telle que TIMESTAMP AS OF ou VERSION AS OF directement à un identifiant de vue. Si vous avez besoin de données historiques, définissez une vue dont la définition SQL applique les fonctionnalités temporelles à la table sous-jacente, ou utilisez une CTE qui interroge directement la table sous-jacente. Pour en savoir plus, consultez Créer une vue avec la fonctionnalité temporelle sur les tables sous-jacentes.

Étapes suivantes