다음을 통해 공유


Microsoft SQL Server EF Core 데이터베이스 공급자

이 데이터베이스 공급자를 사용하면 Entity Framework Core를 Microsoft SQL Server(Azure SQL 및 Azure Synapse Analytics 포함)와 함께 사용할 수 있습니다. 공급자는 Entity Framework Core 프로젝트일부로 유지 관리됩니다.

설치하다

Microsoft.EntityFrameworkCore.SqlServer NuGet 패키지설치합니다.

dotnet add package Microsoft.EntityFrameworkCore.SqlServer

메모

공급자는 Microsoft.Data.SqlClient(System.Data.SqlClient 아님)를 참조합니다. 프로젝트가 SqlClient에 직접 종속되는 경우 Microsoft.Data.SqlClient 패키지를 참조하는지 확인합니다.

Microsoft.Data.SqlClient 패키지는 EF Core 공급자보다 더 자주 제공됩니다. 새 기능 및 버그 수정을 활용하려면 최신 버전의 Microsoft.Data.SqlClient에 직접 패키지 참조를 추가할 수 있습니다.

경고

Microsoft.Data.SqlClient 비동기 구현에는 알려진 문제(예: #593, #601등)가 있습니다. 예기치 않은 성능 문제가 발생하는 경우 특히 큰 텍스트 또는 이진 값을 처리할 때 동기화 명령 실행을 대신 사용해 보세요.

사용법

EF 9부터 UseAzureSqlUseAzureSynapse 사용하여 Azure SQL 또는 Azure Synapse Analytics에 특별히 연결하도록 지정하고 UseSqlServer 온-프레미스 SQL Server에 연결하도록 지정하는 것이 좋습니다. 이렇게 하면 공급자가 이러한 플랫폼을 최적화하고 적절하게 지원할 수 있습니다. 또한 UseCompatibilityLevel 메서드를 사용하여 생성된 SQL이 호환되거나 가능한 최신 기능을 사용하도록 호환성 수준을 지정하는 것이 좋습니다.

메모

UseAzureSql 및 UseAzureSynapse 메서드는 EF Core 9.0에서 도입되었습니다.

지원되는 데이터베이스 엔진

  • Microsoft SQL Server(2012 이상)
  • Azure SQL
  • Azure Synapse Analytics