Listar tabelas

Ao listar tabelas, é possível conferir todas as entidades de tabela registradas em um namespace no catálogo de tempo de execução do Lakehouse.

Os mecanismos de consulta podem listar tabelas usando comandos SQL padrão, e os clientes REST podem recuperar identificadores de tabela diretamente pela especificação da API Iceberg REST Catalog de código aberto (GET /v1/{prefix}/namespaces/{namespace}/tables).

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 listar tabelas, 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.

Listar tabelas

Listar tabelas.

Console

  1. No console Google Cloud , acesse Lakehouse.

    Acessar o Lakehouse

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

Suas tabelas aparecem na página Detalhes do namespace.

Spark 

spark.sql("SHOW TABLES").show()

Trino 

SHOW TABLES;

REST

Para listar identificadores de tabela em um namespace usando a API REST, faça uma solicitação GET ao endpoint ListIcebergTableIdentifiers:

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

A resposta contém uma matriz JSON de identificadores de tabela registrados no namespace especificado.

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.

A seguir