You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+11-6Lines changed: 11 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -18,21 +18,26 @@ In an Amazon Aurora database (DB) cluster, failover is a mechanism by which Auro
18
18
Although Aurora is able to provide maximum availability through the use of failover, existing client drivers do not currently support this functionality. This is partially due to the time required for the DNS of the new primary DB instance to be fully resolved in order to properly direct the connection. The AWS Advanced JDBC Wrapper allows customers to continue using their existing community drivers in addition to having the JDBC Wrapper fully exploit failover behavior by maintaining a cache of the Aurora cluster topology and each DB instance's role (Aurora Replica or primary DB instance). This topology is provided via a direct query to the Aurora DB, essentially providing a shortcut to bypass the delays caused by DNS resolution. With this knowledge, the AWS Advanced JDBC Wrapper can more closely monitor the Aurora DB cluster status so that a connection to the new primary DB instance can be established as fast as possible. Additionally, as noted above, the AWS Advanced JDBC Wrapper is designed to augment existing JDBC community drivers and be a unified connector to JDBC workflows for Aurora.
19
19
20
20
## Getting Started
21
-
For more information on how to obtain the JDBC Wrapper, minimum requirements to use it, and how to integrate the JDBC Wrapper into your project, please visit the [getting started page](./docs/GettingStarted.md).
21
+
For more information on how to obtain the JDBC Wrapper, minimum requirements to use it, and how to integrate the JDBC Wrapper into your project, please visit the [Getting Started page](./docs/GettingStarted.md).
22
+
23
+
## Using the Wrapper
24
+
Please refer to the JDBC Wrapper's [Documentation page](./docs/Documentation.md) for details about using the JDBC Wrapper.
25
+
26
+
## Logging
27
+
To configure logging, check out the [Logging](./docs/using-the-jdbc-wrapper/UsingTheJdbcWrapper.md#logging) section.
22
28
23
29
## Documentation
24
-
Please refer to the JDBC Wrapper's [documentation](./docs/Documentation.md) for details on how to use the JDBC Wrapper and for a development guide. All technical documentation regarding the functionality of the AWS Advanced JDBC Wrapper will be contained in this GitHub repository. Since the JDBC Wrapper requires an underlying JDBC Driver, please refer to the individual driver's documentation for driver specific information.
30
+
Technical documentationregarding the functionality of the AWS Advanced JDBC Wrapper will be maintained in this GitHub repository. Since the JDBC Wrapper requires an underlying JDBC Driver, please refer to the individual driver's documentation for driver specific information.
25
31
26
32
## Getting Help and Opening Issues
27
33
If you encounter a bug with the AWS Advanced JDBC Wrapper, we would like to hear about it.
28
-
Please search the [existing issues](https://github.com/awslabs/aws-advanced-jdbc-wrapper/issues) to see if others are also experiencing the issue before opening a new issue.
29
-
The GitHub issues are intended for bug reports and feature requests. Keeping the list of open issues lean will help us respond in a timely manner.
34
+
Please search the [existing issues](https://github.com/awslabs/aws-advanced-jdbc-wrapper/issues) to see if others are also experiencing the issue before reporting the problem in a new issue.
35
+
GitHub issues are intended for bug reports and feature requests. Keeping the list of open issues lean will help us respond in a timely manner.
30
36
31
37
When opening a new issue, please include a reproduction case and logs for the issue to help expedite the investigation process.
32
-
To configure logging, check out the [Logging](./docs/using-the-jdbc-wrapper/UsingTheJdbcWrapper.md#logging) section.
33
38
34
39
## How to Contribute
35
-
1. Set up your environment by following the [Development Guide](docs/development-guide/DevelopmentGuide.md)
40
+
1. Set up your environment by following the directions in the [Development Guide](docs/development-guide/DevelopmentGuide.md).
36
41
2. To contribute, first make a fork of this project.
37
42
3. Make any changes on your fork. Make sure you are aware of the requirements for the project (e.g. do not require Java 7 if we are supporting Java 8 and higher).
0 commit comments