Excalibur.EventSourcing.SqlServer 10.0.0-alpha.14

.NET 10.0 This package targets .NET 10.0. The package is compatible with this framework or higher.
This is a prerelease version of Excalibur.EventSourcing.SqlServer. 
dotnet add package Excalibur.EventSourcing.SqlServer --version 10.0.0-alpha.14
                    


                    

                
NuGet\Install-Package Excalibur.EventSourcing.SqlServer -Version 10.0.0-alpha.14
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="Excalibur.EventSourcing.SqlServer" Version="10.0.0-alpha.14" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="Excalibur.EventSourcing.SqlServer" Version="10.0.0-alpha.14" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="Excalibur.EventSourcing.SqlServer" />
                    


                            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 Excalibur.EventSourcing.SqlServer --version 10.0.0-alpha.14
                    


                    

                
#r "nuget: Excalibur.EventSourcing.SqlServer, 10.0.0-alpha.14"
#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 Excalibur.EventSourcing.SqlServer@10.0.0-alpha.14
#: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=Excalibur.EventSourcing.SqlServer&version=10.0.0-alpha.14&prerelease
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=Excalibur.EventSourcing.SqlServer&version=10.0.0-alpha.14&prerelease
                    


                            Install as a Cake Tool

Excalibur.EventSourcing.SqlServer

SQL Server implementation of event sourcing infrastructure for the Excalibur framework.

Part Of

This package is included in the following metapackages:

Metapackage Tier What It Adds
Excalibur.Dispatch.SqlServer Starter + Dispatch core + Outbox + Hosting
Excalibur.SqlServer Complete + Inbox + Saga + Leader Election + Audit + Compliance + Data

Tip: Install Excalibur.SqlServer for a production-ready SQL Server stack with a single package reference.

Installation

dotnet add package Excalibur.EventSourcing.SqlServer

Features

  • SqlServerEventStore - Dapper-based event store implementation
  • SqlServerSnapshotStore - SQL Server snapshot persistence
  • Optimized for high-throughput event streaming
  • Connection factory pattern for multi-database scenarios
  • AOT-compatible with full Native AOT support
  • NO Entity Framework Core dependency

Usage

// Recommended: Builder-integrated registration
services.AddExcalibur(x => x.AddEventSourcing(es =>
{
    es.UseSqlServer(options =>
    {
        options.ConnectionString = connectionString;
        options.EventStoreSchema = "events";
    });
    es.AddRepository<OrderAggregate, Guid>(id => new OrderAggregate(id));
}));

// Alternative: Direct registration
services.AddSqlServerEventSourcing(options =>
{
    options.ConnectionString = connectionString;
});

Database Schema

The store does not create its tables at runtime. Provision them before the first append, by running the scripts shipped inside this package under scripts/:

Script Creates Required
scripts/001_CreateEventStoreSchema.sql dbo.EventStoreEvents Yes — this is the event store itself
scripts/002_CreateSnapshotSchema.sql dbo.EventStoreSnapshots Only if you enable snapshots
scripts/003_CreateCursorMapSchema.sql dbo.ProjectionCursorMaps Only if a projection resumes from per-stream positions
scripts/004_CreateSubscriptionCheckpointSchema.sql dbo.SubscriptionCheckpoints Only if you run catch-up subscriptions

Every script is guarded, so re-running one against an existing database is a no-op.

EventStoreEvents.TenantId is created NOT NULL, and an untenanted event stores the reserved __untenanted__ sentinel rather than NULL, so an untenanted event is a value rather than a missing one and the stream-identity constraint binds it like any other.

A database provisioned by an earlier prerelease has no in-place upgrade path; re-provision it from these scripts.

  • Excalibur.EventSourcing - Core event sourcing abstractions
  • Excalibur.Data.Abstractions - Data access patterns

License

This project is multi-licensed under:

See LICENSE for details.

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on Excalibur.EventSourcing.SqlServer:

Package Downloads
Excalibur.Dispatch.SqlServer

Experience metapackage bundling Excalibur.Dispatch with SQL Server event sourcing and a SQL Server outbox store. Provides a single AddDispatchWithSqlServer() call for the common SQL Server scenario. The outbox stages messages durably; background delivery is opt-in. PRE-RELEASE: the public API is not frozen and may change between pre-release builds. Not recommended for production use. Known issues: https://docs.excalibur-dispatch.dev/docs/known-issues

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
10.0.0-alpha.14 66 10/2/2026
10.0.0-alpha.13 63 9/29/2026
10.0.0-alpha.12 71 9/25/2026
10.0.0-alpha.11 83 9/15/2026
10.0.0-alpha.10 88 9/6/2026
10.0.0-alpha.9 86 8/31/2026
10.0.0-alpha.8 104 8/14/2026
10.0.0-alpha.7 91 8/13/2026
10.0.0-alpha.6 94 8/11/2026
10.0.0-alpha.5 89 8/10/2026
10.0.0-alpha.4 80 8/10/2026
3.0.0-alpha.216 96 6/30/2026
3.0.0-alpha.215 98 6/23/2026
3.0.0-alpha.214 94 6/23/2026
3.0.0-alpha.208 91 6/11/2026
3.0.0-alpha.207 95 6/11/2026
3.0.0-alpha.205 97 6/10/2026
3.0.0-alpha.204 95 6/8/2026
3.0.0-alpha.203 93 6/8/2026
3.0.0-alpha.202 85 6/8/2026
Loading failed

Release notes and versioning policy: https://docs.excalibur-dispatch.dev/docs/migration/version-upgrades