Skip to content

docs: mention querying durable state changes by slices - #3595

Merged
He-Pin merged 1 commit into
apache:mainfrom
pjfanning:docs-durable-state-query-by-slices
Oct 9, 2026
Merged

He-Pin merged 1 commit into
apache:mainfrom
pjfanning:docs-durable-state-query-by-slices

Conversation

@pjfanning

Copy link
Copy Markdown
Member

Motivation

The durable state Persistence Query page says the query is only based
on tags, but persistence-query also provides
DurableStateStoreBySliceQuery with changesBySlices and
currentChangesBySlices.

Modification

Describe both ways of querying durable state changes: by tag with
DurableStateStoreQuery, and by slices with DurableStateStoreBySliceQuery
(marked @ApiMayChange), including what a slice is and the
sliceForPersistenceId/sliceRanges helpers, and link to the
EventsBySlice section. Note that support depends on the state store
plugin.

Result

Users know the by-slices query exists.

Tests

  • Not run - docs only

References

None - found during a review of the docs

Motivation:
The durable state Persistence Query page says the query is only based
on tags, but persistence-query also provides
DurableStateStoreBySliceQuery with changesBySlices and
currentChangesBySlices.

Modification:
Describe both ways of querying durable state changes: by tag with
DurableStateStoreQuery, and by slices with DurableStateStoreBySliceQuery
(marked @ApiMayChange), including what a slice is and the
sliceForPersistenceId/sliceRanges helpers, and link to the
EventsBySlice section. Note that support depends on the state store
plugin.

Result:
Users know the by-slices query exists.

Tests:
- Not run - docs only

References:
None - found during a review of the docs
@pjfanning pjfanning added this to the 2.0.0-M5 milestone Oct 8, 2026

@He-Pin He-Pin left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

lgtm

@He-Pin
He-Pin merged commit 93b48ec into apache:main Oct 9, 2026
10 checks passed
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