Mostrar tablas

Enumerar tablas te permite ver todas las entidades de tabla registradas dentro de un espacio de nombres en el catálogo del entorno de ejecución de Lakehouse.

Los motores de consultas pueden enumerar tablas con comandos estándar de SQL, y los clientes de REST pueden recuperar identificadores de tablas directamente a través de la especificación de la API de REST Catalog de Iceberg de código abierto (GET /v1/{prefix}/namespaces/{namespace}/tables).

Antes de comenzar

Consulta la descripción general de la tabla para comprender los diferentes tipos de tablas y las implicaciones de usarlas.

  1. Verifica que la facturación esté habilitada para tu Google Cloud proyecto.

  2. Habilita la API de BigLake.

    Roles necesarios para habilitar las APIs

    Para habilitar las APIs, necesitas el rol de IAM de administrador de Service Usage (roles/serviceusage.serviceUsageAdmin), que contiene el permiso serviceusage.services.enable. Obtén más información para otorgar roles.

    Habilitar la API

Roles obligatorios

Para obtener los permisos que necesitas para enumerar tablas, pídele a tu administrador que te otorgue los siguientes roles de IAM en tu proyecto:

  • Todos: Visualizador de BigLake (roles/biglake.viewer) - tu proyecto

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Enumerar tablas

Enumera las tablas.

Console

  1. En la Google Cloud consola de, ve a Lakehouse.

    Ir a Lakehouse

  2. Selecciona un catálogo existente o crea uno si no tienes.

Tus tablas aparecen en la página Detalles del espacio de nombres.

Spark 

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

Trino 

SHOW TABLES;

REST

Para enumerar los identificadores de tablas dentro de un espacio de nombres con la API de REST, realiza una solicitud GET al extremo ListIcebergTableIdentifiers:

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

La respuesta contiene un array JSON de identificadores de tablas registrados en el espacio de nombres especificado.

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del Google Cloud proyecto.
  • CATALOG_ID: Es el ID de tu catálogo del entorno de ejecución de Lakehouse.
  • NAMESPACE_NAME: Es el nombre del espacio de nombres de tu catálogo.

¿Qué sigue?