Consultar una vista de Apache Iceberg te permite leer resultados seleccionados sin copias de las tablas de Iceberg subyacentes ejecutando la definición de SQL almacenada en el catálogo de tiempo de ejecución de Lakehouse. Tu motor de procesamiento carga la definición de la vista desde el catálogo, resuelve cada tabla a la que se hace referencia y la vista anidada, y, luego, lee los archivos de datos en Cloud Storage.
Solo puedes consultar vistas de Iceberg desde motores de código abierto compatibles con Iceberg, como Spark y Trino. BigQuery no admite la consulta de vistas de 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
Debido a que tu motor de procesamiento evalúa las vistas del cliente, necesitas permisos en la vista y en cada tabla y vista anidada a la que hace referencia la vista.
Para obtener los permisos que necesitas para consultar una vista, pídele a tu administrador que te otorgue los siguientes roles de IAM en tu proyecto y bucket de almacenamiento:
-
Lee la vista y las tablas a las que se hace referencia en el modo de entrega de credenciales:
Visualizador de BigLake (
roles/biglake.viewer): tu proyecto -
Lee la vista y las tablas de referencia en el modo de credenciales del usuario final:
- Visualizador de BigLake (
roles/biglake.viewer): tu proyecto - Visualizador de objetos de Storage (
roles/storage.objectViewer): el bucket de Cloud Storage
- Visualizador de BigLake (
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 consultar una vista. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:
Permisos necesarios
Se requieren los siguientes permisos para consultar una vista:
-
Consulta una vista:
-
biglake.views.geten la vista y en cualquier vista anidada -
biglake.tables.geten cada tabla de Iceberg a la que hace referencia la vista
-
-
Lee los datos de la tabla en el modo de entrega de credenciales:
biglake.tables.getDataen cada tabla de Iceberg a la que hace referencia la vista -
Lee los metadatos de la vista y los datos de la tabla 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.
Consulta una vista
Selecciona todos los datos de una vista:
Spark
SELECT * FROM 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.
Puedes consultar vistas que contengan uniones, agregaciones, CTEs y vistas anidadas de la misma manera. Por ejemplo, en las siguientes consultas, se usan las vistas de Crea una vista:
SELECT * FROM my_ns.eng_employees ORDER BY emp_id;
SELECT * FROM my_ns.employee_directory ORDER BY id;
SELECT * FROM my_ns.top_eng_employees;
Viaje en el tiempo y vistas
No puedes aplicar una cláusula de viaje en el tiempo, como TIMESTAMP AS OF o
VERSION AS OF, directamente a un identificador de vista. Si necesitas datos históricos,
define una vista cuya definición de SQL aplique el viaje en el tiempo a la tabla subyacente
o usa una CTE que consulte la tabla subyacente directamente. Para obtener más información,
consulta Crea una vista con viaje en el tiempo en tablas
subyacentes.
¿Qué sigue?
- Obtén información para obtener detalles de las vistas.
- Obtén más información para solucionar problemas de las vistas de Iceberg.