このページでは、 Google Cloud Lakehouseとその関連リソースに関する一般的な問題を解決する方法について説明します。
Lakehouse Apache Iceberg REST Catalog エンドポイント テーブルに対してビューを作成できない
この問題は、 Iceberg REST Catalog エンドポイントで管理されている Lakehouse Iceberg REST Catalog テーブルに対して BigQuery でビューを作成しようとすると発生します。
これらのテーブルに対するビューの作成はサポートされていません。
メタデータ テーブルにクエリを実行できない
この問題は、5 つの部分からなる名前識別子を使用して、BigQuery の Lakehouse Iceberg REST Catalog テーブルのメタデータ テーブル（.snapshots や .files など）にクエリを実行すると発生します。
この問題を解決するには、Apache Spark を使用してこれらのテーブルにクエリを実行します。
metadata.json ファイルサイズの制限
Apache Iceberg の metadata.json ファイルサイズは 1 MB に制限されています。この制限は、テーブル スナップショット、スキーマ、パーティション仕様を追跡するメタデータ ファイルに適用されます。メタデータ ファイルがこのサイズを超えると、Apache Iceberg REST Catalog エンドポイントを介してテーブル オペレーションを実行する際にエラーが発生する可能性があります。
この問題を解決するには、Google アカウント チームに連絡して上限の引き上げをリクエストしてください。
マルチリージョン カタログにクエリを実行すると NOT_FOUND エラーが発生する
この問題は、プライマリ ロケーションを指定せずにマルチリージョン Cloud Storage バケットを使用して Lakehouse ランタイム
カタログにカタログを作成し、BigQuery 仮想リージョン（US や EU など）を指定してカタログにクエリを実行しようとすると発生します。
マルチリージョン バケットを使用してカタログを作成すると、そのメタデータは、対応する BigQuery 仮想リージョンではなく、マルチリージョンの地理的範囲内の特定のリージョン ロケーションに保存されます。メタデータが存在しない仮想リージョンでクエリを強制的に実行すると、クエリは失敗し、NOT_FOUND エラーが返されます。
この問題を解決するには、カタログを作成するときにプライマリ ロケーション（US や EU
など）を指定します。詳細については、米国と EU のマルチリージョンのプライマリ リージョンを指定する
をご覧ください。