Connecting to Amazon Redshift
Concept Information
Amazon Redshift is a cloud data warehouse service used for business intelligence. Use the Amazon Redshift data connector to import your organization's Amazon Redshift data.
Note
Analytics provides Amazon Redshift as an optional connector and if it is not available in your Data Access window, it is likely that the connector was not selected during installation. For more information, see Install optional Analytics data connectors and Python engine.
Before you start
To connect to Amazon Redshift, you must gather the following:
- the server and database name from the ODBC URL of the Amazon Redshift cluster
- username of the user account that has permission to connect to the database
- password of the user account that has permission to connect to the database
- the port number that was specified when the cluster was launched (ensure the port is open if you have a firewall)
Note
When gathering the required connection information:
- you can obtain the ODBC URL from the AWS Management Console by looking at the database properties for your cluster
- verify that the connecting account has database permissions, not just Amazon Redshift permissions
For more information about configuring an ODBC connection, see the online Amazon AWS documentation.
For help gathering the connection prerequisites, contact the Amazon Redshift administrator in your organization. If your administrator cannot help you, you or your administrator should contact Amazon Redshift Support.
Create an Amazon Redshift connection
- From the Analytics main menu, select Import > Database and application.
- From the New Connections tab, in the ACL Connectors section, select Amazon Redshift.
Tip
You can filter the list of available connectors by entering a search string in the Filter connections box. Connectors are listed alphabetically.
- In the Data Connection Settings panel, enter the connection settings and at the bottom of the panel, click Save and Connect.
You can accept the default Connection Name, or enter a new one.
The connection for Amazon Redshift is saved to the Existing Connections tab. In the future, you can reconnect to Amazon Redshift from the saved connection.
Once the connection is established, the Data Access window opens to the Staging Area and you can begin importing data. For help importing data from Amazon Redshift, see Working with the Data Access window.
Connection settings
Basic settings
Setting | Description | Example |
---|---|---|
Server |
Host name or IP address of the Redshift cluster. You can obtain this value from the AWS Management Console. |
|
Port | The TCP port number of the Amazon Redshift server. | 5439 |
Database |
Name of the Redshift database. If you do not specify database, the connection uses the user's default database. |
|
User |
The user name to access the Redshift server. If you are using keys to set driver options, UID takes precedence over Username. |
|
Password | The password used to authenticate the user. | |
SSL Authentication |
The SSL certificate verification mode to use when connecting to Redshift. The values available are as follows:
|
require |
Enable HTTP Proxy Connection | Specifies whether the driver can pass the IAM authentication processes through a proxy server. | |
Proxy Server | The host name or IP address of a proxy server through which to pass IAM authentication processes. | |
Proxy Port | Port number that the proxy server uses to listen for client connections. |
Advanced settings
Setting | Description | Example |
---|---|---|
Use Unicode | Specifies whether the driver returns Redshift data as Unicode or regular SQL types. | |
Show Boolean Column As String |
Specifies the SQL data type that the driver uses to return Boolean data. If enabled, the driver returns Boolean columns as SQL_VARCHAR data with a length of 5, else as SQL_BIT data. |
|
Text as LongVarChar |
Specifies the SQL data type that the driver uses to return Text data. If disabled, the driver returns text columns as SQL_VARCHAR data. |
|
Max Varchar | The maximum data length for VARCHAR columns. | 255 |
Max LongVarChar | The maximum data length for LongVarChar columns. | 8190 |
Max Bytea | The maximum data length for Bytea columns. | 255 |