Aggiorna un catalogo

Il catalogo di runtime Lakehouse consente di modificare le proprietà degli endpoint del catalogo esistenti in Lakehouse senza confini.

Per gli endpoint del catalogo REST Apache Iceberg, puoi aggiornare la modalità delle credenziali, la posizione predefinita del warehouse e il tipo di catalogo. Ad esempio, puoi eseguire l'upgrade di un catalogo con un singolo bucket a un catalogo con più bucket (consigliato) in modo che il catalogo possa estendersi su più bucket di archiviazione.

Prima di iniziare

  1. Leggi Informazioni sul catalogo di runtime Lakehouse per capire come funziona il catalogo di runtime Lakehouse e le limitazioni del servizio.
  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

    Verify that billing is enabled for your Google Cloud project.

    Enable the BigLake API, if it is not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the 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 un catalogo utilizzando la console Google Cloud , gcloudo l'API REST. Per aggiornare un catalogo federato per l'accesso ai dati cross-cloud, consulta la guida alla configurazione dell'origine dati. Ad esempio, consulta AWS Glue Data Catalog.

Console

  1. Nella console Google Cloud , vai alla pagina Lakehouse.

    Vai a Lakehouse

  2. Fai clic sul nome del catalogo.

  3. Nella pagina Dettagli catalogo, a seconda di ciò che vuoi aggiornare, esegui una delle seguenti operazioni:

    • Modifica autenticazione del catalogo: nella sezione Metodo di autenticazione, fai clic su  Modifica autenticazione del catalogo. Nella finestra di dialogo, seleziona Credenziali dell'utente finale o Modalità di distribuzione delle credenziali, quindi fai clic su Salva.
    • Imposta o aggiorna le autorizzazioni del bucket: se il tuo catalogo utilizza la modalità di distribuzione delle credenziali, vai alla sezione Metodo di autenticazione. Per un catalogo con più bucket, fai clic su Imposta le autorizzazioni per il bucket. Per un catalogo con un singolo bucket, fai clic su Imposta autorizzazioni bucket. Nella finestra di dialogo di conferma, fai clic su Conferma.
    • Converti in un catalogo con più bucket o aggiungi bucket: per eseguire l'upgrade di un catalogo con un singolo bucket o associare bucket di archiviazione aggiuntivi, utilizza il comando gcloud biglake iceberg catalogs update nella scheda gcloud o l'API REST nella scheda REST.

gcloud

Opzione 1: aggiorna le proprietà del catalogo

Per aggiornare le proprietà del catalogo (ad esempio la descrizione o le località limitate), esegui il comando gcloud biglake iceberg catalogs update:

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

Sostituisci quanto segue:

  • CATALOG_ID: l'ID del catalogo di 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 le credenziali utente finale o vended-credentials per la modalità di distribuzione delle credenziali.
  • RESTRICTED_LOCATIONS: (facoltativo) un elenco separato da virgole di bucket o percorsi di archiviazione consentiti aggiuntivi. Attenzione: se specifichi più bucket o percorsi sovrapposti, questa configurazione può causare conflitti di metadati, sovrascritture accidentali dei dati o problemi di sicurezza come la perdita di autorizzazioni.

Opzione 2: esegui l'upgrade di un catalogo con un singolo bucket a un catalogo con più bucket (consigliato)

Per eseguire l'upgrade di un catalogo a bucket singolo esistente a un catalogo a più bucket (consigliato), esegui il comando gcloud biglake iceberg catalogs update e imposta il parametro --catalog-type su biglake:

gcloud biglake iceberg catalogs update CATALOG_ID \
    --project="PROJECT_ID" \
    --catalog-type="biglake"

REST

Opzione 1: aggiorna le proprietà del catalogo

Per modificare le proprietà di un catalogo (ad esempio la descrizione) 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=description

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

{
  "description": "Updated catalog description"
}

Opzione 2: esegui l'upgrade di un catalogo con un singolo bucket a un catalogo con più bucket (consigliato)

Per eseguire l'upgrade del tipo utilizzando l'API REST, invia una richiesta PATCH all'endpoint UpdateIcebergCatalog con catalogType in updateMask:

PATCH /iceberg/v1/restcatalog/extensions/projects/PROJECT_ID/catalogs/CATALOG_ID?updateMask=catalog_type

Il corpo della richiesta deve contenere un payload JSON IcebergCatalog con il nuovo tipo di catalogo:

{
  "catalog_type": "CATALOG_TYPE_BIGLAKE"
}

Sostituisci quanto segue:

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

Nota: dopo l'upgrade a un catalogo con più bucket, aggiorna le configurazioni del motore di query client (come Spark o Trino) per specificare il percorso del warehouse utilizzando il formato bl://: bl://projects/PROJECT_ID/catalogs/CATALOG_ID.