L'aggiornamento di un catalogo (ad esempio un catalogo REST Apache Iceberg) consente di modificarne le proprietà, come la modalità delle credenziali, la località predefinita del warehouse o il tipo di catalogo sottostante.
Ad esempio, puoi eseguire l'upgrade di un catalogo a bucket singolo (gs://) a un catalogo a più bucket (bl://) (consigliato). L'upgrade del catalogo offre vantaggi significativi, ad esempio la possibilità di estendere il catalogo a più bucket di archiviazione.
Prima di iniziare
- Leggi Informazioni sul catalogo runtime Lakehouse per capire come funziona il catalogo runtime Lakehouse e i limiti del servizio.
- 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 theresourcemanager.projects.createpermission. Learn how to grant roles. - 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 theresourcemanager.projects.createpermission. Learn how to grant roles.
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
Verify that billing is enabled for your Google Cloud project.
Enable the BigLake API.
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.
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
Verify that billing is enabled for your Google Cloud project.
Enable the BigLake API.
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.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per aggiornare un catalogo, chiedi all'amministratore di concederti i seguenti ruoli IAM:
-
Tutti:
- BigLake Admin (
roles/biglake.admin) sul progetto - Amministratore Spazio di archiviazione (
roles/storage.admin) sul progetto
- BigLake Admin (
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 Google Cloud console, gcloud o l'
API REST.
Console
Nella Google Cloud console, apri la pagina Lakehouse.
Nella riga del catalogo che vuoi aggiornare, fai clic su Altre azioni del catalogo > Modifica.
In Configurazione del catalogo, modifica le impostazioni che vuoi aggiornare.
Seleziona Salva.
gcloud
Opzione 1: aggiorna le proprietà del catalogo
Per aggiornare le proprietà del catalogo (ad esempio la descrizione o le località con limitazioni),
esegui 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"]
Sostituisci quanto segue:
CATALOG_ID: l'ID del catalogo runtime Lakehouse.PROJECT_ID: l'ID del tuo Google Cloud progetto.DESCRIPTION: (facoltativo) una descrizione del catalogo.CREDENTIAL_MODE: (facoltativo) il metodo di autenticazione. Utilizza