The Sisense DynamoDB connector is a standalone connector that allows you to import data from the DynamoDB API into the ElastiCube Manager. After you have downloaded and installed the connector, you can connect through a connection string you provide Sisense in the ElastiCube Manager. The connection string is used to authenticate users who connect to the DynamoDB API. To obtain a connection string, you will need to create a DynamoDB developers account.

Once you have connected to DynamoDB, you can import a variety of tables from the DynamoDB API.

This page describes how to install the DynamoDB connector, how to connect to DynamoDB with a connection string, and what tables you can import into the ElastiCube Manager:

Installing the DynamoDB Connector

Sisense provides the DynamoDB connector as a standalone connector that you can download and add to your list of default Sisense connectors.

To install the DynamoDB connector:

  1. Download the DynamoDB installation file.
  2. Open the installation file and click Install.
  3. After the installation process is complete, click Close.

The DynamoDB connector is displayed in the ElastiCube Manager under Add Data > Web Services.

dynamodb

Connecting to the DynamoDB REST API

The connection to DynamoDB is made using your AccessKey, SecretKey, and optionally your Domain and Region. Your AccessKey and SecretKey can be obtained on the security credentials page for your Amazon Web Services account. Your Region will be displayed in the upper left-hand corner when you are logged into DynamoDB.

Adding DynamoDB Tables to your ElastiCube

Sisense uses connection strings to connect to DynamoDB and import data into the ElastiCube Manager.

The connection string to connect to DynamoDB has the following structure:

jdbc:DynamoDB:Property1=Value1;Property2=Value2;

An example of a connection string:

jdbc:dynamodb:Access Key=AKIAJH283HDH2932DQ;Secret Key=vG07bFgSmvfgsrdfgHsB6iQU/HVOqO9L9g;Domain=amazonaws.com;Region=OREGON;

Note: To switch between accounts, you need to delete the file OAuthsettings.txt file located at …\Users\xxx\AppData\Roaming\CData\DynamoDB Data Provider.

To add DynamoDB data:

  1. In ElastiCube Manager, click Add Data and then, DynamoDB. The Connect to DynamoDB window is displayed.
    dynamodb2
  2. In Datasource Connection String, enter your connection string.
  3. Click Connect to Server. DynamoDB is displayed in the Select Database list.
  4. Click OK. Sisense connects to DynamoDB and displays a list of tables available for you to import.
  5. Select the relevant tables and click Add.

The tables are displayed in the ElastiCube Manager.

Switching between Accounts

When you connect to the DynamoDB data source, Sisense saves your OAuth values in the file OAuthsettings.txt file located at …\Users\xxx\AppData\Roaming\CData\DynamoDB Data Provider on your Sisense server. To connect to the DynamoDB data source with another user on the same machine, you must delete the OAuthsettings.txt file. Sisense will then generate a new file for that user.

Another option to support multiple users is to define the location and file name of an OAuthsettings file for each unique user in your connection string through the OAuthSettingsLocation parameter. When each user connects to the data source, Sisense generates the OAuth file with the file name you specify in the location you define. In the examples below, two users are allowed to access the DynamoDB data source and for each user, Sisense generates a file that contains that user’s OAuth values in the location defined in the string.

jdbc:DynamoDB:OAuthSettingsLocation=C:\DynamoDB\auth\john.txt;OAuthClientId=11276856774486;OAuthClientSecret
=064c70d78567jm2b7e7e4224fad;InitiateOAuth=GETANDREFRESH;Version=2.8;CallbackURL=http://localhost/;

jdbc:DynamoDB:OAuthSettingsLocation=C:\DynamoDB\auth\sally.txt;OAuthClientId=11276856774486;OAuthClientSecret
=064c70d78567jm2b7e7e4224fad;InitiateOAuth=GETANDREFRESH;Version=2.8;CallbackURL=http://localhost/;

In the example above, to OAuth files are created, one for John and one for Sally in the location C:\DynamoDB\auth\.

This is useful if you support many users who each need to access the DynamoDB data source.

DynamoDB Tables

The Sisense DynamoDB connector allows you to import the following tables into the ElastiCube Manager.

NameDescription
Table0Test table.
Table1Test table.
MoviesSample data file that contains information about a few thousand movies from the Internet Movie Database (IMDb).