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

PolarDB:エンドポイントの表示または申請

最終更新日:May 13, 2025

PolarDB クラスタに接続するには、そのエンドポイントを指定する必要があります。PolarDB は、プライマリエンドポイントとクラスターエンドポイントにプライベートエンドポイントとパブリックエンドポイントを提供します。このトピックでは、PolarDB コンソールでエンドポイントを表示および申請する方法について説明します。

エンドポイント

エンドポイントタイプ

説明

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

クラスターエンドポイント(推奨)

  • PolarDB クラスタには、デフォルトのクラスターエンドポイントがあります。クラスターエンドポイントを使用するすべてのリクエストは、PolarProxy によって処理されます。

  • デフォルトのクラスターエンドポイントは、書き込みリクエストがプライマリノードにルーティングされ、読み取りリクエストが読み取り専用ノードにルーティングされる自動読み書き分離をサポートします。

  • プライベート

  • パブリック

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

PolarDB クラスタは、1 つのプライマリエンドポイントのみをサポートします。プライマリエンドポイントには、次の特徴があります。

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

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

カスタムエンドポイント

  • 最大 5 つのカスタムエンドポイントを作成できます。カスタムエンドポイントを使用するすべてのリクエストは、PolarProxy によって処理されます。

  • カスタムエンドポイントの読み書きモードと負荷分散ポリシーを構成できます。カスタムエンドポイントは、読み書き分離または読み取り専用ワークロードをサポートします。

  • 1 つ以上の読み取り専用ノードをカスタムエンドポイントに関連付けることができます。カスタムエンドポイントを使用するリクエストは、関連付けられた読み取り専用ノードのみにルーティングされます。

説明

PolarDB カスタムエンドポイントを単一ノードに関連付けることができます。ただし、ノードに障害が発生した場合、エンドポイントは最大 1 時間使用できなくなる可能性があります。この潜在的なダウンタイムのため、本番環境ではこの構成を使用することはお勧めしません。

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

ネットワークタイプ

説明

シナリオ

プライベート

  • プライベートエンドポイントを使用して PolarDB クラスタにアクセスすると、最適なパフォーマンスが確保されます。

  • クラスタを作成すると、デフォルトのプライベートエンドポイントが作成されます。このエンドポイントは変更できますが、削除することはできません。

例えば:

  • Elastic Compute Service (ECS) インスタンスがクラスタと同じ Virtual Private Cloud (VPC) にデプロイされている場合、ECS インスタンスはプライベートエンドポイントを使用してクラスタに接続できます。

  • Data Management (DMS) を使用してクラスタにアクセスできます。

パブリック

  • パブリックエンドポイントを申請または削除できます。

  • パブリックエンドポイントを使用して PolarDB クラスタにアクセスしても、最適なパフォーマンスは得られません。

たとえば、パブリックエンドポイントを使用してクラスタに接続し、メンテナンス操作を実行できます。

エンドポイントとポートを表示する

  1. PolarDB コンソール にログインします。左側のナビゲーションウィンドウで、[クラスタ] をクリックします。左上隅で、クラスタのリージョンを選択します。クラスタリストで、クラスタを見つけて ID をクリックし、[基本情報] ページに移動します。

  2. 概要 ページの [データベース接続] セクションで、目的のエンドポイントにカーソルを合わせます。表示されるダイアログボックスの [ネットワーク情報] セクションで、エンドポイントとポート番号の情報を確認できます。image

説明

以前にドメイン名を使用してクラスタに接続し、クラスタがクラウドに移行された後も元のドメイン名を保持したい場合は、image > [プライベートドメイン名をバインド] をクリックして、プライベートドメイン名をバインドできます。プライベートネットワーク エンドポイントのみが プライベートドメイン名 のバインドをサポートしています。

パブリックエンドポイントを申請する

  1. PolarDB コンソール にログインします。左側のナビゲーションウィンドウで、[クラスタ] をクリックします。左上隅で、クラスタのリージョンを選択します。クラスタリストで、クラスタを見つけて ID をクリックし、[基本情報] ページに移動します。

  2. 概要 ページの [データベース接続] セクションで、目的のエンドポイントを見つけて [申請] をクリックし、パブリックエンドポイントを申請します。

  3. image

    説明

    パブリック エンドポイントのみを申請できます。プライベート エンドポイントは、クラスタまたはカスタムエンドポイントを作成すると自動的に生成されます。そのため、プライベートエンドポイントを申請する必要はありません。

  4. 表示されるダイアログボックスで、エンドポイントのプレフィックスを設定し、OK をクリックします。

    説明

    エンドポイントのプレフィックスは、次の要件を満たしている必要があります。

    • 6 ~ 40 文字で、小文字、数字、およびハイフン(-)を含めることができます。

    • 文字で始まり、数字または文字で終わる必要があります。

次のステップ

クラスタに接続する

関連 API 操作

操作

説明

CreateDBEndpointAddress

プライマリエンドポイント、デフォルトクラスターエンドポイント、またはカスタムクラスターエンドポイントのパブリックエンドポイントを作成します。

DescribeDBClusterEndpoints

PolarDB クラスタのエンドポイントを照会します。