Ansicht abfragen

Wenn Sie eine Apache Iceberg-Ansicht abfragen, können Sie kuratierte, kopierfreie Ergebnisse aus den zugrunde liegenden Iceberg-Tabellen lesen, indem Sie die im Lakehouse-Laufzeitkatalog gespeicherte SQL-Definition ausführen. Ihre Compute Engine lädt die Ansichtsdefinition aus dem Katalog, löst jede referenzierte Tabelle und verschachtelte Ansicht auf und liest dann die Datendateien in Cloud Storage.

Sie können Iceberg-Ansichten nur von Iceberg-kompatiblen Open-Source-Engines wie Spark und Trino abfragen. BigQuery unterstützt keine Abfragen von Iceberg-Ansichten.

Hinweis

  1. Prüfen Sie, ob die Abrechnung für Ihr Google Cloud -Projekt aktiviert ist.

  2. Aktivieren Sie die BigLake API, falls sie noch nicht aktiviert ist.

    Rollen, die zum Aktivieren von APIs erforderlich sind

    Zum Aktivieren von APIs benötigen Sie die Berechtigung serviceusage.services.enable. Wenn Sie das Projekt erstellt haben, haben Sie diese Berechtigung wahrscheinlich bereits über die Inhaberrolle (roles/owner). Andernfalls können Sie diese Berechtigung über die Rolle „Service Usage-Administrator“ (roles/serviceusage.serviceUsageAdmin) erhalten. Informationen zum Zuweisen von Rollen

    API aktivieren

  3. Richten Sie den Lakehouse-Laufzeitkatalog mit dem Apache Iceberg REST-Katalogendpunkt ein.
  4. Lesen Sie die Einschränkungen von Iceberg-Ansichten.
  5. Ansicht erstellen

Erforderliche Rollen

Da Ihre Compute Engine Ansichten clientseitig auswertet, benötigen Sie Berechtigungen für die Ansicht und für jede Tabelle und verschachtelte Ansicht, auf die die Ansicht verweist.

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für Ihr Projekt und Ihren Storage-Bucket zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Abfragen einer Ansicht benötigen:

  • Ansicht und referenzierte Tabellen im Modus für die Bereitstellung von Anmeldedaten lesen: BigLake-Betrachter (roles/biglake.viewer) – Ihr Projekt
  • Ansicht und referenzierte Tabellen im Modus für Endnutzer-Anmeldedaten lesen:
    • BigLake-Betrachter (roles/biglake.viewer) – Ihr Projekt
    • Storage-Objekt-Betrachter (roles/storage.objectViewer) – der Cloud Storage-Bucket

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierten Rollen enthalten die Berechtigungen, die zum Abfragen einer Ansicht erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Zum Abfragen einer Ansicht sind die folgenden Berechtigungen erforderlich:

  • Ansicht abfragen:
    • biglake.views.get für die Ansicht und alle verschachtelten Ansichten
    • biglake.tables.get für jede Iceberg-Tabelle, auf die die Ansicht verweist
  • Tabellendaten im Modus für die Bereitstellung von Anmeldedaten lesen: biglake.tables.getData für jede Iceberg-Tabelle, auf die die Ansicht verweist
  • Lesen Sie Ansichtsmetadaten und Tabellendaten im Modus für Endnutzer-Anmeldedaten: storage.objects.get für den Cloud Storage-Bucket

Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

Eine vollständige Liste der Leseberechtigungen finden Sie unter Erforderliche Rollen und Berechtigungen.

Ansicht abfragen

Wählen Sie alle Daten aus einer Ansicht aus:

Spark

SELECT * FROM NAMESPACE_NAME.VIEW_NAME;

Ersetzen Sie Folgendes:

  • NAMESPACE_NAME: der Name Ihres Namespace.
  • VIEW_NAME: der Name der Ansicht.

Sie können Ansichten, die Joins, Aggregationen, CTEs und verschachtelte Ansichten enthalten, auf dieselbe Weise abfragen. In den folgenden Abfragen werden beispielsweise die Ansichten aus Ansicht erstellen verwendet:

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;

Zeitreisen und Aufrufe

Sie können eine Zeitreiseklausel wie TIMESTAMP AS OF oder VERSION AS OF nicht direkt auf eine Ansichtskennung anwenden. Wenn Sie Verlaufsdaten benötigen, definieren Sie eine Ansicht, deren SQL-Definition Zeitreisen auf die zugrunde liegende Tabelle anwendet, oder verwenden Sie einen CTE, der die zugrunde liegende Tabelle direkt abfragt. Weitere Informationen finden Sie unter Ansicht mit Zeitreisen für zugrunde liegende Tabellen erstellen.

Nächste Schritte