Prerequisites
Ensure an instance of SQL Server (Version 2016 or above for custom saga finders sample, or Version 2012 or above for other samples) is installed and accessible on localhost
and port 1433
. A Docker image can be used to accomplish this by running docker run -e 'ACCEPT_EULA=Y' -e 'MSSQL_SA_PASSWORD=yourStrong(!)Password' -p 1433:1433 -d mcr.
in a terminal.
Alternatively, change the connection string to point to different SQL Server instance.
At startup each endpoint will create its required SQL assets including databases, tables, and schemas.
The sample creates a database named SQLServerSimple
.
Running the sample
- Start both the Sender and Receiver projects.
- Press c to send a command, or e to publish an event, from Sender to the Receiver.
- The Receiver handles the message.
Code walk-through
Configuring the SQL Server transport
// for SqlExpress use Data Source=.\SqlExpress;Initial Catalog=SqlServerSimple;Integrated Security=True;Max Pool Size=100;Encrypt=false
var connectionString = @"Server=localhost,1433;Initial Catalog=SqlServerSimple;User Id=SA;Password=yourStrong(!)Password;Max Pool Size=100;Encrypt=false";
var routing = endpointConfiguration.UseTransport(new SqlServerTransport(connectionString)
{
TransportTransactionMode = TransportTransactionMode.SendsAtomicWithReceive
});
routing.RouteToEndpoint(typeof(MyCommand), "Samples.SqlServer.SimpleReceiver");