Excluir uma tabela

A exclusão ou remoção de uma tabela só remove o registro e os metadados da tabela do catálogo de 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 Google Cloud console, comandos SQL drop no Spark e no Trino ou a especificação da API do catálogo REST do Iceberg de código aberto (DELETE /v1/{prefix}/namespaces/{namespace}/tables/{table}).

Antes de começar

Consulte a visão geral da tabela para entender os diferentes tipos de tabelas e as implicações do uso delas.

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

  2. Ative a API BigLake.

    Funções necessárias para ativar APIs

    Para ativar as APIs, é necessário ter o papel do IAM de administrador de uso do serviço (roles/serviceusage.serviceUsageAdmin), que contém a permissão serviceusage.services.enable. Saiba como conceder papéis.

    Ativar a API

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:

  • Todos: 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 personalizados papéis ou outros predefinidos papéis.

Excluir uma tabela

Excluir uma tabela.

Console

  1. No Google Cloud console, acesse Lakehouse.

    Acessar o Lakehouse

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

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

  4. Clique em Excluir.

  5. Confirme a exclusão inserindo o nome da tabela na caixa de diálogo.

  6. Clique em Excluir.

Spark 

spark.sql("DROP TABLE TABLE_NAME;")

Trino 

DROP TABLE TABLE_NAME;

REST

Para excluir um registro de tabela do Iceberg usando a API REST, faça uma solicitação DELETE para o 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 Google Cloud projeto.
  • CATALOG_ID: o ID do catálogo de ambiente de execução do Lakehouse.
  • NAMESPACE_NAME: o nome do namespace do catálogo.
  • TABLE_NAME: o nome da tabela do Iceberg.

A seguir