はじめに
PostgreSQLは、広く使用されているオープンソースのリレーショナルデータベース管理システムです。DomoのPostgreSQL SSHコネクターを使用すると、PostgreSQLデータベースからSSHトンネル経由でデータをロードし、カスタマイズされたレポートを作成することができます。取得するデータの指定は、SQLクエリの入力で行います。PostgreSQL APIに関する詳細は、PostgreSQLのウェブサイト( https://www.postgresql.org/docs/ )を参照してください。 PostgreSQL SSHコネクターは「データベース」コネクターです。つまり、クエリを使ってデータベースからデータを取得します。Data Centerでは、ウィンドウ上部のツールバーで [データベース] をクリックすることで、このコネクターやほかのデータベースコネクターのページにアクセスできます。 PostgreSQLデータベースには、 Data Center から接続します。このトピックでは、PostgreSQL SSHコネクターユーザーインターフェースに固有のフィールドとメニューについて説明します。DataSetの追加や更新スケジュールの設定、DataSet情報の編集に関する一般的な情報は、「 コネクターを使用してDataSetを追加する 」を参照してください。注記: ネットワークの構造によっては、IT管理者が、データコネクターでデータを取得するためのIPアドレスをホワイトリストに登録する必要があります。詳細については、IT管理者にお問い合わせください。
| 主な使用事例 | このコネクターは、データベース内の情報をDomoに取り込むのに適しています。 |
| 主なメトリクス | 該当なし |
| 社内における主な権限 |
|
| 平均導入時間 | 10時間以内 |
| 使いやすさ(1~10の段階。1が「最も使いやすい」) | 9 |
ベストプラクティス
- 読み取り専用クエリのみを使用します。
- 「Append」ではなく「Replace」を使用します。
必要条件
PostgreSQLデータベースにSSHトンネル経由で接続しDataSetを作成するには、以下が必要です。- PostgreSQLデータベースのログインに使用するユーザー名とパスワード
- PostgreSQLデータベースの名前
- PostgreSQLデータベースのポート番号
- PostgreSQLデータベースサーバーのホスト名またはIPアドレス
- SSHトンネルの接続先であるUNIXサーバー
- UNIXアカウントのユーザー名とパスワード
- SSHのポート番号
- SSH秘密鍵(DESまたはRSAのいずれか)
注記: Domoはssh-keygenを使用して生成されるSSHキーをサポートしていません。SSHキーは、OpenSSLが生成するRSAキーである必要があります。
PostgreSQLデータベースに接続する
このセクションでは、PostgreSQL SSHコネクターページの [認証情報] および [詳細] ペインのオプションについて説明します。このページ内のほかのペインに含まれるコンポーネントである [スケジュール設定] や [DataSetに名前を付け、説明を入力] に関しては、ほとんどのタイプのコネクターで共通しています。詳細については「 コネクターを使用してDataSetを追加する 」を参照してください。[認証情報]ペイン
このペインには、データベースと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データベースのポート番号を入力します。 |
[詳細]ペイン
このペインでは、SQLクエリを作成して、データベースからデータを取得します。メニュー | 説明 |
|---|---|
SQL Query | 必要なデータを選択するためのSQL(構造化照会言語)クエリを入力します。例: select * from Employee |
トラブルシューティング
- 適切なIPアドレスがホワイトリストに登録されたことを確認します(IPアドレスのリストについては、「 必要条件 」 を参照してください)。
- フェッチサイズの縮小を試みるか、空白のままにします。