docs: note Result Reuse semantic-equivalence behavior change (2025-11)#714
Merged
Merged
Conversation
Athena changed Result Reuse in November 2025 to match queries by semantic equivalence instead of exact string. Add a note in the Result reuse configuration section so users understand the server-side behavior change. Refs #711
Test suite takes a long time to run across the Python 3.10-3.14 matrix and against real Athena. Docs-only changes don't exercise any code path the tests cover, so skip the workflow when the diff is limited to `docs/**` or top-level Markdown files. The weekly cron schedule keeps tests running against master regardless.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
WHAT
docs/usage.mddescribing the November 2025 Athena server-side change: result reuse is now triggered by semantic equivalence of queries rather than exact-string match.paths-ignoreto.github/workflows/test.yamlso the full test matrix (Python 3.10-3.14 × pyathena/sqla/sqla_async, against real Athena) is skipped for docs-only PRs.WHY
result_reuse_enablemay observe more cache hits than before (whitespace/comment/casing differences no longer block reuse). PyAthena code is unaffected, but the behavior change should be documented so users understand what they're seeing.Closes #711