Skip to content

chore: use consistent naming for GlobalDB related functionalities - #690

Merged
karenc-bq merged 3 commits into
chore/remove-anyfrom
chore/rename-gdb
Aug 20, 2026
Merged

chore: use consistent naming for GlobalDB related functionalities#690
karenc-bq merged 3 commits into
chore/remove-anyfrom
chore/rename-gdb

Conversation

@karenc-bq

Copy link
Copy Markdown
Contributor

Summary

Renames the internal Gdb/GDB code identifiers used for Aurora Global Database support to GlobalDb, for consistent and readable naming across the wrapper.
Configuration parameters and plugin codes are intentionally left as gdb*.

Description

Renamed files / directories (git-tracked as renames):

  • utils/gdb_region_utils.tsutils/global_db_region_utils.ts
  • host_list_provider/monitoring/gdb_monitoring_connection_handler.tsglobal_db_monitoring_connection_handler.ts
  • plugins/read_write_splitting/gdb_read_write_splitting_plugin{,_factory}.tsglobal_db_read_write_splitting_plugin{,_factory}.ts
  • plugins/gdb_failover/plugins/global_db_failover/
  • Corresponding unit/integration tests and the UsingTheGdb* docs

Renamed identifiers (Gdb/GDBGlobalDb):

  • Classes/interfaces: GDBRegionUtils, GdbReadWriteSplittingPlugin(Factory), GdbMonitoringConnectionHandler, GdbMonitoringConnectionPriority, GdbPriorityConfig, GdbTopologyUtils
  • Functions/fields: parseGdbPriority, isGdbTopologyUtils, gdbRdsUtils, GDB_CLUSTER_ARN_PATTERN
  • WrapperProperties constants: GDB_RW_HOME_REGION, GDB_RW_RESTRICT_{WRITER,READER}_TO_HOME_REGION, GDB_ACCESSIBLE_REGIONS, GDB_MONITORING_CONNECTION_PRIORITYGLOBAL_DB_*
  • Message keys and documentation prose

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.

@karenc-bq
karenc-bq requested a review from a team as a code owner August 19, 2026 17:36
@karenc-bq
karenc-bq changed the base branch from main to chore/remove-any August 19, 2026 17:36
> Ensure that `failoverHomeRegion` is included in the `gdbAccessibleRegions` list. Otherwise, home region failover logic will not function correctly.

### Interaction with GDB Read/Write Splitting
### Interaction with GlobalDb Read/Write Splitting

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
### Interaction with GlobalDb Read/Write Splitting
### Interaction with Global Db Read/Write Splitting

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I feel like it may be better to use the fully expanded Global Database in documentation.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Oooh if that is possible then yes, that is even more readable!

| Parameter | Value | Required | Description | Default Value |
| --------------------------------- | :------: | :------: | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------- |
| `monitoringConnectionPriority` | `string` | No | Defines the priority for monitoring connections. Determines which type of host the topology monitor should connect to.<br><br>Possible values: `strict-writer`, `strict-reader`, `writer-or-reader`. | `strict-writer` |
| `gdbMonitoringConnectionPriority` | `string` | No | Defines the priority for monitoring connections in a Global Aurora Database context. Supports region-aware variants and specific region names.<br><br>See [GlobalDb Monitoring Connection Priority Values](#gdb-monitoring-connection-priority-values). | `null` |

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
| `gdbMonitoringConnectionPriority` | `string` | No | Defines the priority for monitoring connections in a Global Aurora Database context. Supports region-aware variants and specific region names.<br><br>See [GlobalDb Monitoring Connection Priority Values](#gdb-monitoring-connection-priority-values). | `null` |
| `gdbMonitoringConnectionPriority` | `string` | No | Defines the priority for monitoring connections in a Global Aurora Database context. Supports region-aware variants and specific region names.<br><br>See [Global Db Monitoring Connection Priority Values](#gdb-monitoring-connection-priority-values). | `null` |

| `writer-or-reader` | The topology monitor connects to a writer host if available; otherwise falls back to a reader host. |

### GDB Values (`gdbMonitoringConnectionPriority`)
### GlobalDb Values (`gdbMonitoringConnectionPriority`)

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
### GlobalDb Values (`gdbMonitoringConnectionPriority`)
### Global Db Values (`gdbMonitoringConnectionPriority`)

@@ -1,19 +1,19 @@
# Global Database (GDB) Failover Plugin
# Global Database (GlobalDb) Failover Plugin

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
# Global Database (GlobalDb) Failover Plugin
# Global Database (Global Db) Failover Plugin

I have a slight preference for putting the space here when used like this in the docs but totally okay to keep it without the space as well

@karenc-bq
karenc-bq merged commit be58a36 into main Aug 20, 2026
4 checks passed
@karenc-bq
karenc-bq deleted the chore/rename-gdb branch August 20, 2026 02:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants