Soluciona problemas de las vistas de Apache Iceberg

Cuando creas, consultas, modificas o borras vistas de Apache Iceberg en el catálogo de tiempo de ejecución de Lakehouse, es posible que encuentres errores, como conflictos de nombres con tablas, denegaciones de acceso, viajes en el tiempo en una vista, instantáneas vencidas, tipos de catálogos no admitidos o una ubicación de vista inmutable. Este documento te ayuda a identificar la causa de estos errores comunes y a resolverlos. Para problemas generales del catálogo, consulta Solución de problemas.

409 Conflict o AlreadyExistsException cuando se crea o reemplaza una vista o tabla

Las tablas y las vistas comparten el mismo espacio de nombres de identificador dentro de un espacio de nombres de catálogo, y el catálogo bloquea los reemplazos de tipos cruzados. No puedes crear una vista con el mismo nombre que una tabla existente ni una tabla con el mismo nombre que una vista existente.

Para encontrar la colisión de nombres, enumera las tablas y las vistas en el espacio de nombres:

SHOW TABLES IN NAMESPACE_NAME;
SHOW VIEWS IN NAMESPACE_NAME;

Elige un nombre diferente o descarta primero el objeto en conflicto.

403 Forbidden o AccessDeniedException en las operaciones de visualización

Debido a que tu Compute Engine evalúa las vistas del lado del cliente, consultar una vista requiere permisos en la vista y en cada tabla a la que hace referencia. Verifica la siguiente información:

  • Para el DDL de vista, el emisor tiene el rol de editor de BigLake (roles/biglake.editor) o administrador de BigLake (roles/biglake.admin).
  • Para las consultas SELECT, el emisor tiene el rol de visualizador de BigLake (roles/biglake.viewer), que otorga biglake.views.get en la vista y biglake.tables.get y biglake.tables.getData en las tablas a las que se hace referencia.
  • En el modo de credenciales de usuario final, el emisor tiene el rol de usuario de objetos de almacenamiento (roles/storage.objectUser) en el bucket de Cloud Storage para la vista DDL o el de visualizador de objetos de almacenamiento (roles/storage.objectViewer) para las consultas de solo lectura.
  • En el modo de venta de credenciales, la cuenta de servicio del catálogo tiene el rol de usuario de objetos de almacenamiento (roles/storage.objectUser) en el bucket de Cloud Storage, y Spark se configura con spark.sql.catalog.CATALOG_NAME.header.X-Iceberg-Access-Delegation=vended-credentials.

Para obtener más información, consulta Roles y permisos necesarios.

UNSUPPORTED_FEATURE.TIME_TRAVEL_ON_VIEW

Spark devuelve AnalysisException: [UNSUPPORTED_FEATURE.TIME_TRAVEL_ON_VIEW] Cannot time travel on view cuando una consulta aplica TIMESTAMP AS OF o VERSION AS OF directamente a un identificador de vista.

Quita la cláusula de viaje en el tiempo de la consulta. Si necesitas datos históricos, define una vista cuya definición de SQL aplique TIMESTAMP AS OF 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.

ValidationException: Cannot find snapshot older than timestamp

Una vista definida con una cláusula de viaje en el tiempo hace referencia a una instantánea que venció o se quitó de la tabla subyacente.

Reemplaza la vista por CREATE OR REPLACE VIEW con una marca de tiempo o un ID de instantánea más recientes, o ajusta la configuración de retención de instantáneas en la tabla de Iceberg subyacente.

409 Conflict: Namespace is not empty cuando se descarta un espacio de nombres

No puedes descartar un espacio de nombres que aún contenga vistas. Enumera y descarta las vistas restantes y, luego, descarta el espacio de nombres:

SHOW VIEWS IN NAMESPACE_NAME;
DROP VIEW IF EXISTS NAMESPACE_NAME.VIEW_NAME;

400 Bad Request con FAILED_PRECONDITION en las operaciones de vista

Las vistas de Iceberg solo se admiten en catálogos de varios buckets y catálogos de un solo bucket. El catálogo rechaza las operaciones de vista en los catálogos de BigQuery o los catálogos federados. Crea la vista en un tipo de catálogo compatible.

400 Bad Request: View location is immutable

No puedes cambiar la ubicación de almacenamiento de una vista después de crearla. Quita la actualización de ubicación de tu solicitud.

En Trino 481 y versiones anteriores, CREATE OR REPLACE VIEW envía una ubicación actualizada que activa este error. Actualiza a Trino 482 o una versión posterior, o ejecuta DROP VIEW seguido de CREATE VIEW para actualizar la definición de la vista. Para obtener más información, consulta Compatibilidad con Trino.

¿Qué sigue?