> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloud.cdata.com/llms.txt
> Use this file to discover all available pages before exploring further.
# PostgreSQL
export const title_3 = "PostgreSQL";
export const title_2 = "PostgreSQL";
export const title_1 = "PostgreSQL";
export const title_0 = "PostgreSQL";
## 前提条件
#### CData IP をホワイトリストに登録
PostgreSQL への接続を確立するには、CData のIP 経由でPostgreSQL へのアクセスを許可する必要があります。PostgreSQL をファイアウォールの内側でホスティングする場合は、これらのIP アドレスをファイアウォールの許可リストに登録する必要があります。
* 範囲：`52.224.0.160`～`52.224.0.175` および`4.154.117.160`～`4.154.117.175`
* CIDR 表記：`52.224.0.160/28` および`4.154.117.160/28`
#### PostgreSQL が一般にアクセス可能であることを確認
パブリックフェイシングIP / ドメインを指定して、このデータソースに接続します。次のプライベートIP の範囲は機能しません。
* `10.0.0.0`～`10.255.255.255`
* `172.16.0.0`～`172.31.255.255`
* `192.168.0.0`～`192.168.255.255`
* `127.0.0.1`（別名 'localhost'）
## セットアップガイド
以下の手順で、PostgreSQL をConnect AI アカウントに接続します：
Connect AI のナビゲーションメニューから**Sources** ページを開きます。
右上の **+ Add Connection** をクリックします。
検索フィールドに *PostgreSQL* と入力し、データソース名をクリックします。
新しいコネクションの**Basic Settings** タブで、コネクション名を入力するかデフォルトの名前をそのまま使用します。
PostgreSQL コネクションがファイアウォール内にある場合は、**Connection Type** を **SSH Tunnel** に設定し、[SSH トンネルの手順](#ssh-tunnel-instructions)に従います。その後、以下の手順に進みます。それ以外の場合は **Connection Type** を **Direct** のままにします。
**Server** フィールドに PostgreSQL サーバーのホスト名または IP アドレスを入力します。
**注：** PostgreSQL データベースで自己署名証明書を使用している場合は、自己署名証明書を **Advanced Settings** > **SSL Server Cert** フィールドにコピーする必要があります。
認証方法を選択し、該当するセクションに進んで手順に従います。
## 認証方法
**User** フィールドに、認証用の PostgreSQL ユーザー名を入力します。
**Password** フィールドにユーザーパスワードを入力します。
（オプション）PostgreSQL の **Database** 名を入力します。何も入力しない場合は、ユーザーのデフォルトデータベースが使用されます。
（オプション）**Port** フィールドに PostgreSQL サーバーへの接続用ポートを指定します。デフォルトは 5432 です。
PostgreSQL で、Connect AI 静的 IP アドレスを接続のホワイトリストに追加します。
Connect AI **Add {title_0} Connection** ページ上部の、**Save & Test** をクリックします。
* 接続テストに成功すると、コネクションが作成されたことを示す**Connection successfully saved** というメッセージが表示されます。**Edit Connection** ページの**Status** も**Authenticated** に変わります。**Edit Connection** ページの右ペインにある**Data Model** タブで、成功したコネクションのデータモデルを表示します。
* 接続テストに失敗した場合は、入力したログイン情報に余分なスペースや文字がないかを確認してください。Connect AI は、データが不足している必須フィールドの下にエラーメッセージを表示します。一部のデータソースでは、ソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、**Sign in** ボタンの下にエラーメッセージが表示されます。エラーを修正し、もう一度試してください。
* 失敗したコネクションは下書きとして保存され、**Status** は**Not Authenticated** になります。後でコネクションに戻って認証することができます。
**User** フィールドに、認証用の PostgreSQL ユーザー名を入力します。
接続先の **Azure Tenant** Id を入力します。
（オプション）PostgreSQL の **Database** 名を入力します。何も入力しない場合は、ユーザーのデフォルトデータベースが使用されます。
（オプション）**Port** フィールドに PostgreSQL サーバーへの接続用ポートを指定します。デフォルトは 5432 です。
OAuth でセキュアに接続するには、**Sign in** をクリックします。これにより、PostgreSQL のサインインページが新しいタブで開かれます。
PostgreSQL アカウントにログインし、リクエストされた権限を設定します（該当する場合）。
PostgreSQL で、Connect AI 静的 IP アドレスを接続のホワイトリストに追加します。
Connect AI **Add {title_1} Connection** ページ上部の、**Save & Test** をクリックします。
* 接続テストに成功すると、コネクションが作成されたことを示す**Connection successfully saved** というメッセージが表示されます。**Edit Connection** ページの**Status** も**Authenticated** に変わります。**Edit Connection** ページの右ペインにある**Data Model** タブで、成功したコネクションのデータモデルを表示します。
* 接続テストに失敗した場合は、入力したログイン情報に余分なスペースや文字がないかを確認してください。Connect AI は、データが不足している必須フィールドの下にエラーメッセージを表示します。一部のデータソースでは、ソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、**Sign in** ボタンの下にエラーメッセージが表示されます。エラーを修正し、もう一度試してください。
* 失敗したコネクションは下書きとして保存され、**Status** は**Not Authenticated** になります。後でコネクションに戻って認証することができます。
**User** フィールドに、認証用の PostgreSQL ユーザー名を入力します。
**Password** フィールドにユーザーパスワードを入力します。
接続先の **Azure Tenant** Id を入力します。
（オプション）PostgreSQL の **Database** 名を入力します。何も入力しない場合は、ユーザーのデフォルトデータベースが使用されます。
（オプション）**Port** フィールドに PostgreSQL サーバーへの接続用ポートを指定します。デフォルトは 5432 です。
PostgreSQL で、Connect AI 静的 IP アドレスを接続のホワイトリストに追加します。
Connect AI **Add {title_2} Connection** ページ上部の、**Save & Test** をクリックします。
* 接続テストに成功すると、コネクションが作成されたことを示す**Connection successfully saved** というメッセージが表示されます。**Edit Connection** ページの**Status** も**Authenticated** に変わります。**Edit Connection** ページの右ペインにある**Data Model** タブで、成功したコネクションのデータモデルを表示します。
* 接続テストに失敗した場合は、入力したログイン情報に余分なスペースや文字がないかを確認してください。Connect AI は、データが不足している必須フィールドの下にエラーメッセージを表示します。一部のデータソースでは、ソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、**Sign in** ボタンの下にエラーメッセージが表示されます。エラーを修正し、もう一度試してください。
* 失敗したコネクションは下書きとして保存され、**Status** は**Not Authenticated** になります。後でコネクションに戻って認証することができます。
**User** フィールドに、認証用の PostgreSQL ユーザー名を入力します。
AWS ルートアカウントに関連付けられた **AWS Access Key** を入力します。
AWS ルートアカウントに関連付けられた **AWS Secret Key** を入力します。
認証するユーザー Id の **AWS Role ARN** を入力します。
（オプション）別のロールをエミュレートする場合のみ、**AWS External Id** を入力します。
（オプション）PostgreSQL の **Database** 名を入力します。何も入力しない場合は、ユーザーのデフォルトデータベースが使用されます。
（オプション）**Port** フィールドに PostgreSQL サーバーへの接続用ポートを指定します。デフォルトは 5432 です。
PostgreSQL で、Connect AI 静的 IP アドレスを接続のホワイトリストに追加します。
Connect AI **Add {title_3} Connection** ページ上部の、**Save & Test** をクリックします。
* 接続テストに成功すると、コネクションが作成されたことを示す**Connection successfully saved** というメッセージが表示されます。**Edit Connection** ページの**Status** も**Authenticated** に変わります。**Edit Connection** ページの右ペインにある**Data Model** タブで、成功したコネクションのデータモデルを表示します。
* 接続テストに失敗した場合は、入力したログイン情報に余分なスペースや文字がないかを確認してください。Connect AI は、データが不足している必須フィールドの下にエラーメッセージを表示します。一部のデータソースでは、ソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、**Sign in** ボタンの下にエラーメッセージが表示されます。エラーを修正し、もう一度試してください。
* 失敗したコネクションは下書きとして保存され、**Status** は**Not Authenticated** になります。後でコネクションに戻って認証することができます。
## SSH トンネルの手順
PostgreSQL データソースがファイアウォール内にある場合は、以下の手順に従います。
**Connection Type** で **SSH Tunnel** をクリックします。
以下の情報を入力します：
* **SSH Server**–SSH サーバー名を入力します。
* **SSH Port**–SSH ポートを入力します。デフォルト値は 22 です。
* **SSH Auth Mode**–認証モードとして **Password** または **Public\_Key** を入力します。
* **Password** の場合は、**SSH User** 名と **SSH Password** を入力します。
* **Public\_Key** の場合は、**SSH User** 名、**SSH Client Cert**、**SSH Client Cert Password**（オプション）を入力します。**SSH Client Cert Type** には PEMKEY\_BLOB のみ使用できます。**SSH Client Cert** は必須で、有効な秘密鍵を指定します。SSH クライアント証明書にパスワードが設定されている場合は、**SSH Client Cert Password** を入力します。
[セットアップガイド](#セットアップガイド)の認証手順を続けます。
## Connect Gateway の接続
PostgreSQL は、オンプレミスのデータと Connect AI の間を橋渡しする Connect Gateway でサポートされているコネクタです。詳細については、[Connect Gateway](/ja/Connect-Gateway) をご覧ください。ゲートウェイの設定が完了したら、**Connect Gateway** の**Connection Type** を選択します。その後、ゲートウェイの **Location Name** と PostgreSQL の認証情報を入力してください。
## 詳細について
Connect AI とPostgreSQL の連携の詳細動作については、[こちらのページ](https://cdn.cdata.com/help/FPM/jp/cloud/default.htm#default)を参照してください。