> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-bradley-turek-pfilter-operators-reference.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# PostgreSQL SSHコネクター

## はじめに

PostgreSQLは、広く使用されているオープンソースのリレーショナルデータベース管理システムです。DomoのPostgreSQL SSHコネクターを使用すると、PostgreSQLデータベースからSSHトンネル経由でデータをロードし、カスタマイズされたレポートを作成することができます。取得するデータの指定は、SQLクエリの入力で行います。PostgreSQL APIに関する詳細は、PostgreSQLのウェブサイト（[https://www.postgresql.org/docs/](https://www.postgresql.org/docs/)）を参照してください。

PostgreSQL SSHコネクターは「データベース」コネクターです。つまり、クエリを使ってデータベースからデータを取得します。Data Centerでは、ウィンドウ上部のツールバーで\*\*［データベース］\*\*をクリックすることで、このコネクターやほかのデータベースコネクターのページにアクセスできます。

PostgreSQLデータベースには、Data Centerから接続します。このトピックでは、PostgreSQL SSHコネクターユーザーインターフェースに固有のフィールドとメニューについて説明します。DataSetの追加や更新スケジュールの設定、DataSet情報の編集に関する一般的な情報は、「[コネクターを使用してDataSetを追加する](/s/article/360042926274)」を参照してください。

<Note>\*\*注記：\*\*ネットワークの構造によっては、IT管理者が、データコネクターでデータを取得するためのIPアドレスをホワイトリストに登録する必要があります。詳細については、IT管理者にお問い合わせください。</Note>

|                                |                                        |
| ------------------------------ | -------------------------------------- |
| **主な使用事例**                     | このコネクターは、データベース内の情報をDomoに取り込むのに適しています。 |
| **主なメトリクス**                    | 該当なし                                   |
| **社内における主な権限**                 | - IT - プロジェクト管理                        |
| **平均導入時間**                     | 10時間以内                                 |
| **使いやすさ（1～10の段階。1が「最も使いやすい」）** | 9                                      |

## ベストプラクティス

* 読み取り専用クエリのみを使用します。
* 「Append」ではなく「Replace」を使用します。

## 必要条件

PostgreSQLデータベースにSSHトンネル経由で接続しDataSetを作成するには、以下が必要です。

* PostgreSQLデータベースのログインに使用するユーザー名とパスワード
* PostgreSQLデータベースの名前
* PostgreSQLデータベースのポート番号
* PostgreSQLデータベースサーバーのホスト名またはIPアドレス
* SSHトンネルの接続先であるUNIXサーバー
* UNIXアカウントのユーザー名とパスワード
* SSHのポート番号
* SSH秘密鍵（DESまたはRSAのいずれか）

PostgreSQLデータベースに接続する前に、データベースサーバーの接続ポートでIPアドレスをいくつかホワイトリストに登録する必要があります。IPアドレスの詳細なリストについては、「[コネクターのIPアドレスをホワイトリストに登録する](/s/article/360043630093)」を参照してください。

<Note>
  **注記:** **Domoはssh-keygenを使用して生成されるSSHキーをサポートしていません。SSHキーは、OpenSSLが生成するRSAキーである必要があります。**
</Note>

## **PostgreSQLデータベースに接続する**

**このセクションでは、PostgreSQL SSHコネクターページの**［認証情報］**および**［詳細］**ペインのオプションについて説明します。このページ内のほかのペインに含まれるコンポーネントである**［スケジュール設定］**や**［DataSetに名前を付け、説明を入力］**に関しては、ほとんどのタイプのコネクターで共通しています。詳細については「[コネクターを使用してDataSetを追加する](/s/article/360042926274)」を参照してください。**

### **［認証情報］ペイン**

**このペインには、データベースとSSHサーバーに接続する認証情報の入力フィールドが含まれています。下表では、各フィールドに必要な内容を説明しています：**

| **フィールド**               | **説明**                                           |
| ----------------------- | ------------------------------------------------ |
| **SSH Server Hostname** | **SSHトンネルの接続先であるUNIXサーバーのホスト名を入力します。**           |
| **SSH Username**        | **UNIXアカウントのSSHユーザー名を入力します。**                    |
| **SSH Password**        | **UNIXアカウントのSSHパスワードを入力します。**                    |
| **SSH Port**            | **UNIXアカウントのポート番号を入力します。**                       |
| **Database Hostname**   | **PostgreSQLデータベースのホスト名を入力します。例：db.company.com** |
| **SSH Private Key**     | **SSH秘密キー（DESまたはRSAのいずれか）を入力します。**               |
| **Database Name**       | **PostgreSQLデータベース名を入力します。**                     |
| **Database Username**   | **PostgreSQLユーザー名を入力します。**                       |
| **Database Password**   | **PostgreSQLパスワードを入力します。**                       |
| **Database Port**       | **PostgreSQLデータベースのポート番号を入力します。**                |

**有効な認証情報を一度入力しておくと、随時同じアカウントを使用して新しいPostgreSQL SSH DataSetを作成することができます。コネクターのアカウントはData Centerの**［アカウント］**タブで管理できます。このタブの詳細については、「[コネクターのユーザーアカウントを管理する](/s/article/360042926054)」を参照してください。**

### **［詳細］ペイン**

**このペインでは、SQLクエリを作成して、データベースからデータを取得します。**

| **メニュー**      | **説明**                                                                  |
| ------------- | ----------------------------------------------------------------------- |
| **SQL Query** | **必要なデータを選択するためのSQL（構造化照会言語）クエリを入力します。例：**  **select \* from Employee** |

## **トラブルシューティング**

* **適切なIPアドレスがホワイトリストに登録されたことを確認します（IPアドレスのリストについては、「必要条件」 を参照してください）。**
* **フェッチサイズの縮小を試みるか、空白のままにします。**