このページでは、Spanner デュアルリージョン クォーラムのヘルス ステータスを確認する方法と、サービスが中断した場合にクォーラムを手動で変更する方法について説明します。
デュアルリージョンの詳細については、Spanner のデュアルリージョン インスタンス構成をご覧ください。
デュアルリージョン クォーラムのステータスを確認する
デュアルリージョン クォーラムのステータスは、次の方法で確認できます。
- [データベースの概要] ページ
- システム分析情報ダッシュボードの使用
[データベースの概要] ページ
Google Cloud コンソールで、[Spanner インスタンス] ページに移動します。
デュアルリージョン構成に含まれるインスタンスの名前をクリックします。
データベースの名前をクリックします。
[概要] で [クォーラム] 行を探します。ここには、インスタンスのデュアルリージョン クォーラムのステータスが表示されます。
両方のリージョンでクォーラムが満たされている場合、ステータスは [デュアルリージョン] を表示します。
手動または Google 管理のフェイルオーバーが実行されている場合は、サービス提供リージョンの名前（
asia-south1など）が表示されます。
システム分析情報ダッシュボード
デュアルリージョン構成を作成すると、インスタンス レベルのシステム分析情報ダッシュボードにデュアルリージョン クォーラムの可用性指標を表示できます。
詳細については、システム分析情報ダッシュボードを表示するをご覧ください。
デュアルリージョン クォーラムをデュアルリージョンからシングル リージョンに変更する（フェイルオーバー）
リージョンの停止やネットワーク パーティショニングの問題が発生した場合に手動でフェイルオーバーするには:
Google Cloud コンソール
Google Cloud コンソールで、[Spanner インスタンス] ページに移動します。
デュアルリージョン構成に含まれるインスタンスの名前をクリックします。
ナビゲーション メニューで [システム分析情報] をクリックします。
デュアルリージョン クォーラムの可用性指標を見つけます。
デュアルリージョン クォーラムの可用性指標で、リージョンで停止があることが示されている場合は、Google Cloud コンソールの上部にある
[Cloud Shell をアクティブにする] をクリックします。Cloud Shell が開きます。
デュアルリージョン クォーラムをデュアルリージョンからシングル リージョンに変更するには、gcloud CLI タブにある次のコマンド「
gcloud spanner databases change-quorum」を入力します。詳しい手順については、[gcloud] タブをご覧ください。
gcloud CLI
gcloud spanner databases change-quorum コマンドを使用して、デュアルリージョン クォーラムをデュアルリージョンからシングル リージョンに変更します。
gcloud spanner databases change-quorum
DATABASE_ID --instance=INSTANCE_ID
--single-region --serving-location=SERVING_LOCATION
[--etag=ETAG]
次のように置き換えます。
DATABASE_ID: データベースの永続的な識別子。INSTANCE_ID: インスタンスの永続的な識別子。SERVING_LOCATION: フェイルオーバーするリージョン インスタンス構成。たとえば、asia-south1（ムンバイ）が異常で、asia-south2（デリー）にフェイルオーバーする場合は、asia-south2を入力します。SERVING_LOCATIONが正常なリージョンであることを確認します。フェイルオーバーに間違ったリージョンを選択すると、データベースが使用不能になり、リージョンがオンラインに復帰する前に復元できません。
オプションのフラグ:
--etag=ETAG:ETAG引数は、リプレイ保護に使用できます。
クォーラム変更オペレーションのステータスを確認するには、gcloud spanner databases describe コマンドを実行します。quorumInfo フィールドには、オペレーションに関する情報が表示されます。
gcloud spanner databases describe DATABASE_ID
--instance=INSTANCE_ID
デュアルリージョン クォーラムをシングル リージョンからデュアルリージョンに変更する（フェイルバック）
中断されたリージョンが正常な状態になった後、またはネットワーク パーティションの問題が解決した後に手動でフェイルバックするには:
Google Cloud コンソール
Google Cloud コンソールで、[Spanner インスタンス] ページに移動します。
デュアルリージョン構成に含まれるインスタンスの名前をクリックします。
ナビゲーション メニューで [システム分析情報] をクリックします。
デュアルリージョン クォーラムの可用性指標を見つけます。
デュアルリージョン クォーラムの可用性指標で、[リージョン クォーラムを変更] をクリックします。
Cloud Shell が開きます。
デュアルリージョン クォーラムをデュアルリージョンからシングル リージョンに変更するには、gcloud CLI タブにある次のコマンド「
gcloud spanner databases change-quorum」を入力します。詳しい手順については、[gcloud] タブをご覧ください。
gcloud CLI
gcloud spanner databases change-quorum コマンドを使用して、デュアルリージョン クォーラムをシングル リージョンからデュアルリージョンに変更します。
gcloud spanner databases change-quorum
DATABASE_ID --instance=INSTANCE_ID
--dual-region
[--etag=ETAG]
次のように置き換えます。
DATABASE_ID: データベースの永続的な識別子。INSTANCE_ID: インスタンスの永続的な識別子。
オプションのフラグ:
--etag=ETAG:ETAG引数は、オプティミスティックな同時実行制御に使用できます。
クォーラム変更オペレーションのステータスを確認するには、gcloud spanner databases describe コマンドを実行します。quorumInfo フィールドには、オペレーションに関する情報が表示されます。
gcloud spanner databases describe DATABASE_ID
--instance=INSTANCE_ID
次のステップ
- デュアルリージョン インスタンスの構成の詳細を確認する。