ApsaraDB RDS:データベースプロキシエンドポイントの読み取り/書き込み属性と読み取りの重みの設定

前提条件

開始する前に、以下を確認してください。

• RDS インスタンスでデータベースプロキシ機能が有効になっていること。詳細については、「データベースプロキシ機能の有効化」をご参照ください。

• 読み書き分離のために、RDS インスタンスに少なくとも 1 つの読み取り専用インスタンスがアタッチされていること。詳細については、「ApsaraDB RDS for PostgreSQL の読み取り専用インスタンスの作成」をご参照ください。

読み取り/書き込み属性

プロキシエンドポイントは、以下の 2 つのモードのいずれかで動作します。

属性と重みによる動作

以下の表に、読み取り/書き込み属性と重み設定の各組み合わせでトラフィックがどのように処理されるかを示します。

表中の用語

• プライマリへのトラフィックなし：プライマリインスタンスは、読み取り専用リクエストの転送から除外されます。

• 接続エラー：読み取り専用のプロキシエンドポイントにリクエストを処理できる利用可能な読み取り専用インスタンスがない場合に発生します。

• 読み取り/書き込みモードでプライマリの重みが 0 の場合：通常の状態では、読み取りリクエストはプライマリインスタンスに転送されません。すべての読み取り専用インスタンスに障害が発生した場合、強制的なヒントが指定された場合、またはトランザクション分割が有効になっている場合、プロキシはフォールバックとして読み取りリクエストをプライマリインスタンスに転送します。

読み取り/書き込み属性と読み取りの重みの設定

1. [インスタンス] ページに移動します。上部メニューで、RDS インスタンスが存在するリージョンを選択し、インスタンス ID をクリックします。

2. ナビゲーションペインで、[データベースプロキシ] をクリックします。

3. [接続情報] セクションで、[プロキシエンドポイント (ターミナル) ID] 列で変更するエンドポイントを見つけ、[操作] 列の [設定変更] をクリックします。

4. [読み取り/書き込み属性] を以下のいずれかに設定します。

   • [読み取り/書き込み (読み書き分離)]

   • [読み取り専用 (プライマリインスタンスはトラフィックを受信しません)]

5. [読み取りの重みの割り当て] を [自動] または [カスタム] に設定します。

   • [自動]：システムは、各インスタンスのスペックに基づいて読み取りの重みを割り当てます。読み取り専用インスタンスを追加すると、システムは適切な重みで自動的に読み書き分離に含めます。手動での更新は不要です。システムが割り当てる重みの値については、「デフォルトの読み取りの重み」をご参照ください。

   • [カスタム]：各読み取り専用インスタンスの読み取りの重みを指定します。有効な値：0～10000。新しい読み取り専用インスタンスを作成すると、その初期の重みは 0 になります。トラフィック分散に含めるには、重みを更新してください。

   説明 重みが高いほど、インスタンスは比例してより多くの読み取りリクエストを受信します。たとえば、3 つの読み取り専用インスタンスの重みが 100、200、200 で、プライマリインスタンスの重みが 0 の場合、プライマリは書き込みのみを処理し、読み取り専用インスタンスは 1:2:2 の比率でトラフィックを受信します。

   重みの変更は、接続切断なしで即座に有効になります。既存の接続は影響を受けず、新しい接続のみが更新された重みを使用します。

SQL ヒントを使用したリクエストのルーティング

特定のクエリに対してプロキシのルーティング決定を上書きするには、SQL ステートメントに SQL ヒントを追加します。

• クエリをプライマリインスタンスに強制的にルーティングする

  /*FORCE_MASTER*/ SELECT * FROM table_name;

• クエリを読み取り専用インスタンスに強制的にルーティングする

  /*FORCE_SLAVE*/ SELECT * FROM table_name;

API リファレンス