다음을 통해 공유


Entity Framework Core 설치

필수 조건

  • EF에는 최신 .NET SDK가 필요합니다.

    • 런타임에 EF Core에는 최신 버전의 .NET이 필요합니다. 사용하려는 EF Core 버전에 필요한 최소 .NET 버전을 찾으려면 EF Core 릴리스를 참조하세요.
  • EF Core를 사용하면 Windows에서 Visual Studio를 사용하여 애플리케이션을 개발할 수 있습니다. Visual Studio의 최신 버전을 사용하는 것이 좋습니다.

Entity Framework Core 구하기

EF Core는 NuGet 패키지로 제공됩니다. EF Core를 애플리케이션에 추가하려면 사용할 데이터베이스 공급자에 대한 NuGet 패키지를 설치하세요. 사용 가능한 데이터베이스 공급자 목록은 공급자를 참조하세요.

NuGet 패키지를 설치하거나 업데이트하려면 .NET Core CLI(명령줄 인터페이스), Visual Studio 패키지 관리자 대화 상자 또는 Visual Studio 패키지 관리자 콘솔을 사용할 수 있습니다.

.NET Core CLI

  • 운영 체제의 명령줄에서 다음 .NET Core CLI 명령을 사용하여 EF Core SQL Server 공급자를 설치하거나 업데이트합니다.

    dotnet add package Microsoft.EntityFrameworkCore.SqlServer
    
  • dotnet add package 명령에서 -v 한정자를 사용하여 특정 버전을 나타낼 수 있습니다. 예를 들어 EF Core 6.0.14 패키지를 설치하려면 명령에 -v 6.0.14을 추가합니다.

자세한 내용은 .NET CLI(명령줄 인터페이스 도구)를 참조하세요.

Visual Studio NuGet 패키지 관리자 대화 상자

  • Visual Studio 메뉴에서 프로젝트 > NuGet 패키지 관리 선택

  • 찾아보기 또는 업데이트 탭 클릭

  • SQL Server 공급자를 설치하거나 업데이트하려면 Microsoft.EntityFrameworkCore.SqlServer 패키지를 선택하고 확인합니다.

자세한 내용은 NuGet 패키지 관리자 대화 상자를 참조하십시오.

Visual Studio NuGet 패키지 관리자 콘솔

  • Visual Studio 메뉴에서 도구 > NuGet 패키지 관리자 > 패키지 관리자 콘솔 선택

  • SQL Server 공급자를 설치하려면 패키지 관리자 콘솔에서 다음 명령을 실행합니다.

    Install-Package Microsoft.EntityFrameworkCore.SqlServer
    
  • 공급자를 업데이트하려면 Update-Package 명령을 사용합니다.

  • 특정 버전을 지정하려면 -Version 한정자를 사용합니다. 예를 들어 EF Core 6.0.14 패키지를 설치하려면 명령에 -Version 6.0.14을 추가합니다.

자세한 내용은 패키지 관리자 콘솔을 참조하십시오.

Entity Framework Core 도구 가져오기

프로젝트에서 EF Core 관련 작업(예: 데이터베이스 마이그레이션 생성 및 적용)을 수행하거나 기존 데이터베이스를 기반으로 EF Core 모델을 생성하는 도구를 설치할 수 있습니다.

사용 가능한 두 가지 도구 집합:

.NET Core CLI 도구 가져오기

.NET core CLI 도구에는 필수 구성 요소에서 앞서 언급한 .NET Core SDK를 필요로 합니다.

  • dotnet ef는 전역 또는 로컬 도구로 설치해야 합니다. 대부분 개발자는 다음 명령을 사용하여 dotnet ef를 전역 도구로 설치하는 것을 선호합니다.

    dotnet tool install --global dotnet-ef
    

    dotnet ef는 로컬 도구로도 사용할 수 있습니다. 로컬 도구로 사용하려면 도구 매니페스트 파일을 사용하여 이 도구를 도구 종속성으로 선언하는 프로젝트의 종속성을 복원합니다.

  • 도구를 업데이트하려면 dotnet tool update 명령을 사용합니다.

  • 최신 Microsoft.EntityFrameworkCore.Design 패키지를 설치합니다.

    dotnet add package Microsoft.EntityFrameworkCore.Design
    

중요

항상 런타임 패키지의 주 버전에 부합하는 도구 패키지 버전을 사용합니다.

패키지 관리자 콘솔 도구 가져오기

EF Core용 패키지 관리자 콘솔 도구를 가져오려면 Microsoft.EntityFrameworkCore.Tools 패키지를 설치합니다. 예를 들어 Visual Studio에서:

Install-Package Microsoft.EntityFrameworkCore.Tools

최신 EF Core로 업그레이드

  • 새로운 버전의 EF Core를 릴리스할 때마다 Microsoft.EntityFrameworkCore.SqlServer, Microsoft.EntityFrameworkCore.Sqlite, Microsoft.EntityFrameworkCore.Cosmos, Microsoft.EntityFrameworkCore.InMemory와 같은 EF Core 프로젝트의 일부인 새 버전의 공급자도 릴리스합니다. 모든 개선 사항을 가져오려면 새 버전의 공급자로 업그레이드하면 됩니다.

  • 타사 데이터베이스 공급자를 사용하는 애플리케이션을 업데이트해야 할 경우 항상 공급자의 업데이트가 사용할 EF Core 버전과 호환되는지 확인합니다. 예를 들어 버전 1.0용 데이터베이스 공급자는 EF Core 런타임 버전 2.0 등과 호환되지 않습니다.

  • EF Core용 타사 공급자는 일반적으로 EF Core 런타임과 함께 패치 버전을 릴리스하지 않습니다. 타사 공급자를 사용하는 애플리케이션을 EF Core의 패치 버전으로 업그레이드하려면 대표적으로 Microsoft.EntityFrameworkCoreMicrosoft.EntityFrameworkCore.Relational과 같은 개별 EF Core 런타임 구성 요소에 직접 참조를 추가해야 할 수 있습니다.