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.

Sign up for GitHub

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

docs: clarify migration and retrieval of durable state based persistence ids #544

Merged
merged 3 commits into from
Jul 1, 2024
Merged

docs: clarify migration and retrieval of durable state based persistence ids #544

Changes from 1 commit
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
921dce6
docs: clarify migration and retrieval of durable state based persiste…
sebastian-alfers Apr 4, 2024
3310e4b
Update docs/src/main/paradox/migration.md
sebastian-alfers Jun 5, 2024
8d8f7dd
remove note about how to retrieve the list of persistence ids
sebastian-alfers Jun 5, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions docs/src/main/paradox/migration.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,8 @@ idempotent result. Full rolling update when switching database or Persistence pl
you can migrate most of the data while the system is online and then have a short full shutdown while
migrating the remaining data that was written after the previous online migration.

The migration tool is intended to run as a separate, standalone application and should not be part of the same jvm process the main application is running under.

## Dependencies

The Akka dependencies are available from Akka's library repository. To access them there, you need to configure the URL for this repository.
Expand Down Expand Up @@ -74,6 +76,8 @@ The migration tool can be run as main class `akka.persistence.r2dbc.migration.Mi

Durable State is not migrated by `MigrationTool.migrateAll`, instead you need to use `MigrationTool.migrateDurableStates` for a given list of persistence ids.

This list can be retrieved by using `currentPersistenceIds` of @ref:[Durable state queries](./query.md#durable-state-queries).
Copy link
Member

Choose a reason for hiding this comment

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

This is misleading because you would have to retrieve them from the source (old) database, and akka-persistence-jdbc doesn't implement that query. Isn't it obvious that you can retrieve such list of persistence ids with just sql select?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

You are right, I have to remove that sentence as it was a misunderstanding.


@@@

## Configuration
Expand Down
Loading