Gestisci i cataloghi nella console Google Cloud

L'endpoint del catalogo REST di Apache Iceberg nel catalogo del runtime di Lakehouse crea interoperabilità tra i motori di query offrendo un'unica fonte di verità per Google Cloud Lakehouse.

Questo documento descrive le azioni di gestione del catalogo REST di Apache Iceberg che possono essere eseguite nella Google Cloud console.

Prima di iniziare

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

  2. Abilita l'API BigLake.

    Ruoli richiesti per abilitare le API

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

    Abilitare l'API

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per utilizzare il catalogo del runtime di Lakehouse nella Google Cloud console, chiedi all'amministratore di concederti i seguenti ruoli IAM sul tuo progetto:

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 un catalogo

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

    Vai a Google Cloud Lakehouse

  2. Fai clic su Crea catalogo. Viene visualizzata la pagina Crea catalogo.

  3. In Seleziona un bucket Cloud Storage, inserisci il nome del bucket Cloud Storage da utilizzare con il catalogo. In alternativa, fai clic su Sfoglia per scegliere da un elenco di bucket esistenti o per crearne uno nuovo. Puoi avere un solo catalogo per bucket Cloud Storage.

  4. In Metodo di autenticazione, seleziona Credenziali utente finale o Modalità di distribuzione delle credenziali.

  5. Fai clic su Crea.

    Il catalogo viene creato e viene visualizzata la pagina Dettagli catalogo.

  6. In Metodo di autenticazione, fai clic su Imposta autorizzazioni bucket.

  7. Nella finestra di dialogo, fai clic su Conferma.

    In questo modo verifichi che il account di servizio del catalogo abbia il ruolo Utente oggetti Storage sul bucket di archiviazione.

Attiva la distribuzione delle credenziali

Se il metodo di autenticazione per il catalogo è impostato su credenziali utente finale, puoi passare alla modalità di distribuzione delle credenziali.

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

    Vai a Google Cloud Lakehouse

  2. Nella riga del catalogo che stai aggiornando, fai clic su Altre azioni del catalogo > Modifica autenticazione.

  3. Nella finestra di dialogo di autenticazione, seleziona Modalità di distribuzione delle credenziali.

  4. Fai clic su Salva.

    Il catalogo viene aggiornato e viene visualizzata la pagina Dettagli catalogo.

  5. In Metodo di autenticazione, fai clic su Imposta autorizzazioni bucket.

  6. Nella finestra di dialogo, fai clic su Conferma.

    In questo modo verifichi che il account di servizio del catalogo abbia il ruolo Utente oggetti Storage sul bucket di archiviazione.

Visualizza i dettagli del catalogo

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

    Vai a Google Cloud Lakehouse

  2. Fai clic sul nome di un catalogo.

  3. Nella pagina Dettagli catalogo, esplora le informazioni sul catalogo, come ID catalogo, timestamp di creazione, URI del catalogo REST, metodo di autenticazione e account di servizio.

Importa tabelle

Puoi importare i dati dai cataloghi REST di Apache Iceberg (IRC) esterni direttamente nelle tabelle di Google Cloud Lakehouse utilizzando l'interfaccia utente del builder di job di Dataflow. Per saperne di più, consulta Importare tabelle Iceberg esterne in Dataflow.

Elimina un catalogo

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

    Vai a Google Cloud Lakehouse

  2. Nella riga del catalogo che stai eliminando, fai clic su Altre azioni del catalogo > Elimina.

  3. Nella finestra di dialogo di eliminazione, inserisci DELETE e fai clic su Elimina.

Visualizza audit log

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

    Vai a Google Cloud Lakehouse

  2. Nella riga del catalogo che stai visualizzando, fai clic su Altre azioni del catalogo > Visualizza audit log.

Prezzi

Per i dettagli sui prezzi, consulta Prezzi di Google Cloud Lakehouse.

Passaggi successivi

Scopri di più sull'endpoint del catalogo REST di Apache Iceberg.