EntityFrameworkCore.SqlServer.Seeding 5.0.0

There is a newer version of this package available.
See the version list below for details.
dotnet add package EntityFrameworkCore.SqlServer.Seeding --version 5.0.0
NuGet\Install-Package EntityFrameworkCore.SqlServer.Seeding -Version 5.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="EntityFrameworkCore.SqlServer.Seeding" Version="5.0.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add EntityFrameworkCore.SqlServer.Seeding --version 5.0.0
#r "nuget: EntityFrameworkCore.SqlServer.Seeding, 5.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 EntityFrameworkCore.SqlServer.Seeding as a Cake Addin
#addin nuget:?package=EntityFrameworkCore.SqlServer.Seeding&version=5.0.0

// Install EntityFrameworkCore.SqlServer.Seeding as a Cake Tool
#tool nuget:?package=EntityFrameworkCore.SqlServer.Seeding&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.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
5.0.12 2,596 12/12/2021
5.0.0 357 5/8/2021
0.9.1 473 10/17/2020