クロスクラウド データアクセスのトラブルシューティング

このドキュメントでは、ボーダーレス Lakehouse のクロスクラウド データアクセス機能を使用する際に発生する一般的な問題を解決する方法について説明します。

データとリソースが古いか、更新されていない

Lakehouse 連携カタログは、更新間隔に基づいてリモート クラウドからメタデータを同期します。カタログのバックグラウンド メタデータの更新は、リソース（共有、スキーマ、Namespace、テーブル）が多いほど時間がかかることがあります。前回の更新がオーバーランした場合、現在の更新はスキップされますが、次の更新は次の間隔で再スケジュールされます。

クエリされたデータが古いように見える場合は、カタログのバックグラウンド メタデータの更新がオーバーランしているか、失敗している可能性があります。リモート クラウド リソースも同じ動作の対象となります。リモートクラウドでリソースを削除すると、次回のバックグラウンド メタデータの更新が成功したときにのみ、Lakehouse から削除されます。

連携カタログのバックグラウンド メタデータ更新ステータスを確認するには、Lakehouse Google Cloud コンソール ページで確認するか、gcloud CLI を実行します。

[レイクハウス] に移動

gcloud alpha biglake iceberg catalogs describe FEDERATED_CATALOG_NAME \
    --project="PROJECT_ID"

gcloud alpha biglake delta-sharing catalogs describe FEDERATED_CATALOG_NAME \
    --project="PROJECT_ID"

接続またはルーティングに関する問題

プライベート相互接続の使用時に接続またはルーティングの問題が発生した場合は、次のことを確認してください。

  • ルートの伝播を確認する:Google Cloud の Cloud Router を確認して、AWS VPC プレフィックスを学習していることを確認します。AWS ルートテーブルを調べて、 Google Cloud VPC へのルートがあることを確認します。
  • ILB の健全性を確認する: Google Cloud コンソールで、[ネットワーク サービス] > [ロード バランシング] に移動します。ILB バックエンド サービスのバックエンド（NEG）が正常かどうかを確認します。そうでない場合は、ネットワーク接続と AWS セキュリティ グループのルールを確認します。
  • Google Cloudからの接続をテストする: ILB または Service Directory エンドポイントと同じGoogle Cloud VPC とサブネットでテスト VM インスタンスを起動し、ポート 443 の AWS ENI IP アドレスに接続してみます（たとえば、curl または telnet を使用します）。
  • Service Directory の解決: カタログのサービス アカウントに Service Directory エンドポイント（roles/servicedirectory.viewer、roles/servicedirectory.pscAuthorizedService）を解決する権限があることを確認します。
  • セキュリティ グループとファイアウォール ルール: Google Cloud ファイアウォール ルールと AWS セキュリティ グループで、関連する IP 範囲間の TCP ポート 443 のトラフィックが許可されていることを確認します。

Snowflake カタログの更新がコード 16（未認証）で失敗する

Snowflake Horizon カタログのバックグラウンド メタデータの更新がステータス Code 16（UNAUTHENTICATED）で失敗した場合は、次のことを確認します。

  • シークレット ペイロードの形式: Secret Manager のシークレット トークンに、未加工の個人用アクセス トークン（PAT）文字列ではなく、必要な JSON 構造（{"client_secret": "<var>SNOWFLAKE_PAT_TOKEN</var>", "scope": "session:role:<var>SNOWFLAKE_ROLE</var>"}）が含まれていることを確認します。
  • トークンの有効期限と権限: Snowflake PAT が有効であり、関連するユーザーとロールにターゲット カタログとデータベースにアクセスするのに十分な権限があることを確認します。
  • ネットワーク ポリシー: Snowflake ネットワーク ポリシーが構成されている場合は、goog.json からの Google の下り（外向き）IP アドレス範囲が許可リストに登録されていることを確認します。