É 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
-
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 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.getna visualização -
Ler arquivos de metadados de visualização no modo de credenciais do usuário final:
storage.objects.getno 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
- Saiba como consultar uma visualização.
- Saiba como alterar uma visualização.