Eliminazione di una tabella

L'eliminazione o l'eliminazione di una tabella rimuove solo la registrazione e i metadati della tabella dal catalogo di runtime Lakehouse. I file di dati sottostanti archiviati in Cloud Storage non vengono eliminati o cancellati.

Puoi eliminare una tabella utilizzando la console Google Cloud , i comandi SQL drop in Spark e Trino o l'API REST.

Prima di iniziare

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

  2. Abilita l'API BigLake, se non è già abilitata.

    Ruoli richiesti per abilitare le API

    Per abilitare le API, devi disporre dell'autorizzazione serviceusage.services.enable. Se hai creato il progetto, probabilmente hai già questa autorizzazione tramite il ruolo Proprietario (roles/owner). In caso contrario, puoi ottenere questa autorizzazione tramite il ruolo Amministratore Service Usage (roles/serviceusage.serviceUsageAdmin). Scopri come concedere i ruoli.

    Abilitare l'API

  3. Configura il catalogo di runtime Lakehouse con l'endpoint del catalogo REST Apache Iceberg.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per eliminare una tabella, chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto:

  • Elimina una tabella: Amministratore BigLake (roles/biglake.admin) - il 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.

Funzionalità e supporto delle tabelle

Quando utilizzi le tabelle nel catalogo di runtime di Lakehouse, è utile comprendere i diversi tipi di tabelle e le relative funzionalità di attivazione. Per scoprire di più sull'utilizzo specifico delle tabelle Apache Iceberg, consulta Panoramica delle tabelle Apache Iceberg.

Tabelle Iceberg supportate

Sono supportate solo le tabelle Apache Iceberg V2 (GA) e V3 (anteprima). Le tabelle Iceberg V1 non sono supportate. Per eseguire l'upgrade delle tabelle V1 esistenti, consulta Esegui l'upgrade delle tabelle Iceberg V1 alla versione V2.

Utilizza le opzioni della tabella (anteprima)

Puoi attivare l'utilizzo delle funzionalità gestite di BigQuery, come il linguaggio di manipolazione dei dati (DML) di BigQuery e la gestione automatica delle tabelle, configurando proprietà specifiche delle tabelle. Queste funzionalità vengono attivate in modi diversi a seconda di dove viene creata la tabella:

  • Da BigQuery: BigQuery DML e la gestione automatica delle tabelle sono abilitati per impostazione predefinita.
  • Dai motori open source: per attivare l'opzione, devi configurare esplicitamente le proprietà della tabella. Per saperne di più, consulta Configura le opzioni della tabella.

L'eliminazione di una registrazione della tabella dal catalogo rimuove la tabella, indipendentemente dal fatto che si tratti di una tabella Iceberg standard o di una tabella abilitata per le funzionalità gestite di BigQuery. Consulta Configura le opzioni della tabella per capire in che modo l'eliminazione della tabella interagisce con i job di gestione delle tabelle in background.

Eliminazione di una tabella

Eliminare una tabella.

Console

  1. Nella console Google Cloud , vai a Lakehouse.

    Vai a Lakehouse

  2. Seleziona un catalogo esistente o creane uno se non ne hai uno.

  3. Nella tabella Dettagli spazio dei nomi, seleziona una tabella ed espandi le opzioni del menu.

  4. Fai clic su Elimina.

  5. Conferma l'eliminazione inserendo il nome della tabella nella finestra di dialogo.

  6. Fai clic su Elimina.

Spark 

spark.sql("DROP TABLE TABLE_NAME;")

DROP TABLE TABLE_NAME;

gcloud

Per eliminare una tabella utilizzando gcloud, esegui il comando gcloud biglake iceberg tables delete.

gcloud biglake iceberg tables delete TABLE_NAME \
    --project="PROJECT_ID" \
    --catalog="CATALOG_ID" \
    --namespace="NAMESPACE_NAME"

Sostituisci quanto segue:

  • TABLE_NAME: il nome della tabella Iceberg.
  • PROJECT_ID: il tuo ID progetto Google Cloud .
  • CATALOG_ID: l'ID del tuo catalogo.
  • NAMESPACE_NAME: il nome dello spazio dei nomi del catalogo.

BigQuery

Per eliminare la registrazione di una tabella Apache Iceberg nel catalogo di runtime Lakehouse da BigQuery, utilizza la seguente istruzione GoogleSQL DROP TABLE:

DROP TABLE `PROJECT_ID.CATALOG_ID.NAMESPACE.TABLE_NAME`;

Sostituisci quanto segue:

  • PROJECT_ID: il tuo ID progetto Google Cloud .
  • CATALOG_ID: l'ID del catalogo di runtime Lakehouse.
  • NAMESPACE: il nome dello spazio dei nomi Iceberg.
  • TABLE_NAME: il nome della tabella Iceberg.

REST

Per eliminare la registrazione di una tabella Iceberg utilizzando l'API REST, invia una richiesta DELETE all'endpoint DeleteIcebergTable:

DELETE /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces/NAMESPACE_NAME/tables/TABLE_NAME

Sostituisci quanto segue:

  • PROJECT_ID: il tuo ID progetto Google Cloud .
  • CATALOG_ID: l'ID del tuo catalogo.
  • NAMESPACE_NAME: il nome dello spazio dei nomi del catalogo.
  • TABLE_NAME: il nome della tabella Iceberg.

Passaggi successivi