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

ApsaraDB RDS:PostgreSQL インスタンスへの接続

最終更新日:May 19, 2026

ApsaraDB RDS for PostgreSQL インスタンスを作成し、アカウントの作成や IP ホワイトリストの設定などの必要な設定を完了すると、インスタンスに接続できるようになります。このトピックでは、Data Management (DMS)、pgAdmin クライアント、PostgreSQL CLI、またはアプリケーションを使用して接続する方法について説明します。

前提条件

  • ApsaraDB RDS for PostgreSQL インスタンスが作成されていること。詳細については、「ApsaraDB RDS for PostgreSQL インスタンスの作成」をご参照ください。

  • アカウントとデータベースが作成されていること。詳細については、「アカウントとデータベースの作成」をご参照ください。

  • ECS インスタンスまたはオンプレミスデバイスからアクセスできるよう、IP ホワイトリストが設定されていること。詳細については、「IP ホワイトリストの設定」をご参照ください。

    • 内部ネットワーク経由で ECS インスタンスから接続する場合、ECS インスタンスと RDS インスタンスは同じリージョン、同じ Alibaba Cloud アカウント、同じ VPC に存在する必要があります。ECS インスタンスのプライベート IP アドレスを IP ホワイトリストに追加する必要があります。

    • オンプレミスデバイスから接続する場合、デバイスのパブリック IP アドレスを IP ホワイトリストに追加する必要があります。

手順

Data Management (DMS)

Data Management (DMS) は、データ管理、スキーマ管理、ユーザー承認、セキュリティ監査、データトレンド、データトレース、BI チャート、パフォーマンス最適化、サーバー管理を統合したオールインワンデータ管理サービスです。DMS の詳細については、「Data Management (DMS) とは」をご参照ください。

  1. RDSインスタンスにアクセスし、上部のリージョンを選択し、対象のRDSインスタンスのIDをクリックします。
  2. 基本情報 ページで、データベースにログイン をクリックします。SQLQuery

  3. DMS の データベースインスタンスへのログオン ページで、Access Method[制御モード] を選択します。

    パラメータ

    説明

    [Access Method]

    このトピックでは、DMS を使用して ApsaraDB RDS インスタンスにアクセスする方法を、アカウント + パスワードログイン を例に説明します。

    • [アカウント + パスワードログイン]: ターゲットデータベースに対する権限を持つデータベースアカウントのユーザー名とパスワードでログインします。

    • [KMS 認証情報でログイン]:DMS はインスタンスのセキュアホスティングを自動的に有効にします。KMS で作成された RDS 認証情報を手動で選択してログインする必要があります。

    説明
    • [KMS 認証情報でログイン] アクセス方法を使用する場合、DMS はインスタンスの セキュアホスティング を無料で自動的に有効にします。

    • [ワンクリックでセキュアホスティングを有効にする] をクリックし、アカウントとパスワードを入力して、インスタンスの セキュアホスティング を無料で有効にすることもできます。これにより、安全で制御可能な パスワードレスログイン が可能になります。

    コントロールモード

    DMS は 3 つのインスタンスレベルの コントロールモード を提供しています。ビジネスシナリオに応じて選択できます。

    • 柔軟な管理

    • 安定した変更

    • セキュリティコラボレーション

  4. ログインしてページを更新すると、左側の [接続済みインスタンス] ペインにインスタンスとそのデータベースが表示されます。

    説明

    セキュアホスティングを有効にした場合、左側の [パスワードレスインスタンス] ペインにログイン済みのインスタンスとそのデータベースが表示されます。

    image

    • DMS コンソールでは、対象データベースをダブルクリックすることでのみデータベースを切り替えることができます。USE コマンドはサポートされていません。

    • インスタンスは存在するのに、展開後に対象データベースが見つからない場合、原因は次のいずれかである可能性があります。

      • ログインアカウントに対象データベースへのアクセス権限がありません。必要な権限を持つアカウントでログインしてください。

      • メタデータが同期されていないため、カタログが表示されていません。この問題を解決するには、インスタンス名にカーソルを合わせ、その右側にある image アイコンをクリックします。これにより、データベースリストが更新され、対象データベースが表示されます。

      データベースとテーブルのスキーマを迅速に同期するには、DMS の 空のデータベース初期化 機能を使用できます。

説明
  • ApsaraDB RDS コンソールから DMS にログインする以外に、DMS コンソールに直接ログインして ApsaraDB RDS インスタンスを追加することもできます。その後、DMS コンソールからデータベースに迅速にログインできます。詳細については、「クラウドデータベースインスタンスの登録」をご参照ください。

  • アカウント パスワードをリセットした場合、DMS に再度ログインする必要があります。

pgAdmin クライアント

pgAdmin クライアントは、PostgreSQL データベースに接続するための、公式に推奨されているツールです。このセクションでは、pgAdmin 4 v6.2.0 を例として、ApsaraDB RDS for PostgreSQL インスタンスに接続する方法を説明します。PostgreSQL 公式ウェブサイト から PostgreSQL をダウンロードしてインストールすると、pgAdmin 4 クライアントが自動的にインストールされます。

PostgreSQL をインストールしたくない場合は、リモート接続専用のスタンドアロン pgAdmin クライアント をダウンロードできます。

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

    説明

    最新バージョンのクライアントに初めてログインする場合、保存されたパスワードやその他の認証情報を保護するためにマスター パスワードを設定する必要があります。

  2. [サーバー] を右クリックし、[登録] > [サーバー...] の順に選択します。

  3. [一般] タブで、接続の名前を設定します。

  4. [接続] タブをクリックし、インスタンスの接続情報を入力します。

    パラメータ

    説明

    ホスト名 / アドレス

    ApsaraDB RDS for PostgreSQL インスタンスのエンドポイントとポートです。

    • 内部ネットワーク経由で接続する場合は、インスタンスの内部エンドポイントとポートを入力します。

    • インターネット経由で接続する場合は、インスタンスのパブリックエンドポイントとポートを入力します。

    この情報は、ApsaraDB RDS for PostgreSQL インスタンスの [データベース接続] ページで確認できます。

    詳細については、「エンドポイントとポートの表示と変更」をご参照ください。

    ポート

    ユーザー名

    ApsaraDB RDS for PostgreSQL インスタンスアカウントのユーザー名とパスワードです。

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

    パスワード

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

    接続情報が正しければ、サーバーが正常に追加されます。

    重要

    postgres データベースは、ApsaraDB RDS インスタンスのデフォルトのシステムデータベースです。このデータベースでは操作を実行しないでください。

PostgreSQL CLI

PostgreSQL 公式ウェブサイト から PostgreSQL をインストールすると、PostgreSQL CLI もインストールされます。

コマンドラインターミナルで、次のコマンドを実行して ApsaraDB RDS for PostgreSQL データベースに接続します。

psql -h <endpoint> -U <username> -p <port> [-d <database_name>]

psqlLog on

パラメータ

説明

エンドポイント

ApsaraDB RDS for PostgreSQL インスタンスのエンドポイントとポートです。

  • 内部ネットワーク経由で接続する場合は、インスタンスの内部エンドポイントとポートを入力します。

  • インターネット経由で接続する場合は、インスタンスのパブリックエンドポイントとポートを入力します。

この情報は、ApsaraDB RDS for PostgreSQL インスタンスの [データベース接続] ページで確認できます。

詳細については、「エンドポイントとポートの表示と変更」をご参照ください。

[ポート番号]

[ユーザー名]

ApsaraDB RDS for PostgreSQL インスタンスのアカウントです。

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

[データベース名]

オプション。接続先のデータベース名です。postgres データベースは、ApsaraDB RDS for PostgreSQL インスタンスのデフォルトのシステムデータベースです。このデータベースでは操作を実行しないでください。インスタンスで作成した別のデータベースを指定することを推奨します。

データベースの作成と表示方法については、「データベースの作成」をご参照ください。

アプリケーション

説明

このセクションでは、JDBC を使用して Maven プロジェクトから ApsaraDB RDS for PostgreSQL インスタンスに接続する例を説明します。他のプログラミング言語でも接続手順は同様です。

  1. pom.xml ファイルに依存関係を追加します。

    <dependency>
      <groupId>postgresql</groupId>
      <artifactId>postgresql</artifactId>
      <version>8.2-504.jdbc3</version>
    </dependency>
  2. 次のコードは、インスタンスに接続する方法の例です。

    public class DatabaseConnection
    {
        public static void main( String[] args ){
            try {
                Class.forName("org.postgresql.Driver");
            } catch (ClassNotFoundException e) {
                e.printStackTrace();
            }
            // インスタンスのエンドポイント
            String hostname = "pgm-bp1i3kkq7321o9****.pg.rds.aliyuncs.com";
            // インスタンスのポート
            int port = 5432;
            // データベース名
            String dbname = "postgres";
            // ユーザー名
            String username = "username";
            // パスワード
            String password = "password";
    
            String dbUrl = "jdbc:postgresql://" + hostname + ":" + port + "/" + dbname + "?binaryTransfer=true";
            Connection dbConnection;
            try {
                dbConnection = DriverManager.getConnection(dbUrl, username, password);
                Statement statement = dbConnection.createStatement();
                // 実行する SQL 文を指定します
                String selectSql = "SELECT * FROM information_schema.sql_features LIMIT 10";
                ResultSet resultSet = statement.executeQuery(selectSql);
                while (resultSet.next()) {
                    System.out.println(resultSet.getString("feature_name"));
                }
            } catch (SQLException e) {
                e.printStackTrace();
            }
        }
    }

サードパーティ BI ツール

ApsaraDB RDS for PostgreSQL は、サードパーティのビジネスインテリジェンス (BI) ツールからの接続をサポートしています。これらのツールを使用して、分析のためにデータの取得、クリーニング、モデリング、視覚化を行うことができます。このセクションでは、Microsoft Power BI を例として、ApsaraDB RDS for PostgreSQL インスタンスに接続する方法を説明します。使用するクライアントバージョンは Power BI 2.112.1161.0 64-bit です。

  1. Power BI Desktop クライアントをダウンロードしてインストールします。詳細については、「Power BI Desktop の取得」をご参照ください。

  2. Power BI Desktop クライアントを起動します。

  3. 上部のメニューバーにあるホームページタブで、[データを取得] > さらに表示の順にクリックします。Get data

  4. [データの取得] ダイアログボックスで、データベース > PostgreSQL の順に選択し、Connection をクリックします。PostgreSQLDatabase

  5. PostgreSQL ダイアログボックスで、サーバーデータベース を指定し、決定 をクリックします。Connection address

    パラメータ

    説明

    サーバー

    ApsaraDB RDS for PostgreSQL インスタンスのエンドポイントとポートです。

    形式:endpoint:port

    • 内部ネットワーク経由で接続する場合は、インスタンスの内部エンドポイントとポートを入力します。

    • インターネット経由で接続する場合は、インスタンスのパブリックエンドポイントとポートを入力します。

    この情報は、ApsaraDB RDS for PostgreSQL インスタンスの [データベース接続] ページで確認できます。

    詳細については、「エンドポイントとポートの表示と変更」をご参照ください。

    [データベース]

    postgres データベースは、ApsaraDB RDS for PostgreSQL インスタンスのデフォルトのシステムデータベースです。このデータベースでは操作を実行しないでください。インスタンスで作成した別のデータベースを指定することを推奨します。

    データベースの作成と表示方法については、「データベースの作成」をご参照ください。

  6. ユーザー名パスワード を設定し、Connection をクリックします。Connect

    説明

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

  7. 「暗号化サポート」ダイアログボックスで、決定をクリックします。Encryption Support

  8. 接続が成功すると、[Navigator] ペインからデータベース内のテーブル情報を表示できます。対象テーブルを選択し、ビジネス要件に応じて [読み込み] または [データの変換] を選択できます。Load or Transform Data

SSL 暗号化

ApsaraDB RDS for PostgreSQL は、転送中のデータを保護するために SSL 暗号化をサポートしています。具体的な設定の詳細については、「SSL 暗号化接続を使用した ApsaraDB RDS for PostgreSQL インスタンスへの接続」をご参照ください。

よくある質問

  • Q:ECS インスタンスと ApsaraDB RDS インスタンスが異なるリージョンまたは異なるアカウントにある場合、ApsaraDB RDS インスタンスに接続するにはどうすればよいですか。

    A:次の 2 つの方法のいずれかを使用できます。

  • Q:Function Compute から ApsaraDB RDS に接続してデータを取得するにはどうすればよいですか。

    A:関数にサードパーティの依存関係をインストールし、組み込みモジュールを使用して ApsaraDB RDS からデータを取得できます。詳細については、「関数へのサードパーティ依存関係のインストール」をご参照ください。