Aggiorna un catalogo

L'aggiornamento di un catalogo (ad esempio un catalogo REST Apache Iceberg) consente di modificarne le proprietà, ad esempio la modalità delle credenziali, la posizione predefinita del warehouse o il tipo di catalogo sottostante. Ad esempio, puoi eseguire l'upgrade di un catalogo di bucket Cloud Storage legacy (catalogo gs://) a un catalogo BigLake (catalogo bl://).

Prima di iniziare

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

  2. Abilita l'API BigLake.

    Ruoli richiesti per abilitare le API

    Per abilitare le API, devi disporre del ruolo IAM Amministratore utilizzo dei servizi (roles/serviceusage.serviceUsageAdmin), che include l'autorizzazione serviceusage.services.enable. Scopri come concedere i ruoli.

    Abilitare l'API

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per aggiornare un catalogo, chiedi all'amministratore di concederti i seguenti ruoli IAM:

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.

Aggiorna un catalogo

Puoi aggiornare la configurazione di un catalogo, ad esempio modificandone la descrizione, la modalità delle credenziali o le località consentite.

Inoltre, puoi eseguire l'upgrade di un catalogo di bucket Cloud Storage esistente (catalogo gs:// legacy) a un catalogo BigLake (catalogo bl://). Il catalogo aggiornato mantiene il nome del bucket originale. Dopo l'upgrade, puoi associare più bucket e configurare le località con limitazioni.

Puoi aggiornare un catalogo utilizzando la consoleGoogle Cloud , gcloud o l'API REST.

Console

  1. Nella console Google Cloud , apri la pagina Lakehouse.

    Vai a Lakehouse

  2. Nella riga del catalogo che vuoi aggiornare, fai clic su Altre azioni del catalogo > Modifica.

  3. In Configurazione catalogo, modifica le impostazioni che vuoi aggiornare.

  4. Seleziona Salva.

gcloud

Utilizza il comando gcloud beta biglake iceberg catalogs update.

gcloud beta biglake iceberg catalogs update CATALOG_ID \
    --project="PROJECT_ID" \
    [--description="DESCRIPTION"] \
    [--credential-mode="CREDENTIAL_MODE"] \
    [--restricted-locations="RESTRICTED_LOCATIONS"] \
    [--catalog-type=biglake]

Sostituisci quanto segue:

  • CATALOG_ID: l'ID del catalogo runtime Lakehouse.
  • PROJECT_ID: il tuo ID progetto Google Cloud .
  • DESCRIPTION: (Facoltativo) una descrizione del catalogo.
  • CREDENTIAL_MODE: (facoltativo) il metodo di autenticazione. Utilizza end-user per Credenziali utente finale o vended-credentials per Modalità di distribuzione delle credenziali.
  • RESTRICTED_LOCATIONS: (facoltativo) un elenco separato da virgole di bucket o percorsi di archiviazione consentiti aggiuntivi.

REST

Per modificare un catalogo o aggiornarne il tipo utilizzando l'API REST, invia una richiesta PATCH all'endpoint UpdateIcebergCatalog con il updateMask appropriato:

PATCH /iceberg/v1/restcatalog/extensions/projects/PROJECT_ID/catalogs/CATALOG_ID?updateMask=icebergCatalog.catalogType,icebergCatalog.description

Il corpo della richiesta deve contenere un payload JSON IcebergCatalog con i campi da aggiornare:

{
  "catalogType": "BIGLAKE",
  "description": "Updated catalog description"
}

Sostituisci quanto segue:

  • PROJECT_ID: il tuo ID progetto Google Cloud .
  • CATALOG_ID: l'ID del catalogo runtime Lakehouse.