is an easy-to-use online platform for creating and sharing non-relational document based databases. For more information, see https://aws.amazon.com/dynamodb/.

Limitations and Requirements

Create Connection

via

When you create the connection, please review the following properties and specify them accordingly:

Connection PropertyDescription
DomainYour AWS domain name. The default domain value is amazonaws.com.
AWS RegionThe hosting region for your Amazon Web Services resources. Default is set to Oregon .
Connect String Options

The following default value sets the connection timeout in seconds:

Timeout=0;

Setting this value to 0 disables timeouts.

Access key IDYour AWS account access key. This value is accessible from your AWS security credentials page.
Secret access keyYour AWS account secret key. This value is accessible from your AWS security credentials page.
Default Column Data Type InferenceLeave this value as Enabled.

For more information, see the driver documentation  https://cdn.cdata.com/help/DDG/jdbc/ .

via API

Depending on your product edition, you can create connections of this type. Key information:

"vendor": "amazon_dynamodb",
"vendorName": "Amazon DynamoDB",
"type": "jdbc"

For more information, see

operation/createConnection

Data Type Conversions

For more information, see the driver documentation https://cdn.cdata.com/help/DDG/jdbc/ .

Flattening Documents

Documents can contain other documents, which enables the storage of nested data. You can control the flattening of nested objects and arrays through the CData driver through Connect String Options.

NOTE: Columns that have been flattened can be accessed or referenced using custom SQL queries. Additional information is below.

Flatten Objects:

By default, the CData driver flattens nested Objects. As needed, you can set FlattenObjects to  false  to disable this behavior.

In , objects are represented as Map datatype.

For more information, see https://cdn.cdata.com/help/DDG/jdbc/RSBDynamoDB_p_FlattenObjects.htm.

Flatten Arrays:

By default, CData driver does not flatten Arrays.

As needed, you can configure the number of elements that you want to have returned in your flattened arrays.  

In , Arrays are represented as NumberSet, StringSet ,or BinarySet datatypes.  

NOTE: List datatype does not support flattening property.

For more information, see https://cdn.cdata.com/help/DDG/jdbc/RSBDynamoDB_p_FlattenArrays.htm.

Referencing flattened columns:

If you have flattened Objects or Arrays, you can reference these columns using square brackets in your custom SQL queries.

Example of flattened Object:

SELECT [address.city] FROM my_table;

Example of flattened Array:

SELECT * FROM my_table WHERE [hobbies.0]='cricket';