Iceberg V1-Tabellen auf V2 aktualisieren

Wenn Sie vorhandene 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

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

  2. Aktivieren Sie die BigLake API.

    Rollen, die zum Aktivieren von APIs erforderlich sind

    Zum Aktivieren von APIs benötigen Sie die IAM-Rolle „Service Usage-Administrator“ (roles/serviceusage.serviceUsageAdmin), die die Berechtigung serviceusage.services.enable enthält. Weitere Informationen zum Zuweisen von Rollen

    API aktivieren

  3. 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 Speicher-Bucket zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Aktualisieren einer Tabelle benötigen:

  • Tabelle im Credential Vending Mode aktualisieren: BigLake Editor (roles/biglake.editor) – das Projekt
  • Upgrade-Tabelle im Modus ohne Bereitstellung von Anmeldedaten:
    • BigLake Editor (roles/biglake.editor): das Projekt
    • Storage Object User (roles/storage.objectUser) – der Cloud Storage-Bucket

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 Ihrer Tabelle.

Nächste Schritte