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.

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: event tag migration guide #781

Merged
merged 7 commits into from
Oct 27, 2023
Merged
Changes from 1 commit
Commits
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
29 changes: 29 additions & 0 deletions docs/src/main/paradox/migration.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,34 @@
# Migration

## Migrating to version 5.4.0

Release `5.4.0` change the schema of `event_tag` table.

The previous version was using auto increment column as a primary key and foreign key of `event_tag` table, this has resulted in we can no longer do a batch insert due to the insert returning the ordering.
Roiocam marked this conversation as resolved.
Show resolved Hide resolved

while in `5.4.0` the primary key and foreign key of `event_tag` table has been replaced with primary key of `event_journal` table. In order to migrate to the new schema, we made a [**migration script**](https://github.com/akka/akka-persistence-jdbc/tree/master/core/src/main/resources/schema) capable of the column creation, rows and constraint migration.
Roiocam marked this conversation as resolved.
Show resolved Hide resolved

The new "tag key" disable by default, If you want to use it, apply migration script and enable property via configuration:
Roiocam marked this conversation as resolved.
Show resolved Hide resolved

```config
jdbc-journal {
tables {

// ...

event_tag {

// ...
// enable the new tag key
legacy-tag-key = false

}

}
}
```


## Migrating to version 5.2.0

**Release `5.2.0` updates H2 to version 2.1.214 which is not compatible to the previous 1.4.200***
Expand Down