Connecting to Amazon Redshift
The Zoomdata Server supports Redshift v1.0 and later versions.
BEFORE YOU BEGIN
Before you can establish a connection between Redshift and Zoomdata, you must verify that the size of the maximum transmission unit (MTU) on your Zoomdata Server is set to 1500.
The MTU size determines the maximum size, in bytes, of a packet that can be transferred in one Ethernet frame over your network connection. If your MTU size is too large for the connection, you might experience incomplete query results, your query might hang, or the connection might be dropped altogether(1).
(1) Excerpted from aws documentation for Amazon Redshift: " Queries Appear to Hang in the Client and Do Not Reach the Cluster ."
To review the MTU value, use the "ip" command:
If you need to edit the MTU value and set the size to 1500, use the following "ip" command:
CONNECTING TO THE AMAZON REDSHIFT CONNECTOR
Perform the following steps to configure the connector:
Log into Zoomdata.
Administrators and users with appropriate access privileges can connect data sources in Zoomdata.
- Click the Sources menu item.
page, define your connection source. You can use an existing connection, if available, or create a new one. To use existing validated credentials, select the
Use validated credentials
option button and specify the connection name and JDBC URL.
You can find the URL on the Configuration tab of a cluster under Cluster Database Properties . The format varies slightly based on the type of database being connected. For Redshift, use the following format: jdbc:redshift://HOSTNAME:PORT/DATABASE_NAME
If Redshift authentication is enabled, specify user name and password fields.
Click Validate to ensure you entered a valid URL. Valid credentials will be saved. Click Next to continue.
On the Tables page, select your database schema if needed. Use the search bar to find your database. Select the data collection that will be used for charts.
- If you want to add a custom SQL query to retrieve the data, click Custom SQL .
- On the Fields page, you can create unique label names for the available fields in your data source. These labels will be displayed in the charts. Create unique label names, as needed, for each Label field. If necessary, change the Type and Default options and select the Distinct Count checkbox to enable this option. Click Next to continue.
- On the Refresh page, you can schedule asynchronous jobs to refresh fields in your data source. Refer to Using the Zoomdata Scheduler article for more information.
- On the Charts page, you can:
- Edit Global Default Settings
- Select the Standard and, if available, Custom chart styles to be used with the data source
- Set default parameters (group-bys, colors, sorting, etc.) for each chart style
- Click Finish to save your changes.