Obtén detalles de la tabla

Ver los detalles de la tabla expone el esquema subyacente, las propiedades de la tabla y los metadatos de configuración de una tabla de Apache Iceberg en el catálogo de entornos de ejecución de Lakehouse.

En el modo de venta de credenciales, los motores de consultas también recuperan credenciales de acceso de corta duración para interactuar de forma segura con los archivos subyacentes de Cloud Storage sin requerir permisos de almacenamiento directos de IAM.

Puedes inspeccionar los detalles de la tabla con la consola de Google Cloud , los comandos de SQL DESCRIBE en Spark y Trino, o la API de REST.

Antes de comenzar

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

  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 entornos de ejecución de Lakehouse con el extremo del catálogo de REST de Apache Iceberg.

Roles obligatorios

Para obtener los permisos que necesitas y ver los detalles de la tabla, 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.

Funciones y asistencia de tablas

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

Tablas de Iceberg compatibles

Solo se admiten las tablas de Apache Iceberg V2 (GA) y V3 (versión preliminar). No se admiten las tablas de Iceberg V1. Para actualizar las tablas de la versión 1 existentes, consulta Actualiza las tablas de Iceberg de la versión 1 a la versión 2.

Obtén detalles de la tabla

Inspecciona el esquema y las propiedades de la tabla.

Console

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

    Ir a Lakehouse

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

  3. En la tabla Detalles del espacio de nombres, haz clic en el nombre de la tabla que deseas inspeccionar.

  4. En la página Detalles de la tabla, explora el esquema, la especificación de partición y las propiedades de metadatos de la tabla.

Spark 

spark.sql("DESCRIBE EXTENDED NAMESPACE_NAME.TABLE_NAME").show()

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

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

Trino 

DESCRIBE SCHEMA_NAME.TABLE_NAME;

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

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

gcloud

Para describir una tabla con gcloud, ejecuta el comando gcloud biglake iceberg tables describe.

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

Reemplaza lo siguiente:

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

BigQuery

Para ver los detalles de la tabla y las propiedades de metadatos de una tabla de Apache Iceberg en el catálogo del entorno de ejecución de Lakehouse desde BigQuery, puedes examinar los detalles de la tabla en la consola de BigQuery o usar el comando bq show.

REST

Para recuperar los metadatos de la tabla con la API de REST, realiza una solicitud GET al extremo GetIcebergTable:

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

Para cargar credenciales de tabla de corta duración en el modo de venta de credenciales, realiza una solicitud GET al extremo LoadIcebergTableCredentials:

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

Reemplaza lo siguiente:

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

¿Qué sigue?