Connecting to Amazon Redshift
Zoomdata's Amazon Redshift connector lets you access the data available in the Amazon Redshift storage for visualization and exploration within the Zoomdata Client. Zoomdata supports Amazon Redshift versions
BEFORE YOU BEGIN
Before you can establish a connection between Amazon 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:
The table below lists information on the features that are supported by Amazon Redshift:
|Supports Distinct Count?||Yes|
|Supports Live Mode/ Playback?||Yes|
|Supports Group-by Time?||Yes|
|Supports Multi Group-by Charts?||Yes|
|Supports Box Plot?||Yes|
|Custom SQL Capable?||Yes|
|Supports Last Value?||No|
Starting with Zoomdata v2.5.3, the Amazon Redshift connector requires a JDBC driver to be configured before you can connect to your data source. You can download the driver from the vendor's site. Be aware that the JDBC Driver for Redshift contains more than one jar file. You need to place them in the same location to avoid any issues.
If you are upgrading, keep in mind you will need to configure the JDBC driver (refer to the article Upgrading Zoomdata Server to v2.5 for instructions). For more information, see Adding a JDBC Driver.
CONFIGURING THE CONNECTION
For details about what is provided on each page of the connection process, review the article Source Connection Workflow . Depending on your needs, you can either follow the steps in order from start to finish or jump to a specific section in the connection process:
- General Page
When the connector server is set up by the Zoomdata Administrator, certain parameters on the Connectors page may be customized. The instructions below assumes that the default configuration parameters were kept. If this is not the case, then your Connection page may differ slightly from the screen captures and references provided.
- Tables Page
- Refresh Page
- Refresh Page
- Charts Page
Log into Zoomdata.
Administrators and users with appropriate access privileges can connect data sources in Zoomdata.
- Click the Sources menu item.
- Click Next to continue to the next setup page.
This page defines the connection source for Zoomdata to be able to access the data source. If this is the first time setting up a connection, then you need to input the necessary credentials. If a validated connection already exists, you are given the option to use it.
- To create a new connection, select the Input New Credentials option.
- Enter a unique name for the connection (to help distinguish between other connections in this Zoomdata account).
Specify the JDBC URL. You can find the URL on the
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:
If authentication has been set up, provide the User Name and Password.
If successfully validated, the connection is saved.
The Tables page lets you select the schema and collection to connect with and provides a preview of the selected collection. In addition, caching options and toggling the availability of the fields can be done on this page.
- Select the schema, if available, and then select the desired collection to connect to Zoomdata.
- Create a Custom SQL query, if needed.
- Toggle the caching option, as needed.
- Toggle the availability of the fields, as needed.
- Click Next to continue.
The Fields page lets you (1) configure attribute options, (2) create custom labels for the fields in your data source (that will be displayed in the charts), (3) manage the Volume metric, and (4) work with Calculations.
- Determine whether the field should be visible or not to the user.
- Create unique label names, as needed, for each Label field.
- For the Type column, you have the option to edit the field type (although usually you won't need to do this).
- For the Configure column, numeric and time-based fields may be edited:
- Select fields for Distinct Counts as needed.
- Refresh the connection to a particular field, as desired.
- Configure Filter Display settings for fields.
- Edit the Volume Metric settings, as needed.
, if available and as needed.
If you are setting up a new connection, the Calculations section will not be available until after the connection is saved.
- Click Next to continue.
The Refresh page lets you schedule asynchronous jobs to update the source metadata. For guidance to set up a refresh schedule, refer to the article Using the Zoomdata Scheduler .
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, sub-group, colors, sorting, and so on) for each chart style.
Click Finish to save your changes. Once your data connection has been established, it will be listed under the My Data Sources section of the page.