Shuttle.Recall.Sql.Storage 18.0.0

Prefix Reserved
.NET Standard 2.1 This package targets .NET Standard 2.1. The package is compatible with this framework or higher.
There is a newer version of this package available.
See the version list below for details. 
dotnet add package Shuttle.Recall.Sql.Storage --version 18.0.0
                    


                    

                
NuGet\Install-Package Shuttle.Recall.Sql.Storage -Version 18.0.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="Shuttle.Recall.Sql.Storage" Version="18.0.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="Shuttle.Recall.Sql.Storage" Version="18.0.0" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="Shuttle.Recall.Sql.Storage" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add Shuttle.Recall.Sql.Storage --version 18.0.0
                    


                    

                
#r "nuget: Shuttle.Recall.Sql.Storage, 18.0.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. 
#:package Shuttle.Recall.Sql.Storage@18.0.0
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=Shuttle.Recall.Sql.Storage&version=18.0.0
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=Shuttle.Recall.Sql.Storage&version=18.0.0
                    


                            Install as a Cake Tool

Sql Server

PM> Install-Package Shuttle.Recall.Sql.Storage

A Sql Server implementation of the Shuttle.Recall event sourcing EventStore.

Configuration

services.AddSqlEventStorage();

Database

In order to create the relevant database structures execute the relevant EventStoreCreate.sql script:

%userprofile%\.nuget\packages\shuttle.recall.sql.storage\{version}\scripts\{provider}\EventStoreCreate.sql

Supported providers

  • Microsoft.Data.SqlClient
  • System.Data.SqlClient

If you'd like support for another SQL-based provider please feel free to give it a bash and send a pull request if you do go this route. You are welcome to create an issue and assistance will be provided where possible.

IKeyStore

You are bound to run into situations where you have a business or other key that is required to be unique. Given that the IEventStore makes use of only surrogate keys the IKeyStore is used to create a unique list of keys associated with a given aggregate identifier.

Since the keys used in the key store have to be unique you should ensure that they contain enough information to be unique and have the intended meaning.

A key could be something such as [order-number]:ord-001/2016, [customer-onboarding]:id-number=0000005555089, or [system-name/profile]:672cda1c-c3ec-4f81-a577-e64f9f14e141.

Contains

bool Contains(string key);

Returns true if the given key has an associated aggregate identifier.

bool Contains(Guid id);

Returns true if the given id is present in the key store.

Get

Guid? Get(string key);

Returns the Guid associated with the given key; else null.

Remove

void Remove(string key);
void Remove(Guid id);

When specifying the key the assocation with the identifier will be removed. When specifying the id all keys associated with the given id will be removed.

Add

void Add(Guid id, string key);

Creates an association between the id and the key.

Add

void Rekey(string key, string rekey);

Changes key to a new key specified by rekey.

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.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
.NET Core netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.1 is compatible. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen 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 (3)

Showing the top 3 NuGet packages that depend on Shuttle.Recall.Sql.Storage:

Package Downloads
Shuttle.Recall.Sql.EventProcessing

Sql-based implementation of the event store Shuttle.Recall projection interfaces.
Shuttle.Access.Sql

Provides Sql-based implementation of data access components for use with Shuttle.Access implementations.
Shuttle.Access.Application

Application concern implementations such as Shuttle.Core.Mediator participants.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
20.0.0 1,462 2/2/2025
18.0.0 233 8/5/2024
17.0.1 260 5/3/2024
17.0.0 296 4/30/2024
16.1.1 1,207 12/1/2022
16.0.1 1,265 9/18/2022
16.0.0 1,222 9/4/2022
14.0.0 2,154 5/29/2022
13.1.1 1,023 5/6/2022
13.1.0 1,247 5/6/2022
13.0.2 1,071 4/9/2022
13.0.1 1,523 4/9/2022
13.0.0 1,349 3/21/2022
12.0.2 3,005 2/4/2021
12.0.1 1,360 11/8/2020
11.0.1 1,434 9/1/2020
11.0.0 1,504 8/21/2019
10.2.0 1,467 5/27/2019
10.1.4 1,543 9/22/2018
10.1.3 1,911 9/16/2018
10.0.3 1,593 8/7/2018
10.0.2 2,365 7/8/2018
10.0.0 3,263 2/13/2018
8.0.11 1,892 10/14/2017
8.0.10 1,721 8/6/2017
8.0.9 2,410 7/2/2017
8.0.8 1,897 7/1/2017