This section shows how to establish a connection to data in DbVisualizer, use the table editor to edit and save data, and execute SQL.

Add the JDBC Driver for Amazon DynamoDB

Complete the following steps to add the driver .jar file in a driver definition:

1. In DbVisualizer, select Tools > Driver Manager and then select Driver > Create Driver.
2. Enter a name for the driver.
3. Enter the following in the URL Format box:
   

   jdbc:amazondynamodb:

4. In the Driver JAR Files section, click the folder icon and browse to the driver .jar file, cdata.jdbc.amazondynamodb.jar. By default, this is located in the lib subfolder of the installation directory. Note that the .lic file in this folder must be located in the same folder as the .jar file.
5. In the Driver Class menu, select the AmazonDynamoDBDriver class, cdata.jdbc.amazondynamodb.AmazonDynamoDBDriver.

Create a Database Connection for Amazon DynamoDB

Complete the following steps to select the Amazon DynamoDB driver and build the JDBC URL to create the JDBC data source:

1. In the main DbVisualizer window, select Tools > Connection Wizard.

2. Enter an alias for the connection.
3. Select the driver definition you created.

4. In the following fields, enter the JDBC URL and provide authentication.

   See Establishing a Connection for a guide.

5. Database URL: Enter the full JDBC URL. The syntax of the JDBC URL is jdbc:amazondynamodb: followed by the connection properties in a semicolon-separated list of name-value pairs.

   A typical connection string is below:
   

   jdbc:amazondynamodb:AWS Access Key=xxx;AWS Secret Key=xxx;Domain=amazonaws.com;AWS Region=OREGON;

6. Database UserId: Enter the username for authentication to Amazon DynamoDB, if needed.
7. Database Password: Enter the password for authentication to Amazon DynamoDB, if needed.

Note: After you successfully create a database connection for Amazon DynamoDB you should set the "Database Type" property to "Generic".

Discover Schemas and Query Amazon DynamoDB Data

In the main DbVisualizer window, click Connect on the Connection tab for the newly created connection. You can then browse data and execute SQL in the following ways:

• To access the available tables, from the Databases tab, expand the nodes for the connection, database, schema, and table or view.
• To browse through table data and metadata, right-click a table and click Open in New Tab.
• To execute SQL queries, select SQL Commander > New SQL Commander. Select the Database Connection, Database, and Schema from the available menus.

See NoSQL Database for information on querying specific tables. See SQL Compliance for more information on the SQL syntax.