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

PolarDB:PolarDB クラスターへの接続

最終更新日:Sep 26, 2025

アプリケーションを PolarDB クラスターに接続するには、スクリプト、ユーティリティ、またはアプリケーションの接続文字列で提供されるホストアドレスとポートを含むエンドポイントを使用します。ほとんどのユースケースでは、クラスターへのすべての接続にクラスターエンドポイントを使用することをお勧めします。これにより、接続の高可用性が確保され、スケーリングのために読み取り専用ノードが自動的に活用されます。より専門的なユースケースのために、PolarDB はカスタムエンドポイントとプライマリエンドポイントも提供しています。このガイドでは、さまざまな種類のエンドポイントと、それらを効果的に使用する方法について説明します。

クラスターエンドポイントとプライマリエンドポイントの比較

すべての PolarDB クラスターには 3 種類のエンドポイントがあり、それぞれが特定のユースケース向けに設計されています。クラスターエンドポイントとカスタムエンドポイントは、マネージド PolarProxy によって強化されており、読み書き分離、負荷分散、コネクションプーリングなどの高度な機能を提供します。

タイプ

説明

ユースケース

サポートされるネットワークタイプ

デフォルトのクラスターエンドポイント (推奨)

クラスターの現在のプライマリノードに接続する単一のエンドポイント。

PolarProxy によって提供され、自動的な読み書き分離をサポートします。書き込みリクエストはプライマリノードにルーティングされ、読み取りリクエストは読み取り専用ノードにルーティングされます。

読み書き分離を必要とし、読み取り専用ノードを追加することでリアルタイムで迅速にスケールアウトできるビジネス。

  • プライベートネットワーク

  • パブリックネットワーク

カスタムエンドポイント

クラスター内のノードの特定のサブセットに接続するユーザー定義のエンドポイント。

  • カスタムエンドポイントがトラフィックをルーティングするノード (プライマリまたは読み取り専用)、その読み書きモード、および負荷分散ポリシーを設定できます。

  • カスタムエンドポイントは、少なくとも 1 つの読み取り専用ノードにアタッチする必要があります。このエンドポイントに送信されたリクエストは、アタッチされた読み取り専用ノードにのみルーティングされます。

説明

単一ノードのカスタムエンドポイントは、開発またはテスト目的のみを対象としており、本番環境では決して使用しないでください。これらのエンドポイントは高可用性を提供しません。基盤となるノードに障害が発生した場合、エンドポイントは最大 1 時間利用できなくなり、接続されているアプリケーションで障害が発生します。

さまざまなサービスのためにデータベースノードへのアクセスを分離します。たとえば、前の図で読み取り専用ノード 5 に障害が発生した場合、影響を受けるのはサービス Z のみです。

読み書きモードを [読み取り専用] に設定することで、読み取り専用サービスのみをサポートするようにエンドポイントを設定できます。

プライマリエンドポイント

PolarProxy をバイパスして、特定のデータベースノードに接続する単一のプライマリエンドポイント。

  • 常にプライマリノードに接続し、読み取りと書き込みの両方の操作をサポートします。

  • プライマリノードに障害が発生した場合、プライマリエンドポイントは自動的に新しいプライマリノードに切り替わります。

読み書き分離を必要としないビジネス。

プライベートエンドポイントとパブリックエンドポイント

エンドポイントは、アクセスを制御するためにさまざまなネットワークタイプで設定できます。

ネットワークタイプ

説明

ユースケース

プライベートネットワーク (VPC)

  • トラフィックを Virtual Private Cloud (VPC) 内に保持することで、最高のパフォーマンスとセキュリティを提供します。これは、本番アプリケーションに推奨されるネットワークタイプです。

  • クラスターを作成すると、デフォルトでプライベートエンドポイントが生成されます。このエンドポイントは変更できますが、リリースすることはできません。詳細については、「クラスターのエンドポイントを変更する」をご参照ください。

例:

  • ECS インスタンスとデータベースクラスターが同じ VPC にある場合、ECS インスタンスはプライベートエンドポイントを介してデータベースクラスターにアクセスできます。

  • DMS を使用して VPC 経由でデータベースクラスターにアクセスします。

パブリックネットワーク

  • パブリックインターネット経由での接続を許可します。これは、開発、リモート管理、または VPC 外のサービスからの接続に役立ちますが、最適なパフォーマンスは提供されず、慎重なセキュリティ管理が必要です。

  • パブリックエンドポイントをリクエストまたはリリースできます。詳細については、「クラスターのエンドポイントを管理する」をご参照ください。

たとえば、メンテナンス操作のためにパブリックエンドポイントを介してデータベースクラスターにアクセスします。

クラスターエンドポイントの読み書きモード

クラスターエンドポイントは、読み書き (自動読み書き分離) と 読み取り専用 の 2 つの読み書きモードをサポートしています。次の表に、2 つのモードの違いを示します。

説明

クラスターエンドポイントの読み書きモードを設定する方法については、「PolarProxy の設定」をご参照ください。

項目

読み書き (自動読み書き分離)

読み取り専用

サービスノードの選択方法

次の 3 つの方法がサポートされています:

  • プライマリノードのみを選択します。

  • 1 つ以上の読み取り専用ノードを選択します。

  • プライマリノードと 1 つ以上の読み取り専用ノードを選択します。

説明

読み書き分離モードでは:

  • すべての書き込みリクエストは、プライマリノードがサービスノードとして追加されているかどうかに関係なく、プライマリノードに送信されます。

  • 読み取りリクエストの場合、プライマリノードによる読み取りリクエストの許可 設定を使用して、プライマリノードが読み取りリクエストを処理するかどうかを決定できます。

次の方法のみがサポートされています:

  • 1 つ以上の読み取り専用ノードを選択します。

説明

読み取り専用モードでは:

  • すべての読み取りリクエストは、負荷分散ポリシーに基づいて読み取り専用ノードに転送されます。

  • プライマリノードがサービスノードとして追加されていても、リクエストはプライマリノードに転送されません。

  • プライマリノードのみを含む読み取り専用クラスターエンドポイントは作成できません。

負荷分散ポリシー

アクティブなリクエストベースのロードバランシング ポリシーをサポートします。

「負荷分散ポリシー」をご参照ください。

接続数に基づく負荷分散 と アクティブなリクエストベースのロードバランシング がサポートされています。

詳細については、「負荷分散ポリシー」をご参照ください。

プライマリノードによる読み取りリクエストの許可

サポートされています。詳細については、「特徴」をご参照ください。

この機能は、プライマリノードの負荷を軽減するように設計されているため、適用されません。読み取り専用 エンドポイントのプライマリノードは、読み取りまたは書き込みリクエストを処理しません。

トランザクション分離

サポートされています。

「トランザクション分割」をご参照ください。

説明

この構成は、一貫性レベル が セッション整合性 (中) または グローバル整合性 (強) に設定されている場合にのみサポートされます。

この機能は、プライマリノードの負荷を軽減するように設計されているため、適用されません。読み取り専用 エンドポイントのプライマリノードは、読み取りまたは書き込みリクエストを処理しません。

一貫性レベル

最終的な整合性 (弱)、セッション整合性 (中)、および グローバル整合性 (強) をサポートします。「整合性レベル」をご参照ください。

このエンドポイントは書き込み操作を実行しないため、最終的な整合性 (弱) のみがサポートされます。

接続プール

セッションレベル および トランザクションレベル の接続プールをサポートします。

詳細については、「接続プール」をご参照ください。

説明
  • 接続プールは PolarDB PolarProxy の機能であり、クライアントの接続プール機能には影響しません。クライアントが接続プールを提供している場合は、オフ を選択して PolarProxy の接続プール機能を無効にできます。

  • プロキシの接続プール機能を オフ にすると、クライアント接続はプロキシを介して、プライマリノードと読み取り専用ノードを含む、エンドポイント用に構成されたすべてのノードにルーティングされます。利用可能なビジネス接続の総数は、プライマリノードの最大接続数によって制限されます。

サポートされていません。

説明

PolarDB は、読み取り専用 クラスターエンドポイント用に構成されたすべての読み取り専用ノードに接続を均等に分散します。プライマリノードは接続の分散には参加しません。クライアント接続は、プロキシを介して単一の読み取り専用ノードにルーティングされます。利用可能な接続の総数は、すべての読み取り専用ノードの最大接続数の合計です。

セキュリティ保護

サポートされています。「過負荷保護」をご参照ください。

サポートされていません。

よくある質問

セッション情報から、アプリケーションがプライマリエンドポイントとクラスターエンドポイントのどちらに接続されているかを確認するにはどうすればよいですか?

これには 2 つの方法があります:

  1. セッション ID 別:
    セッション ID が 16777215 未満の場合、接続はプライマリアドレスへの接続です。それ以外の場合、接続はクラスターアドレスへの接続です。

  2. SQL Insight の Vip フィールド別:
    SQL エクスプローラー 内の [監査] タブに移動します。Vip フィールドに値が含まれている場合、接続はクラスターアドレスまたはカスタムアドレスへの接続です。フィールドが空の場合は、次の 2 つのうちのいずれかを意味する可能性があります:

    • 接続はプライマリアドレスへの接続です。

    • 接続はクラスターアドレスへの接続ですが、データベースカーネルのバージョンが古すぎて Vip 情報を出力できません。たとえば、MySQL 8.0.1 の場合、マイナーカーネルバージョンは 8.0.1.1.3 以降である必要があります。

    後者の場合は、このチェックに Vip フィールドを確実に使用できるように、データベースカーネルのバージョンをアップグレードすることをお勧めします。

現在のセッションがデフォルトのクラスターエンドポイントとカスタムエンドポイントのどちらに接続されているかを確認するにはどうすればよいですか?

SQL エクスプローラーの [監査] タブで Vip フィールドを確認します。このフィールドに表示される IP アドレスは、クラスターまたはカスタムアドレスの IP です。

このフィールドが空の場合、データベースカーネルのバージョンが古すぎてこの情報を出力できない可能性があります。たとえば、MySQL 8.0.1 の場合、マイナーカーネルバージョンは 8.0.1.1.3 以降である必要があります。この状況では、データベースカーネルのバージョンをアップグレードすることをお勧めします。

読み取り専用ノードに直接接続するにはどうすればよいですか?

カスタムアドレスを作成することで、読み取り専用ノード専用のエンドポイントを作成できます。この新しいエンドポイントを使用して行われた接続は、選択した読み取り専用ノードにのみルーティングされます。

手順:

  1. PolarDB コンソールにログインします。 クラスターの [基本情報] ページで、[データベース接続] セクションを見つけ、[カスタムエンドポイントの作成] をクリックします。

  2. [カスタムエンドポイントの作成] ダイアログボックスで、[読み書きモード] を [読み取り専用] に設定し、目的の読み取り専用ノードを選択して、[OK] をクリックします。

  3. カスタムエンドポイントが作成されたら、その接続文字列を使用して、指定された読み取り専用ノードに直接接続できます。