이벤트
3월 31일 오후 11시 - 4월 2일 오후 11시
궁극적인 Microsoft Fabric, Power BI, SQL 및 AI 커뮤니티 주도 이벤트입니다. 2025년 3월 31일부터 4월 2일까지.
지금 등록작성자: Tom Dykstra, Jon P Smith 및 Rick Anderson
Contoso University 웹앱은 EF Core 및 Visual Studio를 사용하여 Razor Pages 웹앱을 만드는 방법을 보여줍니다. 자습서 시리즈에 대한 정보는 첫 번째 자습서를 참조합니다.
해결할 수 없는 문제가 발생한 경우 완성된 앱을 다운로드하고 자습서를 따라 만든 코드와 해당 코드를 비교합니다.
이 자습서에서는 데이터 모델 변경 관리를 위한 EF Core 마이그레이션 기능을 도입합니다.
새 앱이 개발되면 데이터 모델이 자주 변경됩니다. 모델이 변경될 때마다 모델이 데이터베이스와 동기화 해제됩니다. 이 자습서 시리즈는 존재하지 않는 경우 데이터베이스를 만들도록 Entity Framework를 구성하여 시작되었습니다. 데이터 모델이 변경될 때마다 데이터베이스를 삭제해야 합니다. 다음에 앱이 실행되면 EnsureCreated
가 호출되어 새 데이터 모델과 일치하도록 데이터베이스를 다시 만듭니다. 그런 다음, DbInitializer
클래스가 실행되어 새 데이터베이스를 시드합니다.
DB를 데이터 모델과 동기화된 상태로 유지하는 접근 방식은 앱을 제작 환경에 배포할 때까지 잘 작동하게 합니다. 앱이 프로덕션 환경에서 실행 중인 경우 일반적으로 유지 관리해야 하는 데이터를 저장합니다. 앱은 변경(예: 새 열 추가)될 때마다 테스트 DB로 시작될 수 없습니다. EF Core 마이그레이션 기능은 EF Core에서 새 데이터베이스를 만드는 대신 DB 스키마를 업데이트하도록 하여 이 문제를 해결합니다.
데이터 모델이 변경될 때 데이터베이스를 삭제하고 다시 작성하는 대신 마이그레이션은 스키마를 업데이트하고 기존 데이터를 유지합니다.
참고
SQLite 제한 사항
이 자습서에서는 가능한 경우 Entity Framework Core ‘마이그레이션’ 기능을 사용합니다. 마이그레이션은 데이터 모델의 변경 내용과 일치하도록 데이터베이스 스키마를 수정합니다. 그러나 마이그레이션은 데이터베이스 엔진에서 지원하는 종류의 변경만 수행하며 SQLite의 스키마 변경 기능은 제한됩니다. 예를 들어 열 추가는 지원되지만 열 제거는 지원되지 않습니다. 열을 제거하기 위해 마이그레이션을 만들면 ef migrations add
명령은 성공하지만 ef database update
명령은 실패합니다.
SQLite 제한 사항에 대한 해결 방법은 테이블의 내용이 변경되면 테이블을 다시 빌드하기 위해 수동으로 마이그레이션 코드를 작성하는 것입니다. 코드는 마이그레이션을 위한 Up
과 Down
메서드에 포함되고 다음을 포함합니다.
이 형식의 데이터베이스 관련 코드를 작성하는 방법은 이 자습서에서 다루지 않습니다. 대신, 이 자습서에서는 마이그레이션을 적용하려는 시도가 실패할 때마다 데이터베이스를 삭제하고 다시 만듭니다. 자세한 내용은 다음 리소스를 참조하세요.
SSOX(SQL Server 개체 탐색기)를 사용하여 데이터베이스를 삭제하거나, PMC(패키지 관리자 콘솔)에서 다음 명령을 실행합니다.
Drop-Database
PMC에서 다음 명령을 실행합니다.
Add-Migration InitialCreate
Update-Database
이 자습서 시리즈는 EnsureCreated를 사용하여 시작되었습니다. EnsureCreated
는 마이그레이션 기록 테이블을 만들지 않으므로 마이그레이션과 함께 사용할 수 없습니다. 데이터베이스를 삭제하고 자주 다시 생성하는 테스트 또는 신속한 프로토타입 만들기를 위해 디자인되었습니다.
이 지점부터 자습서에서는 마이그레이션을 사용합니다.
에서 Program.cs
다음 줄을 삭제합니다.
context.Database.EnsureCreated();
앱을 실행하고 데이터베이스가 시드되는지 확인합니다.
EF Coremigrations add
명령은 데이터베이스를 만드는 코드를 생성했습니다. 이 마이그레이션 코드는 Migrations\<timestamp>_InitialCreate.cs
파일에 있습니다. InitialCreate
클래스의 Up
메서드는 데이터 모델 엔터티 집합에 해당하는 데이터베이스 테이블을 만듭니다. Down
메서드는 다음 예제처럼 테이블을 삭제합니다.
using System;
using Microsoft.EntityFrameworkCore.Metadata;
using Microsoft.EntityFrameworkCore.Migrations;
namespace ContosoUniversity.Migrations
{
public partial class InitialCreate : Migration
{
protected override void Up(MigrationBuilder migrationBuilder)
{
migrationBuilder.CreateTable(
name: "Course",
columns: table => new
{
CourseID = table.Column<int>(nullable: false),
Title = table.Column<string>(nullable: true),
Credits = table.Column<int>(nullable: false)
},
constraints: table =>
{
table.PrimaryKey("PK_Course", x => x.CourseID);
});
migrationBuilder.CreateTable(
name: "Student",
columns: table => new
{
ID = table.Column<int>(nullable: false)
.Annotation("SqlServer:ValueGenerationStrategy", SqlServerValueGenerationStrategy.IdentityColumn),
LastName = table.Column<string>(nullable: true),
FirstMidName = table.Column<string>(nullable: true),
EnrollmentDate = table.Column<DateTime>(nullable: false)
},
constraints: table =>
{
table.PrimaryKey("PK_Student", x => x.ID);
});
migrationBuilder.CreateTable(
name: "Enrollment",
columns: table => new
{
EnrollmentID = table.Column<int>(nullable: false)
.Annotation("SqlServer:ValueGenerationStrategy", SqlServerValueGenerationStrategy.IdentityColumn),
CourseID = table.Column<int>(nullable: false),
StudentID = table.Column<int>(nullable: false),
Grade = table.Column<int>(nullable: true)
},
constraints: table =>
{
table.PrimaryKey("PK_Enrollment", x => x.EnrollmentID);
table.ForeignKey(
name: "FK_Enrollment_Course_CourseID",
column: x => x.CourseID,
principalTable: "Course",
principalColumn: "CourseID",
onDelete: ReferentialAction.Cascade);
table.ForeignKey(
name: "FK_Enrollment_Student_StudentID",
column: x => x.StudentID,
principalTable: "Student",
principalColumn: "ID",
onDelete: ReferentialAction.Cascade);
});
migrationBuilder.CreateIndex(
name: "IX_Enrollment_CourseID",
table: "Enrollment",
column: "CourseID");
migrationBuilder.CreateIndex(
name: "IX_Enrollment_StudentID",
table: "Enrollment",
column: "StudentID");
}
protected override void Down(MigrationBuilder migrationBuilder)
{
migrationBuilder.DropTable(
name: "Enrollment");
migrationBuilder.DropTable(
name: "Course");
migrationBuilder.DropTable(
name: "Student");
}
}
}
위의 코드는 초기 마이그레이션에 대한 코드입니다. 코드:
migrations add InitialCreate
명령에서 생성되었습니다.database update
명령에서 실행됩니다.파일 이름에는 마이그레이션 이름 매개 변수(예제에서 InitialCreate
)가 사용됩니다. 마이그레이션 이름은 임의의 유효한 파일 이름이 될 수 있습니다. 마이그레이션에서 수행 중인 작업을 요약한 단어 또는 구를 선택하는 것이 가장 좋습니다. 예를 들어 부서 테이블을 추가한 마이그레이션은 "AddDepartmentTable"이라고 할 수 있습니다.
__EFMigrationsHistory
테이블이 추가된 것을 볼 수 있습니다. __EFMigrationsHistory
테이블은 데이터베이스에 적용된 마이그레이션을 추적합니다.__EFMigrationsHistory
테이블의 데이터를 봅니다. 첫 번째 마이그레이션에 대해 한 행을 표시합니다.마이그레이션에서는 현재 데이터 모델의 Migrations/SchoolContextModelSnapshot.cs
스냅샷 만듭니다. 마이그레이션을 추가하면 EF가 현재 데이터 모델을 스냅샷 파일과 비교하여 변경 내용을 확인합니다.
스냅샷 파일이 데이터 모델의 상태를 추적하므로 <timestamp>_<migrationname>.cs
파일을 삭제하여 마이그레이션을 삭제할 수 없습니다. 가장 최근 마이그레이션을 백업하려면 migrations remove
명령을 사용해야 합니다. migrations remove
는 마이그레이션을 삭제하고 스냅샷이 올바르게 다시 설정되도록 합니다. 자세한 내용은 dotnet ef migrations remove를 참조하세요.
모든 마이그레이션을 제거하려면 모든 마이그레이션 초기화를 참조하세요.
프로덕션 앱은 애플리케이션 시작 시 Database.Migrate를 호출하지 않는 것이 좋습니다. Migrate
는 서버 팜에 배포된 앱에서 호출하면 안 됩니다. 앱이 여러 서버 인스턴스로 확장되는 경우 데이터베이스 스키마 업데이트가 여러 서버에서 발생하거나 읽기/쓰기 권한과 충돌하지 않도록 하는 것이 어렵습니다.
데이터베이스 마이그레이션은 배포의 일부로 제어된 방식으로 수행되어야 합니다. 프로덕션 데이터베이스 마이그레이션 방법은 다음과 같습니다.
dotnet ef database update
실행앱에서 SQL Server LocalDB를 사용하고 다음 예외를 표시하는 경우:
SqlException: Cannot open database "ContosoUniversity" requested by the login.
The login failed.
Login failed for user 'user name'.
솔루션은 명령 프롬프트에서 dotnet ef database update
를 실행해야 할 수 있습니다.
다음 자습서에서는 데이터 모델을 빌드하여 엔터티 속성 및 새 엔터티를 추가합니다.
이 자습서에서는 데이터 모델 변경 관리를 위한 EF Core 마이그레이션 기능이 사용됩니다.
해결할 수 없는 문제가 발생한 경우 완성된 앱을 다운로드합니다.
새 앱이 개발되면 데이터 모델이 자주 변경됩니다. 모델이 변경될 때마다 모델이 데이터베이스와 동기화 해제됩니다. 이 자습서는 존재하지 않는 경우 데이터베이스를 만들도록 Entity Framework를 구성하여 시작되었습니다. 데이터 모델이 변경될 때마다 다음이 수행됩니다.
DB를 데이터 모델과 동기화된 상태로 유지하는 접근 방식은 앱을 제작 환경에 배포할 때까지 잘 작동하게 합니다. 앱이 프로덕션 환경에서 실행 중인 경우 일반적으로 유지 관리해야 하는 데이터를 저장합니다. 앱은 변경(예: 새 열 추가)될 때마다 테스트 DB로 시작될 수 없습니다. EF Core 마이그레이션 기능은 EF Core에서 새 데이터베이스를 만드는 대신 DB 스키마를 업데이트하도록 하여 이 문제를 해결합니다.
데이터 모델이 변경될 때 DB를 삭제하고 다시 작성하는 대신 마이그레이션은 스키마를 업데이트하고 기존 데이터를 유지합니다.
SSOX(SQL Server 개체 탐색기) 또는 database drop
명령을 사용합니다.
PMC(패키지 관리자 콘솔)에서 다음 명령을 입력합니다.
Drop-Database
PMC에서 Get-Help about_EntityFrameworkCore
를 실행하여 도움말 정보를 가져옵니다.
프로젝트를 빌드하고 첫 번째 마이그레이션을 만듭니다.
Add-Migration InitialCreate
Update-Database
EF Coremigrations add
명령은 데이터베이스를 만드는 코드를 생성했습니다. 이 마이그레이션 코드는 Migrations\<timestamp>_InitialCreate.cs
파일에 있습니다. InitialCreate
클래스의 Up
메서드는 데이터 모델 엔터티 집합에 해당하는 데이터베이스 테이블을 만듭니다. Down
메서드는 다음 예제처럼 테이블을 삭제합니다.
public partial class InitialCreate : Migration
{
protected override void Up(MigrationBuilder migrationBuilder)
{
migrationBuilder.CreateTable(
name: "Course",
columns: table => new
{
CourseID = table.Column<int>(nullable: false),
Title = table.Column<string>(nullable: true),
Credits = table.Column<int>(nullable: false)
},
constraints: table =>
{
table.PrimaryKey("PK_Course", x => x.CourseID);
});
migrationBuilder.CreateTable(
protected override void Down(MigrationBuilder migrationBuilder)
{
migrationBuilder.DropTable(
name: "Enrollment");
migrationBuilder.DropTable(
name: "Course");
migrationBuilder.DropTable(
name: "Student");
}
}
마이그레이션에서는 마이그레이션을 위한 데이터 모델 변경을 구현하기 위해 Up
메서드를 호출합니다. 업데이트를 롤백하는 명령을 입력하면 마이그레이션에서 Down
메서드를 호출합니다.
위의 코드는 초기 마이그레이션에 대한 코드입니다. 이 코드는 migrations add InitialCreate
명령을 실행할 때 만들어집니다. 파일 이름에는 마이그레이션 이름 매개 변수(이 예제에서 "InitialCreate")가 사용됩니다. 마이그레이션 이름은 임의의 유효한 파일 이름이 될 수 있습니다. 마이그레이션에서 수행 중인 작업을 요약한 단어 또는 구를 선택하는 것이 가장 좋습니다. 예를 들어 부서 테이블을 추가한 마이그레이션은 "AddDepartmentTable"이라고 할 수 있습니다.
초기 마이그레이션이 생성되었고 DB가 존재하는 경우:
앱이 새 환경에 배포되면 DB 만들기 코드를 실행하여 DB를 만들어야 합니다.
이전에 DB는 삭제되었거나 존재하지 않으므로 마이그레이션에서 새 DB를 만듭니다.
마이그레이션은 현재 데이터베이스 스키마의 스냅샷을 Migrations/SchoolContextModelSnapshot.cs
에 만듭니다. 마이그레이션을 추가하면 EF가 데이터 모델을 스냅샷 파일과 비교하여 변경 내용을 확인합니다.
마이그레이션을 삭제하려면 다음 명령을 사용합니다.
마이그레이션 제거
마이그레이션 제거 명령은 마이그레이션을 삭제하고 스냅샷이 올바르게 다시 설정되도록 합니다.
초기 개발에는 EnsureCreated
가 사용되었습니다. 이 자습서에서는 마이그레이션이 사용됩니다. EnsureCreated
에는 다음과 같은 제한 사항이 적용됩니다.
EnsureCreated
를 제거합니다.
context.Database.EnsureCreated();
앱을 실행하고 DB이 시드되었는지 확인합니다.
SQL Server 개체 탐색기를 사용하여 DB를 검사합니다. __EFMigrationsHistory
테이블이 추가된 것을 볼 수 있습니다. __EFMigrationsHistory
테이블은 DB에 적용된 마이그레이션을 추적합니다. __EFMigrationsHistory
테이블의 데이터를 보면 첫 번째 마이그레이션에 대해 한 행이 표시됩니다. 앞의 CLI 출력 예제의 마지막 로그는 이 행을 만드는 INSERT 문을 보여 줍니다.
앱을 실행하고 모든 항목이 작동하는지 확인합니다.
프로덕션 앱은 애플리케이션 시작 시 Database.Migrate를 호출하지 않는 것이 좋습니다. 서버 팜의 앱에서 Migrate
를 호출하면 안됩니다. 예를 들어, 앱이 스케일 아웃으로 클라우드에 배포된 경우(앱의 여러 인스턴스가 실행 중임)
데이터베이스 마이그레이션은 배포의 일부로 제어된 방식으로 수행되어야 합니다. 프로덕션 데이터베이스 마이그레이션 방법은 다음과 같습니다.
dotnet ef database update
실행EF Core는 __MigrationsHistory
테이블을 사용하여 마이그레이션을 실행해야 하는지 확인합니다. DB가 최신 상태이면 마이그레이션이 실행되지 않습니다.
완료된 앱을 다운로드합니다.
앱에서는 다음과 같은 예외가 생성됩니다.
SqlException: Cannot open database "ContosoUniversity" requested by the login.
The login failed.
Login failed for user 'user name'.
해결 방법: dotnet ef database update
를 실행합니다.
ASP.NET Core 피드백
ASP.NET Core은(는) 오픈 소스 프로젝트입니다. 다음 링크를 선택하여 피드백을 제공해 주세요.
이벤트
3월 31일 오후 11시 - 4월 2일 오후 11시
궁극적인 Microsoft Fabric, Power BI, SQL 및 AI 커뮤니티 주도 이벤트입니다. 2025년 3월 31일부터 4월 2일까지.
지금 등록