O catálogo do ambiente de execução do Lakehouse permite excluir tabelas do Apache Iceberg para limpar entradas não utilizadas ou desatualizadas. Essa operação remove o registro e os metadados da tabela, mas não exclui os arquivos de dados subjacentes no Cloud Storage.
É possível excluir uma tabela usando o console do Google Cloud , instruções SQL DROP TABLE
no Apache Spark ou no BigQuery, a
Google Cloud CLI ou a API REST.
Antes de começar
-
Verifique se o faturamento está ativado para o projeto do Google Cloud .
-
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. - 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 como usar as 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 pelo 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. Para mais informações, consulte Configurar opções de tabela.
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
No console do Google Cloud , acesse a página Lakehouse.
Selecione o catálogo que contém a tabela que você quer excluir.
Selecione o namespace que contém a tabela.
Exclua a tabela usando um dos seguintes métodos:
- Na linha da tabela que você quer excluir, clique em Ações > Excluir.
- Clique no nome da tabela e, na barra de ferramentas, clique em Excluir tabela.
Na caixa de diálogo de confirmação, digite
deletee 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 do 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 do Google Cloud.CATALOG_ID: o ID do catálogo.NAMESPACE: o nome do namespace da tabela 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 do 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.