Class EventSourcingBuilderSqlServerExtensions
- Namespace
- Excalibur.EventSourcing.SqlServer
- Assembly
- Excalibur.EventSourcing.SqlServer.dll
Extension methods for configuring SQL Server event sourcing on IEventSourcingBuilder.
public static class EventSourcingBuilderSqlServerExtensions
- Inheritance
-
EventSourcingBuilderSqlServerExtensions
- Inherited Members
Remarks
These extensions provide fluent provider selection following the canonical
CDC builder pattern (see CdcBuilderSqlServerExtensions).
Methods
UseSqlServer(IEventSourcingBuilder, Action<ISqlServerEventSourcingBuilder>)
Configures the event sourcing builder to use SQL Server for event store and snapshot store.
public static IEventSourcingBuilder UseSqlServer(this IEventSourcingBuilder builder, Action<ISqlServerEventSourcingBuilder> configure)
Parameters
builderIEventSourcingBuilderThe event sourcing builder.
configureAction<ISqlServerEventSourcingBuilder>Configuration action for the SQL Server event sourcing builder.
Returns
- IEventSourcingBuilder
The builder for fluent chaining.
Examples
// Connection string
services.AddExcalibur(x => x.AddEventSourcing(es =>
{
es.UseSqlServer(sql =>
{
sql.ConnectionString(configuration.GetConnectionString("EventStore")!)
.EventStoreSchema("es")
.SnapshotStoreSchema("es");
})
.AddRepository<OrderAggregate, Guid>();
}));
// Named connection string
services.AddExcalibur(x => x.AddEventSourcing(es =>
{
es.UseSqlServer(sql =>
{
sql.ConnectionStringName("EventStore");
});
}));
// Connection factory (Azure Managed Identity)
services.AddExcalibur(x => x.AddEventSourcing(es =>
{
es.UseSqlServer(sql =>
{
sql.ConnectionFactory(sp =>
{
var config = sp.GetRequiredService<IConfiguration>();
var connStr = config.GetConnectionString("EventStore")!;
return () => new SqlConnection(connStr);
});
});
}));
// Bind from appsettings.json
services.AddExcalibur(x => x.AddEventSourcing(es =>
{
es.UseSqlServer(sql =>
{
sql.BindConfiguration("EventSourcing:SqlServer");
});
}));
Exceptions
- ArgumentNullException
Thrown when
builderorconfigureis null.