tan-yi-cheng / amazon-documentdb-jdbc-driver

Amazon DoumentDB JDBC driver to connect from BI tools and execute SQL Queries

Amazon DocumentDB JDBC Driver

Overview

The JDBC driver for the Amazon DocumentDB managed document database provides an SQL-relational interface for developers and BI tool users.

Security

See CONTRIBUTING for more information.

License

This project is licensed under the Apache-2.0 License.

Documentation

See the product documentation for more detailed information about this driver.

Setup and Usage

To setup and use the DocumentDB JDBC driver, follow these directions.

Connection String Syntax

jdbc:documentdb://[<user>[:<password>]@]<hostname>[:<port>]/<database-name>[?<option>=<value>[&<option>=<value>[...]]]

For more information about connecting to an Amazon DocumentDB database using this JDBC driver, see the connection string documentation for more details.

Schema Discovery

The Amazon DocumentDB JDBC driver can perform automatic schema discovery and generate an SQL to DocumentDB schema mapping. See the schema discovery documentation for more details of this process.

Schema Management

Schema can be managed in the following ways:

• generated
• removed
• listed
• exported
• imported

See the schema management documentation and table schemas JSON format for further information.

SQL and JDBC Limitations

The Amazon DocumentDB JDBC driver has a number of important limitations. See the SQL limitations documentation and JDBC limitations documentation for more information.

Troubleshooting Guide

If you're having an issue using the Amazon DocumentDB JDBC driver, consult the Troubleshooting Guide to see if has a solution for your issue.