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
-
Prüfen Sie, ob die Abrechnung für Ihr Google Cloud -Projekt aktiviert ist.
-
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 - Richten Sie den Lakehouse-Laufzeitkatalog mit dem Apache Iceberg REST-Katalogendpunkt ein.
- Lesen Sie die Einschränkungen von Iceberg-Ansichten.
- 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
- BigLake-Betrachter (
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.getfür die Ansicht und alle verschachtelten Ansichten -
biglake.tables.getfür jede Iceberg-Tabelle, auf die die Ansicht verweist
-
-
Tabellendaten im Modus für die Bereitstellung von Anmeldedaten lesen:
biglake.tables.getDatafür jede Iceberg-Tabelle, auf die die Ansicht verweist -
Lesen Sie Ansichtsmetadaten und Tabellendaten im Modus für Endnutzer-Anmeldedaten:
storage.objects.getfü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
- Informationen zum Abrufen von Ansichtsdetails
- Informationen zur Fehlerbehebung bei Iceberg-Ansichten