En esta página, se muestra cómo resolver problemas habituales con Lakehouse para Apache Iceberg y sus recursos asociados.
No se pueden crear vistas sobre las tablas de extremos del catálogo de REST de Apache Iceberg de Lakehouse
Este problema se produce cuando intentas crear una vista en BigQuery sobre una tabla del catálogo de REST de Lakehouse Iceberg administrada por el extremo del catálogo de REST de Iceberg.
No se admite la creación de vistas sobre estas tablas.
No se pueden consultar tablas de metadatos
Este problema ocurre cuando consultas tablas de metadatos, como .snapshots o .files, para tus tablas de Apache Iceberg compatibles con el catálogo del entorno de ejecución de Lakehouse en BigQuery con un identificador de nombre de cinco partes.
Para resolver este problema, consulta estas tablas con Apache Spark.
Límite de tamaño del archivo metadata.json
El tamaño del archivo metadata.json de Apache Iceberg está limitado a 1 MB. Este límite se aplica al archivo de metadatos que hace un seguimiento de las instantáneas, los esquemas y las especificaciones de partición de la tabla. Si tu archivo de metadatos supera este tamaño, es posible que encuentres errores cuando realices operaciones de tabla a través del extremo del catálogo de REST de Apache Iceberg.
Para resolver este problema, comunícate con tu equipo de cuentas de Google y solicita un aumento del límite.
Errores NOT_FOUND cuando se consultan catálogos multirregionales
Este problema se produce cuando creas un catálogo en el catálogo de entorno de ejecución de Lakehouse con un bucket de Cloud Storage multirregional sin especificar una ubicación principal y, luego, intentas consultar el catálogo especificando una región virtual de BigQuery (como US o EU).
Cuando se crea un catálogo con un bucket multirregional, sus metadatos se almacenan en ubicaciones regionales específicas dentro del alcance geográfico de la multirregión, en lugar de en la región virtual de BigQuery correspondiente. Si fuerzas la ejecución de una consulta en una región virtual en la que no están presentes los metadatos, la consulta fallará con un error NOT_FOUND.
Para resolver este problema, especifica la ubicación principal (por ejemplo, US o EU) cuando crees el catálogo. Para obtener más información, consulta Cómo especificar regiones principales para las multirregiones de EE.UU. y la UE.