このトピックでは、Data Management Service (DMS) とクライアントを使用してPolarDB for PostgreSQLクラスターに接続する方法について説明します。
前提条件
PolarDBクラスターの特権アカウントまたは標準アカウントが作成されます。 詳細については、「データベースアカウントの作成」をご参照ください。
PolarDBクラスターに接続するホストのIPアドレスがホワイトリストに追加されます。 詳細については、「クラスターのホワイトリストの設定」をご参照ください。
DMSを使用したPolarDBクラスターへの接続
DMSは、統合データ管理ソリューションを提供します。 DMSは、データ管理、スキーマ管理、アクセス制御、BIチャート、トレンド分析、データ追跡、パフォーマンス最適化、およびサーバー管理をサポートしています。 DMSを使用すると、MySQL、SQL Server、PostgreSQLなどのリレーショナルデータベース、およびMongoDBやRedisなどのNoSQLデータベースを管理できます。 DMSでは、Linuxサーバーを管理することもできます。
PolarDBコンソールにログインします。
左上隅で、クラスターがデプロイされているリージョンを選択します。
クラスターを見つけて、そのIDをクリックします。
概要 ページの右上隅にある データベースにログイン をクリックします。
表示されるダイアログボックスで、PolarDBクラスターに作成したデータベースアカウントとパスワードを入力します。
[ログイン] をクリックします。
説明DMSを使用して初めてPolarDBクラスターに接続する場合は、ホワイトリストを設定するように求められます。 [ホワイトリストの設定] をクリックして承認を完了します。
DMSにログインした後、ページを更新します。 左側のナビゲーションウィンドウで、[インスタンスにログイン] をクリックします。
管理するデータベースの名前を見つけてダブルクリックします。 その後、データベースを管理できます。
クライアントを使用したPolarDBクラスターへの接続
pgAdmin 4クライアントを使用してPolarDBクラスターに接続することもできます。
pgAdmin 4クライアントを起動します。
次の図に示すように、[サーバー] を右クリックし、 を選択します。
[作成-サーバー] ダイアログボックスの [全般] タブで、次の図に示すように、サーバーの名前を入力します。
[接続] タブをクリックし、接続するクラスターに関する情報を指定します。 下表に、各パラメーターを説明します。
表 1 パラメーターの説明
パラメーター
説明
ホスト名 /アドレス
PolarDBクラスターのエンドポイント。 PolarDBクラスターに関するエンドポイントおよびポート情報を表示するには、次の手順を実行します。
PolarDB コンソールにログインします。
コンソールの左上で、クラスターがデプロイされているリージョンを選択します。
[クラスター] ページで、管理するクラスターのIDをクリックします。
アドレス セクションで、PolarDBクラスターのエンドポイントを表示します。
ポート
PolarDB for PostgreSQLクラスターのポート。 デフォルト値: 1921
メンテナンスデータベース
メンテナンスデータベース。 デフォルト値: postgres
ユーザー名
PolarDBクラスターのアカウント。 アカウントの作成方法の詳細については、「データベースアカウントの作成」をご参照ください。
Password
PolarDBクラスターのアカウントのパスワード。
[保存] をクリックします。
接続情報が有効な場合、データベース名をクリックすると、次のようなページが表示されます。 これは、データベースが接続されていることを示します。
管理するデータベースの名前を右クリックし、[クエリツール...] をクリックします。 表示されるページで、データベース内のデータを追加、削除、更新、およびクエリできます。
psqlを使用したPolarDBクラスターへの接続
上記のPolarDBクラスターへの接続方法に加えて、PostgreSQLクライアントをダウンロードしてインストールし、psqlを使用してPolarDBクラスターに接続することもできます。
Windowsオペレーティングシステムでpsqlを使用してPolarDBクラスターに接続する方法は、Linuxオペレーティングシステムの場合と同じです。
psqlの使用方法の詳細については、「psql」をご参照ください。
psqlコマンドラインインターフェイス (CLI) で次のコマンドを入力し、Enterキーを押します。
psql -U <username> -h <host> -p <port> <dbname>
パラメーター
説明
ユーザー名
PolarDBクラスターのアカウント。 アカウントの作成方法の詳細については、「データベースアカウントの作成」をご参照ください。
ホスト
PolarDBクラスターのエンドポイント。 PolarDBクラスターに関するエンドポイントおよびポート情報を表示するには、次の手順を実行します。
PolarDB コンソールにログインします。
コンソールの左上で、クラスターがデプロイされているリージョンを選択します。
[クラスター] ページで、管理するクラスターのIDをクリックします。
アドレス セクションで、PolarDBクラスターのエンドポイントを表示します。
ポート
PolarDBクラスターのポート。 デフォルト値: 1921
dbname
管理するメンテナンスデータベースの名前。 データベースの作成方法の詳細については、「データベースの作成」をご参照ください。
以下にコードの例を示します。
psql -U testuser -h hostname -p 1521 testdb
指定した
ユーザー名
のパスワードを入力し、Enterキーを押します。 次いで、接続が確立される。
トラブルシューティング
IPアドレスホワイトリストが無効です。
デフォルトのホワイトリストには、IP アドレス 127.0.0.1 のみが含まれています。 127.0.0.1は、IPアドレスがPolarDBクラスターにアクセスできないことを示します。 したがって、クラスターへのアクセスに使用するクライアントのIPアドレスをホワイトリストに追加する必要があります。 詳細については、「クラスターのIPアドレスのホワイトリストの設定」をご参照ください。
ホワイトリストのエントリは0.0.0.0に設定されています。 有効な形式は0.0.0.0/0です。
重要0.0.0.0/0は、すべてのIPアドレスがPolarDBクラスターにアクセスできることを示します。 作業は慎重に行ってください。
ホワイトリストに追加したパブリックIPアドレスが無効です。 例えば、パブリックIPアドレスは、動的IPアドレスであってもよく、またはパブリックIPアドレスをチェックするために使用されるツールまたはウェブサイトは、無効なIPアドレスを提供する。
内部エンドポイントまたはパブリックエンドポイントが誤って使用されている。
内部エンドポイントを使用してインターネット経由の接続を確立する場合、またはパブリックエンドポイントを使用して内部ネットワーク経由の接続を確立する場合、接続は失敗します。
必要なエンドポイントを使用します。 内部ネットワーク経由でPolarDBクラスターに接続する場合は、PolarDBクラスターの内部エンドポイントを使用します。 インターネット経由でPolarDBクラスターに接続する場合は、PolarDBクラスターのパブリックエンドポイントを使用します。
ドメインネームシステム (DNS) サーバーがクラスターのエンドポイントの解決に失敗します。
PolarDBクラスターに接続するために入力したエンドポイントが無効です。 この場合、問題のトラブルシューティングを行います。
PolarDBクラスターのエンドポイントが無効です。 この場合、PolarDBコンソールで有効なエンドポイントを表示します。 詳細については、「エンドポイントの表示または適用」をご参照ください。
入力するエンドポイントはパブリックエンドポイントです。 ただし、パブリックエンドポイントは手動で削除されます。
一部のアプリケーションではエンドポイントの長さに制限があり、入力したエンドポイントは切り捨てられます。
PolarDBクラスターのエンドポイントが有効な場合は、DNSサーバーのIPアドレスをAlibaba Cloud DNSサーバーのIPアドレスに変更します。
ネットワークタイプ
Alibaba Cloud DNSサーバーのIPアドレス
内部ネットワーク (クラシックネットワーク)
10.143.22.116
10.143.22.118
内部ネットワーク (仮想プライベートクラウド)
100.100.2.136
100.100.2.138
インターネット
223.5.5.5
223.6.6.6