Open Database Connectivity (ODBC) を使用して AnalyticDB for PostgreSQL インスタンスに接続します。
前提条件
開始する前に、以下の条件を満たしていることを確認してください。
ご利用の AnalyticDB for PostgreSQL インスタンスのイントラネットエンドポイントまたはパブリックエンドポイント
内部エンドポイント: クライアントが、AnalyticDB for PostgreSQL インスタンスと同じリージョンおよびネットワークタイプの Elastic Compute Service (ECS) インスタンス上で実行されている場合に使用します。 エンドポイントは、AnalyticDB for PostgreSQL コンソールの [基本情報] ページの データベース接続情報 で確認できます。
パブリックエンドポイント: お客様のクライアントが、AnalyticDB for PostgreSQL インスタンスとは異なるリージョンまたはネットワークタイプの ECS インスタンス上、あるいは Alibaba Cloud 外部で実行されている場合に使用します。申請については、「パブリックエンドポイントの管理」をご参照ください。
インスタンスの IP アドレスホワイトリストに追加されたクライアント IP アドレスです。詳細については、「IP アドレスホワイトリストの設定」をご参照ください。
Linux ホスト上で
yumパッケージマネージャが利用可能であること
ODBC による接続
ステップ 1:ODBC ドライバーのインストール
PostgreSQL ODBC ドライバーは、GNU Lesser General Public License (LGPL) の下で公開されているオープンソースソフトウェアです。以下のコマンドを実行してインストールします。
yum install -y unixODBC.x86_64
yum install -y postgresql-odbc.x86_64ステップ 2:データソースの設定
/etc/odbc.ini を編集用に開きます。
vim /etc/odbc.iniご利用のインスタンス情報を含む接続セクションを追加します。以下に例を示します。
[mygpdb]
Description = Test to gp
Driver = PostgreSQL
Database = <your-database>
Servername = <your-instance-endpoint>
UserName = <your-username>
Password = <your-password>
Port = 5432
ReadOnly = 0プレースホルダーを実際の値に置き換えます。
| パラメーター | 説明 | 例 |
|---|---|---|
[mygpdb] | データソース名 (DSN)。接続時にこの名前を使用します。 | [mygpdb] |
Driver | ドライバー名。 | PostgreSQL |
Database | 接続先のデータベース名。 | mydb |
Servername | AnalyticDB for PostgreSQL インスタンスのエンドポイント。 | gp-bp1k1b8683t****.gpdb.rds.aliyuncs.com |
UserName | データベースユーザー名。 | myuser |
Password | データベースユーザーのパスワード。 | MyPassword12! |
Port | ポート番号。 | 5432 |
ReadOnly | 接続が読み取り専用かどうか。 | 0 |
ステップ 3:接続のテスト
以下のコマンドを実行して、接続を確認します。
echo "select count(*) from pg_class" | isql mygpdb接続が成功した場合、次のような出力が表示されます。
+---------------------------------------+
| Connected! |
| |
| sql-statement |
| help [tablename] |
| quit |
| |
+---------------------------------------+
SQL> select count(*) from pg_class
+---------------------+
| count |
+---------------------+
| 388 |
+---------------------+
SQLRowCount returns 1
1 rows fetchedステップ 4:アプリケーションの接続設定
ODBC ドライバーの接続が正常に完了したら、アプリケーションを設定してドライバーを使用できるようにします。言語ごとの設定方法については、以下のリソースをご参照ください。
補足情報
Greenplum 公式サイトでは、JDBC、ODBC、libpq を含むツールパッケージが提供されています。「Greenplum ドキュメント」でインストールおよび使用方法の詳細をご確認ください。