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

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

最終更新日:Jun 21, 2024

このトピックでは、Data Management Service (DMS) とクライアントを使用してPolarDB for PostgreSQLクラスターに接続する方法について説明します。

前提条件

DMSを使用したPolarDBクラスターへの接続

DMSは、統合データ管理ソリューションを提供します。 DMSは、データ管理、スキーマ管理、アクセス制御、BIチャート、トレンド分析、データ追跡、パフォーマンス最適化、およびサーバー管理をサポートしています。 DMSを使用すると、MySQL、SQL Server、PostgreSQLなどのリレーショナルデータベース、およびMongoDBやRedisなどのNoSQLデータベースを管理できます。 DMSでは、Linuxサーバーを管理することもできます。

  1. PolarDBコンソールにログインします。

  2. 左上隅で、クラスターがデプロイされているリージョンを選択します。

  3. クラスターを見つけて、そのIDをクリックします。

  4. 概要 ページの右上隅にある データベースにログイン をクリックします。

  5. 表示されるダイアログボックスで、PolarDBクラスターに作成したデータベースアカウントパスワードを入力します。

  6. [ログイン] をクリックします。

    説明

    DMSを使用して初めてPolarDBクラスターに接続する場合は、ホワイトリストを設定するように求められます。 [ホワイトリストの設定] をクリックして承認を完了します。

  7. DMSにログインした後、ページを更新します。 左側のナビゲーションウィンドウで、[インスタンスにログイン] をクリックします。

  8. 管理するデータベースの名前を見つけてダブルクリックします。 その後、データベースを管理できます。

クライアントを使用したPolarDBクラスターへの接続

pgAdmin 4クライアントを使用してPolarDBクラスターに接続することもできます。

  1. pgAdmin 4クライアントを起動します。

  2. 次の図に示すように、[サーバー] を右クリックし、[作成] > [サーバー] を選択します。

    Create a server

  3. [作成-サーバー] ダイアログボックスの [全般] タブで、次の図に示すように、サーバーの名前を入力します。

    pgAdmin 4 - General

  4. [接続] タブをクリックし、接続するクラスターに関する情報を指定します。 下表に、各パラメーターを説明します。

    pgAdmin 4 - Connection

    表 1 パラメーターの説明

    パラメーター

    説明

    ホスト名 /アドレス

    PolarDBクラスターのエンドポイント。 PolarDBクラスターに関するエンドポイントおよびポート情報を表示するには、次の手順を実行します。

    1. PolarDB コンソールにログインします。

    2. コンソールの左上で、クラスターがデプロイされているリージョンを選択します。

    3. [クラスター] ページで、管理するクラスターのIDをクリックします。

    4. アドレス セクションで、PolarDBクラスターのエンドポイントを表示します。

    ポート

    PolarDB for PostgreSQLクラスターのポート。 デフォルト値: 1921

    メンテナンスデータベース

    メンテナンスデータベース。 デフォルト値: postgres

    ユーザー名

    PolarDBクラスターのアカウント。 アカウントの作成方法の詳細については、「データベースアカウントの作成」をご参照ください。

    Password

    PolarDBクラスターのアカウントのパスワード。

  5. [保存] をクリックします。

  6. 接続情報が有効な場合、データベース名をクリックすると、次のようなページが表示されます。 これは、データベースが接続されていることを示します。

    Connection established

  7. 管理するデータベースの名前を右クリックし、[クエリツール...] をクリックします。 表示されるページで、データベース内のデータを追加、削除、更新、およびクエリできます。

    Query editor

psqlを使用したPolarDBクラスターへの接続

上記のPolarDBクラスターへの接続方法に加えて、PostgreSQLクライアントをダウンロードしてインストールし、psqlを使用してPolarDBクラスターに接続することもできます。

説明
  • Windowsオペレーティングシステムでpsqlを使用してPolarDBクラスターに接続する方法は、Linuxオペレーティングシステムの場合と同じです。

  • psqlの使用方法の詳細については、「psql」をご参照ください。

  1. psqlコマンドラインインターフェイス (CLI) で次のコマンドを入力し、Enterキーを押します。

    psql -U <username> -h <host> -p <port> <dbname>

    パラメーター

    説明

    ユーザー名

    PolarDBクラスターのアカウント。 アカウントの作成方法の詳細については、「データベースアカウントの作成」をご参照ください。

    ホスト

    PolarDBクラスターのエンドポイント。 PolarDBクラスターに関するエンドポイントおよびポート情報を表示するには、次の手順を実行します。

    1. PolarDB コンソールにログインします。

    2. コンソールの左上で、クラスターがデプロイされているリージョンを選択します。

    3. [クラスター] ページで、管理するクラスターのIDをクリックします。

    4. アドレス セクションで、PolarDBクラスターのエンドポイントを表示します。

    ポート

    PolarDBクラスターのポート。 デフォルト値: 1921

    dbname

    管理するメンテナンスデータベースの名前。 データベースの作成方法の詳細については、「データベースの作成」をご参照ください。

    以下にコードの例を示します。

    psql -U testuser -h hostname -p 1521 testdb
  2. 指定したユーザー名のパスワードを入力し、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