> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Amazon Redshiftコネクター

## はじめに

Amazon Redshiftは高速で拡張可能なData Warehouseであり、Data Warehouseとデータレイク全体のすべてのデータを簡単かつ費用効果の高い方法で分析できます。DomoではRedshiftのデータを活用することができます。1つのRedshiftデータソースであっても、1000の様々なデータソースであっても、すべてのデータソースをDomoに取り込み、一元化したエクスペリエンスですべてを同時に表示および分析します。

DomoはRedshiftに直接接続して必要な情報をリアルタイムで可視化できるため、分析を簡単に実行することができます。さらに、Redshiftのデータを、ほかのシステムのメトリクスと一緒にすべて単一のプラットフォームで表示することができます。DomoのAmazon Redshiftコネクターを使用して、Redshiftのデータベースからデータを取得し、カスタマイズされたレポートを作成できます。SQLクエリを入力することにより、必要なデータを指定することができます。Redshift APIの詳細については、ウェブサイト（
[https://docs.aws.amazon.com/redshift/latest/dg/c\_redshift-sql.html](https://docs.aws.amazon.com/redshift/latest/dg/c_redshift-sql.html) ）を参照してください。

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

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

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

|                                |                                             |
| :----------------------------- | :------------------------------------------ |
| **主な使用事例**                     | Redshift Dara Warehouseまたはデータマートからデータを取得する。 |
| **主なメトリクス**                    | これは、Redshiftインスタンスに保存されたデータ次第です。            |
| **社内における主な権限**                 | <ul><li>BIリード</li><li>IT権限</li></ul>        |
| **使いやすさ（1～10の段階。1が「最も使いやすい」）** | 6                                           |

## ベストプラクティス

結果セットのサイズをできる限り制限します。データの取得速度を高めるには、「フェッチサイズ」を増加できます。ただし、あまり大きなサイズにすると、コネクター実行の失敗が発生し、Redshiftインスタンスのパフォーマンスに問題が生じる可能性があります。まずは10000から始めるのが適切でしょう。

## 必要条件

Redshiftデータベースに接続し、DataSetを作成するには、以下が必要です。

* Redshiftデータベースのログインに使用するユーザー名とパスワード
* データベースサーバーのホスト名（例：[db.company.com](http://db.company.com) ）
* データベースのポート番号
* データベース名

CA証明書テキストまたはURLパスは、 **［Certificate Format］** メニューでそれぞれ **［Certificate String］** または **［URL Path］** を選択する場合 *のみ* 必要になります。

### Redshiftアカウントを作成する

Redshiftユーザーアカウントを作成するには、Redshiftデータベース管理者（DBA）に連絡し、以下を行ってもらいます。

デフォルトでは、クラスターを起動したときに作成したマスターユーザーのみがクラスターの初期データベースにアクセスできます。ほかのユーザーにアクセス権を付与するには、1つ以上のユーザーアカウントを作成する必要があります。データベースのユーザーアカウントは、個々のデータベースに属するものではなく、クラスターのすべてのデータベースでグローバルに使用できます。

CREATE USER コマンドを使って、データベースの新規ユーザーを作成します。新規ユーザーを作成する際に、新規ユーザーの名前とパスワードを指定します。パスワードは必須です。8文字から64文字で、大文字と小文字、数字がそれぞれ1つ以上含まれている必要があります。

例えば、ユーザー名をGUESTにし、パスワードをABCd4321にする場合、次のコマンドを使います。

`create user guest password 'ABCd4321';`

### IPアドレスをホワイトリストに登録する

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

## Redshiftデータベースに接続する

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

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

このペインには、データベースに接続するための認証情報の入力フィールドが含まれています。以下の表で、各フィールドについて説明します。

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:207;a"><thead><tr><th colspan="1" rowspan="1"><p> フィールド </p></th><th colspan="1" rowspan="1"><p> 説明 </p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p> JDBC Driver </p></td><td colspan="1" rowspan="1"><p> 接続に使用するJDBCドライバーを選択します。 </p></td></tr><tr><td colspan="1" rowspan="1"><p> Host </p></td><td colspan="1" rowspan="1"><p> SQLデータベースに接続するためのホスト文字列を入力します。例： <span class="mt-font-courier-new"> // <a href="http://examplecluster.cpdbcwb2mzr4.us-east-2.redshift.amazonaws.com" rel="noopener" target="_blank"> examplecluster.cpdbcwb2mzr4.us-east-2.redshift.amazonaws.com </a></span></p></td></tr><tr><td colspan="1" rowspan="1"><p> Database </p></td><td colspan="1" rowspan="1"><p> SQLデータベース名を入力します。 </p></td></tr><tr><td colspan="1" rowspan="1"><p> Username </p></td><td colspan="1" rowspan="1"><p> Redshiftユーザー名を入力します。 </p></td></tr><tr><td colspan="1" rowspan="1"><p> Password </p></td><td colspan="1" rowspan="1"><p> Redshiftパスワードを入力します。 </p></td></tr><tr><td colspan="1" rowspan="1"><p> Database Port </p></td><td colspan="1" rowspan="1"><p> データベースのポート番号を入力します。 </p></td></tr><tr><td colspan="1" rowspan="1"><p> Certificate Format </p></td><td colspan="1" rowspan="1"><p> 証明書書式を選択します。証明書を含めない場合は、 <b> ［No Certificate］ </b> を選択します。 <b> ［Certificate String］ </b> を選択する場合は、証明書用テキストを <b> ［Certificate］ </b> フィールドに貼り付ける必要があります。 <b> ［URL Path］ </b> を選択する場合は、証明書がある場所のURLを <b> ［Certificate］ </b> フィールドに入力する必要があります。 </p></td></tr><tr><td colspan="1" rowspan="1"><p> Certificate </p></td><td colspan="1" rowspan="1"><p> CA証明書用テキストを貼り付けるか、証明書がある場所のURLを入力します。これはオプションです。証明書を含めない場合は、［Certificate Format］メニューで［No Certificate］を選択します。 </p></td></tr></tbody></table>

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

### ［詳細］ペイン

このペインでは、SQLクエリを作成して、データベースからデータを取得します。指定のデータベーステーブルと列を選択し、どの列をレポートに表示するかを指定することもできます。

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:207;a"><thead><tr><th colspan="1" rowspan="1"><p> メニュー </p></th><th colspan="1" rowspan="1"><p> 説明 </p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p> Query Type </p></td><td colspan="1" rowspan="1"><p> クエリタイプを選択します。 </p><table border="1"><tbody><tr><th colspan="1" rowspan="1"> クエリタイプ </th><th colspan="1" rowspan="1"> 説明 </th></tr><tr><td colspan="1" rowspan="1"> Query Builder </td><td colspan="1" rowspan="1"> クエリを自動生成するテーブルとフィールドを選択します。 </td></tr><tr><td colspan="1" rowspan="1"> Custom Query </td><td colspan="1" rowspan="1"> 実行するSQLクエリを入力します。 </td></tr></tbody></table></td></tr><tr><td colspan="1" rowspan="1"><p> Query </p></td><td colspan="1" rowspan="1"><p> 必要なデータを選択するためのSQL（構造化照会言語）クエリを入力します。例： </p><p><span class="mt-font-courier-new"> select \* from Employee </span></p></td></tr><tr><td colspan="1" rowspan="1"> Query Parameter </td><td colspan="1" rowspan="1"><span> このチェックボックスを選択してクエリパラメーターを追加します。 </span></td></tr><tr><td colspan="1" rowspan="1"> Query Parameter </td><td colspan="1" rowspan="1"><p><span> クエリパラメーターの値を入力します。この値は、クエリパラメーターの初期値となります。最終実行日はオプションです。指定されていない場合は、デフォルトで「02/01/1700 15:22:15 -0700」になります。 </span></p><p><span> 例： <tt>!\{lastvalue:\_id}!=1,!\{lastrundate:start\_date}!=02/01/1944 </tt></span></p></td></tr><tr><td colspan="1" rowspan="1"><p> Database Tables </p></td><td colspan="1" rowspan="1"><p> レポートに表示するデータベーステーブルを選択します。 </p></td></tr><tr><td colspan="1" rowspan="1"><p> Table Columns </p></td><td colspan="1" rowspan="1"><p> レポートに表示するテーブルの列をすべて選択します。 </p></td></tr><tr><td colspan="1" rowspan="1"> Fetch Size </td><td colspan="1" rowspan="1"><span> メモリのパフォーマンスのフェッチサイズを入力します。空白の場合、デフォルト値は1000です。値に対してメモリー不足の例外が発生した場合、フェッチサイズを小さくしてください。 </span></td></tr><tr><td colspan="1" rowspan="1"> Boolean Format </td><td colspan="1" rowspan="1"><p><span> ブール型データ列で表示するためのブール型フォーマットを選択します。 </span></p><table border="1"><tbody><tr><th colspan="1" rowspan="1"> Boolean Format </th><th colspan="1" rowspan="1"> 説明 </th></tr><tr><td colspan="1" rowspan="1"> 1/0 </td><td colspan="1" rowspan="1"> trueの値は「1」を返し、falseの値は「0」を返します </td></tr><tr><td colspan="1" rowspan="1"> t/f </td><td colspan="1" rowspan="1"> trueの値は「t」を返し、falseの値は「f」を返します </td></tr><tr><td colspan="1" rowspan="1"> T/F </td><td colspan="1" rowspan="1"> trueの値は「T」を返し、falseの値は「F」を返します </td></tr><tr><td colspan="1" rowspan="1"> true/false </td><td colspan="1" rowspan="1"> trueの値は「true」を返し、falseの値は「false」を返します </td></tr></tbody></table></td></tr><tr><td colspan="1" rowspan="1"><p> Query Timeout </p></td><td colspan="1" rowspan="1"><p><span> コネクターのタイムアウト値を分単位で入力します。 </span></p></td></tr></tbody></table>

### その他のペイン

スケジュール設定、再試行、更新に関するオプションなど、コネクターインターフェースのその他のペインに表示されるオプションについては、「 [コネクターを使用してDataSetを追加する](/ja/s/article/360042926274) 」を参照してください。

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

接続問題が発生した場合は、

* pgAdminを使用して接続を確認します。
* 必要なすべてのDomo IPがホワイトリストに登録されていることを確認します（上述の「 [IPアドレスをホワイトリストに登録する](#h_7aed10c8-825b-494f-98f1-9b84b7652ebc) 」を参照）。
* SQLクエリでプロファイルを実行します。

## よくある質問

<AccordionGroup>
  <Accordion title="このコネクターを使用するにはどのような認証情報が必要ですか？">
    Redshiftデータベースのユーザー名、パスワード、ホスト名、ポート番号、データベース名が必要です。
  </Accordion>

  <Accordion title="データはどれくらいの頻度で更新できますか？">
    必要に応じて何回でも更新できます。
  </Accordion>

  <Accordion title="注意すべきAPI制限はありますか？">
    制限は使用するサーバー構成によって異なります。
  </Accordion>

  <Accordion title="クエリの記述の際に注意すべき点はありますか？">
    すべての単語、テーブル名、フィールド名が正しく記述されていることを確認してください。
  </Accordion>

  <Accordion title="メモリ不足エラーが発生しています。それはなぜですか？">
    このコネクターでは、メモリパフォーマンスのフェッチサイズのデフォルト値は1000です。メモリ不足のエラーが発生した場合は、フェッチサイズを小さくしてください。
  </Accordion>

  <Accordion title="Redshiftデータベースに接続できない理由は？IPアドレスをホワイトリストに登録する必要がありますか？">
    Redshiftデータベースに接続する前に、接続先となるデータベースサーバーのポートで使用するIPアドレスをいくつかホワイトリストに登録する必要があります。IPアドレスの詳細なリストは、「 [コネクターとフェデレーテッドアダプターのIPアドレスをホワイトリストに登録する](/ja/s/article/360043630093) 」を参照してください。
  </Accordion>
</AccordionGroup>
