はじめに
Amazon Redshiftは、ホスト型Data Warehouseプロジェクトで、大型クラウドコンピューティングプラットフォームであるAmazon Web Servicesの一部です。Amazon Redshift SSH Writebackコネクターを使うと、Domo DataSetから提供されているAmazon RedshiftデータベースにSSHトンネルを使って簡単かつ安全にデータをエクスポートできるようになります。 Redshift APIについて詳しくは、ウェブサイト( http://docs.aws.amazon.com/redshift/…_commands.html )を参照してください。 Data CenterでDomo-Redshift接続を設定します。このトピックでは、Amazon Redshift SSH Writebackコネクターのユーザーインターフェースに固有のフィールドとメニューについて説明します。DataSetの追加や更新スケジュールの設定、DataSet情報の編集に関する一般的な情報は、「 コネクターを使用してDataSetを追加する 」を参照してください。注記: Writeback DataSetの所有者は、入力DataSetの所有者または共同所有者である必要があります。
必要条件
このコネクターを構成するには、以下の情報が必要です。- SSHトンネルを使用しているUNIXサーバーのホスト名
- UNIXアカウントのSSHユーザー名とパスワード
- SSHポート番号
- SSH秘密キー
- Redshiftデータベースのホスト名またはIPアドレス
- Redshiftデータベース名
- Redshiftデータベースのログインに使用するユーザー名とパスワード
- Redshiftデータベースのポート番号
- AWSアクセスキー。これは、AWS Consoleの[Security Credentials]セクションで、IAMを使用している場合は[Users]で確認できます。
- AWSシークレットキー。これは、アクセスキーを作成したときに提供されたものです。新しいシークレットキーは、AWS Consoleで生成できます。
- AWS S3バケットの名前
- Google Developersアカウントに関連付けられたクライアントIDとクライアントシークレット
- CA証明書テキストまたはURLパスは、[Certificate String] または [URL Path] をそれぞれ [Certificate Format] メニューで選択した時 のみ 必要になります。
注記: Domoは、ssh-keygenを使用して生成されるSSHキーをサポートしていません。SSHキーは、OpenSSLが生成するDESまたはRSAキー(PEM形式)である必要があります。
DomoクライアントIDとクライアントシークレットを作成するには、以下の手順を実行します。
- Domoデベロッパーアカウント にログインします。
- 右上隅の [My Account] の下にある [New Client] をクリックします。
- アプリケーション名と説明を入力します。
- [Data] と [User] のチェックボックスを選択して、アプリケーションのスコープを指定します。
- [Create] をクリックします。
- クライアントの作成が完了すると、 [Manage Client] をクリックすることによってクライアントを管理できるようになります。
接続を設定する
このセクションでは、Amazon Redshift SSH Writebackコネクターページの [認証情報] および [詳細] ペインのオプションについて説明します。このページのほかのペインの項目にある [スケジュール設定] や [DataSetに名前を付け、説明を入力] に関しては、ほとんどのタイプのコネクターで共通しています。詳細については、「 コネクターを使用してDataSetを追加する 」を参照してください。[認証情報]ペイン
このペインには、DomoデベロッパーアカウントとAmazon Redshiftデータベースに接続するための認証情報の入力フィールドがあります。下表では、各フィールドに必要な内容を説明しています。フィールド | 説明 |
|---|---|
| SSH Server Hostname | SSHトンネルの接続先であるUNIXサーバーのホスト名を入力します。 |
| SSH Username | UNIXアカウントのSSHユーザー名を入力します。 |
| SSH Password | UNIXアカウントのSSHパスワードを入力します。 |
| SSH Port | SSHポート番号を入力します。 |
| SSH Private Key | SSH秘密キーを入力します。 |
| Database Hostname | Redshiftデータベースのホスト名またはIPアドレスを入力します。 |
| Database Name | Redshiftデータベース名を入力します。 |
| Database Username | Redshiftデータベースのログインに使用するユーザー名を入力します。 |
| Database Password | Redshiftデータベースのログインに使用するパスワードを入力します。 |
| Database Port | Redshiftデータベースのポート番号を入力します。 |
| Certificate Format | 証明書書式を選択します。証明書を含めない場合は、 [No certificate] を選択します。証明書テキストを選択する場合は、 [Certificate] フィールドに証明書のテキストを貼り付ける必要があります。 [URL path] を選択する場合は、証明書がある場所のURLを [Certificate] フィールドに入力する必要があります。 |
Certificate | CA証明書用テキストを貼り付けるか、証明書がある場所のURLを入力します。これはオプションです。証明書を含めない場合は、 [Certificate Type] メニューで [No Certificate] を選択します。 |
| Access Key | AWSアクセスキーを入力します。これは、AWS Consoleの[Security Credentials]セクションで、IAMを使用している場合は[Users]で確認できます。 |
| Secret Key | AWSシークレットキーを入力します。これは、アクセスキーを作成したときに提供されたものです。新しいシークレットキーは、AWS Consoleで生成できます。 |
| Region | Amazon S3のリージョンを選択します。 |
| Bucket | AWS S3バケットの名前を入力します。 |
| Domo Client ID | DomoクライアントIDを入力します。 |
| Domo Client Secret | Domoクライアントシークレットを入力します。 |
[詳細]ペイン
このペインには、データを指定してデータの送信先を示すための多数のフィールドがあります。メニュー | 説明 |
|---|---|
| Input DataSet ID | DataSet URLにあるDomo DataSet ID(GUID)を入力します。 Data CenterでDataSetの詳細ビューを開き、URLの「 datasources/ 」に続く部分でIDを見つけることができます。例えば、URLが https://mycompany.domo.com/datasources/845305d8-da3d-4107-a9d6-13ef3f86d4a4/details/overview であれば、DataSet IDは 845305d8-da3d-4107-a9d6-13ef3f86d4a4 になります。 |
| Table Name Source | Redshiftテーブルに名前を付ける方法を選択します。
|
| Custom Table Name | Redshiftテーブルの名前を入力します。 |
| Schema Name | DataSetのデータを書き込むスキーマを選択します。 |
| Operation Type | 新しいテーブルを作成するか既存のテーブルを更新するかを選択します。 |
| Create New Table | 実行ごとに新しいテーブルを作成するには、このオプションを選択します。テーブル名は、テーブル名ソースフィールドで指定された名前に数値カウンターが追加されます。 |
| Update an Existing Table | Redshiftサーバーでテーブル名が既存のものと一致した場合にのみ既存のテーブルを更新します。一致しなければ、コネクターは最初の実行で新しいテーブルを作成します。 |
| Append Or Overwrite | データベーステーブルの更新方法を選択します。 注記: 最初の実行でテーブルが存在しない場合、コネクターは新しいテーブルを作成することができます。その後の実行またはスケジュール実行で、選択されたオプションに従ってテーブルを更新します。 |
| Append Data | コネクターは取得したデータを既存のテーブルに追加します。 |
| Overwrite With New Data | コネクターは取得した新しいデータで既存のテーブルを上書きします。 |
その他のペイン
スケジュール設定、再試行、オプションの更新など、コネクターインターフェースの残りのセクションについては、「 コネクターを使用してDataSetを追加する 」を参照してください。よくある質問
このコネクターを作成するにはどのような認証情報が必要ですか?
このコネクターを作成するにはどのような認証情報が必要ですか?
Redshift SSHサーバーのホスト名、ポート番号、秘密キー、ユーザー名、パスワード、およびデータベースのホスト名、ポート番号、データベース名、ユーザー名、パスワードが必要です。AWSアクセスキーとシークレットキー、AWS S3バケット名、Domo開発者アカウント認証情報(クライアントIDとクライアントシークレット)も必要です。
Redshiftデータベースに接続できない理由は?
Redshiftデータベースに接続できない理由は?
Redshiftデータベースに接続する前に、接続先となるデータベースサーバーのポートでIPアドレスをいくつかホワイトリストに登録する必要があります。IPアドレスの詳細なリストは、「 コネクターのIPアドレスをホワイトリストに登録する 」を参照してください。
注意すべきAPI制限はありますか?
注意すべきAPI制限はありますか?
制限は使用するサーバー構成によって異なります。
トラブルシューティング
- 認証が有効であることを確認してください。
- 設定を見直し、すべての必須項目が選択されていることを確認してください。
- コネクターの履歴にエラーメッセージが記録されていないか確認してください。
- まれに、リクエストした情報が多すぎた結果、API制限またはタイムアウトに達する場合があります。記録されている場合は、コネクターの履歴でエラーメッセージと実行時間を確認することができます。また、取得するアカウント数やレポートのメトリクス数を減らしたり、取得するタイムフレームを短縮したりすることができます。