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

PolarDB:PolarDB for PostgreSQL(Oracle 互換)クラスターへの接続

最終更新日:Mar 28, 2026

pgAdmin 4(クエリ実行およびデータ管理が可能なグラフィカルクライアント)を使用して、ご利用の PolarDB for PostgreSQL(Oracle 互換)クラスターに接続します。

その他の接続方法

コマンドラインインターフェイス (CLI) を使用することもできます。CLI は、「クライアントおよびドライバーのダウンロード」からダウンロードしてください。ドライバーを用いた接続については、以下のドキュメントをご参照ください。

前提条件

開始する前に、以下の条件を満たしていることを確認してください。

  • クラスター用の特権アカウントまたは標準アカウント — 「データベースアカウントの作成」をご参照ください。

  • クライアントの IP アドレスがクラスターのホワイトリストに登録済みであること — 「クラスターのホワイトリストの設定」をご参照ください。

  • クライアントマシン(例:Elastic Compute Service (ECS) インスタンスなど)に pgAdmin 4 がインストール済みであること — pgadmin.org/download からダウンロードしてください。

接続情報を取得する

pgAdmin 4 を起動する前に、PolarDB コンソールから以下の情報を収集してください。これらの情報を事前に準備しておくことで、接続設定中に中断が発生するのを防げます。

項目確認方法
エンドポイントご利用の PolarDB クラスターのエンドポイントPolarDB コンソール > クラスター ID > エンドポイント セクション
ポート1521(デフォルト)PolarDB コンソール > クラスター ID > エンドポイント セクション
メンテナンスデータベースpostgres(デフォルト)該当なし
ユーザー名ご利用のクラスターのアカウント名クラスター向けに作成したアカウント
パスワードご利用のクラスターのアカウントパスワードそのアカウントのパスワード

内部エンドポイントとパブリックエンドポイントの違い:クライアントがクラスターと同じ VPC またはクラシックネットワーク上にある場合は、内部エンドポイントを使用してください。インターネット経由で接続する場合は、パブリックエンドポイントを使用してください。誤ったエンドポイントタイプを使用すると、接続に失敗します。

エンドポイントの確認手順は以下のとおりです。

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

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

  3. クラスター ページで、ご利用のクラスターの ID をクリックします。

  4. エンドポイント セクションで、適切なエンドポイントをコピーします。

pgAdmin 4 を使用した接続

  1. pgAdmin 4 を起動します。

  2. サーバー を右クリックし、作成 > サーバー を選択します。

    Create a server

  3. 全般 タブ(サーバーの作成 ダイアログ)で、この接続の名前を入力します。

    pgAdmin 4 - General

  4. 接続 タブをクリックし、先ほど収集したクラスターの詳細情報を入力します。

    パラメーター
    ホスト名/アドレスご利用の PolarDB クラスターのエンドポイント
    ポート1521
    メンテナンスデータベースpostgres
    ユーザー名ご利用の PolarDB クラスターのアカウント
    パスワードそのアカウントのパスワード

    pgAdmin 4 - Connection

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

  6. データベース名をクリックします。以下の画面と類似したダッシュボードが表示されれば、接続が確立されたことを確認できます。

    Connection established

  7. データベース名を右クリックし、クエリツール... を選択してクエリエディターを開きます。ここで、データの追加、削除、更新、および検索が可能です。

    Query editor

次のステップ

Oracle 互換性

トラブルシューティング

接続が即座に失敗した場合、最も一般的な原因を以下に示します。順に確認してください。

  1. ホワイトリストが未設定 — 接続が即座に拒否されます。

  2. エンドポイントタイプの誤り — ホワイトリストが正しく設定されていても、接続がタイムアウトまたは拒否されることがあります。

  3. DNS 解決失敗 — pgAdmin 4 がホスト名を解決できません。

ホワイトリストが未設定

デフォルトのホワイトリストには 127.0.0.1 のみが含まれています。PolarDB では、127.0.0.1 は「すべての IP アドレスからのアクセスを許可しない」ことを意味します。クライアントの IP アドレスをホワイトリストに追加してください — 「クラスターのホワイトリストの設定」をご参照ください。

ホワイトリスト設定における代表的なミスと修正方法は以下のとおりです。

ミス修正方法
0.0.0.0代わりに 0.0.0.0/0 を使用
動的 IP アドレスを登録現在のパブリック IP アドレスを再確認し、ホワイトリストを更新
重要

0.0.0.0/0 はすべての IP アドレスからの接続を許可します。使用には十分ご注意ください。

エンドポイントタイプの誤り

インターネット経由で内部エンドポイントを使用したり、内部ネットワーク経由でパブリックエンドポイントを使用したりすると、接続に失敗します。ネットワーク環境に応じて適切なエンドポイントタイプを選択してください。

ネットワーク環境使用するエンドポイント
クラスターと同じ VPC またはクラシックネットワーク上内部エンドポイント
インターネットパブリックエンドポイント

DNS 解決失敗

以下の項目を順に確認してください。

  1. エンドポイントの確認PolarDB コンソール にログインし、エンドポイント セクションでエンドポイントを確認します。タイポを防ぐため、直接コピーしてください。

  2. パブリックエンドポイントの削除確認:コンソール上にエンドポイントが表示されない場合、手動で削除された可能性があります。

  3. 文字列の切り捨て確認:一部のアプリケーションではエンドポイントの文字列長が制限されています。pgAdmin 4 に渡されるエンドポイントが完全であることを確認してください。

  4. DNS サーバの更新:エンドポイントが有効でも解決できない場合は、Alibaba Cloud DNS サーバに切り替えてください。

    ネットワークタイプDNS サーバの IP アドレス
    内部ネットワーク(クラシックネットワーク)10.143.22.116 および 10.143.22.118
    内部ネットワーク(VPC)100.100.2.136 および 100.100.2.138
    インターネット223.5.5.5 および 223.6.6.6