Nesta página, mostramos como resolver problemas comuns com o Lakehouse para Apache Iceberg e os recursos associados.
Não é possível consultar tabelas de metadados
Esse problema ocorre quando você consulta tabelas de metadados, como .snapshots ou .files, para as tabelas do Apache Iceberg com suporte do catálogo de ambiente 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 metadata.json do Apache Iceberg é 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, solicite um aumento de limite entrando em contato com a equipe da sua conta do Google.
Erros NOT_FOUND ao consultar catálogos multirregionais
Esse problema ocorre quando você cria um catálogo no catálogo de ambiente 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 de na região virtual correspondente do BigQuery. Se você forçar a execução de uma consulta em uma região virtual em que os metadados não estão presentes, a consulta 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.