すべてのプロダクト
Search
ドキュメントセンター

ApsaraDB for MongoDB:ノードタグの申請

最終更新日:May 01, 2025

ApsaraDB for MongoDB インスタンスのセカンダリノードにノードタグが追加されていない場合、そのノードの readPreferenceTags 設定は無効になります。この場合、ノードのノードタグを申請できます。このトピックでは、インスタンスのノードタグを申請する方法について説明します。

背景情報

接続文字列 URI には、指定されたタグに対応するノードに読み取りリクエストを優先的に送信するための readPreferenceTags パラメーターが含まれています。このパラメーターは、ノードタグを設定した後にのみ有効になります。既存のインスタンスのセカンダリノードには、ノードタグが追加されていません。この場合、接続文字列 URI を使用すると、ノードに読み取りリクエストを送信できません。 この問題に対処するために、ApsaraDB for MongoDB では、インスタンスのノードタグを申請できます。

このトピックで説明する手順を実行して、インスタンスにノードタグが適用されているかどうかを確認できます。ノードタグが適用されている場合、関連するボタンは選択不可になります。

インスタンスのノードタグを申請した後、対応する機能を実現するために、接続文字列 URI に次のタグを追加します。

  • readPreferenceTags=role:electable: セカンダリノードから優先的にデータを読み取ります。

  • readPreferenceTags=role:readonly: 読み取り専用ノードから優先的にデータを読み取ります。

詳細については、「レプリカセットインスタンスへの接続」および「シャードクラスターインスタンスへの接続」をご参照ください。

前提条件

インスタンスは、クラウドディスクを使用するレプリカセットまたはシャードクラスターインスタンスです。

手順

  1. [レプリカセットインスタンス] ページまたは [シャードクラスターインスタンス] ページに移動します。トップナビゲーションバーで、インスタンスが存在するリージョンを選択します。次に、インスタンスを見つけて、インスタンスの ID をクリックします。

  2. インスタンスの詳細ページの左側のナビゲーションウィンドウで、データベース接続 をクリックします。

  3. [ノードタグの申請] をクリックします。

  4. インスタンスアーキテクチャ(レプリカセットまたはシャードクラスター)に基づいて、必要な操作を実行します。

    • レプリカセットインスタンス

      [ノードタグの申請] メッセージで、[OK] をクリックします。

    • シャードクラスターインスタンス

      [ノードタグの申請] パネルで、タグを申請するノードを選択し、[OK] をクリックします。

説明

ノードタグを申請すると、インスタンスの状態が [パラメーター設定の切り替え中] に変わります。この期間中、インスタンスで実行される読み取り/書き込み操作は影響を受けません。インスタンスの状態が [実行中] に戻ると、ノードタグの申請は完了です。