C# Academy · 강의

마이그레이션과 스키마 관리

마이그레이션을 만들고 적용하고 롤백해 데이터베이스 스키마를 안전하게 발전시킵니다.

마이그레이션과 스키마 관리은(는) CoddyKit의 무료 C# Academy 강의입니다. 이것은 4개 중 2번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 C# Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. C# Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

EF Core 마이그레이션이란?

마이그레이션은 데이터베이스 스키마의 점진적인 변경 사항을 설명하는 코드 생성 파일입니다. DDL을 직접 작성하는 대신 EF Core가 이를 자동으로 생성하고 적용하여 코드와 데이터베이스를 동기화합니다.

EF Core 도구 설치하기

터미널에서 마이그레이션 명령을 실행하려면 EF Core CLI 도구(dotnet-ef)를 전역 도구 또는 로컬 도구로 설치해야 합니다.

# Install globally
dotnet tool install --global dotnet-ef

# Verify
dotnet ef --version

# Required NuGet packages in your project:
# Microsoft.EntityFrameworkCore.Design
# Microsoft.EntityFrameworkCore.SqlServer (or Sqlite, etc.)

첫 번째 마이그레이션 만들기

dotnet ef migrations add는 현재 모델을 마지막 스냅샷과 비교하고, Up()(적용) 및 Down()(롤백) 메서드가 포함된 마이그레이션 파일을 생성합니다.

# Create initial migration
dotnet ef migrations add InitialCreate

# Output files created:
# Migrations/20240101_InitialCreate.cs       <- Up/Down
# Migrations/20240101_InitialCreate.Designer.cs
# Migrations/AppDbContextModelSnapshot.cs   <- current model

마이그레이션 파일 내부 살펴보기

각 마이그레이션에는 변경 사항을 적용하는 Up 메서드와 변경 사항을 되돌리는 Down 메서드가 있습니다. EF Core는 모델 간의 차이에서 이를 자동으로 생성합니다.

public partial class InitialCreate : Migration
{
    protected override void Up(MigrationBuilder migrationBuilder)
    {
        migrationBuilder.CreateTable(
            name: "Products",
            columns: table => new
            {
                Id    = table.Column<int>(nullable: false)
                             .Annotation("SqlServer:Identity", "1, 1"),
                Name  = table.Column<string>(maxLength: 200, nullable: false),
                Price = table.Column<decimal>(type: "decimal(18,2)", nullable: false)
            },
            constraints: table => table.PrimaryKey("PK_Products", x => x.Id));
    }

    protected override void Down(MigrationBuilder migrationBuilder)
    {
        migrationBuilder.DropTable(name: "Products");
    }
}

마이그레이션 적용하기

dotnet ef database update는 아직 적용되지 않은 모든 마이그레이션을 적용합니다. EF Core는 __EFMigrationsHistory 테이블에서 실행된 마이그레이션을 추적합니다.

# Apply all pending migrations
dotnet ef database update

# Apply up to a specific migration
dotnet ef database update AddProductIndex

# Roll back to a previous migration
dotnet ef database update InitialCreate

시작 시 프로그래밍 방식으로 마이그레이션 적용하기

운영 환경에서는 시작할 때 프로그래밍 방식으로 마이그레이션을 적용하여 수동 CLI 단계 없이 데이터베이스를 항상 최신 상태로 유지할 수 있습니다.

var app = builder.Build();

// Apply pending migrations at startup
using (var scope = app.Services.CreateScope())
{
    var db = scope.ServiceProvider.GetRequiredService<AppDbContext>();
    await db.Database.MigrateAsync();
}

app.Run();

새 마이그레이션에서 열 추가하기

엔터티에 속성을 추가한 다음 새 마이그레이션을 생성합니다. EF Core가 변경 사항을 감지하고 AddColumn 작업을 생성합니다.

// 1. Add property to entity
public class Product
{
    public int Id { get; set; }
    public string Name { get; set; } = "";
    public decimal Price { get; set; }
    public string? Description { get; set; } // NEW
}

// 2. Generate migration
// dotnet ef migrations add AddProductDescription

// Generated Up():
migrationBuilder.AddColumn<string>(
    name: "Description",
    table: "Products",
    nullable: true);

마이그레이션에서 데이터 초기화하기

OnModelCreating에서 HasData를 사용하여 참조 데이터를 초기화합니다. EF Core는 이를 마이그레이션의 Up에 INSERT 문으로 포함합니다.

modelBuilder.Entity<Category>().HasData(
    new Category { Id = 1, Name = "Electronics" },
    new Category { Id = 2, Name = "Books" },
    new Category { Id = 3, Name = "Clothing" }
);

// Then regenerate the migration:
// dotnet ef migrations add SeedCategories

마이그레이션에서 사용자 지정 SQL 사용하기

EF Core가 자동으로 생성할 수 없는 DDL이 필요한 경우(트리거, 뷰, 저장 프로시저) migrationBuilder.Sql()을 사용합니다.

protected override void Up(MigrationBuilder migrationBuilder)
{
    migrationBuilder.Sql(@"
        CREATE VIEW vw_ActiveProducts AS
        SELECT Id, Name, Price
        FROM Products
        WHERE IsActive = 1
    ");
}

protected override void Down(MigrationBuilder migrationBuilder)
{
    migrationBuilder.Sql("DROP VIEW vw_ActiveProducts");
}

마이그레이션 제거하기

아직 마이그레이션을 적용하지 않았다면 dotnet ef migrations remove로 삭제할 수 있습니다. 이 방법으로는 마지막 마이그레이션만 제거할 수 있습니다.

# Remove the last unapplied migration
dotnet ef migrations remove

# List all migrations and their status
dotnet ef migrations list

# Script all migrations to SQL (for DBA review)
dotnet ef migrations script --output deploy.sql

실전: CI/CD 마이그레이션 전략

CI/CD 배포 과정에서는 마이그레이션 스크립트를 생성하고 DBA가 운영 환경에 적용하기 전에 검토하도록 하십시오. 중요한 운영 시스템에서 MigrateAsync()를 맹목적으로 실행해서는 안 됩니다.

# Generate idempotent script for all pending migrations
dotnet ef migrations script --idempotent --output migrations.sql

# Review migrations.sql, then apply via sqlcmd / psql:
# sqlcmd -S server -d db -i migrations.sql

빠른 확인

데이터베이스에 이미 적용된 마이그레이션을 추적하는 EF Core 테이블은 무엇입니까?

복습: 마이그레이션 및 스키마 관리

핵심 내용:

dotnet ef migrations add <Name>는 스키마를 점진적으로 변경하는 파일을 생성합니다
각 마이그레이션에는 Up()(적용) 및 Down()(롤백) 메서드가 있습니다
dotnet ef database update는 아직 적용되지 않은 마이그레이션을 적용합니다
자동 배포를 위해 앱 시작 시 MigrateAsync()를 사용합니다
운영 배포 과정에서 DBA가 검토할 수 있도록 멱등성 스크립트를 생성합니다

자주 묻는 질문

“마이그레이션과 스키마 관리” 강의는 무료인가요?

네 — “마이그레이션과 스키마 관리” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 C# Academy 강의 전체를 잠금 해제할 수 있습니다. C# Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“마이그레이션과 스키마 관리”에서 뭘 배우나요?

마이그레이션을 만들고 적용하고 롤백해 데이터베이스 스키마를 안전하게 발전시킵니다. 브라우저에서 직접 실행하는 실습 코드로 C# Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

C# Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 C# Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 2번째 강의입니다.

“마이그레이션과 스키마 관리” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 C# Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 C# Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

← C# Academy(으)로 돌아가기