Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

feat: enable transactional connection state as an opt-in #3326

Open
wants to merge 7 commits into
base: transactional-connection-state
Choose a base branch
from

Conversation

olavloite
Copy link
Collaborator

@olavloite olavloite commented Sep 9, 2024

This change enables transactional connection state for the Connection API.
It can be enabled by default for PostgreSQL-dialect databases using a system
property, and is always an opt-in for GoogleSQL-dialect databases.

Transactional connection state can be enabled for any database connection
with the connection_state_type connection STARTUP property.

@product-auto-label product-auto-label bot added size: l Pull request size is large. api: spanner Issues related to the googleapis/java-spanner API. labels Sep 9, 2024
@olavloite olavloite force-pushed the enable-transactional-connection-state branch from 2bfc411 to 259460d Compare September 10, 2024 08:37
…tate

This change adds internal data structures that can be used for transactional
connection state. These data structures also reduces the amount of code that
is needed for each connection property that is added. Connection properties
are currently represented as actual variables in the ConnectionImpl class.
These new data structures removes the need for that.

Only the connection property retryAbortsInternally is refactored to use
the new data structure. All other connection properties will be refactored
in a following change, in order to keep each change as small as possible.

The data structure supports both transactional and non-transactional
connection state. Transactional state is disabled in the current version
in order to be consistent with the current behavior. It will be enabled
in a later change when all connection properties have been refactored
to use the new data structure.
@olavloite olavloite force-pushed the refactor-connection-variables-to-connection-state branch from 94c2d17 to 8d91e01 Compare September 10, 2024 10:54
@olavloite olavloite force-pushed the enable-transactional-connection-state branch from 259460d to 0c2b944 Compare September 10, 2024 11:34
Replace individual variables in ConnectionOptions and ConnectionImpl with
references to ConnectionProperties. This reduces the amount of code bloat,
especially in ConnectionOptions, as all connection property parsing is
now handled by the ConnectionState class in a generic way.

This setup also reduces the amount of code that is needed to add a new
connection property, as there is only one source of truth: the list of
properties in the ConnectionProperties class.

Following steps that will reduce the amount of code bloat further are:
1. Replace all the regular expressions for SET and SHOW statements with
   a simple token-based parser.
2. Cleaning up ConnectionOptions further by removing the duplicate list
   of ConnectionProperties there. These can be removed once the JDBC
   driver has been updated to use the new list of properties.
@olavloite olavloite force-pushed the refactor-connection-variables-to-connection-state branch from 8d91e01 to aec3020 Compare September 10, 2024 11:40
…tate

This change adds internal data structures that can be used for transactional
connection state. These data structures also reduces the amount of code that
is needed for each connection property that is added. Connection properties
are currently represented as actual variables in the ConnectionImpl class.
These new data structures removes the need for that.

Only the connection property retryAbortsInternally is refactored to use
the new data structure. All other connection properties will be refactored
in a following change, in order to keep each change as small as possible.

The data structure supports both transactional and non-transactional
connection state. Transactional state is disabled in the current version
in order to be consistent with the current behavior. It will be enabled
in a later change when all connection properties have been refactored
to use the new data structure.
Replace individual variables in ConnectionOptions and ConnectionImpl with
references to ConnectionProperties. This reduces the amount of code bloat,
especially in ConnectionOptions, as all connection property parsing is
now handled by the ConnectionState class in a generic way.

This setup also reduces the amount of code that is needed to add a new
connection property, as there is only one source of truth: the list of
properties in the ConnectionProperties class.

Following steps that will reduce the amount of code bloat further are:
1. Replace all the regular expressions for SET and SHOW statements with
   a simple token-based parser.
2. Cleaning up ConnectionOptions further by removing the duplicate list
   of ConnectionProperties there. These can be removed once the JDBC
   driver has been updated to use the new list of properties.
This change enables transactional connection state for the Connection API.
It can be enabled by default for PostgreSQL-dialect databases using a system
property, and is always an opt-in for GoogleSQL-dialect databases.

Transactional connection state can be enabled for any database connection
with the `connection_state_type` connection STARTUP property.
@olavloite olavloite force-pushed the enable-transactional-connection-state branch from 0c2b944 to b74abca Compare September 10, 2024 12:02
@olavloite olavloite changed the title feat: use transactional connection state for PostgreSQL feat: enable transactional connection state Sep 10, 2024
@olavloite olavloite changed the title feat: enable transactional connection state feat: enable transactional connection state as an opt-in Sep 10, 2024
@olavloite olavloite marked this pull request as ready for review September 10, 2024 15:26
@olavloite olavloite requested a review from a team as a code owner September 10, 2024 15:26
Base automatically changed from refactor-connection-variables-to-connection-state to transactional-connection-state September 12, 2024 08:48
@rahul2393 rahul2393 requested a review from a team as a code owner September 12, 2024 08:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
api: spanner Issues related to the googleapis/java-spanner API. size: l Pull request size is large.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant