Skip to content

Akka.Persistence.Sql v1.5.13
Compare
Choose a tag to compare
@Aaronontheweb Aaronontheweb released this 27 Sep 19:21
1.5.13
e577632
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Verified
Learn about vigilant mode.

1.5.13 September 28 2023

1.5.12 August 8 2023

Akka.Persistence.Sql is now out of beta and ready for general use.

1.5.12-beta1 August 4 2023

1.5.9-beta1 July 20 2023

1.5.4-beta1 April 25 2023

Added transaction for every SQL queries with adjustable isolation level for read and write operations. You can go to the official Microsoft documentation to read more about these transaction isolation level settings.

Four new HOCON settings are introduced:

  • akka.persistence.journal.sql.read-isolation-level
  • akka.persistence.journal.sql.write-isolation-level
  • akka.persistence.snapshot-store.sql.read-isolation-level
  • akka.persistence.snapshot-store.sql.write-isolation-level

In Akka.Persistence.Sql.Hosting, These settings can be set programmatically through these new properties:

  • SqlJournalOptions.ReadIsolationLevel
  • SqlJournalOptions.WriteIsolationLevel
  • SqlSnapshotOptions.ReadIsolationLevel
  • SqlSnapshotOptions.WriteIsolationLevel

NOTE

Currently, there is a bug with Linq2Db and MySql implementation that can cause the SQL generator to throw an exception if you use the default IsolationLevel.Unspecified setting. Please use IsolationLevel.ReadCommitted if this happens to you.

1.5.2-beta3 April 19 2023

NOTE: Database schema changes

1.5.2-beta2 package should be considered as deprecated. If you experimented with 1.5.2-beta1 and/or 1.5.2-beta2, you will need to drop existing persistence tables and recreate them using 1.5.2-beta3

This beta version introduces database schema optimization to:

  • Improve the tag table based query performance even more.
  • Improve inter-compatibility with other SQL persistence plugins.

Tag Query Benchmark

Benchmark is performed on a worst possible scenario:

  • Event journal table with 3 million row entries
  • Tagged events near the end of the table
  • Numbers are measured as the time required to complete one operation (complete retrieval of N tagged events).
Tag Count TagMode Mean Error StdDev
10 Csv 1,760.393 ms 27.1970 ms 25.4401 ms
100 Csv 1,766.355 ms 25.0182 ms 23.4021 ms
1000 Csv 1,755.960 ms 33.8171 ms 34.7276 ms
10000 Csv 1,905.026 ms 22.3564 ms 20.9122 ms
10 TagTable 2.336 ms 0.0389 ms 0.0344 ms
100 TagTable 3.943 ms 0.0705 ms 0.0660 ms
1000 TagTable 18.597 ms 0.3570 ms 0.3506 ms
10000 TagTable 184.446 ms 3.3447 ms 2.9650 ms

1.5.2-beta2 April 14 2023

NOTE: Database schema changes

1.5.2-beta1 package should be considered as deprecated. If you experimented with 1.5.2-beta1, you will need to drop existing persistence tables and recreate them using 1.5.2-beta2

This beta version introduces database schema optimization to:

  • Improve the tag table based query performance, without compromising overall persistence performance.
  • Improve inter-compatibility with other SQL persistence plugins.

Tag Query Benchmark

Benchmark is performed on a worst possible scenario:

  • Event journal table with 3 million row entries
  • Tagged events near the end of the table
Tag Count TagMode Mean Error StdDev
10 Csv 1,746.621 ms 27.8946 ms 29.8469 ms
100 Csv 1,724.465 ms 25.4638 ms 23.8189 ms
1000 Csv 1,723.063 ms 26.2311 ms 24.5366 ms
10000 Csv 1,873.467 ms 26.1173 ms 23.1523 ms
10 TagTable 3.201 ms 0.0633 ms 0.1479 ms
100 TagTable 5.163 ms 0.1018 ms 0.1358 ms
1000 TagTable 25.545 ms 0.4952 ms 0.4864 ms
10000 TagTable 441.877 ms 3.5410 ms 2.9569 ms

1.5.2-beta1 April 12 2023

NOTE: This beta release is intended for greenfield projects only.

Until backward compatibility is properly tested and documented, it is recommended to use this plugin only on new greenfield projects that does not rely on existing persisted data.

Akka.Persistence.Sql is a successor of Akka.Persistence.Linq2Db. It is being retooled to provide a better inter-compatibility with other SQL based Akka.Persistence plugin family.

Currently supported database family:

  • Microsoft SQL Server
  • MS SQLite
  • System.Data.SQLite
  • PostgreSQL using binary payload

Akka.Hosting Extension Setup

Assuming a MS SQL Server 2019 setup:

var host = new HostBuilder()
    .ConfigureServices((context, services) => {
        services.AddAkka("my-system-name", (builder, provider) =>
        {
            builder.WithSqlPersistence(
                connectionString: _myConnectionString,
                providerName: ProviderName.SqlServer2019)
        });
    })

ProviderName is a string constant defining the database type to connect to, valid values are defined inside LinqToDB.ProviderName static class. Refer to the Members of LinqToDb.ProviderName for included providers.

HOCON Configuration Setup

akka.persistence {
    journal {
        plugin = "akka.persistence.journal.sql"
        sql {
            connection-string = "{database-connection-string}"
            provider-name = "{provider-name}"
        }
    }
    snapshot-store {
        plugin = "akka.persistence.snapshot-store.sql"
        sql {
            connection-string = "{database-connection-string}"
            provider-name = "{provider-name}"
        }
    }
}
  • database-connection-string: The proper connection string to your database of choice.
  • provider-name: A string constant defining the database type to connect to, valid values are defined inside LinqToDB.ProviderName static class. Refer to the Members of LinqToDb.ProviderName for included providers.

Changes:

  • e577632 Update RELEASE_NOTES.md for 1.5.13 release (#328)
  • 033f5d5 build(deps): bump jetbrains.resharper.globaltools (#326)
  • d43af21 build(deps): bump FluentAssertions from 5.10.3 to 6.12.0 (#309)
  • 99612bc build(deps): bump SqliteVersion from 1.0.117 to 1.0.118 (#267)
  • 98c7396 build(deps): bump linq2db from 5.1.1 to 5.2.2 (#266)
  • f2aaaca build(deps): bump Microsoft.SqlServer.SqlManagementObjects (#263)
  • 4a71d29 build(deps): bump coverlet.collector from 3.2.0 to 6.0.0 (#261)
  • ac8fd20 build(deps): bump System.Reactive.Linq from 5.0.0 to 6.0.0 (#260)
  • 3cfbc03 build(deps): bump xunit.runner.visualstudio from 2.4.5 to 2.5.1 (#327)
  • 427ef0d build(deps): bump xunit from 2.5.0 to 2.5.1 (#320)
See More
  • 81c129d Export symbol packages (#325)
  • fd67772 Add xUnit 2.5.1 compatibility (#324)
  • 47bec0f Add end-to-end unit test for HOCON based configuration (#314)
  • dadd774 build(deps): bump Akka.Persistence.Sqlite from 1.5.12 to 1.5.13 (#322)
  • 6ffa405 build(deps): bump AkkaVersion from 1.5.12 to 1.5.13 (#321)
  • e0bc1d3 build(deps): bump jetbrains.resharper.globaltools (#310)
  • f26a2e8 build(deps): bump xunit.runner.visualstudio from 2.5.0 to 2.5.1 (#319)
  • 4e048a4 build(deps): bump Npgsql from 7.0.4 to 7.0.6 (#318)
  • 3b96a92 build(deps): bump LanguageExt.Core from 4.4.3 to 4.4.4 (#315)
  • b3443c1 build(deps): bump AkkaHostingVersion from 1.5.12 to 1.5.12.1 (#312)
  • 6cc080d Fix missing default query configuration (#317)
  • a96de68 build(deps): bump BenchmarkDotNet from 0.13.7 to 0.13.8 (#316)
  • d9934c8 build(deps): bump Microsoft.Data.Sqlite.Core from 7.0.9 to 7.0.11 (#313)
  • ee80f2a build(deps): bump Microsoft.NET.Test.Sdk from 17.7.0 to 17.7.2 (#311)
  • 1e4cd07 Update HOCON documentation in README.md (#308)
  • a65283d build(deps): bump MySql.Data from 8.0.33 to 8.1.0 (#284)
  • 63e54a3 build(deps): Bump jetbrains.resharper.globaltools (#293)
  • 39b1c3e build(deps): Bump BenchmarkDotNet from 0.13.6 to 0.13.7 (#299)
  • 89297fd build(deps): Bump Microsoft.NET.Test.Sdk from 17.6.3 to 17.7.0 (#300)

This list of changes was auto generated.

Assets 4
Loading