|
1 | 1 | # Aurora Initial Connection Strategy Plugin
|
2 |
| -The Aurora Initial Connection Strategy Plugin allows users to configure their initial connection strategy, and it can also be used to obtain a connection more reliably if DNS is updating by replacing an out of date endpoint. When the Aurora Initial Connection Strategy Plugin attempts to make a connection, it may retry the connection attempt if there is a failure. Users are able to configure how often to retry a connection and the maximum allowed time to obtain a connection using the connection parameters. |
| 2 | +The Aurora Initial Connection Strategy Plugin allows users to configure their initial connection strategy, and it can also be used to obtain a connection more reliably if DNS is updating by replacing an out-of-date endpoint. |
3 | 3 |
|
4 |
| -When this plugin is enabled, if the initial connection is to a reader cluster endpoint, the connected reader host will be chosen based on the configured strategy. The [initial connection strategy](../ReaderSelectionStrategies.md) specifies how the driver determines which available reader to connect to. |
| 4 | +The following sequence diagram describes the default plugin behaviour if no custom initial connection strategy is provided: |
| 5 | +<div style="text-align:center"><img src="../../images/aurora_initial_connection_strategy.png"/></div> |
| 6 | +The AWS Advanced Python Wrapper may retry the connection attempts multiple times until it is able to connect to a valid reader instance or a valid writer instance. |
| 7 | +You can configure how often to retry a connection and the maximum allowed time to obtain a connection using the `open_connection_retry_interval_ms` and the `open_connection_retry_timeout_ms` parameters respectively. |
5 | 8 |
|
6 |
| -This plugin also helps retrieve connections more reliably. When a user connects to a cluster endpoint, the actual instance for a new connection is resolved by DNS. During failover, the cluster elects another instance to be the writer. While DNS is updating, which can take up to 40-60 seconds, if a user tries to connect to the cluster endpoint, they may be connecting to an old host. This plugin helps by replacing the out of date endpoint if DNS is updating. |
| 9 | +When this plugin is enabled, if the initial connection is to a reader cluster endpoint, the connected reader host will be chosen based on selection strategy specified using the `reader_initial_connection_host_selector_strategy` parameter. |
| 10 | +See [initial connection strategy](../ReaderSelectionStrategies.md) for all possible strategies. |
| 11 | + |
| 12 | +This plugin also helps retrieve connections more reliably. When a user connects to a cluster endpoint, the actual instance for a new connection is resolved by DNS. |
| 13 | +During failover, the cluster elects another instance to be the writer. While DNS is updating, which can take up to 40-60 seconds, if a user tries to connect to the cluster endpoint, they may be connecting to an old host. |
| 14 | +This plugin helps by replacing the out of date endpoint if DNS is updating. |
7 | 15 |
|
8 | 16 | ## Enabling the Aurora Initial Connection Strategy Plugin
|
9 | 17 |
|
|
0 commit comments