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 del entorno 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 de IAM directos.

Puedes inspeccionar los detalles de la tabla con la Google Cloud consola de, los DESCRIBE comandos de SQL en Spark y Trino, o 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 permiso serviceusage.services.enable. Si creaste el proyecto, es probable que ya tengas este permiso a través del rol Propietario (roles/owner). De lo contrario, puedes obtener este permiso a través del rol Administrador de Service Usage (roles/serviceusage.serviceUsageAdmin). Obtén información para otorgar roles.

   Habilitar la API

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

Roles obligatorios

Para obtener los permisos que necesitas para 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 mediante roles personalizados o cualquier otro rol predefinido.

Funciones y compatibilidad de tablas

Cuando usas tablas en el catálogo del entorno de ejecución de Lakehouse, es útil comprender los diferentes tipos de tablas y sus capacidades de participació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.

Obtén detalles de la tabla

Inspecciona el esquema y las propiedades de la tabla.

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

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

DESCRIBE SCHEMA_NAME.TABLE_NAME;

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

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

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

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

¿Qué sigue?

• Aprende a consultar una tabla.
• Aprende a modificar una tabla.