Il catalogo di runtime Lakehouse ti consente di creare spazi dei nomi negli endpoint del catalogo Lakehouse senza confini per raggruppare e organizzare le tabelle correlate.
Quando crei uno spazio dei nomi, puoi facoltativamente associarlo a un bucket Cloud Storage o percorso personalizzato o ereditare la posizione di archiviazione predefinita del catalogo.
Prima di iniziare
- Leggi Informazioni sul catalogo di runtime Lakehouse per capire come funziona il catalogo di runtime Lakehouse e le limitazioni 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.
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, 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.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per creare uno spazio dei nomi, chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto:
-
Tutti:
- BigLake Admin (
roles/biglake.admin) - Storage Admin (
roles/storage.admin)
- 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.
Crea uno spazio dei nomi
Crea uno spazio dei nomi all'interno di un catalogo.
Considerazioni
Quando crei uno spazio dei nomi, puoi facoltativamente specificare un bucket Cloud Storage o un percorso da associare allo spazio dei nomi:
- Catalogo con più bucket (consigliato): puoi impostare qualsiasi località personalizzata, purché si trovi in una località consentita dal catalogo (
default_locationorestricted_locations). Se non specifichi una località, lo spazio dei nomi viene creato nella località predefinita del catalogo (ad esempio,gs://{default_location}/{namespace_name}). Catalogo con bucket singolo: la posizione dello spazio dei nomi viene ereditata automaticamente dal bucket singolo del catalogo.
Console
Nella console Google Cloud , vai alla pagina Lakehouse.
Seleziona un catalogo esistente o creane uno se non ne hai uno.
Nella pagina Dettagli catalogo che si apre, fai clic su Crea spazio dei nomi.
Nella sezione Dettagli spazio dei nomi, configura le seguenti impostazioni:
- Nel campo Nome namespace, inserisci un nome univoco per il tuo namespace.
- (Facoltativo) Nel campo Località, inserisci o cerca un bucket Cloud Storage o un percorso da associare al tuo spazio dei nomi. Per impostazione predefinita, questo campo viene compilato con un percorso nella località predefinita del catalogo. Per un catalogo con più bucket, la posizione deve trovarsi in una posizione del magazzino consentita dal catalogo. Per un catalogo con un singolo bucket, la località viene ereditata automaticamente dal bucket del catalogo.
- (Facoltativo) Nel campo Proprietario, inserisci o aggiorna il proprietario dello spazio dei nomi. Per impostazione predefinita, questo campo viene compilato con il tuo nome utente.
(Facoltativo) Per aggiungere proprietà di metadati personalizzati allo spazio dei nomi, fai clic su Aggiungi proprietà nella sezione Proprietà. Nei campi Chiave e Valore, inserisci una chiave e un valore.
Fai clic su Crea. Lo spazio dei nomi viene creato e visualizzato nella tabella Spazi dei nomi della pagina Dettagli catalogo.
gcloud
Creare uno spazio dei nomi in un catalogo multi-bucket (consigliato)
Per creare uno spazio dei nomi in un catalogo con più bucket (dove puoi facoltativamente specificare una località personalizzata), esegui il comando gcloud biglake iceberg namespaces create con il flag --properties:
gcloud biglake iceberg namespaces create NAMESPACE_NAME \ --project="PROJECT_ID" \ --catalog="CATALOG_ID" \ [--properties="location=LOCATION"]
Sostituisci quanto segue:
NAMESPACE_NAME: un nome per lo spazio dei nomi.PROJECT_ID: il tuo ID progetto Google Cloud .CATALOG_ID: l'ID del tuo catalogo.LOCATION: (facoltativo) un bucket o un percorso Cloud Storage personalizzato da associare allo spazio dei nomi (ad esempio,gs://my-bucket/my-path).
Crea uno spazio dei nomi in un catalogo con un singolo bucket
Per creare uno spazio dei nomi in un catalogo con un singolo bucket, ometti il flag --properties.
La località dello spazio dei nomi viene ereditata automaticamente dal singolo bucket del catalogo.
gcloud biglake iceberg namespaces create NAMESPACE_NAME \ --project="PROJECT_ID" \ --catalog="CATALOG_ID"
REST
Per creare uno spazio dei nomi utilizzando l'API REST, invia una richiesta POST all'endpoint CreateIcebergNamespace:
POST /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces
Il corpo della richiesta deve contenere un payload JSON Iceberg CreateNamespaceRequest che definisce l'identificatore e le proprietà dello spazio dei nomi:
{
"namespace": [
"NAMESPACE_NAME"
],
"properties": {
"location": "LOCATION"
}
}
Sostituisci quanto segue:
PROJECT_ID: il tuo ID progetto Google Cloud .CATALOG_ID: l'ID del tuo catalogo.NAMESPACE_NAME: un nome per lo spazio dei nomi.LOCATION: (facoltativo) un bucket o un percorso Cloud Storage personalizzato da associare allo spazio dei nomi (ad esempiogs://my-bucket/my-path).
Passaggi successivi
- Scopri come gestire gli ACL dello spazio dei nomi.