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. 
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. 
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. 
// Install Shuttle.Recall.Sql.Storage as a Cake Addin
#addin nuget:?package=Shuttle.Recall.Sql.Storage&version=18.0.0

// Install Shuttle.Recall.Sql.Storage as a Cake Tool
#tool nuget:?package=Shuttle.Recall.Sql.Storage&version=18.0.0

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. 
.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

A client component that calls the Shuttle.Access.WebApi to interact with the Shuttle.Access Identity and Access Management domain.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
18.0.0 133 8/5/2024
17.0.1 133 5/3/2024
17.0.0 178 4/30/2024
16.1.1 1,067 12/1/2022
16.0.1 1,145 9/18/2022
16.0.0 1,092 9/4/2022
14.0.0 1,976 5/29/2022
13.1.1 891 5/6/2022
13.1.0 1,121 5/6/2022
13.0.2 905 4/9/2022
13.0.1 1,391 4/9/2022
13.0.0 1,189 3/21/2022
12.0.2 2,685 2/4/2021
12.0.1 1,183 11/8/2020
11.0.1 1,269 9/1/2020
11.0.0 1,327 8/21/2019
10.2.0 1,290 5/27/2019
10.1.4 1,358 9/22/2018
10.1.3 1,709 9/16/2018
10.0.3 1,311 8/7/2018
10.0.2 1,913 7/8/2018
10.0.0 2,820 2/13/2018
8.0.11 1,593 10/14/2017
8.0.10 1,429 8/6/2017
8.0.9 2,063 7/2/2017
8.0.8 1,588 7/1/2017