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
-
Verifica que la facturación esté habilitada para tu proyecto de Google Cloud .
-
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. - Configura el catálogo de tiempo de ejecución de Lakehouse con el extremo del catálogo de REST de Apache Iceberg.
- Revisa las limitaciones de las vistas de Iceberg.
- 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.geten la vista -
Lee los archivos de metadatos de la vista en el modo de credenciales del usuario final:
storage.objects.geten 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?
- Obtén información para consultar una vista.
- Obtén información para modificar una vista.