dotnet ef 명령어 사용을 위한 준비
dotnet ef 명령어는 Microsoft.EntityFrameworkCore를 위한 확장 명령어인데, 이에 대해서는 다음의 글에서 자세하게 설명하고 있습니다.
EF Core .NET Command-line Tools
; https://docs.microsoft.com/en-us/ef/core/miscellaneous/cli/dotnet
dotnet ef 명령어를 위한 사전 준비 작업은 간단합니다. 우선, .csproj 파일에 다음과 같이 DotNetCliToolReference 노드를 추가합니다.
<Project Sdk="Microsoft.NET.Sdk.Web">
...[생략]...
<ItemGroup>
...[생략]...
<DotNetCliToolReference Include="Microsoft.EntityFrameworkCore.Tools.DotNet" Version="2.0.0" />
</ItemGroup>
</Project>
이렇게만 설정하면 이후 dotnet ef 명령어가 실행 가능합니다. 하지만, "dotnet ef database update"와 같은 명령어가 제대로 동작하려면 해당 프로젝트에 "Microsoft.EntityFrameworkCore.Design" 어셈블리도 참조가 되어 있어야 합니다. 이를 위해 다음과 같이 NuGet으로부터 패키지 추가를 하면 됩니다.
Install-Package Microsoft.EntityFrameworkCore.Design
또는 명령행에서 "dotnet add package"를 수행해도 됩니다.
...> dotnet add package Microsoft.EntityFrameworkCore.Design
...> dotnet restore
이후 .csproj 파일이 있는 폴더에서 "dotnet ef ..." 명령어를 수행하면 정상적으로 Microsoft.EntityFrameworkCore 관련 작업을 수행할 수 있습니다.
오류 정리입니다. ^^ 만약 다음과 같이 오류가 발생하면,
E:\WebApplication1> dotnet ef
No executable found matching command "dotnet-ef"
반드시 .csproj 파일과 같은 폴더에서 "dotnet ef" 명령어를 수행했는지 확인 후, .csproj 파일에도 다음의 설정이 포함되어 있는지 봅니다.
<DotNetCliToolReference Include="Microsoft.EntityFrameworkCore.Tools.DotNet" Version="2.0.0" />
반면, 다음과 같은 오류가 발생한다면?
E:\WebApplication1\WebApplication2> dotnet ef database update
Your startup project 'WebApplication2' doesn't reference Microsoft.EntityFrameworkCore.Design. This package is required for the Entity Framework Core Tools to work. Ensure your startup project is correct, install the package, and try again.
프로젝트(csproj)에 "Microsoft.EntityFrameworkCore.Design" 어셈블리가 참조되어 있는지 확인합니다. 없다면 NuGet으로부터 추가합니다.
Install-Package Microsoft.EntityFrameworkCore.Design
또는 이런 오류 메시지가 나온다면?
E:\WebApplication1\WebApplication2> dotnet ef database update
No DbContext was found in assembly 'WebApplication2'. Ensure that you're using the correct assembly and that the type is neither abstract nor generic.
해당 .csproj 파일에 DbContext 관련 클래스가 정의되어 있지 않기 때문입니다. 관련 코드를 먼저 추가한 다음 "dotnet ef database update" 명령어를 수행해야 합니다.
그 외에, UseSqlServer 확장 메서드 사용 시
services.AddDbContext<YourDBContext>(options => options.UseSqlServer(dbConnectionString));
다음과 같은 컴파일 오류가 발생할 수 있습니다.
Error CS1061 'DbContextOptionsBuilder' does not contain a definition for 'UseSqlServer' and no extension method 'UseSqlServer' accepting a first argument of type 'DbContextOptionsBuilder' could be found (are you missing a using directive or an assembly reference?)
UseSqlServer 확장 메서드는 Microsoft.EntityFrameworkCore.SqlServer 어셈블리에 정의되어 있는데 이를 참조하지 않아서 그런 것입니다. 역시 NuGet을 통해 참조를 하면 정상적으로 빌드가 됩니다.
Install-Package Microsoft.EntityFrameworkCore.SqlServer
[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]