Visualizações em lista

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

  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.
  5. 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.list no 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