Questa pagina mostra come risolvere i problemi comuni relativi a Lakehouse per Apache Iceberg e alle risorse associate.
Impossibile creare visualizzazioni sulle tabelle degli endpoint del catalogo REST Iceberg di Lakehouse
Questo problema si verifica quando tenti di creare una visualizzazione in BigQuery su una tabella del catalogo REST Iceberg di Lakehouse gestita dall'endpoint del catalogo REST Iceberg.
La creazione di visualizzazioni su queste tabelle non è supportata.
Impossibile eseguire query sulle tabelle dei metadati
Questo problema si verifica quando esegui query sulle tabelle dei metadati, ad esempio .snapshots o .files, per le tabelle Apache Iceberg supportate dal catalogo runtime Lakehouse in BigQuery utilizzando un identificatore di nome in cinque parti.
Per risolvere il problema, esegui query su queste tabelle utilizzando Apache Spark.
Limite di dimensione del file metadata.json
La dimensione del file metadata.json di Apache Iceberg è limitata a 1 MB. Questo limite si applica al file di metadati che tiene traccia degli snapshot, degli schemi e delle specifiche di partizionamento delle tabelle. Se il file di metadati supera questa dimensione, potresti riscontrare errori durante l'esecuzione delle operazioni sulle tabelle tramite l'endpoint del catalogo REST Apache Iceberg.
Per risolvere il problema, richiedi un aumento del limite contattando il team dell'account Google.
Errori NOT_FOUND durante l'esecuzione di query sui cataloghi multiregionali
Questo problema si verifica quando crei un catalogo nel catalogo runtime Lakehouse utilizzando un bucket Cloud Storage multiregionale senza specificare una località principale e poi tenti di eseguire query sul catalogo specificando una regione virtuale BigQuery (ad esempio US o EU).
Quando viene creato un catalogo con un bucket multiregionale, i relativi metadati vengono archiviati in località regionali specifiche nell'ambito geografico della regione multiregionale anziché nella regione virtuale BigQuery corrispondente. Se forzi l'esecuzione di una query in una regione virtuale in cui i metadati non sono presenti, la query non riesce e viene visualizzato un errore NOT_FOUND.
Per risolvere il problema, specifica la località principale (ad esempio US o EU) quando crei il catalogo. Per saperne di più, consulta Specificare le regioni principali
per le regioni multiregionali US ed EU.