Receber detalhes da tabela

A visualização dos detalhes da tabela expõe o esquema subjacente, as propriedades da tabela 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 distribuição de credenciais, os mecanismos de consulta também recuperam credenciais de acesso de curta duração para interagir com segurança com os arquivos subjacentes do Cloud Storage sem exigir permissões de armazenamento do IAM diretas.

É possível inspecionar os detalhes da tabela usando o Google Cloud console, comandos SQL describe no Spark e no Trino ou a especificação da API REST do catálogo do Iceberg 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 Google Cloud projeto.

  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 os 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 personalizados papéis ou outros predefinidos papéis.

Receber detalhes da tabela

Inspecione o esquema e as propriedades da tabela.

Console

  1. No Google Cloud console, 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 , explore 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 para o GetIcebergTable endpoint:

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 distribuição de credenciais, faça uma GET solicitação para o LoadIcebergTableCredentials endpoint:

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

Substitua:

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

A seguir