Obtén detalles de la vista

Puedes inspeccionar el esquema, los comentarios de las columnas, las propiedades y la definición de SQL de una vista de Apache Iceberg registrada en el catálogo de tiempo de ejecución de Lakehouse con Spark o el extremo del catálogo de REST de Apache Iceberg.

Antes de comenzar

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

  2. Habilita la API de BigLake si aún no está habilitada.

    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 de propietario (roles/owner). De lo contrario, puedes obtenerlo a través del rol de administrador de Service Usage (roles/serviceusage.serviceUsageAdmin). 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 de REST de Apache Iceberg.
  4. Revisa las limitaciones de las vistas de Iceberg.
  5. Crea una vista.

Roles obligatorios

Para obtener los permisos que necesitas para ver los detalles, pídele a tu administrador que te otorgue los siguientes roles de IAM en tu proyecto y bucket de almacenamiento:

  • Obtener detalles de la vista: Visualizador de BigLake (roles/biglake.viewer): tu proyecto
  • Lee los archivos de metadatos de la vista en el modo de credenciales del usuario final: Visualizador de objetos de almacenamiento (roles/storage.objectViewer): el bucket de Cloud Storage

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

Estos roles predefinidos contienen los permisos necesarios para obtener los detalles de la vista. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para obtener los detalles de la vista:

  • Obtén detalles de la vista: biglake.views.get en la vista
  • Lee los archivos de metadatos de la vista en el modo de credenciales del usuario final: storage.objects.get en el bucket de Cloud Storage

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Para obtener una lista completa de los permisos de lectura, consulta Roles y permisos necesarios.

Obtén detalles de la vista

Inspecciona una vista.

Spark

Muestra el esquema de la vista, los comentarios de las columnas y las propiedades de la vista:

DESCRIBE EXTENDED NAMESPACE_NAME.VIEW_NAME;

Muestra la instrucción de SQL que define la vista:

SHOW CREATE TABLE NAMESPACE_NAME.VIEW_NAME;

Mostrar solo las propiedades de la vista:

SHOW TBLPROPERTIES NAMESPACE_NAME.VIEW_NAME;

Reemplaza lo siguiente:

  • NAMESPACE_NAME: Es el nombre de tu espacio de nombres.
  • VIEW_NAME: Es el nombre de tu vista.

REST

Para cargar los metadatos actuales de una vista con la API de REST, realiza una solicitud GET al extremo GetIcebergView:

GET /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces/NAMESPACE_NAME/views/VIEW_NAME

La respuesta contiene el metadata-location y el metadata de la vista.

Para verificar si existe una vista sin cargar sus metadatos, realiza una solicitud HEAD a la misma ruta de acceso. El extremo CheckIcebergViewExists devuelve 204 No Content si la vista existe o 404 Not Found si no existe.

Reemplaza lo siguiente:

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

¿Qué sigue?