> ## 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 Advanced Connector

## Intro

Amazon Redshift is a hosted data warehouse project that is part of the larger cloud computing platform Amazon Web Services. Redshift handles analytics workloads on large scale DataSets stored by a column-oriented DBMS principle. You can use Domo's Amazon Redshift Connector to pull data from your Redshift database and compile custom reports. You indicate the data you want by inputting an SQL query. For more information about the Redshift API, visit their website. ([http://docs.aws.amazon.com/redshift/...e/Welcome.html)](http://docs.aws.amazon.com/redshift/latest/APIReference/Welcome.html)

You connect to your Redshift database in the Data Center. This topic discusses the fields and menus that are specific to the Redshift connector user interface. General information for adding DataSets, setting update schedules, and editing DataSet information is discussed in [Adding a DataSet Using a Data Connector](/s/article/360042926274).

<Note>
  **Note:** Depending on your network's structure, you may need to whitelist any IP addresses necessary for the data connector to retrieve data. Contact your IT administrator for assistance.
</Note>

## Prerequisites

To connect to a Redshift database and create a DataSet, you must have the following:

* The username and password you use to log into your Redshift database
* The host name for the database server (e.g.
  [db.company.com](http://db.company.com) ).
* The port number for the database
* The database name

CA certificate text or URL path is required *only* if you select **Certificate String** or **URL Path**, respectively, in the **Certificate Format** menu.

Before you can connect to a Redshift database, you must also whitelist a number of IP addresses on your database server on the port you want to connect to. For the full list of IP addresses, see [Whitelisting IP Addresses for Connectors](/s/article/360043630093 "Whitelisting IP Addresses for Connectors").

## Connecting to Your Redshift Account

This section enumerates the options in the **Credentials** and **Details** panes in the Redshift Connector page. The components of the other panes in this page, **Scheduling** and **Name & Describe Your DataSet**, are universal across most connector types and are discussed in greater length in [Adding a DataSet Using a Data Connector](/s/article/360042926274 "Adding a DataSet Using a Data Connector").

### Credentials Pane

This pane contains fields for entering credentials to connect to your Redshift account. The following table describes what is needed for each field:

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:207;a"><thead><tr><th colspan="1" rowspan="1"><p><span class="s1"> Field </span></p></th><th colspan="1" rowspan="1"><p><span class="s1"> Description </span></p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p> JDBC Driver </p></td><td colspan="1" rowspan="1"><p> Select the JDBC driver you want to use to connect. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Host </p></td><td colspan="1" rowspan="1"><p> Enter the host name for the SQL database. For example: <span class="mt-font-courier-new"><a href="http://db.company.com" rel="noopener" target="_blank"> db.company.com </a></span></p></td></tr><tr><td colspan="1" rowspan="1"><p> Database </p></td><td colspan="1" rowspan="1"><p> Enter the name of the SQL database. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Username </p></td><td colspan="1" rowspan="1"><p> Enter your Redshift username. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Password </p></td><td colspan="1" rowspan="1"><p> Enter your Redshift password. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Database Port </p></td><td colspan="1" rowspan="1"><p> Enter the port number for the database. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Certificate Format </p></td><td colspan="1" rowspan="1"><p> Select the certificate format. If you do not want to include a certificate, select <b> No Certificate </b>. If you select <b> Certificate String </b>, you must paste the text for your certificate in the <b> Certificate </b> field. If you select <b> URL Path </b>, you must enter the URL where your certificate is located in the <b> Certificate </b> field. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Certificate </p></td><td colspan="1" rowspan="1"><p> Paste the text for your CA certificate or enter the URL where your certificate is located. This is optional. If you do not want to include a certificate, select <b> No Certificate </b> in the <b> Certificate Format </b> menu. </p></td></tr></tbody></table>

Once you have entered valid Redshift credentials, you can use the same account any time you go to create a new Redshift DataSet. You can manage connector accounts in the **Accounts** tab in the Data Center. For more information about this tab, see [Managing User Accounts for Connectors](/s/article/360042926054 "Managing User Accounts for Connectors").

### Details Pane

In this pane you create an SQL query to pull data from your database. You can also choose a specific database table and columns and specify a timeout value.

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:207;a"><thead><tr><th colspan="1" rowspan="1"><p> Menu </p></th><th colspan="1" rowspan="1"><p> Description </p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p> Query Type </p></td><td colspan="1" rowspan="1"><p> Select the type of query you want to execute. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Query </p></td><td colspan="1" rowspan="1"><p> Enter the Structured Query Language (SQL) query to use in selecting the data you want. </p><p> For example: </p><p><code> select \* from Employee </code></p></td></tr><tr><td colspan="1" rowspan="1"><p> Parameter Date Format </p></td><td colspan="1" rowspan="1"><p> If you have used the <b> Date </b> data type in the <b> Query Parameters </b> field, enter a parameter date format here. This is optional. If you leave this blank, Domo will attempt to infer the date format. However, for the most accurate query results, you should provide the date format. </p><p> All of the following date formats are accepted: </p><table border="1" cellpadding="1" cellspacing="1" class="mt-responsive-table"><thead><tr><th colspan="1" rowspan="1"><p> Format </p></th><th colspan="1" rowspan="1"><p> Example </p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p> EEE MMM dd HH:mm:ss z yyyy </p></td><td colspan="1" rowspan="1"><p> Mon Dec 02 13:23:22 MST 2013 </p></td></tr><tr><td colspan="1" rowspan="1"><p> yyyy-MM-dd'T'HH:mm:ss.S+S </p></td><td colspan="1" rowspan="1"><p> 2014-11-30T12:34:56.000+0000 </p></td></tr><tr><td colspan="1" rowspan="1"><p> yyyy-MM-dd'T'HH:mm:ss.S </p></td><td colspan="1" rowspan="1"><p> 2014-06-10T07:34:16.671 </p></td></tr><tr><td colspan="1" rowspan="1"><p> yyyy-MM-dd HH:mm:ss.S </p></td><td colspan="1" rowspan="1"><p> 2014-12-22 08:41:33.397 </p></td></tr><tr><td colspan="1" rowspan="1"><p> yyyy-MM-dd HH:mm:ssXXX </p></td><td colspan="1" rowspan="1"><p> 2014-06-10 05:34:16+00:00 </p></td></tr><tr><td colspan="1" rowspan="1"><p> yyyy-MM-dd'T'HH:mm:ss'Z' </p></td><td colspan="1" rowspan="1"><p> 2013-03-25T08:45:00Z </p></td></tr><tr><td colspan="1" rowspan="1"><p> yyyy-MM-dd'T'HH:mm:ssXXX </p></td><td colspan="1" rowspan="1"><p> 2014-06-10T05:34:16+00:00 </p></td></tr><tr><td colspan="1" rowspan="1"><p> yyyy-MM-dd'T'HH:mm:ss.SSS'Z' </p></td><td colspan="1" rowspan="1"><p> 2013-03-25T08:45:00.123Z </p></td></tr><tr><td colspan="1" rowspan="1"><p> EEE, dd MMM yyyy HH:mm:ss z </p></td><td colspan="1" rowspan="1"><p> Mon, Jan 20 2014 17:01:38 EST </p></td></tr><tr><td colspan="1" rowspan="1"><p> MMM dd, yyyy </p></td><td colspan="1" rowspan="1"><p> March 20, 2014 </p></td></tr><tr><td colspan="1" rowspan="1"><p> yyyy MMM dd </p></td><td colspan="1" rowspan="1"><p> 2014 March 20 </p></td></tr><tr><td colspan="1" rowspan="1"><p> MMM dd yyyy </p></td><td colspan="1" rowspan="1"><p> March 20 2014 </p></td></tr><tr><td colspan="1" rowspan="1"><p> MM/dd/yy </p></td><td colspan="1" rowspan="1"><p> 03/20/14 </p></td></tr><tr><td colspan="1" rowspan="1"><p> dd/MM/yy </p></td><td colspan="1" rowspan="1"><p> 20/03/14 </p></td></tr><tr><td colspan="1" rowspan="1"><p> MM-dd-yy </p></td><td colspan="1" rowspan="1"><p> 03-20-14 </p></td></tr><tr><td colspan="1" rowspan="1"><p> dd-MM-yy </p></td><td colspan="1" rowspan="1"><p> 20-03-14 </p></td></tr><tr><td colspan="1" rowspan="1"><p> yyyy/MM/dd </p></td><td colspan="1" rowspan="1"><p> 2014/03/20 </p></td></tr><tr><td colspan="1" rowspan="1"><p> yyyy-MM-dd </p></td><td colspan="1" rowspan="1"><p> 2014-03-20 </p></td></tr><tr><td colspan="1" rowspan="1"><p> yyyy-MMM-dd </p></td><td colspan="1" rowspan="1"><p> 2014-March-20 </p></td></tr><tr><td colspan="1" rowspan="1"><p> MM/dd/yyyy </p></td><td colspan="1" rowspan="1"><p> 03/20/2014 </p></td></tr><tr><td colspan="1" rowspan="1"><p> dd/MM/yyyy </p></td><td colspan="1" rowspan="1"><p> 20/03/2014 </p></td></tr><tr><td colspan="1" rowspan="1"><p> MM-dd-yyyy </p></td><td colspan="1" rowspan="1"><p> 03-20-2014 </p></td></tr><tr><td colspan="1" rowspan="1"><p> dd-MM-yyyy </p></td><td colspan="1" rowspan="1"><p> 20-03-2014 </p></td></tr><tr><td colspan="1" rowspan="1"><p> dd-MMM-yyyy </p></td><td colspan="1" rowspan="1"><p> 20-March-2014 </p></td></tr><tr><td colspan="1" rowspan="1"><p> MMM-dd-yyyy </p></td><td colspan="1" rowspan="1"><p> March-20-2014 </p></td></tr><tr><td colspan="1" rowspan="1"><p> yyyy-MM </p></td><td colspan="1" rowspan="1"><p> 2014-03 </p></td></tr></tbody></table></td></tr><tr><td colspan="1" rowspan="1"><p> Database Tables </p></td><td colspan="1" rowspan="1"><p> Select the database table you want to appear in your report. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Table Columns </p></td><td colspan="1" rowspan="1"><p> Select all table columns you want to appear in your report. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Query Helper </p></td><td colspan="1" rowspan="1"><p> Revise this query if desired. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Query Timeout </p></td><td colspan="1" rowspan="1"><p> Enter the connector timeout value in minutes. </p></td></tr></tbody></table>

### Other Panes

For information about the remaining sections of the connector interface, including how to configure scheduling, retry, and update options, see [Adding a DataSet Using a Data Connector](/s/article/360042926274).
