Excluir uma tabela

Excluir ou remover uma tabela só remove o registro e os metadados dela do catálogo do ambiente de execução do Lakehouse. Os arquivos de dados subjacentes armazenados no Cloud Storage não são limpos nem excluídos.

É possível excluir uma tabela usando o console do Google Cloud , comandos de descarte de SQL no Spark e no Trino ou a API REST.

Antes de começar

  1. Verifique se o faturamento está ativado para o projeto do Google Cloud .

  2. Ative a API BigLake, se ainda não tiver feito isso.

    Funções necessárias para ativar APIs

    Para ativar APIs, você precisa da permissão serviceusage.services.enable. Se você criou o projeto, provavelmente já tem essa permissão pelo papel de proprietário (roles/owner). Caso contrário, é possível conseguir essa permissão pelo papel de administrador do Service Usage (roles/serviceusage.serviceUsageAdmin). Saiba como conceder papéis.

    Ativar a API

  3. Configure o catálogo do ambiente de execução do Lakehouse com o endpoint do catálogo REST do Apache Iceberg.

Funções exigidas

Para receber as permissões necessárias para excluir uma tabela, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto:

  • Excluir uma tabela: Administrador do BigLake (roles/biglake.admin) - seu projeto

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias usando papéis personalizados ou outros papéis predefinidos.

Recursos e suporte de tabelas

Ao usar tabelas no catálogo do ambiente de execução do Lakehouse, é útil entender os diferentes tipos de tabela e os recursos de ativação deles. Para saber mais sobre o uso de tabelas do Apache Iceberg, consulte Visão geral das tabelas do Apache Iceberg.

Tabelas do Iceberg compatíveis

Somente as tabelas Apache Iceberg V2 (GA) e V3 (pré-lançamento) são compatíveis. As tabelas do Iceberg V1 não são compatíveis. Para fazer upgrade das tabelas V1 atuais, consulte Fazer upgrade das tabelas do Iceberg V1 para V2.

Usar opções de tabela (pré-lançamento)

É possível ativar o uso de recursos gerenciados do BigQuery, como a linguagem de manipulação de dados (DML) do BigQuery e o gerenciamento automático de tabelas, configurando propriedades de tabela específicas. Esses recursos são ativados de maneiras diferentes, dependendo de onde a tabela é criada:

  • Do BigQuery:a DML do BigQuery e o gerenciamento automático de tabelas são ativados por padrão.
  • De mecanismos de código aberto:para ativar, é preciso configurar explicitamente as propriedades da tabela. Consulte Configurar opções de tabela para mais informações.

A exclusão de um registro de tabela do catálogo remove a tabela, seja ela uma tabela padrão do Iceberg ou uma tabela ativada para recursos gerenciados do BigQuery. Consulte Configurar opções de tabela para entender como a exclusão de tabelas interage com jobs de gerenciamento de tabelas em segundo plano.

Excluir uma tabela

Excluir uma tabela.

Console

  1. No console do Google Cloud , acesse Lakehouse.

    Acessar o Lakehouse

  2. Selecione um catálogo ou crie um, se ainda não tiver.

  3. Na tabela Detalhes do namespace, selecione uma tabela e expanda as opções do menu.

  4. Clique em Excluir.

  5. Para confirmar a exclusão, digite o nome da tabela na caixa de diálogo.

  6. Clique em Excluir.

Spark 

spark.sql("DROP TABLE TABLE_NAME;")

DROP TABLE TABLE_NAME;

gcloud

Para excluir uma tabela usando gcloud, execute o comando gcloud biglake iceberg tables delete.

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

Substitua:

  • TABLE_NAME: o nome da tabela do Iceberg.
  • PROJECT_ID: o ID do projeto Google Cloud .
  • CATALOG_ID: o ID do catálogo.
  • NAMESPACE_NAME: o nome do namespace do catálogo.

BigQuery

Para excluir um registro de tabela do Apache Iceberg no catálogo do ambiente de execução do Lakehouse do BigQuery, use a seguinte instrução DROP TABLE do GoogleSQL:

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

Substitua:

  • PROJECT_ID: o ID do projeto Google Cloud .
  • CATALOG_ID: o ID do catálogo do ambiente de execução do Lakehouse.
  • NAMESPACE: o nome do namespace do Iceberg.
  • TABLE_NAME: o nome da tabela do Iceberg.

REST

Para excluir um registro de tabela do Iceberg usando a API REST, faça uma solicitação DELETE ao endpoint DeleteIcebergTable:

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

Substitua:

  • PROJECT_ID: o ID do projeto Google Cloud .
  • CATALOG_ID: o ID do catálogo.
  • NAMESPACE_NAME: o nome do namespace do catálogo.
  • TABLE_NAME: o nome da tabela do Iceberg.

A seguir