aws-advanced-jdbc-wrapper

KO | EN

gitlite — search

#hacktoberfest #react #ai #typescript #go #linux #docker #macos #windows #awesome-list #pytorch #security #ios #mcp

aws-advanced-jdbc-wrapper

(★ 356)

The Amazon Web Services JDBC Driver has been redesigned as an advanced JDBC wrapper. This wrapper is complementary to and extends the functionality of an existing JDBC driver to help an application take advantage of the features of clustered databases such as Amazon Aurora.

파일 탐색기

최종 버전 다운로드 (.zip)

- - bug_report.yml
  - documentation.yml
  - feature_request.yml
- - dependabot-auto-merge.yml
  - main.yml
  - maven_local.yml
  - maven_release.yml
  - maven_snapshot.yml
  - mlc_config.json
  - mysql_advanced_performance.yml
  - mysql_performance.yml
  - pg_advanced_performance.yml
  - pg_performance.yml
  - release_draft.yml
  - remove-old-artifacts.yml
  - run-autoscaling-tests.yml
  - run-bg-integration-tests-latest.yml
  - run-checker-framework.yml
  - run-hibernate-orm-tests.yml
  - run-integration-tests-5-instance-default.yml
  - run-integration-tests-5-instance-latest.yml
  - run-integration-tests-codebuild.yml
  - run-integration-tests-default.yml
  - run-integration-tests-full-matrix-weekly.yml
  - run-integration-tests-latest.yml
  - run-integration-tests-mysql-aurora-java-lts.yml
  - run-metrics-latest.yml
  - run-standard-integration-tests.yml
  - scorecard.yml
  - test-encryption-e2e.yml
- dependabot.yml
- pull_request_template.md
- build.gradle.kts
- gradle.properties
- README.md
- build.gradle.kts
- - amazon.header
  - checkstyle-suppressions.xml
  - google_checks.xml
- - Architecture.md
  - DevelopmentGuide.md
  - IntegrationTests.md
  - LoadablePlugins.md
  - Pipelines.md
  - PluginManager.md
  - PluginPipelinePerformanceResults.md
  - PluginService.md
  - ReadWriteSplittingPluginPerformanceResults.md
- - configuration-profile-presets.pdf
  - jquery.min.js
  - masonry.pkgd.min.js
  - scripts.js
  - style.css
- - cluster_id_one_cluster_example.jpg
  - cluster_id_two_cluster_example.jpg
  - configuration-presets.png
  - connection_plugin_manager.png
  - efm_monitor_process.png
  - enhanced_failure_monitoring_diagram.png
  - failover1.jpg
  - failover2.jpg
  - failover2_panic.jpg
  - failover_behavior.png
  - failover_diagram.png
  - jdbc_wrapper_connect_execute_pipelines_benchmarks.png
  - jdbc_wrapper_init_release_pipelines_benchmarks.png
  - jdbc_wrapper_mysql_benchmarks.png
  - jdbc_wrapper_pipelines_benchmarks.png
  - jdbc_wrapper_postgresql_benchmarks.png
  - jdbc_wrapper_postgresql_efm_30000_5000_3.png
  - jdbc_wrapper_postgresql_efm_6000_1000_1.png
  - jdbc_wrapper_postgresql_failover_efm_30000_5000_3.png
  - jdbc_wrapper_postgresql_failover_efm_6000_1000_1.png
  - jdbc_wrapper_postgresql_failover_with_30s_socket_timeout.png
  - jdbc_wrapper_postgresql_readwritesplitting_connectionpooling_performance.png
  - pipelines.png
  - plugin_manager.png
  - plugin_service.png
  - query_caching_diagram_1.png
  - query_caching_diagram_2.png
  - query_caching_perf_results.png
  - session_state_switch_connection.jpg
  - telemetry_nested.png
  - telemetry_toplevel.png
  - telemetry_traces.png
- - AwsCredentials.md
  - ClusterId.md
  - Compatibility.md
  - CompatibilityCrossPlugins.md
  - CompatibilityDatabaseTypes.md
  - CompatibilityEndpoints.md
  - ConfigurationPresets.md
  - DatabaseDialects.md
  - DataSource.md
  - ExceptionContext.md
  - FailoverConfigurationGuide.md
  - Frameworks.md
  - GlobalDatabases.md
  - HostAvailabilityStrategy.md
  - HostSelectionStrategies.md
  - SessionState.md
  - SupportForRDSMultiAzDBCluster.md
  - TargetDriverDialects.md
  - Telemetry.md
  - UsingTheJdbcDriver.md
  - UsingXADataSource.md
  - WhatIsFailover.md
- DatabaseEncryptionSetup.md
- Documentation.md
- GettingStarted.md
- index.html
- JDBC-WRAPPER-CONFIGURATION-ASSISTANT.md
- - build.gradle.kts
  - gradle.properties
- - build.gradle.kts
  - gradle.properties
- - build.gradle.kts
  - gradle.properties
- - build.gradle.kts
  - gradle.properties
  - README.md
- - build.gradle
  - gradle.properties
  - README.md
- - build.gradle.kts
  - gradle.properties
- - build.gradle.kts
  - gradle.properties
- - build.gradle.kts
  - gradle.properties
  - README.md
- - build.gradle.kts
  - CUSTOM_ANNOTATIONS.md
  - gradle.properties
  - README.md
- - build.gradle.kts
  - CUSTOM_ANNOTATIONS.md
  - gradle.properties
  - README.md
- - build.gradle.kts
  - gradle.properties
  - README.md
- - build.gradle.kts
  - gradle.properties
  - README.md
- - README.md
- - build.gradle.kts
  - gradle.properties
  - README.md
- - gradle-wrapper.jar
  - gradle-wrapper.properties
- build.gradle.kts
- gradle.properties
.editorconfig
.gitattributes
.gitignore
ADOPTERS.md
build.gradle.kts
CHANGELOG.md
CODE_OF_CONDUCT.md
CODEOWNERS.md
CONTRIBUTING.md
gradle.properties
gradlew
gradlew.bat
KEY
LICENSE
Maintenance.md
NOTICE
README.md
SECURITY.md
settings.gradle.kts
THIRD-PARTY-LICENSES

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/aws/aws-advanced-jdbc-wrapper

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd aws-advanced-jdbc-wrapper

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Gradle (Java/Kotlin)

보통 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
JDK (Java) Java/Kotlin 프로젝트를 빌드/실행하려면 필요합니다.
Gradle 레포에 포함된 gradlew(Gradle Wrapper)를 쓰면 Gradle을 따로 설치할 필요가 없습니다.

cd benchmarks

이 프로젝트의 관련 파일이 하위 폴더 안에 있어서, 먼저 그 폴더로 이동합니다.

./gradlew build

Gradle로 빌드를 진행합니다.

✅ BUILD SUCCESSFUL 메시지가 뜨면 성공입니다. build/ 폴더에 결과물이 생성됩니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

> [!NOTE]
> 📊 **We want to hear from you — community survey is open**
>
> Help us get to know who's using the AWS Advanced JDBC Wrapper. The survey is a single GitHub Discussion with one question per comment. You answer by reacting with emojis — pick **all that apply**, multi-select is supported.
>
> - Takes about 3–5 minutes
> - Covers usage, deployment topology, plugins, frameworks, and your experience
> - Every reaction is visible to the community; total participants are counted from a single 👍 on the participation comment
>
> 👉 **[Take the survey](https://github.com/aws/aws-advanced-jdbc-wrapper/discussions/1954)**
>

# Amazon Web Services (AWS) JDBC Driver
[![build_status](https://github.com/aws/aws-advanced-jdbc-wrapper/actions/workflows/main.yml/badge.svg)](https://github.com/aws/aws-advanced-jdbc-wrapper/actions/workflows/main.yml)
[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://raw.githubusercontent.com/aws/aws-advanced-jdbc-wrapper/main/LICENSE)
[![Maven Central](https://img.shields.io/maven-central/v/software.amazon.jdbc/aws-advanced-jdbc-wrapper)](https://central.sonatype.com/artifact/software.amazon.jdbc/aws-advanced-jdbc-wrapper)
[![Javadoc](https://javadoc.io/badge2/software.amazon.jdbc/aws-advanced-jdbc-wrapper/javadoc.svg)](https://javadoc.io/doc/software.amazon.jdbc/aws-advanced-jdbc-wrapper)
[![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/aws/aws-advanced-jdbc-wrapper/badge)](https://scorecard.dev/viewer/?uri=github.com/aws/aws-advanced-jdbc-wrapper)

The **Amazon Web Services (AWS) JDBC Driver** has been redesigned as an advanced JDBC wrapper.

The wrapper is complementary to an existing JDBC driver and aims to extend the functionality of the driver to enable applications to take full advantage of the features of clustered databases such as Amazon Aurora. In other words, the AWS Advanced JDBC Wrapper does not connect directly to any database, but enables support of AWS and Aurora functionalities on top of an underlying JDBC driver of the user's choice. This approach enables service-specific enhancements, without requiring users to change their workflow and existing JDBC driver tooling.

The AWS Advanced JDBC Wrapper is targeted to work with **any** existing JDBC driver. Currently, the AWS Advanced JDBC Wrapper has been validated to support the [PostgreSQL JDBC Driver](https://github.com/pgjdbc/pgjdbc), [MySQL JDBC Driver](https://github.com/mysql/mysql-connector-j), and [MariaDB JDBC Driver](https://github.com/mariadb-corporation/mariadb-connector-j) (with some caveats, see [below](#mariadb)).

The AWS Advanced JDBC Wrapper provides modular functionality through feature plugins, with each plugin being relevant to specific database services based on their architecture and capabilities. For example, [AWS Identity and Access Management (IAM)](https://aws.amazon.com/iam/) authentication is supported across multiple services, while [AWS Secrets Manager](https://aws.amazon.com/secrets-manager/) applies to services that support password-based authentication. The fast failover plugin provides reduced recovery time during failover for Aurora PostgreSQL and Aurora MySQL clusters.

## Benefits of the AWS Advanced JDBC Wrapper for All Aurora and RDS Database Services

### Seamless AWS Authentication Service Integration

Built-in support for AWS Identity and Access Management (IAM) authentication eliminates the need to manage database passwords, while AWS Secrets Manager integration provides secure credential management for services that require password-based authentication.

### Seamless Query Caching Integration

The driver includes [Remote Query Cache Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheRemoteQueryCachePlugin.md) that stores cacheable read-only query results in a remote Valkey cache along with support for plain username/password authentication and IAM authentication with [AWS ElastiCache](https://aws.amazon.com/elasticache/). Applications can opt‑in per query using a SQL query hint that specifies a time‑to‑live (TTL).

### Preserve Existing Workflows

The wrapper design allows developers to continue using their preferred JDBC drivers and existing database code while gaining service-specific enhancements. No application rewrites are required.

### Modular Plugin Architecture

The plugin-based design ensures applications only load the functionality they need, reducing dependencies and overhead.

## Benefits of the AWS Advanced JDBC Wrapper for Aurora PostgreSQL, Aurora MySQL, and RDS

### Faster Failover and Reduced Downtime

For Aurora PostgreSQL, Aurora MySQL, and RDS Multi-AZ DB clusters, the driver significantly reduces connection recovery time during [database failovers](./docs/using-the-jdbc-driver/WhatIsFailover.md). By maintaining a real-time cache of cluster topology and bypassing DNS resolution delays, applications can reconnect to healthy database instances in seconds rather than minutes.

### Enhanced Failure Detection

The driver includes Enhanced Failure Monitoring (EFM) that proactively monitors database node health, detecting failures faster than traditional timeout-based approaches. This allows applications to respond to issues before they impact end users.

## Using the AWS Advanced JDBC Wrapper with...

### Amazon Aurora PostgreSQL and Aurora MySQL

The AWS Advanced JDBC Wrapper provides fast failover capabilities for Aurora PostgreSQL and Aurora MySQL clusters, significantly reducing connection recovery time during database failovers.

Visit [Using Failover 2](./docs/using-the-jdbc-driver/using-plugins/UsingTheFailover2Plugin.md) for more details.

### Amazon RDS Multi-AZ DB Clusters

The [AWS RDS Multi-AZ DB Clusters](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html) are capable of switching over the current writer node to another node in the cluster within approximately 1 second or less, in case of minor engine version upgrade or OS maintenance operations. The AWS Advanced JDBC Wrapper has been optimized for such fast failover when working with AWS RDS Multi-AZ DB Clusters.

With the `failover` plugin, the downtime during certain DB cluster operations, such as engine minor version upgrades, can be reduced to one second or even less with finely tuned parameters. It supports both MySQL and PostgreSQL clusters.

Visit [Support for RDS MultiAZ](./docs/using-the-jdbc-driver/SupportForRDSMultiAzDBCluster.md) for more details.

### Using the AWS Advanced JDBC Wrapper with Amazon Aurora Global Databases

As of version [3.0.0](https://github.com/aws/aws-advanced-jdbc-wrapper/releases/tag/3.0.0), the driver supports in-region `failover` and 
cross-region `planned failover` and `switchover` of [Amazon Aurora Global Databases](https://aws.amazon.com/ru/rds/aurora/global-database/). 
A [Global Writer Endpoint](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-global-database-connecting.html) 
is also recognized and can be handled to minimize potential stale DNS issues. 
Please check [failover plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheFailoverPlugin.md), [failover2 plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheFailover2Plugin.md) and 
[Aurora Initial Connection Strategy plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheAuroraInitialConnectionStrategyPlugin.md) for more information.

For detailed configuration instructions, see [Aurora Global Databases](./docs/using-the-jdbc-driver/GlobalDatabases.md).

### Plain Amazon RDS databases

The AWS Advanced JDBC Wrapper also provides limited functionality for RDS provided databases that are not Aurora, see the compatibility matrix for details.

### RDS Proxy

As of version [3.0.0](https://github.com/aws/aws-advanced-jdbc-wrapper/releases/tag/3.0.0) the [Simple R/W Splitting Plugin](https://github.com/aws/aws-advanced-jdbc-wrapper/blob/main/docs/using-the-jdbc-driver/using-plugins/UsingTheSimpleReadWriteSplittingPlugin.md#using-the-simple-readwrite-splitting-plugin-with-rds-proxy) can be used with RDS Proxy. 
There are limitations with the AWS Advanced JDBC Wrapper and RDS Proxy.  This is currently intended, by design, since the main reason is that RDS Proxy transparently re-routes requests to a single database instance. 
RDS Proxy decides which database instance is used based on many criteria (on a per-request basis).
Due to this, functionality like Failover, Enhanced Host Monitoring, and Read/Write Splitting is not compatible since the driver relies on cluster topology and RDS Proxy handles this automatically.

The driver remains useful with RDS Proxy for authentication workflows, such as IAM authentication and AWS Secrets Manager integration. 
See [Compatibility](./docs/using-the-jdbc-driver/Compatibility.md) for compatibility information and refer to the [using plugins](./docs/using-the-jdbc-driver/using-plugins) documentation for details.

Visit [Using Plain RDS](./docs/using-the-jdbc-driver/UsingTheJdbcDriver.md#using-the-aws-advanced-jdbc-wrapper-with-plain-rds-databases) for more details.

## Getting Started
For more information on how to download the AWS Advanced JDBC Wrapper, minimum requirements to use it,
and how to integrate it within your project and with your JDBC driver of choice, please visit the
[Getting Started page](./docs/GettingStarted.md).

### Maven Central
You can find our driver by searching in The Central Repository with GroupId and ArtifactId [software.amazon:aws-advanced-jdbc-wrapper][mvn-search].

[![Maven Central](https://img.shields.io/maven-central/v/software.amazon.jdbc/aws-advanced-jdbc-wrapper)](https://central.sonatype.com/artifact/software.amazon.jdbc/aws-advanced-jdbc-wrapper)
```xml

<dependency>
 <groupId>software.amazon.jdbc</groupId>
 <artifactId>aws-advanced-jdbc-wrapper</artifactId>
 <version>LATEST</version>
</dependency>
```

[mvn-search]: https://central.sonatype.com/artifact/software.amazon.jdbc/aws-advanced-jdbc-wrapper "Search on Maven Central"

## Configuring the Driver with AI Tools

The driver ships with a self-contained configuration assistant skill, [`JDBC-WRAPPER-CONFIGURATION-ASSISTANT.md`](./docs/JDBC-WRAPPER-CONFIGURATION-ASSISTANT.md), that you can drop into your AI tool's knowledge base (Kiro, Cursor, Claude Projects, ChatGPT, Amazon Bedrock, GitHub Copilot, etc.) to help build, review, or troubleshoot wrapper configurations.

For drop-in locations, example prompts, and usage details, see [Configuring the Driver with AI Tools](./docs/GettingStarted.md#configuring-the-driver-with-ai-tools) in the Getting Started guide.

## Properties

| Parameter | Reference | Documentation Link |
|-----------------------------------------------------|:--------------------------------------------------------------------------------------:|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|
| `allowStatementRecreationOnConnectionSwitch` | `UnifiedReadWriteSplittingPlugin.ALLOW_STATEMENT_RECREATION_ON_CONNECTION_SWITCH` | [Read/Write Splitting Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheReadWriteSplittingPlugin.md) |
| `appId` | `OktaAuthPlugin.APP_ID` | [Okta Authentication Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheOktaAuthPlugin.md#okta-authentication-plugin-parameters) |
| `auditLoggingEnabled` | `EncryptionConfig.AUDIT_LOGGING_ENABLED` | [KMS Encryption Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheKmsEncryptionPlugin.md) |
| `autoSortWrapperPluginOrder` | `PropertyDefinition.AUTO_SORT_PLUGIN_ORDER` | [Plugins](./docs/using-the-jdbc-driver/UsingTheJdbcDriver.md#plugins) |
| `awsProfile` | `PropertyDefinition.AWS_PROFILE` | [AWS Advanced JDBC Wrapper Parameters](./docs/using-the-jdbc-driver/UsingTheJdbcDriver.md#aws-advanced-jdbc-wrapper-parameters) |
| `bgBaselineMs` | `BlueGreenStatusProvider.BG_INTERVAL_BASELINE_MS` | [Blue/Green Deployment Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheBlueGreenPlugin.md) |
| `bgdId` | `BlueGreenConnectionPlugin.BGD_ID` | [Blue/Green Deployment Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheBlueGreenPlugin.md) |
| `bgConnectTimeoutMs` | `BlueGreenConnectionPlugin.BG_CONNECT_TIMEOUT` | [Blue/Green Deployment Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheBlueGreenPlugin.md) |
| `bgDropBlueConnections` | `BlueGreenStatusProvider.BG_DROP_BLUE_CONNECTIONS` | [Blue/Green Deployment Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheBlueGreenPlugin.md) |
| `bgHighMs` | `BlueGreenStatusProvider.BG_INTERVAL_HIGH_MS` | [Blue/Green Deployment Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheBlueGreenPlugin.md) |
| `bgIncreasedMs` | `BlueGreenStatusProvider.BG_INTERVAL_INCREASED_MS` | [Blue/Green Deployment Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheBlueGreenPlugin.md) |
| `bgSwitchoverTimeoutMs` | `BlueGreenStatusProvider.BG_SWITCHOVER_TIMEOUT_MS` | [Blue/Green Deployment Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheBlueGreenPlugin.md) |
| `clusterId` | `RdsHostListProvider.CLUSTER_ID` | [ClusterId](./docs/using-the-jdbc-driver/ClusterId.md) |
| `clusterInstanceHostPattern` | `RdsHostListProvider.CLUSTER_INSTANCE_HOST_PATTERN` | [Failover Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheFailoverPlugin.md) |
| `clusterTopologyHighRefreshRateMs` | `RdsHostListProvider.CLUSTER_TOPOLOGY_HIGH_REFRESH_RATE_MS` | [Failover Plugin v2](./docs/using-the-jdbc-driver/using-plugins/UsingTheFailover2Plugin.md) |
| `clusterTopologyRefreshRateMs` | `RdsHostListProvider.CLUSTER_TOPOLOGY_REFRESH_RATE_MS` | [Failover Plugin v2](./docs/using-the-jdbc-driver/using-plugins/UsingTheFailover2Plugin.md) |
| `connectTimeout` | `PropertyDefinition.CONNECT_TIMEOUT` | [AWS Advanced JDBC Wrapper Parameters](./docs/using-the-jdbc-driver/UsingTheJdbcDriver.md#aws-advanced-jdbc-wrapper-parameters) |
| `connectionPoolType` | `PropertyDefinition.CONNECTION_POOL_TYPE` | [AWS Advanced JDBC Wrapper Parameters](./docs/using-the-jdbc-driver/UsingTheJdbcDriver.md#aws-advanced-jdbc-wrapper-parameters) |
| `customEndpointInfoMaxRefreshRateMs` | `CustomEndpointPlugin.CUSTOM_ENDPOINT_INFO_MAX_REFRESH_RATE_MS` | [Custom Endpoint Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheCustomEndpointPlugin.md#custom-endpoint-plugin-parameters) |
| `customEndpointInfoRefreshRateBackoffFactor` | `CustomEndpointPlugin.CUSTOM_ENDPOINT_INFO_REFRESH_RATE_BACKOFF_FACTOR` | [Custom Endpoint Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheCustomEndpointPlugin.md#custom-endpoint-plugin-parameters) |
| `customEndpointInfoRefreshRateMs` | `CustomEndpointPlugin.CUSTOM_ENDPOINT_INFO_REFRESH_RATE_MS` | [Custom Endpoint Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheCustomEndpointPlugin.md#custom-endpoint-plugin-parameters) |
| `customEndpointMonitorExpirationMs` | `CustomEndpointPlugin.CUSTOM_ENDPOINT_MONITOR_IDLE_EXPIRATION_MS` | [Custom Endpoint Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheCustomEndpointPlugin.md#custom-endpoint-plugin-parameters) |
| `customEndpointRegion` | `CustomEndpointPlugin.REGION_PROPERTY` | [Custom Endpoint Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheCustomEndpointPlugin.md#custom-endpoint-plugin-parameters) |
| `dataCacheTriggerCondition` | `DataLocalCacheConnectionPlugin.DATA_CACHE_TRIGGER_CONDITION` | [Using the AWS Advanced JDBC Wrapper](./docs/using-the-jdbc-driver/UsingTheJdbcDriver.md#list-of-available-plugins) |
| `dataKeyCacheEnabled` | `EncryptionConfig.DATA_KEY_CACHE_ENABLED` | [KMS Encryption Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheKmsEncryptionPlugin.md) |
| `dataKeyCacheExpirationMs` | `EncryptionConfig.DATA_KEY_CACHE_EXPIRATION_MS` | [KMS Encryption Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheKmsEncryptionPlugin.md) |
| `dataKeyCacheMaxSize` | `EncryptionConfig.DATA_KEY_CACHE_MAX_SIZE` | [KMS Encryption Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheKmsEncryptionPlugin.md) |
| `cacheEndpointAddrRw` | `CacheConnection.CACHE_RW_ENDPOINT_ADDR` | [Remote Query Cache Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheRemoteQueryCachePlugin.md) |
| `cacheEndpointAddrRo` | `CacheConnection.CACHE_RO_ENDPOINT_ADDR` | [Remote Query Cache Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheRemoteQueryCachePlugin.md) |
| `cacheUseSSL` | `CacheConnection.CACHE_USE_SSL` | [Remote Query Cache Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheRemoteQueryCachePlugin.md) |
| `cacheTlsCaCertPath` | `CacheConnection.CACHE_TLS_CA_CERT_PATH` | [Remote Query Cache Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheRemoteQueryCachePlugin.md) |
| `cacheUsername` | `CacheConnection.CACHE_USERNAME` | [Remote Query Cache Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheRemoteQueryCachePlugin.md) |
| `cachePassword` | `CacheConnection.CACHE_PASSWORD` | [Remote Query Cache Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheRemoteQueryCachePlugin.md) |
| `cacheName` | `CacheConnection.CACHE_NAME` | [Remote Query Cache Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheRemoteQueryCachePlugin.md) |
| `cacheIamRegion` | `CacheConnection.CACHE_IAM_REGION` | [Remote Query Cache Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheRemoteQueryCachePlugin.md) |
| `cacheMaxQuerySize` | `RemoteQueryCachePlugin.CACHE_MAX_QUERY_SIZE` | [Remote Query Cache Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheRemoteQueryCachePlugin.md) |
| `cacheConnectionTimeoutMs` | `CacheConnection.CACHE_CONNECTION_TIMEOUT` | [Remote Query Cache Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheRemoteQueryCachePlugin.md) |
| `cacheConnectionPoolSize` | `CacheConnection.CACHE_CONNECTION_POOL_SIZE` | [Remote Query Cache Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheRemoteQueryCachePlugin.md) |
| `cacheKeyPrefix` | `CacheConnection.CACHE_KEY_PREFIX` | [Remote Query Cache Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheRemoteQueryCachePlugin.md) |
| `failWhenCacheDown` | `CacheConnection.FAIL_WHEN_CACHE_DOWN` | [Remote Query Cache Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheRemoteQueryCachePlugin.md) |
| `cacheInFlightWriteSizeLimitBytes` | `CacheMonitor.CACHE_IN_FLIGHT_WRITE_SIZE_LIMIT` | [Remote Query Cache Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheRemoteQueryCachePlugin.md) |
| `cacheHealthCheckInHealthyState` | `CacheMonitor.CACHE_HEALTH_CHECK_IN_HEALTHY_STATE` | [Remote Query Cache Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheRemoteQueryCachePlugin.md) |
| `cacheAllowStreamSource` | `RemoteQueryCachePlugin.CACHE_ALLOW_STREAM_SOURCE` | [Remote Query Cache Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheRemoteQueryCachePlugin.md) |
| `cacheAllowUrl` | `RemoteQueryCachePlugin.CACHE_ALLOW_URL` | [Remote Query Cache Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheRemoteQueryCachePlugin.md) |
| `database` | `PropertyDefinition.DATABASE` | [AWS Advanced JDBC Wrapper Parameters](./docs/using-the-jdbc-driver/UsingTheJdbcDriver.md#aws-advanced-jdbc-wrapper-parameters) |
| `defaultHostAvailabilityStrategy` | `HostAvailabilityStrategyFactory.DEFAULT_HOST_AVAILABILITY_STRATEGY` | [Host Availability Strategy](./docs/using-the-jdbc-driver/HostAvailabilityStrategy.md) |
| `enableClusterAwareFailover` | `FailoverConnectionPlugin.ENABLE_CLUSTER_AWARE_FAILOVER` | [Failover Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheFailoverPlugin.md) |
| `enableTelemetry` | `PropertyDefinition.ENABLE_TELEMETRY` | [Monitoring](./docs/using-the-jdbc-driver/Telemetry.md) |
| `endpointSubstitutionRole` | `AuroraInitialConnectionStrategyPlugin.ENDPOINT_SUBSTITUTION_ROLE` | [Aurora Initial Connection Strategy Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheAuroraInitialConnectionStrategyPlugin.md) |
| `enhancedLogQueryEnabled` | `LogQueryConnectionPlugin.ENHANCED_LOG_QUERY_ENABLED` | [Using the AWS Advanced JDBC Wrapper](./docs/using-the-jdbc-driver/UsingTheJdbcDriver.md#list-of-available-plugins) |
| `encryptionMetadataSchema` | `EncryptionConfig.ENCRYPTION_METADATA_SCHEMA` | [KMS Encryption Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheKmsEncryptionPlugin.md) |
| `failoverClusterTopologyRefreshRateMs` | `FailoverConnectionPlugin.FAILOVER_CLUSTER_TOPOLOGY_REFRESH_RATE_MS` | [Failover Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheFailoverPlugin.md) |
| `failoverMode` | `FailoverConnectionPlugin.FAILOVER_MODE` | [Failover Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheFailoverPlugin.md) |
| `failoverReaderConnectTimeoutMs` | `FailoverConnectionPlugin.FAILOVER_READER_CONNECT_TIMEOUT_MS` | [Failover Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheFailoverPlugin.md) |
| `failoverReaderHostSelectorStrategy` | `FailoverConnectionPlugin.FAILOVER_READER_HOST_SELECTOR_STRATEGY` | [Failover Plugin v2](./docs/using-the-jdbc-driver/using-plugins/UsingTheFailover2Plugin.md) |
| `failoverTimeoutMs` | `FailoverConnectionPlugin.FAILOVER_TIMEOUT_MS` | [Failover Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheFailoverPlugin.md) [Failover Plugin v2](./docs/using-the-jdbc-driver/using-plugins/UsingTheFailover2Plugin.md) |
| `failoverWriterReconnectIntervalMs` | `FailoverConnectionPlugin.FAILOVER_WRITER_RECONNECT_INTERVAL_MS` | [Failover Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheFailoverPlugin.md) |
| `failureDetectionCount` | `HostMonitoringConnectionPlugin.FAILURE_DETECTION_COUNT` | [Host Monitoring Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheHostMonitoringPlugin.md) |
| `failureDetectionEnabled` | `HostMonitoringConnectionPlugin.FAILURE_DETECTION_ENABLED` | [Host Monitoring Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheHostMonitoringPlugin.md) |
| `failureDetectionInterval` | `HostMonitoringConnectionPlugin.FAILURE_DETECTION_INTERVAL` | [Host Monitoring Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheHostMonitoringPlugin.md) |
| `failureDetectionTime` | `HostMonitoringConnectionPlugin.FAILURE_DETECTION_TIME` | [Host Monitoring Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheHostMonitoringPlugin.md) |
| `gdbRwHomeRegion` | `GdbReadWriteSplittingPlugin.RW_HOME_REGION` | [Global Database (GDB) Read/Write Splitting Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheGdbReadWriteSplittingPlugin.md) |
| `gdbRwRestrictReaderToHomeRegion` | `GdbReadWriteSplittingPlugin.RESTRICT_READER_TO_HOME_REGION` | [Global Database (GDB) Read/Write Splitting Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheGdbReadWriteSplittingPlugin.md) |
| `gdbRwRestrictWriterToHomeRegion` | `GdbReadWriteSplittingPlugin.RESTRICT_WRITER_TO_HOME_REGION` | [Global Database (GDB) Read/Write Splitting Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheGdbReadWriteSplittingPlugin.md) |
| `gdbAccessibleRegions` | `PropertyDefinition.GDB_ACCESSIBLE_REGIONS` | [Global Database (GDB) Failover Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheGdbFailoverPlugin.md) [Global Database (GDB) Read/Write Splitting Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheGdbReadWriteSplittingPlugin.md) |
| `gdbMonitoringConnectionPriority` | `GdbMonitoringConnectionHandler.GDB_MONITORING_CONNECTION_PRIORITY` | [Global Database (GDB) Failover Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheGdbFailoverPlugin.md) |
| `globalClusterInstanceHostPatterns` | `GlobalAuroraHostListProvider.GLOBAL_CLUSTER_INSTANCE_HOST_PATTERNS` | [Failover Plugin v2](./docs/using-the-jdbc-driver/using-plugins/UsingTheFailover2Plugin.md) [Global Database (GDB) Failover Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheGdbFailoverPlugin.md) |
| `hostAvailabilityStrategyInitialBackoffTime` | `HostAvailabilityStrategyFactory.HOST_AVAILABILITY_STRATEGY_INITIAL_BACKOFF_TIME` | [Host Availability Strategy](./docs/using-the-jdbc-driver/HostAvailabilityStrategy.md) |
| `hostAvailabilityStrategyMaxRetries` | `HostAvailabilityStrategyFactory.HOST_AVAILABILITY_STRATEGY_MAX_RETRIES` | [Host Availability Strategy](./docs/using-the-jdbc-driver/HostAvailabilityStrategy.md) |
| `iamAccessTokenPropertyName` | `IamAuthConnectionPlugin.IAM_TOKEN_PROPERTY_NAME` | [AWS IAM Authentication Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheIamAuthenticationPlugin.md) |
| `iamDefaultPort` | `IamAuthConnectionPlugin.IAM_DEFAULT_PORT` | [AWS IAM Authentication Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheIamAuthenticationPlugin.md) |
| `iamExpiration` | `IamAuthConnectionPlugin.IAM_EXPIRATION` | [AWS IAM Authentication Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheIamAuthenticationPlugin.md) |
| `iamHost` | `IamAuthConnectionPlugin.IAM_HOST` | [AWS IAM Authentication Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheIamAuthenticationPlugin.md) |
| `iamIdpArn` | `OktaAuthPlugin.IAM_IDP_ARN` | [Okta Authentication Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheOktaAuthPlugin.md#okta-authentication-plugin-parameters) |
| `iamRegion` | `IamAuthConnectionPlugin.IAM_REGION` | [AWS IAM Authentication Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheIamAuthenticationPlugin.md) |
| `iamRoleArn` | `FederatedAuthPlugin.IAM_ROLE_ARN` | [Federated Authentication Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheFederatedAuthPlugin.md) |
| `iamRoleArn` | `OktaAuthPlugin.IAM_ROLE_ARN` | [Okta Authentication Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheOktaAuthPlugin.md#okta-authentication-plugin-parameters) |
| `idpEndpoint` | `FederatedAuthPlugin.IDP_ENDPOINT` | [Federated Authentication Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheFederatedAuthPlugin.md) |
| `idpEndpoint` | `OktaAuthPlugin.IDP_ENDPOINT` | [Okta Authentication Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheOktaAuthPlugin.md#okta-authentication-plugin-parameters) |
| `idpPort` | `FederatedAuthPlugin.IDP_PORT` | [Federated Authentication Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheFederatedAuthPlugin.md) |
| `inactiveClusterWriterEndpointSubstitutionRole` | `AuroraInitialConnectionStrategyPlugin.INACTIVE_CLUSTER_WRITER_SUBSTITUTION_ROLE` | [Aurora Initial Connection Strategy Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheAuroraInitialConnectionStrategyPlugin.md) |
| `initialConnectionHostSelectorStrategy` | `AuroraInitialConnectionStrategyPlugin.HOST_SELECTOR_STRATEGY` | [Aurora Initial Connection Strategy Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheAuroraInitialConnectionStrategyPlugin.md) |
| `keyManagementMaxRetries` | `EncryptionConfig.KEY_MANAGEMENT_MAX_RETRIES` | [KMS Encryption Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheKmsEncryptionPlugin.md) |
| `keyManagementRetryBackoffBaseMs` | `EncryptionConfig.KEY_MANAGEMENT_RETRY_BACKOFF_BASE_MS` | [KMS Encryption Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheKmsEncryptionPlugin.md) |
| `kms.region` | `EncryptionConfig.KMS_REGION` | [KMS Encryption Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheKmsEncryptionPlugin.md) |
| `limitlessConnectMaxRetries` | `LimitlessConnectionPlugin.MAX_RETRIES` | [Using the Limitless Connection Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheLimitlessConnectionPlugin.md) |
| `limitlessGetTransactionRouterInfoMaxRetries` | `LimitlessConnectionPlugin.GET_ROUTER_MAX_RETRIES` | [Using the Limitless Connection Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheLimitlessConnectionPlugin.md) |
| `limitlessGetTransactionRouterInfoRetryIntervalMs` | `LimitlessConnectionPlugin.GET_ROUTER_RETRY_INTERVAL_MILLIS` | [Using the Limitless Connection Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheLimitlessConnectionPlugin.md) |
| `limitlessTransactionRouterMonitorDisposalTimeMs` | `LimitlessRouterServiceImpl.MONITOR_DISPOSAL_TIME_MS` | [Using the Limitless Connection Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheLimitlessConnectionPlugin.md) |
| `limitlessTransactionRouterMonitorIntervalMs` | `LimitlessConnectionPlugin.INTERVAL_MILLIS` | [Using the Limitless Connection Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheLimitlessConnectionPlugin.md) |
| `limitlessWaitForTransactionRouterInfo` | `LimitlessConnectionPlugin.WAIT_FOR_ROUTER_INFO` | [Using the Limitless Connection Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheLimitlessConnectionPlugin.md) |
| `loadBalancingIncludeWriter` | `UnifiedReadWriteSplittingPlugin.LOAD_BALANCING_INCLUDE_WRITER` | [Read/Write Splitting Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheReadWriteSplittingPlugin.md) |
| `loginTimeout` | `PropertyDefinition.LOGIN_TIMEOUT` | [AWS Advanced JDBC Wrapper Parameters](./docs/using-the-jdbc-driver/UsingTheJdbcDriver.md#aws-advanced-jdbc-wrapper-parameters) |
| `metadataCacheEnabled` | `EncryptionConfig.METADATA_CACHE_ENABLED` | [KMS Encryption Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheKmsEncryptionPlugin.md) |
| `metadataCacheExpirationMinutes` | `EncryptionConfig.METADATA_CACHE_EXPIRATION_MINUTES` | [KMS Encryption Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheKmsEncryptionPlugin.md) |
| `metadataCacheRefreshIntervalMs` | `EncryptionConfig.METADATA_CACHE_REFRESH_INTERVAL_MS` | [KMS Encryption Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheKmsEncryptionPlugin.md) |
| `monitorDisposalTime` | `HostMonitorServiceImpl.MONITOR_DISPOSAL_TIME_MS` | [Host Monitoring Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheHostMonitoringPlugin.md) |
| `monitoringConnectionPriority` | `AuroraMonitoringConnectionHandler.MONITORING_CONNECTION_PRIORITY` | [Global Database (GDB) Failover Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheGdbFailoverPlugin.md) |
| `openConnectionRetryIntervalMs` | `AuroraInitialConnectionStrategyPlugin.OPEN_CONNECTION_RETRY_INTERVAL_MS` | [Aurora Initial Connection Strategy Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheAuroraInitialConnectionStrategyPlugin.md) |
| `openConnectionRetryTimeoutMs` | `AuroraInitialConnectionStrategyPlugin.OPEN_CONNECTION_RETRY_TIMEOUT_MS` | [Aurora Initial Connection Strategy Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheAuroraInitialConnectionStrategyPlugin.md) |
| `password` | `PropertyDefinition.PASSWORD` | [AWS Advanced JDBC Wrapper Parameters](./docs/using-the-jdbc-driver/UsingTheJdbcDriver.md#aws-advanced-jdbc-wrapper-parameters) |
| `queryLevelLoadBalancing` | `UnifiedReadWriteSplittingPlugin.QUERY_LEVEL_LOAD_BALANCING` | [Read/Write Splitting Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheReadWriteSplittingPlugin.md) |
| `readerHostSelectorStrategy` | `ReadWriteSplittingPlugin.READER_HOST_SELECTOR_STRATEGY` | [Read/Write Splitting Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheReadWriteSplittingPlugin.md) |
| `readerInitialConnectionHostSelectorStrategy` | `AuroraInitialConnectionStrategyPlugin.READER_HOST_SELECTOR_STRATEGY` | [Aurora Initial Connection Strategy Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheAuroraInitialConnectionStrategyPlugin.md) |
| `responseMeasurementIntervalMs` | `FastestResponseStrategyPlugin.RESPONSE_MEASUREMENT_INTERVAL_MILLIS` | [Using the AWS Advanced JDBC Wrapper](./docs/using-the-jdbc-driver/UsingTheJdbcDriver.md#list-of-available-plugins) |
| `roundRobinDefaultWeight` | `RoundRobinHostSelector.ROUND_ROBIN_DEFAULT_WEIGHT` | [Host Selection Strategies](./docs/using-the-jdbc-driver/HostSelectionStrategies.md) |
| `roundRobinHostWeightPairs` | `RoundRobinHostSelector.ROUND_ROBIN_HOST_WEIGHT_PAIRS` | [Host Selection Strategies](./docs/using-the-jdbc-driver/HostSelectionStrategies.md) |
| `rpIdentifier` | `FederatedAuthPlugin.RELAYING_PARTY_ID` | [Federated Authentication Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheFederatedAuthPlugin.md) |
| `secretsManagerConnectRetryIntervalMs` | `AwsSecretsManagerConnectionPlugin.SECRETS_MANAGER_CONNECT_RETRY_INTERVAL_MS_PROPERTY` | [AWS Secrets Manager Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheAwsSecretsManagerPlugin.md) |
| `secretsManagerConnectRetryTimeoutMs` | `AwsSecretsManagerConnectionPlugin.SECRETS_MANAGER_CONNECT_RETRY_TIMEOUT_MS_PROPERTY` | [AWS Secrets Manager Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheAwsSecretsManagerPlugin.md) |
| `secretsManagerEndpoint` | `AwsSecretsManagerConnectionPlugin.ENDPOINT_PROPERTY` | [AWS Secrets Manager Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheAwsSecretsManagerPlugin.md) |
| `secretsManagerExpirationTimeSec` | `AwsSecretsManagerConnectionPlugin.SECRETS_MANAGER_EXPIRATION_SEC_PROPERTY` | [AWS Secrets Manager Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheAwsSecretsManagerPlugin.md) |
| `secretsManagerRegion` | `AwsSecretsManagerConnectionPlugin.REGION_PROPERTY` | [AWS Secrets Manager Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheAwsSecretsManagerPlugin.md) |
| `secretsManagerSecretId` | `AwsSecretsManagerConnectionPlugin.SECRET_ID_PROPERTY` | [AWS Secrets Manager Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheAwsSecretsManagerPlugin.md) |
| `secretsManagerSecretPasswordProperty` | `AwsSecretsManagerConnectionPlugin.SECRETS_MANAGER_SECRET_PASSWORD_PROPERTY` | [AWS Secrets Manager Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheAwsSecretsManagerPlugin.md) |
| `secretsManagerSecretUsernameProperty` | `AwsSecretsManagerConnectionPlugin.SECRETS_MANAGER_SECRET_USERNAME_PROPERTY` | [AWS Secrets Manager Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheAwsSecretsManagerPlugin.md) |
| `singleWriterConnectionString` | `ConnectionStringHostListProvider.SINGLE_WRITER_CONNECTION_STRING` | |
| `skipInactiveWriterClusterEndpointCheck` | `AuroraStaleDnsHelper.SKIP_INACTIVE_WRITER_CLUSTER_CHECK` | [Global Database (GDB) Failover Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheGdbFailoverPlugin.md) |
| `socketTimeout` | `PropertyDefinition.SOCKET_TIMEOUT` | [AWS Advanced JDBC Wrapper Parameters](./docs/using-the-jdbc-driver/UsingTheJdbcDriver.md#aws-advanced-jdbc-wrapper-parameters) |
| `srwConnectRetryIntervalMs` | `SimpleReadWriteSplittingPlugin.SRW_CONNECT_RETRY_INTERVAL_MS` | [Simple Read/Write Splitting Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheSimpleReadWriteSplittingPlugin.md) |
| `srwConnectRetryTimeoutMs` | `SimpleReadWriteSplittingPlugin.SRW_CONNECT_RETRY_TIMEOUT_MS` | [Simple Read/Write Splitting Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheSimpleReadWriteSplittingPlugin.md) |
| `srwReadEndpoint` | `SimpleReadWriteSplittingPlugin.SRW_READ_ENDPOINT` | [Simple Read/Write Splitting Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheSimpleReadWriteSplittingPlugin.md) |
| `srwWriteEndpoint` | `SimpleReadWriteSplittingPlugin.SRW_WRITE_ENDPOINT` | [Simple Read/Write Splitting Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheSimpleReadWriteSplittingPlugin.md) |
| `targetDriverAutoRegister` | `TargetDriverDialectManager.TARGET_DRIVER_AUTO_REGISTER` | [AWS Advanced JDBC Wrapper Parameters](./docs/using-the-jdbc-driver/UsingTheJdbcDriver.md#aws-advanced-jdbc-wrapper-parameters) |
| `tcpKeepAlive` | `PropertyDefinition.TCP_KEEP_ALIVE` | [AWS Advanced JDBC Wrapper Parameters](./docs/using-the-jdbc-driver/UsingTheJdbcDriver.md#aws-advanced-jdbc-wrapper-parameters) |
| `telemetryFailoverAdditionalTopTrace` | `FailoverConnectionPlugin.TELEMETRY_FAILOVER_ADDITIONAL_TOP_TRACE` | [Failover Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheFailoverPlugin.md) |
| `telemetryMetricsBackend` | `PropertyDefinition.TELEMETRY_METRICS_BACKEND` | [Monitoring](./docs/using-the-jdbc-driver/Telemetry.md) |
| `telemetrySubmitToplevel` | `PropertyDefinition.TELEMETRY_SUBMIT_TOPLEVEL` | [Monitoring](./docs/using-the-jdbc-driver/Telemetry.md) |
| `telemetryTracesBackend` | `PropertyDefinition.TELEMETRY_TRACES_BACKEND` | [Monitoring](./docs/using-the-jdbc-driver/Telemetry.md) |
| `user` | `PropertyDefinition.USER` | [AWS Advanced JDBC Wrapper Parameters](./docs/using-the-jdbc-driver/UsingTheJdbcDriver.md#aws-advanced-jdbc-wrapper-parameters) |
| `verifyInactiveClusterWriterEndpointConnectionType` | `AuroraInitialConnectionStrategyPlugin.VERIFY_INACTIVE_CLUSTER_WRITER_CONNECTION_ROLE` | [Aurora Initial Connection Strategy Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheAuroraInitialConnectionStrategyPlugin.md) |
| `verifyInitialConnectionType` | `SimpleReadWriteSplittingPlugin.VERIFY_INITIAL_CONNECTION_TYPE` | [Simple Read/Write Splitting Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheSimpleReadWriteSplittingPlugin.md) |
| `verifyNewSrwConnections` | `SimpleReadWriteSplittingPlugin.VERIFY_NEW_SRW_CONNECTIONS` | [Simple Read/Write Splitting Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheSimpleReadWriteSplittingPlugin.md) |
| `verifyOpenedConnectionType` | `AuroraInitialConnectionStrategyPlugin.VERIFY_OPENED_CONNECTION_ROLE` | [Aurora Initial Connection Strategy Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheAuroraInitialConnectionStrategyPlugin.md) |
| `waitForCustomEndpointInfo` | `CustomEndpointPlugin.WAIT_FOR_CUSTOM_ENDPOINT_INFO` | [Custom Endpoint Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheCustomEndpointPlugin.md#custom-endpoint-plugin-parameters) |
| `waitForCustomEndpointInfoTimeoutMs` | `CustomEndpointPlugin.WAIT_FOR_CUSTOM_ENDPOINT_INFO_TIMEOUT_MS` | [Custom Endpoint Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheCustomEndpointPlugin.md#custom-endpoint-plugin-parameters) |
| `weightedRandomHostWeightPairs` | `WeightedRandomHostSelector.WEIGHTED_RANDOM_HOST_WEIGHT_PAIRS` | [Host Availability Strategy](./docs/using-the-jdbc-driver/HostAvailabilityStrategy.md) |
| `wrapperCaseSensitive` | `PropertyDefinition.CASE_SENSITIVE` | [AWS Advanced JDBC Wrapper Parameters](./docs/using-the-jdbc-driver/UsingTheJdbcDriver.md#aws-advanced-jdbc-wrapper-parameters) |
| `wrapperDialect` | `DialectManager.DIALECT` | [Dialects](./docs/using-the-jdbc-driver/DatabaseDialects.md) |
| `wrapperDriverName` | `DriverMetaDataConnectionPlugin.WRAPPER_DRIVER_NAME` | [DriverMetaDataConnectionPlugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheDriverMetadataConnectionPlugin.md) |
| `wrapperLogUnclosedConnections` | `PropertyDefinition.LOG_UNCLOSED_CONNECTIONS` | [AWS Advanced JDBC Wrapper Parameters](./docs/using-the-jdbc-driver/UsingTheJdbcDriver.md#aws-advanced-jdbc-wrapper-parameters) |
| `wrapperLoggerLevel` | `PropertyDefinition.LOGGER_LEVEL` | [Logging](./docs/using-the-jdbc-driver/UsingTheJdbcDriver.md#logging) |
| `wrapperPlugins` | `PropertyDefinition.PLUGINS` | [AWS Advanced JDBC Wrapper Parameters](./docs/using-the-jdbc-driver/UsingTheJdbcDriver.md#aws-advanced-jdbc-wrapper-parameters) |
| `wrapperProfileName` | `PropertyDefinition.PROFILE_NAME` | [Configuration Profiles](./docs/using-the-jdbc-driver/UsingTheJdbcDriver.md#configuration-profiles) |
| `wrapperTargetDriverDialect` | `TargetDriverDialectManager.TARGET_DRIVER_DIALECT` | [AWS Advanced JDBC Wrapper Parameters](./docs/using-the-jdbc-driver/UsingTheJdbcDriver.md#aws-advanced-jdbc-wrapper-parameters) |

**A Secret ARN** has the following format: `arn:aws:secretsmanager:<Region>:<AccountId>:secret:SecretName-6RandomCharacters`

## Logging
Enabling logging is a very useful mechanism for troubleshooting any issue one might potentially experience while using the AWS Advanced JDBC Wrapper.

In order to learn how to enable and configure logging, check out the [Logging](./docs/using-the-jdbc-driver/UsingTheJdbcDriver.md#logging) section.

## Documentation
Technical documentation regarding the functionality of the AWS Advanced JDBC Wrapper will be maintained in this GitHub repository. 
Since the AWS Advanced JDBC Wrapper requires an underlying JDBC driver, please refer to the individual driver's documentation for driver-specific information.

### Using the AWS Advanced JDBC Wrapper
To find all the documentation and concrete examples on how to use the AWS Advanced JDBC Wrapper, please refer to the [AWS Advanced JDBC Wrapper Documentation](./docs/Documentation.md) page.

### Known Limitations

#### MariaDB

The MariaDB driver uses pipelining, which is not compatible with Aurora. If you use the MariaDB driver against Aurora, you should disable the following properties, because they rely on pipelining.

```java
Properties props = new Properties();
props.setProperty("usePipelineAuth", "false");
props.setProperty("useBatchMultiSend", "false");
```

#### Amazon RDS Blue/Green Deployments

Support for Blue/Green deployments using the AWS Advanced JDBC Wrapper requires specific metadata tables. The following service versions provide support for Blue/Green Deployments:

- Supported RDS PostgreSQL Versions: `rds_tools v1.7 (17.1, 16.5, 15.9, 14.14, 13.17, 12.21)` and above.
- Supported Aurora PostgreSQL Versions: Engine Release `17.5, 16.9, 15.13, 14.18, 13.21` and above.
- Supported Aurora MySQL Versions: Engine Release `3.07` and above.

Please note that Aurora Global Database and RDS Multi-AZ clusters with Blue/Green deployments is currently not supported. For detailed information on supported database versions, refer to the [Blue/Green Deployment Plugin Documentation](./docs/using-the-jdbc-driver/using-plugins/UsingTheBlueGreenPlugin.md).

## Examples

| Description | Examples |
|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|
| Using the AWS Advanced JDBC Wrapper to get a simple connection | [PostgreSQL](examples/AWSDriverExample/src/main/java/software/amazon/PgConnectionSample.java) |
| Using the AWS Advanced JDBC Wrapper with failover handling | [PostgreSQL](examples/AWSDriverExample/src/main/java/software/amazon/PgFailoverSample.java) |
| Using the AWS IAM Authentication Plugin with `DriverManager` | [PostgreSQL](examples/AWSDriverExample/src/main/java/software/amazon/AwsIamAuthenticationPostgresqlExample.java) [MySQL](examples/AWSDriverExample/src/main/java/software/amazon/AwsIamAuthenticationMysqlExample.java) [MariaDB](examples/AWSDriverExample/src/main/java/software/amazon/AwsIamAuthenticationMariadbExample.java) |
| Using the AWS IAM Authentication Plugin with `DataSource` | [PostgreSQL and MySQL](examples/AWSDriverExample/src/main/java/software/amazon/AwsIamAuthenticationDatasourceExample.java) |
| Using the AWS Secrets Manager Plugin with `DriverManager` | [PostgreSQL](examples/AWSDriverExample/src/main/java/software/amazon/AwsSecretsManagerConnectionPluginPostgresqlExample.java) [MySQL](examples/AWSDriverExample/src/main/java/software/amazon/AwsSecretsManagerConnectionPluginMySQLExample.java) |
| Using the AWS Credentials Manager to configure an alternative AWS credentials provider. | [PostgreSQL and MySQL](examples/AWSDriverExample/src/main/java/software/amazon/AwsCredentialsManagerExample.java) |
| Using the AWS Advanced JDBC Wrapper with `AWSWrapperDatasource` | [PostgreSQL](examples/AWSDriverExample/src/main/java/software/amazon/DatasourceExample.java) |
| Using the Driver Metadata Plugin to override driver name, this plugin [enables specific database features that may only be available to target drivers](https://github.com/aws/aws-advanced-jdbc-wrapper/issues/370) | [PostgreSQL](examples/AWSDriverExample/src/main/java/software/amazon/DriverMetaDataConnectionPluginExample.java) |
| Using the Read/Write Splitting Plugin with `DriverManager` | [PostgreSQL](examples/AWSDriverExample/src/main/java/software/amazon/ReadWriteSplittingPostgresExample.java) [MySQL](examples/AWSDriverExample/src/main/java/software/amazon/ReadWriteSplittingMySQLExample.java) |
| Using the Read/Write Splitting Plugin with Spring | [PostgreSQL](examples/AWSDriverExample/src/main/java/software/amazon/ReadWriteSplittingSpringJdbcTemplatePostgresExample.java) [MySQL](examples/AWSDriverExample/src/main/java/software/amazon/ReadWriteSplittingSpringJdbcTemplateMySQLExample.java) |
| Using HikariCP with the `AWSWrapperDatasource` | [PostgreSQL](examples/HikariExample/src/main/java/software/amazon/HikariExample.java) |
| Using HikariCP with the `AWSWrapperDatasource` with failover handling | [PostgreSQL](examples/HikariExample/src/main/java/software/amazon/HikariFailoverExample.java) |
| Using Spring and HikariCP with the AWS Advanced JDBC Wrapper | [PostgreSQL](examples/SpringBootHikariExample/README.md) |
| Using Spring and HikariCP with the AWS Advanced JDBC Wrapper and failover handling | [PostgreSQL](examples/SpringTxFailoverExample/README.md) |
| Using Spring and Hibernate with the AWS Advanced JDBC Wrapper | [PostgreSQL](examples/SpringHibernateExample/README.md) |
| Using Spring and Wildfly with the AWS Advanced JDBC Wrapper | [PostgreSQL](examples/SpringWildflyExample/README.md) |
| Using Vert.x and c3p0 with the AWS Advanced JDBC Wrapper | [PostgreSQL](examples/VertxExample/README.md) |
| Using the AWS Advanced JDBC Wrapper with Telemetry and using the AWS Distro for OpenTelemetry Collector | [PostgreSQL](examples/AWSDriverExample/src/main/java/software/amazon/TelemetryMetricsOTLPExample.java) |
| Using the AWS Advanced JDBC Wrapper with Telemetry and using the AWS X-Ray Daemon | [PostgreSQL](./examples/AWSDriverExample/src/main/java/software/amazon/TelemetryTracingXRayExample.java) |
| Configuring the AWS Advanced JDBC Wrapper with an AI tool (Cursor, Claude, ChatGPT, Bedrock, etc.) using the Configuration Assistant skill | [JDBC Wrapper Configuration Assistant](./docs/JDBC-WRAPPER-CONFIGURATION-ASSISTANT.md) |

## Other AWS Advanced Wrapper Drivers
The AWS Advanced JDBC Wrapper is part of a broader family of AWS "wrapper" drivers that bring the same advanced functionality, such as failover support and IAM authentication, to other languages and database connectivity standards. If you are working outside of Java, you may find one of the following drivers useful:

| Driver                                  | Repository                                                          |
|-----------------------------------------|---------------------------------------------------------------------|
| AWS Advanced Python Wrapper             | https://github.com/aws/aws-advanced-python-wrapper                  |
| AWS Advanced NodeJS Wrapper             | https://github.com/aws/aws-advanced-nodejs-wrapper                  |
| AWS Advanced Go Wrapper                 | https://github.com/aws/aws-advanced-go-wrapper                      |
| AWS Advanced .NET Wrapper               | https://github.com/aws/aws-advanced-dotnet-data-provider-wrapper    |
| AWS Advanced ODBC Wrapper               | https://github.com/aws/aws-advanced-odbc-wrapper                    |

## Getting Help and Opening Issues
If you encounter a bug with the AWS Advanced JDBC Wrapper, we would like to hear about it.
Please search the [existing issues](https://github.com/aws/aws-advanced-jdbc-wrapper/issues) to see if others are also experiencing the issue before reporting the problem in a new issue. GitHub issues are intended for bug reports and feature requests.

When opening a new issue, please fill in all required fields in the issue template to help expedite the investigation process.

For all other questions, please use [GitHub discussions](https://github.com/aws/aws-advanced-jdbc-wrapper/discussions).

## How to Contribute
1. Set up your environment by following the directions in the [Development Guide](docs/development-guide/DevelopmentGuide.md).
2. To contribute, first make a fork of this project.
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).
4. Create a pull request from your fork.
5. Pull requests need to be approved and merged by maintainers into the main branch. 
 **Note:** Before making a pull request, [run all tests](./docs/development-guide/DevelopmentGuide.md#running-the-tests) and verify everything is passing.

### Code Style
The project source code is written using the [Google checkstyle](https://github.com/google/styleguide/blob/gh-pages/intellij-java-google-style.xml), and the style is strictly enforced in our automation pipelines. Any contribution that does not respect/satisfy the style will automatically fail at build time.

## Releases
The `aws-advanced-jdbc-wrapper` has a regular monthly release cadence. A new release will occur during the last week of each month. However, if there are no changes since the latest release, then a release will not occur.

## Aurora Engine Version Testing
This `aws-advanced-jdbc-wrapper` is being tested against the following Community and Aurora database versions in our test suite:

| Database | Versions |
|-------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| MySQL | 8.0.36 |
| PostgreSQL | 16.2 |
| Aurora MySQL | - Default version. To check the default version, open the RDS "Create database" page in the AWS console and check the pre-selected database version. - Latest release, as shown on [this page](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraMySQLReleaseNotes/AuroraMySQL.Updates.30Updates.html). |
| Aurora PostgreSQL | - Default version. To check the default version, open the RDS "Create database" page in the AWS console and check the pre-selected database version. - Latest release, as shown on [this page](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraPostgreSQLReleaseNotes/AuroraPostgreSQL.Updates.html). |

The `aws-advanced-jdbc-wrapper` is compatible with MySQL 5.7 and MySQL 8.0 as per the Community MySQL Connector/J 8.0 Driver.

## License
This software is released under the Apache 2.0 license.

aws-advanced-jdbc-wrapper

파일 탐색기

# 설치 가이드

2. Gradle (Java/Kotlin)

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

aws-advanced-jdbc-wrapper

파일 탐색기

# 설치 가이드

2. Gradle (Java/Kotlin)

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README