EntityFrameworkCore.SqlServer.Seeding.Tool 5.0.0

dotnet tool install --global EntityFrameworkCore.SqlServer.Seeding.Tool --version 5.0.0
This package contains a .NET tool you can call from the shell/command line.
dotnet new tool-manifest # if you are setting up this repo
dotnet tool install --local EntityFrameworkCore.SqlServer.Seeding.Tool --version 5.0.0
This package contains a .NET tool you can call from the shell/command line.
#tool dotnet:?package=EntityFrameworkCore.SqlServer.Seeding.Tool&version=5.0.0
nuke :add-package EntityFrameworkCore.SqlServer.Seeding.Tool --version 5.0.0

alternate text is missing from this package README image

SQL Server script seeding for Entity Framework Core

Data seeding is an important step in development process as it provides data for basic functional testing during development. However, data seeding may be also an integral part of the deployment where pre defined data such as lookups etc. may need to present on all environments where the application is deployed.

There are different ways of doing it and one of them is just use T-SQL script for SQL Server.

Overview

This package allows you to seed the data to SQL Server database using pure T-SQL scripts but in a managed fashion similar to Entity Framework Core migrations.

It makes your scripts part of the project and it also allows you to add new scripts by using IDE or in more managed way by CLI which comes as an additional cross-platform .NET Core global tool package.

Usage

Invoking the seeding

To use SQL script seeding with EF Core and targeting SQL Server database you need to bring in the NuGet package EntityFrameworkCore.SqlServer.Seeding which contains extension methods for dependency injection and ASP.NET Core pipeline.

NuGet

dotnet add package EntityFrameworkCore.SqlServer.Seeding

Add script seeding to services collection and supply the connection string to the database

public void ConfigureServices(IServiceCollection services)
{
	...
	services.AddScriptSeeding(Configuration.GetConnectionString("EmployeesDatabase"));
	...
}

Invoke the seeding in the pipeline by supplying the assembly where your scripts are sitting along with a folder under which scripts sit under project tree. The default value is "Seedings"

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
	...
    app.SeedFromScripts(typeof(EmployeesDatabaseContext).Assembly, "Seedings");
	...
}

Adding new seeding script

Seeding scripts can be added either manually from IDE or using CLI tool.

Adding seeding script manually

To add script manually you need to create new .sql file in your project and mark it as embedder resource. Make sure that your file name starts with timestamp in format yyyyMMddHHss. Here is a sample of a seeding SQL script:

  <ItemGroup Label="seeding">
    <None Remove="Seedings\20201017235255_Add_Initial_Employees.sql" />
    <EmbeddedResource Include="Seedings\20201017235255_Add_Initial_Employees.sql" />
  </ItemGroup>
Adding seeding script via CLI

As a first step you need to install global tool EntityFrameworkCore.SqlServer.Seeding.Tool which will help you add the seeding script to the project where you want to have your seeding scripts. I usually keep them together with migrations as a part of infrastructure.

NuGet

dotnet tool install --global EntityFrameworkCore.SqlServer.Seeding.Tool 

From a command line (cmd, PowerShell, bash…) navigate to project folder where you want your scripts to sit. Simply add the script by invoking the previously installed global tool

seeding add "Add_Initial_Employees" -o Seedings

This will create new file under Seedings folder in your project tree. Once you run the main project, seeding files will be executed and recorded in __SeedingHistory table

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

This package has no dependencies.

Version Downloads Last updated
5.0.0 457 5/8/2021
0.9.5 492 10/24/2020
0.9.4 455 10/17/2020