NEventStore.Persistence.Sql 9.2.0

dotnet add package NEventStore.Persistence.Sql --version 9.2.0
NuGet\Install-Package NEventStore.Persistence.Sql -Version 9.2.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="NEventStore.Persistence.Sql" Version="9.2.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add NEventStore.Persistence.Sql --version 9.2.0
#r "nuget: NEventStore.Persistence.Sql, 9.2.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install NEventStore.Persistence.Sql as a Cake Addin
#addin nuget:?package=NEventStore.Persistence.Sql&version=9.2.0

// Install NEventStore.Persistence.Sql as a Cake Tool
#tool nuget:?package=NEventStore.Persistence.Sql&version=9.2.0

NEventStore.Persistence.Sql

SQL Persistence Engine for NEventStore

NEventStore.Persistence.Sql currently supports:

  • .net framework 4.6.2
  • .net standard 2.0
  • MsSql
  • SqlLite
  • MySql
  • PostgreSQL
  • Oracle (not tested)

Build Status

Branches:

  • master Build status
  • develop Build status

PostgreSQL Warning

If you upgrade Npgsql to version 6.0 and up you must take into account the breaking changes made about the timezones handling Timestamp rationalization and improvements.

Possible solutions:

  • manually migrate the Table schema and update the "CommitStamp" column type from "timestamp" to "timestamptz".
  • disable the new behavior by calling:
    AppContext.SetSwitch("Npgsql.EnableLegacyTimestampBehavior", true);
    
  • use the new PostgreNpgsql6Dialect.

How to Build (locally)

  • Clone the repository with:
git clone --recursive https://github.com/NEventStore/NEventStore.Persistence.SQL.git

or

git clone https://github.com/NEventStore/NEventStore.Persistence.SQL.git
git submodule update

To build the project locally on a Windows Machine:

  • Optional: update .\src\.nuget\NEventStore.Persistence.Sql.nuspec file if needed (before creating relase packages).
  • Open a Powershell console in Administrative mode and run the build script build.ps1 in the root of the repository.

How to Run Unit Tests (locally)

  • Install Database engines or use Docker to run them in a container (you can use the scripts in ./docker folder).

  • Define the following environment variables:

    NEventStore.MsSql="Server=localhost,50001;Database=NEventStore;User Id=sa;Password=Password1;TrustServerCertificate=True;"
    NEventStore.MySql="Server=localhost;Port=50003;Database=NEventStore;Uid=sa;Pwd=Password1;AutoEnlist=false;"
    NEventStore.PostgreSql="Server=localhost;Port=50004;Database=NEventStore;Uid=sa;Pwd=Password1;Enlist=false;"
    NEventStore.Oracle="Data Source=localhost:1521/XE;User Id=system;Password=Password1;Persist Security Info=True;"
    

How to contribute

Git-Flow

This repository uses GitFlow to develop, if you are not familiar with GitFlow you can look at the following link.

Installing and configuring Git Flow

Probably the most straightforward way to install GitFlow on your machine is installing Git Command Line, then install the Visual Studio Plugin for Git-Flow. This plugin is accessible from the Team Explorer menu and allows you to install GitFlow extension directly from Visual Studio with a simple click. The installer installs standard GitFlow extension both for command line and for Visual Studio Plugin.

Once installed you can use GitFlow right from Visual Studio or from Command line, which one you prefer.

Build machine and GitVersion

Build machine uses GitVersion to manage automatic versioning of assemblies and Nuget Packages. You need to be aware that there are a rule that does not allow you to directly commit on master, or the build will fail.

A commit on master can be done only following the Git-Flow model, as a result of a new release coming from develop, or with an hotfix.

Quick Info for NEventstore projects

Just clone the repository and from command line checkout develop branch with

git checkout develop

Then from command line run GitFlow initialization scripts

git flow init

You can leave all values as default. Now your repository is GitFlow enabled.

Note on Nuget version on Nuspec

Remember to update .\src\.nuget\NEventStore.Persistence.Sql.nuspec file if needed (before creating relase packages).

The .nuspec file is needed because the new dotnet pack command has problems dealing with ProjectReferences, submodules get the wrong version number.

While we are on develop branch, (suppose we just bumped major number so the driver version number is 6.0.0-unstablexxxx), we need to declare that this persistence driver depends from a version greater than the latest published. If the latest version of NEventStore 5.x.x wave iw 5.4.0 we need to declare this package dependency as

(5.4, 7)

This means, that we need a NEventStore greater than the latest published, but lesser than the next main version. This allows version 6.0.0-unstable of NEventStore to satisfy the dependency. We remember that prerelease package are considered minor than the stable package. Es.

5.4.0 5.4.1 6.0.0-unstable00001 6.0.0

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework net461 was computed.  net462 is compatible.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (2)

Showing the top 2 NuGet packages that depend on NEventStore.Persistence.Sql:

Package Downloads
EventSaucing

An event source stack based on NEventStore and Akka

CQRSLite.NEventStore

SnapshotStore implemented for NEventStore used together with CQRSLite.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
9.2.0 2,801 4/18/2024
9.1.2 38,310 8/1/2023
9.0.1 97,687 12/29/2021
9.0.0 16,687 12/3/2021
8.0.0 36,773 12/18/2020
7.2.0 110,841 7/24/2019
7.1.0 1,025 7/17/2019
7.0.0 606 7/5/2019
6.0.0 32,220 3/27/2019
6.0.0-rc-1 817 2/15/2019
6.0.0-rc-0 662 12/19/2018