はじめに
MySQLは、広く使用されているオープンソースのリレーショナルデータベース管理システムです。DomoのMySQL SSHコネクターを使用すると、MySQLデータベースからデータを引き出し、カスタムレポートを作成できます。取得するデータの指定は、SQLクエリの入力で行います。MySQL APIの詳細については、ウェブサイト（ http://dev.mysql.com/doc/refman/5.0/en/c-api.html ）を参照してください。 MySQL SSHコネクターは「データベース」コネクターです。つまり、クエリを使ってデータベースからデータを取得します。Data Centerでは、ウィンドウ上部のツールバーで ［データベース］ をクリックすることで、このコネクターやほかのデータベースコネクターのページにアクセスできます。 MySQLデータベースには、Data Centerから接続します。このトピックでは、MySQL SSHコネクターユーザーインターフェイスに固有のフィールドとメニューについて説明します。DataSetの追加や更新スケジュールの設定、DataSet情報の編集に関する一般的な情報は、「 コネクターを使用してDataSetを追加する 」を参照してください。主な使用事例 | データマートとデータウェアハウスSQLクエリを取得する |
主なメトリクス | 該当なし |
社内における主なロール |
|
平均導入時間 | 5～40時間以上 |
使いやすさ（1～10の段階。1が「最も使いやすい」） | 7 |
ベストプラクティス
- 結果セットのサイズをできる限り制限します。
- 列数を最小限に抑えます。
必要条件
MySQLデータベースにSSHサーバー経由で接続してDataSetを作成するには、以下が必要です。- SSHトンネルを使用しているUNIXサーバーのホスト名
- UNIXアカウントのSSHユーザー名とパスワード
- データベースのホスト名
- SSH秘密キー（DESまたはRSAのいずれか）
- データベース名
- MySQLデータベースにログインするためのユーザー名とパスワード
MySQLアカウントを作成する
MySQLアカウントは次の2つの方法で作成することができます。- アカウントの作成とアカウント権限の設定を行うためのアカウント管理ステートメントを使用する（ CREATE USER や GRANT など）。このようなステートメントを使用すると、ベースとなる権限テーブルがサーバーによって更新されます。
- MySQLの権限テーブルを、 INSERT 、 UPDATE 、 DELETE などのステートメントで直接操作する。
ホワイトリストに登録する
MySQLデータベースに接続する前に、データベースサーバーの接続ポートでIPアドレスをいくつかホワイトリストに登録する必要があります。IPアドレスの詳細なリストについては、「 コネクターのIPアドレスをホワイトリストに登録する 」を参照してください。MySQLデータベースに接続する
このセクションでは、MySQLコネクターページの ［認証情報］ および ［詳細］ ペインのオプションについて説明します。このページ内のほかのペインに含まれるコンポーネントである ［スケジュール設定］ や ［DataSetに名前を付け、説明を入力］ に関しては、ほとんどのタイプのコネクターで共通しています。詳細については「 コネクターを使用してDataSetを追加する 」を参照してください。［認証情報］ ペイン
このペインには、データベースに接続するための認証情報の入力フィールドが含まれています。以下の表で、各フィールドについて説明します。フィールド | 説明 |
|---|---|
SSH Server Hostname | SSHトンネルの接続先であるUNIXサーバーのホスト名を入力します。 |
SSH Username | UNIXアカウントのSSHユーザー名を入力します。 |
SSH Password | UNIXアカウントのSSHパスワードを入力します。 |
Database Hostname | SQLデータベースのホスト名またはIPアドレスを入力します。例： db.company.com |
SSH Private Key | SSH秘密キー（DESまたはRSAのいずれか）を入力します。 |
Database Name | SQLデータベース名、あるいはスキーマ名を入力します。 |
Database Username | MySQLユーザー名を入力します。 |
Database Password | MySQLパスワードを入力します。 |
［詳細］ペイン
このペインで、SQLクエリを作成してデータベースからデータを取得し、いくつかのオプションを指定します。メニュー | 説明 | ||||
|---|---|---|---|---|---|
Query Type | クエリタイプを選択します。
| ||||
SQL Query | データを選択する時に使用する構造化照会言語（SQL）クエリです。例： select * from Employee | ||||
Query Parameter | クエリパラメーターの値を入力します。これはクエリパラメーターの初期値になります。最終実行日はオプションです。指定されていない場合は、デフォルトで「02/01/1700」になります。 例：!{lastvalue:_id}!=1,{lastrundate:start_date}!=02/01/1944 | ||||
| TINYINT Values Treated as Bit (Boolean) Values? | TINYINT値をBoolean値として扱う場合は、 ［Yes］ を選択します。 | ||||
| Keep Connection Alive For Large Queries | 大きなクエリ用に接続を維持するべき場合は、 ［Yes］ を選択します。 | ||||
| Include HTML Tag | データと共にHTMLタグを含めるには、［Yes］を選択します。 |
その他のペイン
スケジュール設定、再試行、更新に関するオプションなど、コネクターインターフェースのその他のペインに表示されるオプションについては、「 コネクターを使用してDataSetを追加する 」を参照してください。トラブルシューティング
- MySQL Workbenchを使用して、認証情報を確認します。
- 暗号化された接続がサーバーでサポートされているかどうかを確認します。
- Domo IPがホワイトリストに登録されているかどうかを確認します。