Nesta página, mostramos como resolver problemas comuns com o Lakehouse para Apache Iceberg e os recursos associados a ele.
Não é possível criar visualizações sobre tabelas de endpoints do catálogo REST do Lakehouse Apache Iceberg
Esse problema ocorre quando você tenta criar uma visualização no BigQuery em uma tabela do catálogo REST do Lakehouse Iceberg gerenciada pelo endpoint do catálogo REST do Iceberg.
Não é possível criar visualizações dessas tabelas.
Não é possível consultar tabelas de metadados
Esse problema ocorre quando você consulta tabelas de metadados, como .snapshots ou .files, para suas tabelas do Apache Iceberg compatíveis com o catálogo de tempo de execução do Lakehouse no BigQuery usando um identificador de nome de cinco partes.
Para resolver esse problema, consulte essas tabelas usando o Apache Spark.
Limite de tamanho do arquivo metadata.json
O tamanho do arquivo do Apache Iceberg metadata.json é limitado a 1 MB. Esse limite se aplica ao arquivo de metadados que rastreia snapshots, esquemas e especificações de partição da tabela. Se o arquivo de metadados exceder esse tamanho, você poderá encontrar erros ao
realizar operações de tabela pelo endpoint do catálogo REST do Apache Iceberg.
Para resolver esse problema, entre em contato com a equipe da sua conta do Google para solicitar um aumento no limite.
Erros NOT_FOUND ao consultar catálogos multirregionais
Esse problema ocorre quando você cria um catálogo no Catálogo de ambientes de execução do Lakehouse usando um bucket do Cloud Storage multirregional sem especificar um local principal e tenta consultar o catálogo especificando uma região virtual do BigQuery (como US ou EU).
Quando um catálogo é criado com um bucket multirregional, os metadados são armazenados em
locais regionais específicos no escopo geográfico da multirregião
em vez da região virtual correspondente do BigQuery. Se você forçar uma consulta a ser executada em uma região virtual em que os metadados não estão presentes, ela vai falhar com um erro NOT_FOUND.
Para resolver esse problema, especifique o local principal (por exemplo, US ou EU) ao criar o catálogo. Para mais informações, consulte Especificar regiões principais para multirregiões dos EUA e da UE.