Exclua uma visualização

A exclusão de uma visualização do Apache Iceberg permite remover uma visualização que você não precisa mais do catálogo do ambiente de execução do Lakehouse. A exclusão de uma visualização remove o registro dela e limpa a política do Identity and Access Management (IAM) da visualização, mas não afeta as tabelas do Iceberg subjacentes nem os dados delas.

Não é possível excluir um namespace que ainda contém visualizações. Remova todas as visualizações em um namespace antes de excluir o namespace.

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.
  4. Analise as limitações das visualizações do Iceberg.

Funções exigidas

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

  • Excluir uma visualização: Editor do BigLake (roles/biglake.editor) - seu projeto

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

Esses papéis predefinidos contêm as permissões necessárias para excluir uma visualização. Para acessar as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As permissões a seguir são necessárias para excluir uma visualização:

  • Para excluir uma visualização: biglake.views.delete nela

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Para uma lista completa de permissões de leitura, consulte Papéis e permissões necessários.

Exclua uma visualização

Exclua uma visualização.

Spark

DROP VIEW NAMESPACE_NAME.VIEW_NAME;

Para evitar um erro se a visualização não existir, use DROP VIEW IF EXISTS:

DROP VIEW IF EXISTS NAMESPACE_NAME.VIEW_NAME;

Substitua:

  • NAMESPACE_NAME: o nome do namespace.
  • VIEW_NAME: o nome da visualização.

REST

Para excluir uma visualização usando a API REST, faça uma solicitação DELETE ao endpoint DeleteIcebergView:

DELETE /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces/NAMESPACE_NAME/views/VIEW_NAME

Uma solicitação bem-sucedida retorna 204 No Content.

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.
  • VIEW_NAME: o nome da visualização.

A seguir