NO-SNOW Propagate unrecognised driver parameters as session parameters

[sfc-gh-pfus]

TL;DR

Added functionality to forward unrecognized connection options as session parameters during login, allowing drivers to set arbitrary Snowflake session parameters like QUERY_TAG through connection strings.

What changed?

• Modified sf_core to collect unrecognized string-typed connection settings and forward them as session parameters during login
• Updated ODBC driver to forward unknown connection string keys to sf_core instead of logging warnings
• Added collect_unknown_settings() function to identify and collect unregistered connection options
• Added iter() method to ParamStore to enable iteration over stored settings
• Explicit session parameters take precedence over forwarded connection options when both are present

How to test?

Run the new end-to-end tests across all drivers:

• Set QUERY_TAG=session_param_e2e_test as a connection option
• Execute SELECT CURRENT_QUERY_TAG()
• Verify the result returns "session_param_e2e_test"

Tests are available for JDBC, ODBC, Python, and sf_core, along with a shared Gherkin feature definition.

Why make this change?

This enables drivers to support arbitrary Snowflake session parameters without requiring explicit implementation for each parameter. Users can now set session parameters like QUERY_TAG, TIMEZONE, or any other Snowflake session parameter directly through connection options, improving flexibility and reducing the need for driver-specific parameter support.

[sfc-gh-pfus]

• NO-SNOW Propagate unrecognised driver parameters as session parameters #737 👈 (View in Graphite)
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[Copilot]

Pull request overview

This PR enables drivers to pass arbitrary Snowflake session parameters by supplying unrecognized connection options, which sf_core forwards as session parameters during the login request. It also adds end-to-end coverage across the shared .feature definition and the Rust/Python/JDBC/ODBC driver test suites.

Changes:

• Add sf_core logic to collect unregistered connection settings and forward them as login-time session parameters.
• Update the ODBC wrapper to forward previously-ignored unknown connection string keys into sf_core.
• Add cross-language E2E tests validating QUERY_TAG forwarding behavior.

Reviewed changes

Copilot reviewed 11 out of 12 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
tests/definitions/shared/session/session_parameters.feature	Adds shared behavioral definition for session-parameter forwarding via connection options.
sf_core/tests/e2e/session/session_parameters.rs	Adds Rust E2E test verifying QUERY_TAG is applied via unknown connection option.
sf_core/tests/e2e/session/mod.rs	Wires the new Rust E2E session test module.
sf_core/src/config/param_store.rs	Exposes an iterator over stored parameters for internal use.
sf_core/src/apis/database_driver_v1/validation.rs	Implements collect_unknown_settings + unit test to identify and forward unknown settings.
sf_core/src/apis/database_driver_v1/connection.rs	Merges unknown settings into init_session_parameters before login.
python/tests/e2e/session/test_session_parameters.py	Adds Python E2E test (skipped for reference driver) for unknown option forwarding.
odbc_tests/tests/e2e/session/session_parameters.cpp	Adds ODBC E2E test verifying QUERY_TAG forwarding via connection string.
odbc_tests/tests/e2e/CMakeLists.txt	Registers the new ODBC E2E test target.
odbc/src/api/connection.rs	Forwards unrecognized connection string keys to sf_core instead of ignoring them.
jdbc/src/test/java/net/snowflake/jdbc/e2e/session/SessionParametersTests.java	Adds JDBC E2E test verifying QUERY_TAG forwarding via connection properties.

[Copilot]

Pull request overview

Copilot reviewed 11 out of 12 changed files in this pull request and generated 1 comment.

[sfc-gh-boler]

lgtm, but see the two commends from Copilot, which should be addressed.