As visualizações em lista permitem ver quais visualizações do Apache Iceberg estão registradas em um namespace do catálogo do ambiente de execução do Lakehouse. O resultado contém apenas identificadores de visualização. As tabelas são excluídas, e a listagem de tabelas também exclui as visualizações.
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.
- Analise as limitações das visualizações do Iceberg.
- Criar uma visualização.
Funções exigidas
Para receber as permissões necessárias para listar visualizações em lista, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto:
-
Visualizações em lista:
Leitor do BigLake (
roles/biglake.viewer) - 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 listar visualizações em lista. Para acessar as permissões exatas necessárias, expanda a seção Permissões necessárias:
Permissões necessárias
As seguintes permissões são necessárias para listar visualizações em lista:
-
Visualizações em lista:
biglake.views.listno namespace
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.
Visualizações em lista
Liste as visualizações em um namespace.
Spark
SHOW VIEWS IN NAMESPACE_NAME;
Substitua NAMESPACE_NAME pelo nome do
namespace.
REST
Para listar visualizações em lista usando a API REST, faça uma solicitação GET ao
endpoint ListIcebergViewIdentifiers:
GET /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces/NAMESPACE_NAME/views
O endpoint é compatível com os parâmetros de consulta pageToken e pageSize.
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.
A seguir
- Saiba como conferir os detalhes da visualização.
- Saiba como consultar uma visualização.