クロスリージョン レプリケーションと障害復旧を使用する

Lakehouse for Apache Iceberg は、カタログ メタデータのクロスリージョン レプリケーションと障害復旧をサポートしています。

この構成では、Cloud Storage のデュアルリージョン バケットまたはマルチリージョン バケットでバックアップされたカタログが必要です。

始める前に

1. Google Cloud プロジェクトに対して課金が有効になっていることを確認します。

2. BigLake API を有効にします。

   API を有効にするために必要なロール

   API を有効にするには、serviceusage.services.enable 権限を含む Service Usage 管理者 IAM ロール（roles/serviceusage.serviceUsageAdmin）が必要です。詳しくは、ロールを付与する方法をご覧ください。

   API の有効化

必要なロール

Lakehouse ランタイム カタログで Iceberg REST カタログ エンドポイントを使用するために必要な権限を取得するには、管理者に次の IAM ロールを付与するよう依頼してください。

• カタログ ユーザー アクセス、ストレージ アクセス、カタログの認証情報ベンディング モードの管理などの管理タスクを行います。
  • プロジェクトに対する BigLake 管理者 （roles/biglake.admin）
  • Cloud Storage バケットに対するストレージ管理者 （roles/storage.admin）
• 認証情報ベンディング モードでテーブルデータを読み取る: プロジェクトに対する BigLake 閲覧者 （roles/biglake.viewer）
• 認証情報ベンディング モードでテーブルデータを書き込む: プロジェクトに対する BigLake 編集者 （roles/biglake.editor）
• 非認証情報ベンディング モードでカタログ リソースとテーブルデータを読み取る:
  • プロジェクトに対する BigLake 閲覧者 （roles/biglake.viewer）
  • Cloud Storage バケットに対する Storage オブジェクト閲覧者 （roles/storage.objectViewer）
• 非認証情報ベンディング モードでカタログ リソースを管理し、テーブルデータを書き込む:
  • プロジェクトに対する BigLake 編集者 （roles/biglake.editor）
  • Cloud Storage バケットに対する Storage オブジェクト ユーザー （roles/storage.objectUser）

ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。

レプリケーションと障害復旧のワークフロー

クロスリージョン レプリケーションと障害復旧を使用するには、次の一般的な手順を行います。

1. レプリケーション ステータスを表示する: 現在のプライマリ リージョンとセカンダリ リージョンを特定して、フェイルオーバーのターゲット リージョンを決定します。
2. 同期ステータスを確認する: プライマリ リージョンとセカンダリ リージョンの現在の状態を確認して、移行の準備ができていることを確認します。
3. フェイルオーバー モードを選択する: ソフト フェイルオーバー（計画メンテナンスに最適）またはハード フェイルオーバー（緊急復旧に最適）のいずれかを選択します。
4. フェイルオーバーを開始する: 選択したモードに対応するコマンドを実行して、プライマリ リージョンとセカンダリ リージョンを切り替えます。

フェイルオーバーの準備

現在のプライマリ リージョンを特定し、セカンダリ リージョンの同期ステータスを確認します。次に、フェイルオーバーを開始します。

レプリケーションのステータスを表示する

カタログが複製されるリージョンを確認するには、次の gcloud biglake iceberg catalogs describe コマンドを実行します。

gcloud biglake iceberg catalogs describe CATALOG_NAME

CATALOG_NAME は、カタログの名前に置き換えます。

同期ステータスを確認する

フェイルオーバーを開始する前に、gcloud biglake iceberg catalogs failover コマンドを使用して、セカンダリ レプリカの同期ステータスを確認します。

gcloud biglake iceberg catalogs failover CATALOG_NAME \
    --validate_only \
    --primary-replica PRIMARY_REPLICA_REGION

次のように置き換えます。

• CATALOG_NAME: カタログの名前。
• PRIMARY_REPLICA_REGION: 新しいプライマリ レプリカとして指定するリージョン。

フェイルオーバーを開始する

障害復旧機能では、メタストア レプリケーションを使用してプライマリ リージョンとセカンダリ リージョンを指定します。すべてのテーブル コミット メタデータはプライマリ リージョンから提供され、セカンダリ リージョンに複製されます。フェイルオーバー オペレーションを使用して、カタログのプライマリ リージョンとセカンダリ リージョンを切り替えることができます。

gcloud biglake iceberg catalogs failover CATALOG_NAME \
    --primary-replica PRIMARY_REPLICA_REGION

gcloud biglake iceberg catalogs failover CATALOG_NAME \
    --primary-replica PRIMARY_REPLICA_REGION \
    --conditional-failover-replication-time=REPLICATION_TIMESTAMP

次のステップ

• Lakehouse ランタイム カタログの Iceberg REST カタログを使用する