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 DESCRIBE do SQL no Spark e no Trino ou a API REST.

Antes de começar

  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 a permissão serviceusage.services.enable. Se você criou o projeto, provavelmente já tem essa permissão pelo papel Proprietário (roles/owner). Caso contrário, é possível receber essa permissão pelo papel Administrador de uso do serviço (roles/serviceusage.serviceUsageAdmin). Saiba como conceder papéis.

    Ativar a API

  3. Configure o catálogo de 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 os detalhes da tabela, peça que o administrador conceda 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 com papéis personalizados ou outros papéis predefinidos.

Recursos e suporte da tabela

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

Tabelas do Iceberg com suporte

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

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 atual 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()

Para ativar a interoperabilidade de leitura/gravação e o gerenciamento de tabelas (pré-lançamento), 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é-lançamento), adicione essas 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 tabela do Iceberg.
  • PROJECT_ID: o ID do Google Cloud projeto.
  • CATALOG_ID: o ID do catálogo.
  • NAMESPACE_NAME: o nome do namespace do catálogo.

BigQuery

Para visualizar os detalhes da tabela e as propriedades de metadados de uma tabela do Apache Iceberg no catálogo de ambiente de execução do Lakehouse no 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 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