Wenn Sie bereits Apache Iceberg-Tabellen der Version 1 (V1) haben, müssen Sie sie mit Ihrer Abfrage-Engine aktualisieren, bevor Sie sie mit dem Apache Iceberg REST-Katalogendpunkt verwenden können. Weitere Informationen finden Sie unter Tabelle ändern.
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.
Erforderliche Rollen
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 Upgraden einer Tabelle benötigen:
-
Tabelle im Modus für die Bereitstellung von Anmeldedaten aktualisieren:
BigLake-Bearbeiter (
roles/biglake.editor) – das Projekt -
Tabelle im Modus ohne Bereitstellung von Anmeldedaten aktualisieren:
- BigLake Editor (
roles/biglake.editor) – das Projekt - Storage Object User (
roles/storage.objectUser) – der Cloud Storage-Bucket
- BigLake Editor (
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.
Tabelle upgraden
Führen Sie den folgenden Befehl in Ihrer Abfrage-Engine aus, um ein Upgrade einer Iceberg-V1-Tabelle auf V2 durchzuführen:
Spark
ALTER TABLE CATALOG_NAME.SCHEMA_NAME.TABLE_NAME SET TBLPROPERTIES ('format-version'='2');
Ersetzen Sie Folgendes:
CATALOG_NAME: der Name Ihres Katalogs.SCHEMA_NAME: der Name Ihres Schemas.TABLE_NAME: der Name der Tabelle.