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 para 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 necesidad de permisos de almacenamiento directos de IAM.

Puedes inspeccionar los detalles de la tabla con la Google Cloud consola, los comandos SQL describe en Spark y Trino, o la especificación de la API de REST de Iceberg Catalog de código abierto.

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 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.

Obtén detalles de la tabla

Inspecciona el esquema y las propiedades de la tabla.

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.

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

Trino 

DESCRIBE SCHEMA_NAME.TABLE_NAME;

REST

Para recuperar 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 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 del catálogo.
  • TABLE_NAME: Es el nombre de tu tabla de Iceberg.

¿Qué sigue?