Modifica una vista

La modifica di una vista Apache Iceberg ti consente di evolvere lo schema e la definizione SQL della vista o di impostare e annullare l'impostazione delle proprietà della vista personalizzata, senza modificare l'identità della vista nel catalogo di runtime Lakehouse.

La ridenominazione di una visualizzazione non è supportata. Per rinominare una vista, creane una con il nuovo nome, quindi elimina la vista originale. Anche la località di archiviazione di una visualizzazione è immutabile dopo la creazione e un aggiornamento che imposta una località diversa non va a buon fine con un errore 400 Bad Request.

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 Service Usage (roles/serviceusage.serviceUsageAdmin). Scopri come concedere i ruoli.

    Abilitare l'API

  3. Configura il catalogo di runtime Lakehouse con l'endpoint del catalogo REST Apache Iceberg.
  4. Esamina le limitazioni delle visualizzazioni Iceberg.
  5. Crea una vista.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per modificare una vista, chiedi all'amministratore di concederti i seguenti ruoli IAM sul progetto e sul bucket di archiviazione:

  • Modifica una vista: BigLake Editor (roles/biglake.editor) - il tuo progetto
  • Scrivi i file dei metadati della vista in modalità credenziali dell'utente finale: 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.

Questi ruoli predefiniti contengono le autorizzazioni necessarie per modificare una vista. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per modificare una vista sono necessarie le seguenti autorizzazioni:

  • Modifica una vista:
    • biglake.views.update nella vista
    • biglake.tables.get su ogni tabella Iceberg a cui fa riferimento la nuova definizione della vista
  • Scrivi i file di metadati della vista in modalità credenziali utente finale: storage.objects.create sul bucket Cloud Storage

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Per un elenco completo delle autorizzazioni di visualizzazione, consulta Ruoli e autorizzazioni richiesti.

Sostituisci una definizione di visualizzazione

Sostituisci lo schema e la logica SQL di una vista esistente. Quando sostituisci una vista, il catalogo scrive un nuovo file metadata.json con versione (ad esempio 00001-UUID.metadata.json), aggiunge una nuova versione e uno schema della vista ai metadati della vista e conserva il view-uuid della vista.

Spark

CREATE OR REPLACE VIEW my_ns.eng_employees (
  emp_id,
  emp_name,
  dept,
  salary,
  is_senior
)
COMMENT 'Updated Engineering view with seniority flag'
AS SELECT id, name, dept, salary, (salary >= 140000.0) AS is_senior
FROM my_ns.employees
WHERE dept = 'Engineering';

REST

Per aggiornare una visualizzazione utilizzando l'API REST, invia una richiesta POST all'endpoint UpdateIcebergView:

POST /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces/NAMESPACE_NAME/views/VIEW_NAME

Il corpo della richiesta deve contenere un payload JSON Iceberg CommitViewRequest valido con requirements e updates da applicare. Il catalogo convalida i requisiti di contemporaneità ottimistica ed esegue il commit degli aggiornamenti in un nuovo file metadata.json.

Sostituisci quanto segue:

  • PROJECT_ID: il tuo ID progetto Google Cloud.
  • CATALOG_ID: l'ID del tuo catalogo.
  • NAMESPACE_NAME: il nome dello spazio dei nomi del catalogo.
  • VIEW_NAME: il nome della visualizzazione.

Imposta e annulla l'impostazione delle proprietà della visualizzazione

Imposta o rimuovi le proprietà personalizzate in una vista senza modificarne la definizione.

Spark

Imposta le proprietà:

ALTER VIEW my_ns.eng_employees
SET TBLPROPERTIES ('tier' = 'gold', 'reviewed' = 'true');

Annulla l'impostazione di una proprietà:

ALTER VIEW my_ns.eng_employees
UNSET TBLPROPERTIES IF EXISTS ('reviewed');

Per informazioni dettagliate su come il catalogo gestisce proprietà come write.metadata.compression-codec, consulta Visualizza proprietà.

REST

Invia un CommitViewRequest all'endpoint UpdateIcebergView con aggiornamenti set-properties o remove-properties. Consulta Sostituisci una definizione di visualizzazione per il percorso dell'endpoint.

Passaggi successivi