Skip to content

Akka.Persistence.Sql v1.5.9-beta1
Compare
Choose a tag to compare
@Aaronontheweb Aaronontheweb released this 20 Jul 17:41
1.5.9-beta1
34507d8
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.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:

  • 34507d8 Update RELEASE_NOTES.md for 1.5.9-beta1 (#285)
  • dbeb3d2 build(deps): bump BenchmarkDotNet from 0.13.5 to 0.13.6 (#279)
  • 542501b build(deps): bump AkkaVersion from 1.5.8 to 1.5.9 (#281)
  • 28492ea Fix Persistence.Query Hosting extension support. (#283)
  • 027440c build(deps): bump xunit from 2.4.2 to 2.5.0 (#280)
  • 8839dd6 build(deps): bump AkkaHostingVersion from 1.5.4 to 1.5.8.1 (#276)
  • 3a95790 build(deps): bump Akka.Persistence.Sqlite from 1.5.4 to 1.5.8 (#270)
  • 2634329 build(deps): bump Microsoft.Data.Sqlite.Core from 7.0.5 to 7.0.9 (#274)
  • f8cab40 build(deps): bump AkkaVersion from 1.5.7 to 1.5.8 (#275)
  • 465e87e Fix missing SQL query configuration file (#278)
See More
  • 830235f build(deps): bump jetbrains.resharper.globaltools (#272)
  • 837afa9 build(deps): bump Microsoft.NET.Test.Sdk from 17.6.0 to 17.6.3 (#273)
  • 68a39a2 build(deps): bump AkkaVersion from 1.5.4 to 1.5.7 (#254)
  • 4ea1f2f build(deps): bump Docker.DotNet from 3.125.14 to 3.125.15 (#258)
  • 277968e build(deps): bump Microsoft.NET.Test.Sdk from 17.5.0 to 17.6.0 (#253)
  • 3546bb1 refactor: cleanup naming, apply resharper hints (#243)
  • e584b40 feat: upgrade to npgsql 7.0.4 (#242)
  • 066cb28 refactor: make var names consistent (#239)
  • 1aaf064 Bump jetbrains.resharper.globaltools from 2023.1.0 to 2023.1.1
  • 89c0141 fix: add missing redis versions (#240)
  • 66761c3 Merge pull request #238 from akkadotnet/CumpsD-patch-1
  • 9ff3db4 Update README.md
  • 48557fa docs: typo in Concurrent

This list of changes was auto generated.

Assets 4
Loading