8.2.2 Scaffolding an Existing Database in EF Core

Scaffolding a database produces an Entity Framework model from an existing database. The resulting entities are created and mapped to the tables in the specified database. This feature was introduced in MySQL Connector/NET 6.10.2-beta and 8.0.8-dmr; however, scaffolding is not supported with all versions of Connector/NET (see Table 8.2, “Supported versions of Entity Framework Core”).

Note

The Design package for scaffolding a database is part of the main package in EF Core 2.0 (or later) and no longer separate. If you are upgrading from EF Core 1.1 to EF Core 2.0 or 2.1, you must remove the MySql.Data.EntityFrameworkCore.Design package manually.

The MySql.Data.EntityFrameworkCore.Design package remains available for EF Core 1.1 projects.

NuGet packages have the ability to select the best target for a project, which means that NuGet will install the libraries related to that specific framework version.

There are two different ways to scaffold an existing database:

This section shows how to scaffold the sakila database using both approaches.

Minimum Prerequisites

.NET Core SDK 2.1 (see https://www.microsoft.com/net/core)
Visual Studio 2017 version 15.7 (required for Using Package Manager Console in Visual Studio)
MySQL Server 5.7
sakila database sample (see https://dev.mysql.com/doc/sakila/en/)

Note

Applications targeting previous versions of ASP.NET Core must upgrade to ASP.NET Core 2.1 to use EF Core 2.1.

Scaffolding a Database Using .NET Core CLI

Initialize a valid .NET Core project and console application using the .NET Core command-line interface (CLI) and then change to the newly created folder (sakilaConsole).
```
dotnet new console –o sakilaConsole          
```
```
cd sakilaConsole          
```
Add the MySQL NuGet package for EF Core using the CLI. For example, use the following command to add the MySql.Data.EntityFrameworkCore v8.0.13 package:
```
dotnet add package MySql.Data.EntityFrameworkCore --version 8.0.13         
```
Note
The version (for example, --version 8.0.13) must match the actual Connector/NET version you are using. For current version information, see Table 8.2, “Supported versions of Entity Framework Core”.
Add the following Microsoft.EntityFrameworkCore.Design Nuget package:
```
dotnet add package Microsoft.EntityFrameworkCore.Design
```
EF Core 1.1 only: Also add the MySql.Data.EntityFrameworkCore.Design package.
Add a reference to Microsoft.EntityFrameworkCore.Tools.DotNet as a DotNetCliToolReference entry in the sakilaConsole.csproj file as follows:
EF Core 1.1
```
<ItemGroup>
   <DotNetCliToolReference Include="Microsoft.EntityFrameworkCore.Tools.DotNet" Version="1.1.6"/>
</ItemGroup>
```
EF Core 2.0
```
<ItemGroup>
   <DotNetCliToolReference Include="Microsoft.EntityFrameworkCore.Tools.DotNet" Version="2.0.3"/>
</ItemGroup>
```
Note
The .NET tools are included in the .NET Core 2.1 SDK and not required or supported for EF Core 2.1. If this is an upgrade, remove the following reference to that package from the .csproj file (version 2.0.3 in this example) :
```
<DotNetCliToolReference Include="Microsoft.EntityFrameworkCore.Tools.DotNet" Version="2.0.3" />
```
Restore dependencies and project-specific tools that are specified in the project file as follows:
```
dotnet restore
```
Create the Entity Framework Core model by executing the following command (adjust the connection-string values to match your settings for the user= and password= options):
```
dotnet ef dbcontext scaffold "server=localhost;port=3306;user=root;password=mypass;database=sakila" MySql.Data.EntityFrameworkCore -o sakila -f
```
To validate that the model has been created, open the new sakila folder. You should see files corresponding to all tables mapped to entities. In addition, look for the sakilaContext.cs file, which contains the DbContext for this database.

Scaffolding a Database Using Package Manager Console in Visual Studio

Open Visual Studio and create a new Console App (.NET Core) for C#.
Add the MySQL NuGet package for EF Core using the Package Manager Console. For example, use the following command to add the MySql.Data.EntityFrameworkCore v8.0.13 package:
```
Install-Package MySql.Data.EntityFrameworkCore -Version 8.0.13         
```
Note
The version (for example, -Version 8.0.13) must match the actual Connector/NET version you are using. For current version information, see Table 8.2, “Supported versions of Entity Framework Core”.
Install the following NuGet packages by selecting either Package Manager Console or Manage NuGet Packages for Solution from the Tools and then NuGet Package Manager menu:
- Microsoft.EntityFrameworkCore.Design
  EF Core 1.1 only: Also add the MySql.Data.EntityFrameworkCore.Design package.
- Microsoft.EntityFrameworkCore.Tools version 1.1.6 (for EF Core 1.1) and Microsoft.EntityFrameworkCore.Tools version 2.0.3 (for EF Core 2.0)
  Note
  The .NET tools are included in the .NET Core 2.1 SDK and not required or supported for EF Core 2.1. If this is an upgrade, remove the reference to that package from the .csproj file (version 2.0.3 in this example) :
```
<DotNetCliToolReference Include="Microsoft.EntityFrameworkCore.Tools.DotNet" Version="2.0.3" />
```
Open Package Manager Console and enter the following command at the prompt to create the entities and DbContext for the sakila database (adjust the connection-string values to match your settings for the user= and password= options):
```
Scaffold-DbContext "server=localhost;port=3306;user=root;password=mypass;database=sakila" MySql.Data.EntityFrameworkCore -OutputDir sakila -f
```
Visual Studio creates a new sakila folder inside the project, which contains all the tables mapped to entities and the sakilaContext.cs file.

Scaffolding a Database by Filtering Tables

It is possible to specify the exact tables in a schema to use when scaffolding database and to omit the rest. The command-line examples that follow show the parameters needed for filtering tables.

.NET Core CLI:

dotnet ef dbcontext scaffold "server=localhost;port=3306;user=root;password=mypass;database=sakila" MySql.Data.EntityFrameworkCore -o sakila -t actor -t film -t film_actor -t language -f

Package Manager Console in Visual Studio:

Scaffold-DbContext "server=localhost;port=3306;user=root;password=mypass;database=sakila" MySql.Data.EntityFrameworkCore -OutputDir Sakila -Tables actor,film,film_actor,language -f

Scaffolding with Multiple Schemas

When scaffolding a database, you can use more than one schema or database. Note that the account used to connect to the MySQL server must have access to each schema to be included within the context. Multiple-schema functionality was introduced in Connector/NET 6.10.3-rc and 8.0.9-dmr releases.

The following command-line examples show how to incorporate the sakila and world schemas within a single context.

.NET Core CLI:

dotnet ef dbcontext scaffold "server=localhost;port=3306;user=root;password=mypass;database=sakila" MySql.Data.EntityFrameworkCore -o sakila --schema sakila --schema world -f

Package Manager Console in Visual Studio:

Scaffold-DbContext "server=localhost;port=3306;user=root;password=mypass;database=sakila" MySql.Data.EntityFrameworkCore -OutputDir Sakila -Schemas sakila,world -f