Esegui l'upgrade delle tabelle Iceberg V1 alla versione 2

Se hai tabelle Apache Iceberg versione 1 (V1) esistenti, devi eseguirne l'upgrade utilizzando il motore di query prima di utilizzarle con l'endpoint del catalogo REST Apache Iceberg. Per ulteriori informazioni, vedi Modificare una tabella.

Prima di iniziare

  1. Verifica che la fatturazione sia attivata per il tuo progetto Google Cloud .

  2. Abilita l'API BigLake, se non è già abilitata.

    Ruoli richiesti per abilitare le API

    Per abilitare le API, devi disporre dell'autorizzazione serviceusage.services.enable. Se hai creato il progetto, probabilmente disponi già di questa autorizzazione tramite il ruolo Proprietario (roles/owner). In caso contrario, puoi ottenere questa autorizzazione tramite il ruolo Amministratore utilizzo dei servizi (roles/serviceusage.serviceUsageAdmin). Scopri come concedere i ruoli.

    Abilitare l'API

  3. Configura il catalogo runtime Lakehouse con l'endpoint del catalogo REST Apache Iceberg.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per eseguire l'upgrade di una tabella, chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto e nel bucket di archiviazione:

  • Aggiorna la tabella in modalità di distribuzione delle credenziali: BigLake Editor (roles/biglake.editor) - il progetto
  • Aggiorna la tabella in modalità di distribuzione delle credenziali:
    • BigLake Editor (roles/biglake.editor) - il progetto
    • Storage Object User (roles/storage.objectUser): il bucket Cloud Storage

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Eseguire l'upgrade di una tabella

Per eseguire l'upgrade di una tabella Iceberg V1 alla versione 2, esegui questo comando nel motore di query:

Spark 

ALTER TABLE CATALOG_NAME.SCHEMA_NAME.TABLE_NAME SET TBLPROPERTIES ('format-version'='2');

Sostituisci quanto segue:

  • CATALOG_NAME: il nome del catalogo.
  • SCHEMA_NAME: il nome dello schema.
  • TABLE_NAME: il nome della tabella.

Passaggi successivi