Receber detalhes da tabela

Ao visualizar os detalhes da tabela, você expõe o esquema, as propriedades e os metadados de configuração de uma tabela do Apache Iceberg no catálogo de ambiente de execução do Lakehouse.

No modo de venda de credenciais, os mecanismos de consulta também recuperam credenciais de acesso de curta duração para interagir com segurança com os arquivos do Cloud Storage subjacentes sem exigir permissões diretas de armazenamento do IAM.

É possível inspecionar os detalhes da tabela usando o console Google Cloud , comandos SQL describe no Spark e no Trino ou a especificação da API Iceberg REST Catalog de código aberto.

Antes de começar

Consulte a visão geral da tabela para entender os diferentes tipos de tabelas e as implicações do uso delas.

  1. Verifique se o faturamento está ativado para o projeto do Google Cloud .

  2. Ative a API BigLake.

    Funções necessárias para ativar APIs

    Para ativar as APIs, é necessário ter o papel do IAM de administrador de uso do serviço (roles/serviceusage.serviceUsageAdmin), que contém a permissão serviceusage.services.enable. Saiba como conceder papéis.

    Ativar a API

Funções exigidas

Para receber as permissões necessárias para visualizar detalhes da tabela, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto:

  • Todos: 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.

Também é possível conseguir as permissões necessárias usando papéis personalizados ou outros papéis predefinidos.

Receber detalhes da tabela

Inspecione o esquema e as propriedades da tabela.

Console

  1. No console Google Cloud , acesse Lakehouse.

    Acessar o Lakehouse

  2. Selecione um catálogo ou crie um se você não tiver.

  3. Na tabela Detalhes do namespace, clique no nome da tabela que você quer inspecionar.

  4. Na página Detalhes da tabela, analise o esquema, a especificação de partição e as propriedades de metadados da tabela.

Spark 

spark.sql("DESCRIBE EXTENDED NAMESPACE_NAME.TABLE_NAME").show()

Trino 

DESCRIBE SCHEMA_NAME.TABLE_NAME;

REST

Para recuperar metadados da tabela usando a API REST, faça uma solicitação GET ao endpoint GetIcebergTable:

GET /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces/NAMESPACE_NAME/tables/TABLE_NAME

Para carregar credenciais de tabela de curta duração no modo de fornecimento de credenciais, faça uma solicitação GET ao endpoint LoadIcebergTableCredentials:

GET /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces/NAMESPACE_NAME/tables/TABLE_NAME/credentials

Substitua:

  • PROJECT_ID: o ID do projeto Google Cloud .
  • CATALOG_ID: o ID do catálogo do ambiente de execução do Lakehouse.
  • NAMESPACE_NAME: o nome do namespace do catálogo.
  • TABLE_NAME: o nome da sua tabela Iceberg.

A seguir