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 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 API REST.

Antes de começar

  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

  3. Configure o catálogo do ambiente de execução do Lakehouse com o endpoint do catálogo REST do Apache Iceberg.

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.

Recursos e suporte de tabelas

Ao usar tabelas no catálogo de tempo de execução do lakehouse, é útil entender os diferentes tipos de tabelas e os recursos de ativação. Para saber mais sobre o uso de tabelas do Apache Iceberg, consulte Visão geral das tabelas do Apache Iceberg.

Tabelas do Iceberg compatíveis

Somente tabelas do Apache Iceberg V2 (GA) e V3 (pré-lançamento) são compatíveis. Não há suporte para tabelas do Iceberg V1. Para fazer upgrade das tabelas V1 atuais, consulte Fazer upgrade das tabelas Iceberg V1 para V2.

Receber detalhes da tabela

Inspecione o esquema e as propriedades da tabela.

Console

  1. No console Google Cloud , acesse Lakehouse.

    Acessar Lakehouse

  2. Selecione um catálogo ou crie um se você ainda 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()

Para ativar a interoperabilidade de leitura/gravação e o gerenciamento de tabelas (prévia), adicione as propriedades à cláusula TBLPROPERTIES:

TBLPROPERTIES (
  'gcp.biglake.bigquery-dml.enabled' = true,
  'gcp.biglake.table-management.enabled' = true
)

Trino 

DESCRIBE SCHEMA_NAME.TABLE_NAME;

Para ativar a interoperabilidade de leitura/gravação e o gerenciamento de tabelas (prévia), adicione estas propriedades à cláusula WITH:

WITH (
  "gcp.biglake.bigquery-dml.enabled" = 'true',
  "gcp.biglake.table-management.enabled" = 'true'
)

gcloud

Para descrever uma tabela usando gcloud, execute o comando gcloud biglake iceberg tables describe.

gcloud biglake iceberg tables describe TABLE_NAME \
    --project="PROJECT_ID" \
    --catalog="CATALOG_ID" \
    --namespace="NAMESPACE_NAME"

Substitua:

  • TABLE_NAME: o nome da sua tabela Iceberg.
  • PROJECT_ID: o ID do projeto Google Cloud .
  • CATALOG_ID: o ID do seu catálogo.
  • NAMESPACE_NAME: o nome do namespace do catálogo.

BigQuery

Para conferir os detalhes e as propriedades de metadados de uma tabela do Apache Iceberg no catálogo de tempo de execução do Lakehouse do BigQuery, examine os detalhes da tabela no console do BigQuery ou use o comando bq show.

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