Skip to content

feat(deprecation): Add ZetaSQL deprecation warning for v1.17.2 patch release#237

Open
czgdp1807 wants to merge 1 commit intogoogle:r1.17.0from
czgdp1807:zetasql_dep_1.17.2
Open

feat(deprecation): Add ZetaSQL deprecation warning for v1.17.2 patch release#237
czgdp1807 wants to merge 1 commit intogoogle:r1.17.0from
czgdp1807:zetasql_dep_1.17.2

Conversation

@czgdp1807
Copy link
Collaborator

This PR adds the deprecation warning for the ZetaSQL-based filter_query functionality.

This change was originally intended for the v1.17.1 release but was inadvertently missed during the manual cherry-picking process. To ensure users receive adequate notice before the feature is removed in v1.18.0, this PR targets the r1.17 branch to facilitate a new patch release, v1.17.2.

The changes in this PR are directly adapted from the deprecation work in #226.

Changes

  • Python API: A DeprecationWarning is now raised when ListOptions.filter_query is used in get_artifacts, get_executions, or get_contexts.
  • C++ Backend: A LOG(WARNING) is now emitted in the C++ query executors when a filter_query is processed.
  • Documentation: The RELEASE.md file, and docstrings have been updated to clearly state that filter_query is deprecated and will be removed in v1.18.0.
  • Testing: Python tests have been updated to verify that the DeprecationWarning is correctly raised.

This commit introduces the deprecation warning for the ZetaSQL-based `filter_query` functionality. This warning was intended for the v1.17.1 release but was missed.

This change is being applied to the `r1.17` branch to enable a `v1.17.2` patch release, ensuring users are properly notified of the upcoming removal of `filter_query` in v1.18.0.

Changes include:
- Emitting a `DeprecationWarning` in the Python `MetadataStore` when `filter_query` is used.
- Adding `LOG(WARNING)` to the C++ query executors.
- Updating documentation (`RELEASE.md`, `index.md`, and docstrings) to reflect the deprecation.
- Modifying tests to assert that the deprecation warnings are raised.
@czgdp1807 czgdp1807 requested a review from vkarampudi February 11, 2026 18:08
@czgdp1807
Copy link
Collaborator Author

@vkarampudi As discussed, feel free to go ahead and merge this PR. Post merging you can create a v1.17.2 patch release.

Thank you.

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.

1 participant