Ao consultar uma visualização do Apache Iceberg, é possível ler resultados selecionados e sem cópia das tabelas do Iceberg subjacentes executando a definição de SQL armazenada no catálogo do ambiente de execução do Lakehouse. Seu Compute Engine carrega a definição da visualização do catálogo, resolve cada tabela referenciada e visualização aninhada e, em seguida, lê os arquivos de dados no Cloud Storage.
Só é possível consultar visualizações do Iceberg em mecanismos de código aberto compatíveis com o Iceberg, como Spark e Trino. O BigQuery não é compatível com a consulta de visualizações do 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
Como o Compute Engine avalia as visualizações no lado do cliente, você precisa de permissões na visualização e em todas as tabelas e visualizações aninhadas que ela referencia.
Para ter as permissões necessárias para consultar uma visualização, peça ao administrador para conceder a você os seguintes papéis do IAM no seu projeto e bucket de armazenamento:
-
Leia a visualização e as tabelas referenciadas no modo de venda de credenciais:
Leitor do BigLake (
roles/biglake.viewer) - seu projeto -
Leia a visualização e as tabelas referenciadas no modo de credenciais do usuário final:
- Leitor do BigLake (
roles/biglake.viewer): seu projeto - Leitor de objetos do Storage (
roles/storage.objectViewer): o bucket do Cloud Storage
- Leitor do BigLake (
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 consultar uma visualização. 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 consultar uma visualização:
-
Consultar uma visualização:
-
biglake.views.getna visualização e em todas as visualizações aninhadas -
biglake.tables.getem cada tabela do Iceberg referenciada pela visualização
-
-
Ler dados da tabela no modo de venda de credenciais:
biglake.tables.getDataem cada tabela do Iceberg referenciada pela visualização -
Ler metadados de visualização e dados de tabela 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.
Consultar uma visualização
Selecione todos os dados de uma visualização:
Spark
SELECT * FROM NAMESPACE_NAME.VIEW_NAME;
Substitua:
NAMESPACE_NAME: o nome do namespace.VIEW_NAME: o nome da visualização.
É possível consultar visualizações que contêm mesclagens, agregações, CTEs e visualizações aninhadas da mesma maneira. Por exemplo, as consultas a seguir usam as visualizações de Criar uma visualização:
SELECT * FROM my_ns.eng_employees ORDER BY emp_id;
SELECT * FROM my_ns.employee_directory ORDER BY id;
SELECT * FROM my_ns.top_eng_employees;
Viagem no tempo e visualizações
Não é possível aplicar uma cláusula de viagem no tempo, como TIMESTAMP AS OF ou
VERSION AS OF, diretamente a um identificador de visualização. Se você precisar de dados históricos,
defina uma visualização com uma definição de SQL que aplique a viagem no tempo à tabela,
ou use uma CTE que consulte a tabela diretamente. Para mais informações,
consulte Criar uma visualização com viagem no tempo em tabelas
subjacentes.
A seguir
- Saiba como conferir os detalhes da visualização.
- Saiba como resolver problemas de visualizações do Iceberg.