Gerar visualizações

É possível inspecionar o esquema, os comentários de coluna, as propriedades e a definição de SQL de uma visualização do Apache Iceberg registrada no catálogo do ambiente de execução do Lakehouse usando o Spark ou o endpoint do catálogo REST do Apache Iceberg.

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 ter as permissões necessárias para gerar visualizações, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto e no bucket de armazenamento:

  • Acessar detalhes da visualização: Leitor do BigLake (roles/biglake.viewer) - seu projeto
  • Ler arquivos de metadados de visualização no modo de credenciais do usuário final: Leitor de objetos do Storage (roles/storage.objectViewer): o bucket do Cloud Storage

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 gerar visualizações. 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 gerar visualizações:

  • Receber detalhes da visualização: biglake.views.get na visualização
  • Ler arquivos de metadados de visualização no modo de credenciais do usuário final: storage.objects.get no bucket do Cloud Storage

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.

Gerar visualizações

Inspecionar uma visualização.

Spark

Mostre o esquema de visualização, os comentários da coluna e as propriedades de visualização:

DESCRIBE EXTENDED NAMESPACE_NAME.VIEW_NAME;

Mostre a instrução SQL que define a visualização:

SHOW CREATE TABLE NAMESPACE_NAME.VIEW_NAME;

Mostre apenas as propriedades de visualização:

SHOW TBLPROPERTIES NAMESPACE_NAME.VIEW_NAME;

Substitua:

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

REST

Para carregar os metadados atuais de uma visualização usando a API REST, faça uma solicitação GET para o endpoint GetIcebergView:

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

A resposta contém o metadata-location e o metadata da visualização.

Para verificar se uma visualização existe sem carregar os metadados dela, faça uma solicitação HEAD para o mesmo caminho. O endpoint CheckIcebergViewExists retorna 204 No Content se a visualização existir ou 404 Not Found se não existir.

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