Consultar uma visualização

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

  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

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

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.get na visualização e em todas as visualizações aninhadas
    • biglake.tables.get em cada tabela do Iceberg referenciada pela visualização
  • Ler dados da tabela no modo de venda de credenciais: biglake.tables.getData em 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.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.

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