Mostrar tablas

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

Los motores de consultas pueden enumerar tablas con comandos estándar de SQL, y puedes recuperar identificadores de tablas con la API de REST.

Antes de comenzar

  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

  3. Configura el catálogo de tiempo de ejecución de Lakehouse con el extremo del catálogo REST de Apache Iceberg.

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 mediante roles personalizados o cualquier otro rol predefinido.

Capacidades y compatibilidad de tablas

Cuando usas tablas en el catálogo de tiempo de ejecución de Lakehouse, es útil comprender los diferentes tipos de tablas y sus capacidades de inclusión. Para obtener más información sobre el uso de tablas de Apache Iceberg específicamente, consulta Descripción general de las tablas de Apache Iceberg.

Tablas de Iceberg compatibles

Solo se admiten las tablas de Apache Iceberg V2 (DG) y V3 (vista previa). No se admiten las tablas de Iceberg V1. Para actualizar las tablas V1 existentes, consulta Actualiza las tablas de Iceberg V1 a V2.

Enumerar tablas

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

Para habilitar la interoperabilidad de lectura/escritura y la administración de tablas (vista previa), agrega las propiedades a la cláusula TBLPROPERTIES:

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

Trino 

SHOW TABLES;

Para habilitar la interoperabilidad de lectura/escritura y la administración de tablas (vista previa), agrega estas propiedades a la WITH cláusula:

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

gcloud

Para enumerar tablas con gcloud, ejecuta el gcloud biglake iceberg tables list comando.

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

Reemplaza lo siguiente:

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

BigQuery

Para enumerar las tablas de Apache Iceberg en el catálogo de tiempo de ejecución de Lakehouse desde BigQuery, puedes explorar el panel Explorador en la consola de BigQuery o usar el comando bq ls.

REST

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

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 de.
  • CATALOG_ID: Es el ID de tu catálogo.
  • NAMESPACE_NAME: Es el nombre del espacio de nombres de tu catálogo.

¿Qué sigue?