Zoomdata Version

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:

$ ip addr show eth0

If you need to edit the MTU value and set the size to 1500, use the following "ip" command:

$ ip link set dev eth0 mtu 1500

CONNECTING TO THE AMAZON REDSHIFT CONNECTOR

Perform the following steps to configure the connector:

  1. Log into Zoomdata.
    Administrators and users with appropriate access privileges can connect data sources in Zoomdata.
  2. Click the Sources menu item.

Figure 1

  1. Click the Redshift icon.
  2. Specify the name of your source and add a description (if desired).

Figure 2

  1. Click Next to continue.

Figure 3

  1. On the Connection 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

  2. If Redshift authentication is enabled, specify user name and password fields.

  3. Click Validate to ensure you entered a valid URL. Valid credentials will be saved. Click Next to continue.

  4. 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.

Figure 4

  1. If you want to add a custom SQL query to retrieve the data, click Custom SQL .
Zoomdata wraps your SQL query into a SELECT statement. If specific statements inside the wrapped query are not supported by your data source, the query will not be executed.

Figure 5

  1. 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.

Figure 6

  1. 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.
  2. 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
Learn more about how to customize a chart .


Figure 7

  1. Click Finish to save your changes.