É possível diagnosticar e resolver erros no Lakehouse sem fronteiras e nos
recursos associados, incluindo problemas com consultas de tabela de metadados,
limites de tamanho de arquivo metadata.json e configurações de catálogo multirregional.
Resolver esses problemas ajuda a restaurar as operações de tabela e a execução de consultas
nas cargas de trabalho do lakehouse.
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 compatíveis com o catálogo do 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 de tabela, esquemas e especificações de
partição. Se o arquivo de metadados exceder esse tamanho, talvez ocorram 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 de conta do Google para solicitar um aumento de limite.
Erros NOT_FOUND ao consultar catálogos multirregionais
Esse problema ocorre quando você cria um catálogo no catálogo do ambiente de execução do Lakehouse
usando um bucket multirregional do Cloud Storage sem especificar um local
principal e, em seguida, 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 dele são armazenados em
locais regionais específicos dentro do escopo geográfico da multirregião,
em vez de na 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, 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 primárias
para multirregiões dos EUA e da UE.