https://github.com/aws/amazon-documentdb-jdbc-driver
Amazon DocumentDB JDBC driver to connect from BI tools and execute SQL Queries
https://github.com/aws/amazon-documentdb-jdbc-driver
aws database documentdb documentdb-jdbc jdbc sql
Last synced: 8 months ago
JSON representation
Amazon DocumentDB JDBC driver to connect from BI tools and execute SQL Queries
- Host: GitHub
- URL: https://github.com/aws/amazon-documentdb-jdbc-driver
- Owner: aws
- License: apache-2.0
- Created: 2021-05-06T00:35:25.000Z (almost 5 years ago)
- Default Branch: develop
- Last Pushed: 2024-04-25T23:45:06.000Z (almost 2 years ago)
- Last Synced: 2025-06-22T02:11:59.866Z (8 months ago)
- Topics: aws, database, documentdb, documentdb-jdbc, jdbc, sql
- Language: Java
- Homepage:
- Size: 9.92 MB
- Stars: 16
- Watchers: 9
- Forks: 14
- Open Issues: 37
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# 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](CONTRIBUTING.md#security-issue-notifications) for more information.
## License
This project is licensed under the Apache-2.0 License.
## Documentation
See the [product documentation](src/markdown/index.md) for more detailed information about this driver.
## Setup and Usage
To setup and use the DocumentDB JDBC driver, follow [these directions](src/markdown/setup/setup.md).
## Connection String Syntax
```
jdbc:documentdb://[[:]@][:]/[?=[&=[...]]]
```
For more information about connecting to an Amazon DocumentDB database using this JDBC driver, see
the [connection string documentation](src/markdown/setup/connection-string.md) 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](src/markdown/schema/schema-discovery.md)
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](src/markdown/schema/manage-schema-cli.md) and
[table schemas JSON format](src/markdown/schema/table-schemas-json-format.md) for further
information.
## SQL and JDBC Limitations
The Amazon DocumentDB JDBC driver has a number of important limitations. See the
[SQL limitations documentation](src/markdown/sql/sql-limitations.md) and
[JDBC limitations documentation](src/markdown/jdbc/jdbc-limitations.md) for more information.
## Troubleshooting Guide
If you're having an issue using the Amazon DocumentDB JDBC driver, consult the
[Troubleshooting Guide](src/markdown/support/troubleshooting-guide.md) to see if has a solution for
your issue.
## Security Notice
If you discover a potential security issue in this project, please consult our [security guidance page](SECURITY.md).
## Contributor's Getting Started Guide
If you're a developer and want to contribute to this project, ensure to read and follow the
[Getting Started as a Developer](GETTING_STARTED.md) guide.