# Ви, напевно, не робите правильної Migrations EF

> **Обновлено - МSK1 Октябрь МSK2** Опублікували оригінальну версію ноября 2025 - Corrigled bundle options and added current EF Core | 9/10 | guidance | МSK3 | Aspire integration and clearly marked EF core ♫ 11 ♫ preview features ♫ МSK5 ♫ Zobacz [неправильна](#errata) наприкінці для виправ до оригінальної версії.

Працюючи `MigrateAsync()` на старті? ВиM SK1 даєте схему вашої додатки - змінюєте права і сподіваєтесь, що нічого не станеться не так МSK3 Там' є кращий спосіб MSC5 пакети EF міграції дають вам змогу виконувати міграцію як контрольований крок до CI M SK6 зберігати вашу виробничу додатку в безпеці . Але ось тутМSK8 це те, що ми маємо в головному пункті МСК9 інколи шлях МСК10 неправильний М СК11 насправді правильнийMСК12 ДозвольтеМ СЦК13 дослідити, коли використовувати кожен підхідM СЦк14

<datetime class="hidden">2026-10-27T18:39</datetime>

<!--category--  Entity Framework, Migrations, GitHub, CI -->
**офіційні документи:** [Обзор міграції](https://learn.microsoft.com/en-us/ef/core/managing-schemas/migrations/) | [Застосування міграції](https://learn.microsoft.com/en-us/ef/core/managing-schemas/migrations/applying) | [Об 'єднання](https://learn.microsoft.com/en-us/ef/core/managing-schemas/migrations/applying?tabs=dotnet-core-cli#bundles)

[TOC]

# МSK0Неправильний" Спосіб МSK2Я використовую )

Цей блог використовує `MigrateAsync()` на старті - підхід Я МSK1 я зараз скажу вам не використовувати МSK2 Тут ' чому це Ми звісно вийде для мене СМСК5 і чому це, ймовірно, не вийdzie для вас СМСК6

У моєму `Program.cs` у мене є наступне:

```csharp
    using (var scope = app.Services.CreateScope())
    {
        var blogContext = scope.ServiceProvider.GetRequiredService<IMostlylucidDBContext>();
        await blogContext.Database.MigrateAsync();
    }
```

[`MigrateAsync()`](https://learn.microsoft.com/en-us/dotnet/api/microsoft.entityframeworkcore.relationaldatabasefacadeextensions.migrateasync) застосовує очікувані міграції і створює базу даних, якщо це необхідно. Проста M SK1 але проблематична:

1. **Відлежність від запуску** - Далішня база даних знизилась ? Міграція не спрацювала МSK2 Ваша програма виграла M SK3 не почалася .
2. **Збільшені права** - Ваша програма потребує прав на DDL, необхідних для її міграції , потенційно включно з падінням таблиць M SK2 Це не обов 'язково означає SQL Server `db_owner` роль, але це все ще більше потужності, ніж звичайні запити

Чому я так роблю? **Ви, мабуть, можете**

## Коли миші в часі запуску є непоганими

- **Місцевий dev** - Церемонія швидкого повторення ударів
- **Персональні проекти** - нижній радіус вибуху , не має вразливих даних
- **Докер-зробляє dev середовища** - Приємність виграє
- **Прототипування** - схема постійно змінюється в будь-якому разі

## Коли вони не мають

- **Багато прикладів aplikacji** - Міграції стартапу поєднують кожну репликацію з розгортанням scheмиM SK1 EF Core 9+ додає блокування міграції,, але це не координує старого коду застосування з зміною scheмі
- **Сенсивні дані** - PII , фінансова МSK2 регулювальна МSK3 необхідне proper separation
- **Produkція з реальними користувачами** - Перехід не вийде МSK1 вимкнуто

# Правильний шлях – МСК0

Бэндель EF - це функціональна програма, яка містить ваші згенеровані міграції. Подумайте `dotnet ef database update` упакований як артефект для розгортання. Це рамкаM SK1 по замовчуванню залежна; додавати `--self-contained` щоб включити .NET runtime.

**Чому пакети виграють:**

- **Жодного SDK чи EF CLI на мішені** - Самий пакет, що складається з - також включає в себе МSK2NET runtime МSK3 OS \ / нативні залежності, які досі діють
- **Правильне відокремлення** - Отделка ідентичність розгортання отримує необхідні права на схему ; програмне забезпечення зберігає свої нормальні права на дані
- **Взірчість CI** - Невиліки показані в журналах трубопроводуM SK1 не закопані в запускі aplikacji
- **Випускна шлюза** - Виход з ненульового пакету зупиняє розгортання . Це не гарантія того, що кожна зміна бази даних була повернута назад
- **Міграційна історія** - Сигнали, на які ми implementували міграціїM SK1 Налаштування SQL та седування все ще потребують ретельного повторного спробування

> **Питання ідентичності:** Там, де ваша база даних її підтримує, управляемая ідентичність може видалити заpisane пароліM SK1 Ви все ще потребуєте настроїв для підключення та окремого застосування / прав на розгортання. Bundles provide a place to enforce that separation

## Ось приклад дій GitHub

Обіцяти локальний `dotnet-ef` інструментарій, прив 'язаний до версії EF, яку ви використовуєте, і включає `Microsoft.EntityFrameworkCore.Design` в стартапному проекті. Робот збудування відновлює інструменти і створює артефакт; робота з захищеним розгортанням отримує секрет виробництва

```yaml
# Build job: no production credentials
- name: Restore EF tools
  run: dotnet tool restore

- name: Generate Linux migration bundle
  shell: bash
  run: |
    dotnet restore
    dotnet ef migrations bundle \
      --project Mostlylucid.DbContext \
      --startup-project Mostlylucid \
      --context MostlylucidDbContext \
      --configuration Release \
      --target-runtime linux-x64 \
      --self-contained \
      --output efbundle
  env:
    DOTNET_ENVIRONMENT: Production
    ASPNETCORE_ENVIRONMENT: Production

- uses: actions/upload-artifact@v4
  with:
    name: ef-migrations
    path: efbundle

# Deployment job: after downloading the same tested artifact
- uses: actions/download-artifact@v4
  with:
    name: ef-migrations

- name: Apply migrations
  shell: bash
  run: |
    chmod +x ./efbundle
    ./efbundle --connection "$MIGRATION_CONNECTION_STRING" --no-color --prefix-output
  env:
    DOTNET_ENVIRONMENT: Production
    ASPNETCORE_ENVIRONMENT: Production
    MIGRATION_CONNECTION_STRING: ${{ secrets.PROD_SQL_CONNECTIONSTRING }}
```

Використовуйте ваше справжнє ім 'я контексту. Очевидно вибравши Produkcja , ви також уникнете випадкового завантаження конфігурації розробки . Дизайн M SK2 створення часового контексту все ще потребуєValidable Provider Configuration

Пропонувати один і той самий артефакт за допомогою тесту, встановлення та виробництво . Використовуйте захищене середовище GitHub і серіалізуйте розміщування до тієї ж бази данихM SK2 Якщо створення контексту читає файли настроїв, надсилайте необхідні не секретні файли також з пакетом [інструкція щодо використання та конфігурації](https://learn.microsoft.com/en-us/ef/core/managing-schemas/migrations/applying#environment-and-configuration).

# Локальні Bundles

Ні CI? Потрібно перевірити перед тим, як поштовхнути ? Сконструювати пакети локально МSK2

**Використовуйте cases:** Тестування перед запуском CI, DBA ( самі МSK2 вбудований exe M SK3 не потрібен SDK ), розгортання стенджів MSC5 виправлення з `--verbose`.

## Створювання пакету

```bash
# Once per repository: create a tool manifest if you do not already have one
dotnet new tool-manifest
# Example version: choose the supported patch matching your EF packages
dotnet tool install dotnet-ef --version 10.0.12
# In CI or after cloning
dotnet tool restore

# Basic bundle
dotnet ef migrations bundle \
    --project Mostlylucid.DbContext \
    --startup-project Mostlylucid \
    --output efbundle

# Self-contained (includes runtime for the selected OS/architecture)
dotnet ef migrations bundle \
    --project Mostlylucid.DbContext \
    --startup-project Mostlylucid \
    --output efbundle \
    --self-contained

# Cross-platform (e.g., build on Windows, deploy to Linux)
dotnet ef migrations bundle \
    --project Mostlylucid.DbContext \
    --startup-project Mostlylucid \
    --output efbundle \
    --target-runtime linux-x64
```

## Працюючи з вашим пакетом

Далі ми використовуємо Unix shell. на Windows, з `--output efbundle.exe` і бігати `.\efbundle.exe` в PowerShell.

```bash
# Using the connection configured by your DbContext
./efbundle

# Override with a specific connection string
./efbundle --connection "$MIGRATION_CONNECTION_STRING"

# Or use an environment variable matching the key your context reads
export ConnectionStrings__DefaultConnection="$MIGRATION_CONNECTION_STRING"
./efbundle
```

Для останнього прикладу в PowerShell:

```powershell
$env:ConnectionStrings__DefaultConnection = $env:MIGRATION_CONNECTION_STRING
.\efbundle.exe
```

## Полезні варіанти пакету

Є дві різні поверхні команд: `dotnet ef migrations bundle` **будинки** здатність виконувати; `./efbundle` **бігає** це. Їхні варіанти не взаємозамінні

| При будівлі МSK1 Метою МSK2
|---|---|
| `--output`, `-o` | вихідний шлях файлу |
| `--force`, `-f` | Заміняти існуючий файл пакету
| `--self-contained` | Включити час запуску .NET МSK2
| `--target-runtime`, `-r` | Розгортання RID, такі як `linux-x64` або `linux-musl-x64` |
| `--project`, `--startup-project`, `--context` | Вибирати міграціїM SK1 Начальникова конфігурація і контекст |
| `--configuration`, `--framework` | Виберите конфигурацію будування і цільову структуру
| `--no-build` | Знову використати вгоруM SK1 до- дата створення проекту ; не дозволити об 'єднати старі бінарні пакети

Ці інструменти також мають `--runtime` опція. Використовуйте пакет `--target-runtime` щоб зробити ціль розгортання явною. Самої -забезпечена не означає, що один бінарний варіант працює на Windows , Linux і macOS M SK3 будувати для реального цілі MSC4 включаючи архітектуру та libcM SK5

```bash
./efbundle --help
./efbundle --version

# Apply pending migrations, with deployment-friendly logs
./efbundle --verbose --no-color --prefix-output

# Target is positional: this is NOT --target-migration
./efbundle 20231115_AddUserTable

# Revert everything: destructive, only for a disposable test database
./efbundle 0
```

Програмне забезпечення `--connection`, `--verbose`/`-v`, `--no-color`, `--prefix-output`, допомога та версіяM SK1 Його опційним аргументом є міграція, яка має залишатися застосованою . [Źródło команди пакету EF](https://github.com/dotnet/efcore/blob/v10.0.0/src/EFCore.Design/Migrations/Design/MigrationsBundle.cs) показує справжній аналізатор.

### Немає пляшки для сухого запуску

`./efbundle --dry-run` робить **не** існує. І не існує `--verbose` перетворити виконання на попередження. генерувати SQL, не застосовуючи його

```bash
dotnet ef migrations script PreviousMigration AddNewFeature \
    --project Mostlylucid.DbContext \
    --startup-project Mostlylucid \
    --output migrations.sql
```

Використовувати `0` як перший аргумент для нової бази даних

Щоб побачити міграції проекту', які чекають на конфігуровану базу даних:

```bash
dotnet ef migrations list \
    --project Mostlylucid.DbContext \
    --startup-project Mostlylucid
```

Додайте `--no-connect` для того, щоб ввести список маніпурів конструкції' без зв 'язку з базою даних

## локальний тест робочого потоку

```bash
# 1. Create and inspect the migration
dotnet ef migrations add AddNewFeature \
    --project Mostlylucid.DbContext --startup-project Mostlylucid

# 2. Generate reviewable SQL for the expected starting point
dotnet ef migrations script PreviousMigration AddNewFeature \
    --project Mostlylucid.DbContext --startup-project Mostlylucid \
    --output migrations.sql

# 3. Build the bundle for this test host
dotnet ef migrations bundle \
    --project Mostlylucid.DbContext --startup-project Mostlylucid \
    --output efbundle --force

# 4. Apply to a disposable database or restored test copy
./efbundle --connection "$TEST_MIGRATION_CONNECTION_STRING" --verbose

# 5. Run again to verify migration history/retry behaviour
./efbundle --connection "$TEST_MIGRATION_CONNECTION_STRING"
```

Випробувати як нову базу даних, так і оновлення з репертуарної існуючої бази даних.

Якщо найновіша міграція потребує переробки і лише була застосована локально,, то перша оновлення, що **місцевий** базу даних до `PreviousMigration`. Тоді використайте `dotnet ef migrations remove` з одним і тим же проектом/задумні аргументиM SK1 Знімання джерела редагування міграції ; це не є загальною стратегією зворотнього випуску МSK3 Як тільки випущено МСК4 краще нову корективну міграцію М СК5

## Збудувати продуктивність

**генерація пакетів може бути повільною**, особливо для саморобних мішень МSK1забезпечених цілями МSK2 Не генерувати на кожному будівлі

- Виgenerуватируч під час локального тестування
- Збудувати пакет релізу в CI і провести перевірку міграції на PR
- Cache, використовуючи всі необхідні вхідні дані: міграції

Якщо ви дійсно хочете автоматизовану генерацію

```xml
<Target Name="BuildMigrationBundle">
  <Exec Command="dotnet ef migrations bundle --output $(OutputPath)efbundle.exe --force" />
</Target>
```

Тоді: `dotnet build -t:BuildMigrationBundle`

# Гібридний підхід

Найкраще з обох світів МСК0 зручность локально МSK1 безпека в процесі виробництва .

```csharp
if (builder.Environment.IsDevelopment())
{
    using var scope = app.Services.CreateScope();
    var context = scope.ServiceProvider.GetRequiredService<IMostlylucidDBContext>();
    await context.Database.MigrateAsync();
}
// Production: CI pipeline runs the bundle
```

# Альтернативи до Bundles

## Скрипки SQL

Створити простий SQL замість функціонального. Чудово для перевірки DBA та існуючих процесів управління змінами.

```bash
# All migrations
dotnet ef migrations script --output migrations.sql

# Idempotent: checks migration history, when supported by the provider
dotnet ef migrations script --idempotent --output migrations.sql

# Range of migrations
dotnet ef migrations script FromMigration ToMigration --output migrations.sql
```

**Прос:** Полна видимість, будь-який SQL-клиент може запускати це, дружна до контролю версіїM SK2 робочі потоки для отримання дозвіл DBAMSC3

**Згоди:** Ваш бігун має правильно впоратися з невдачами, і спектральний скрипт припускає очікувану початкову міграцію `--idempotent` додає умовних перевірок, а не вигадує історію відстеження. [SQLite не підтримує скрипти міграції idempotent](https://learn.microsoft.com/en-us/ef/core/providers/sqlite/limitations#idempotent-script-limitations).

Подивіться [офіційні доки про скрипти SQL](https://learn.microsoft.com/en-us/ef/core/managing-schemas/migrations/applying?tabs=dotnet-core-cli#sql-scripts).

### Скрипки SQL в CI

Для SQL Server, зробити SQL помилки неможливими

```bash
sqlcmd -S "$DB_SERVER" -d "$DB_NAME" -b -i migrations.sql
```

Для PostgreSQL, зробити те ж саме явно:

```bash
psql --host="$DB_HOST" --username="$DB_USER" --dbname="$DB_NAME" \
    --set=ON_ERROR_STOP=1 --file=migrations.sql
```

Дозволяти давати credentials за допомогою runner'с піддерживаним безпечним механізмомM SK1 Це альтернативи для постачальника, який генерував SQL, а не дві команди, щоб запускати їх проти однієї бази данихMSC3 Подивіться [sqlcmd](https://learn.microsoft.com/en-us/sql/tools/sqlcmd/sqlcmd-use-utility) і [Управлення проблемою psql](https://www.postgresql.org/docs/current/app-psql.html). Не треба слепо додавати інший конвертер для транзакцій : генеровані скрипти можуть вже управляти транзакціями МSK3, а деякі операції не можуть працювати всередині одного

## DACPAC (SQL Server Only)

[DACPAC](https://learn.microsoft.com/en-us/sql/relational-databases/data-tier-applications/data-tier-applications) є *на основі* не *міграція-на основі*. Ви визначаєте схему, яку хочете , і SqlPackage відокремлює її від цільової бази даних

```bash
SqlPackage.exe /Action:Publish /SourceFile:MyDatabase.dacpac /TargetConnectionString:"..."
```

**Прос:** Сchéма як код, автономноM SK1 генерація дисків , поєднує таблички МSK3 перегляди M SK4 збережені процедури та індиктори MSC5 інструментарій для підприємств .

**Згоди:** Лише SQL Server, схема в двох місцях M SK1 моделі EF + SQL-проект МSK3 дискретний двигун робить сумнівні вибірки М SK4 переименовання столбів схожі на падіння

Подивіться [Доки SqlPackage](https://learn.microsoft.com/en-us/sql/tools/sqlpackage/sqlpackage).

## តារាង порівняння

| Погляньмо на це МSK1 Найкраще для МSK2 Требування . NET \ | \ Auto \- \ вживають треки \ МSK6 \ DBA Дружелюбно \ МSK7 \ Cross \ MSК8 \ Platform DB \MSК9 \
|----------|----------|---------------|---------------------|--------------|-------------------|
| `MigrateAsync()` МSK0 Дев/маленькі проекти M SK2 Так МSK3запусковий час ) ♫ ♫ МSK5 ♫ Так ♫ | ♫ Ні ♫
| EF Bundles МSK1 CIM SK2 СНІДні труби | Ні МSK4 самі \ - вміщовані \ \ МSK7 \ Так | МSK8 \ Дещо \МSK9 \ так \ мSK10
| SQL Scripts | DBAM SK2kontroled environments ♫ ♫ МSK3 ♫ Ні ♫ | ♫ записує історію ♫ `--idempotent` МSK0 Так | Допомічник МSK2 залежать |
| DACPAC ♫ ♫ | ♫ SQL Server enterprise ♫

# Вказівки

## З 'явився файл дизайнера

Миграції працюють локально, але не в CI? **Проверьте, чи ви вклали всі три генеровані шматочки:**

- `20231115_AddUserTable.cs` - Код міграції
- `20231115_AddUserTable.Designer.cs` - Метадані та цільовий модель для цієї міграції
- `BlogDbContextModelSnapshot.cs` - Текущий знімок моделі, який використали для складання наступної міграції

Позбавлені дизайнерських метадань можуть зупинити EF відкрити міграцію; позбавлений або застарілий знімок спричиняє неправильні майбутні розбіжності [управління міграціями](https://learn.microsoft.com/en-us/ef/core/managing-schemas/migrations/managing).

> **Don' не змішувати стратегії створенняM SK1** `EnsureCreated()` мигнорує міграції та їх історію. використати його для одноразових баз даних, які будуть залишатися на тій стратегії `MigrateAsync()` і сподівається, що EF прийме схему [Руководство для створення бази даних EF](https://learn.microsoft.com/en-us/ef/core/managing-schemas/ensure-created).

## Багато контекстів Db

```bash
dotnet ef migrations bundle --context BlogDbContext --output blog-migrations.exe
dotnet ef migrations bundle --context IdentityDbContext --output identity-migrations.exe
```

## Упередженість стрічки підключення

Об 'єднання's `--connection` перекреслює з 'єднання, налаштоване для контексту. В іншому випадкуM SK1 причетність належить до **Konfigurations pipeline для вашої aplikacji'**. За замовчанням ASPM SK1NET Core builder, змінні середовища перейміють JSON\,, але індивідуальні dostawці чи проектні фірми можуть це змінити.

`ConnectionStrings__DefaultConnection` працює лише, якщо ваш контекст дійсно читає `ConnectionStrings:DefaultConnection`; `AdminSite__ConnectionString` використовується заводом нижче читає інший ключ. Umgebung variables are configuration inputs , not a special bundle connection [постачальники конфігурації та замовлення](https://learn.microsoft.com/en-us/aspnet/core/fundamentals/configuration/).

## IDesignTimeDbContextFactory

EF знаряддя потрібні для інстамінації вашого DbContext. Якщо ваш DbKontext є у окремому проекті або має складний стартM SK1 реалізація [`IDesignTimeDbContextFactory<T>`](https://learn.microsoft.com/en-us/ef/core/cli/dbcontext-creation?tabs=dotnet-core-cli#from-a-design-time-factory):

```csharp
public class AdminDbContextFactory : IDesignTimeDbContextFactory<AdminDbContext>
{
    public AdminDbContext CreateDbContext(string[] args)
    {
        var config = new ConfigurationBuilder()
            .SetBasePath(Directory.GetCurrentDirectory())
            .AddJsonFile("appsettings.json", optional: true)
            .AddUserSecrets<AdminDbContextFactory>(optional: true)
            .AddEnvironmentVariables()
            .Build();

        var connectionString = config["AdminSite:ConnectionString"]
            ?? throw new InvalidOperationException("Missing connection string");

        var optionsBuilder = new DbContextOptionsBuilder<AdminDbContext>();
        optionsBuilder.UseSqlServer(connectionString, sql => sql.CommandTimeout(120));

        return new AdminDbContext(optionsBuilder.Options);
    }
}
```

Використовуйте, коли: DbContext у окремому проектіM SK1 складний старт, або контрольоване створення контексту для інструментаріюMSC3 EF використовує відкриту фабрику замість звичайного стартуMska4 базове створенняM Ska5 включне з пакетомMска6 Залишати постачальникаMSKA7 модель послідовною з програмоюM ska8 Ця мінімальна фабрика навмисно завантажує лише базовий JSONMске9 опціональні секрети користувачів та змінні середовищаMská10 додавати середовищеMська11 визначати специфічні файли, якщо це потрібноMskā12 і тримати секрети виробництва за межами артефактуМSK13 середні змінні є останнім тут, так що CI може переміщати локальні секретиMсака14

# Що змінилося навколо міграції?

Головне поради витримують новіші випуски EF: будувати повторюваний артефакт і дати схемі розгортання свою власну ідентичність . Але деякі деталі покращилися з моменту написання першої статтіM SK2

## Кора EF 9+: Замок МSK1 Вибір та перевірка моделей

EF Core 9 запровадило migration locking, щоб захистити concurrent migration execution . Це вирішує важливу стару розбіжність МSK2 це не робить руйнівну зміну схеми здатною до комп 'ютерних застосувань, які досі працюють на старому коді [Миграційне блокування EF Core 9](https://learn.microsoft.com/en-us/ef/core/what-is-new/ef-core-9.0/whatsnew#protection-against-concurrent-migrations).

EF Core 9 також починає відкидати програму міграції, коли у моделі відсутні зміни з знімка.

```bash
dotnet ef migrations has-pending-model-changes \
    --project Mostlylucid.DbContext \
    --startup-project Mostlylucid
```

Це перевіряє **модель проти кадру**, не враховує, чи виробництво використовувало кожну міграцію . Це не розпізнавання дрейфів схем МSK2 Невідоме `HasData` такі як `DateTime.Now` або `Guid.NewGuid()` може призвести до повторних змін моделі; виправити їх, а не придушити перевіркуM SK1 [Різні зміни EF Core 9](https://learn.microsoft.com/en-us/ef/core/what-is-new/ef-core-9.0/breaking-changes#exception-is-thrown-when-applying-migrations-if-there-are-pending-model-changes).

`UseSeeding` і `UseAsyncSeeding`, застосовується в EF Core 9, запускається під блокуванням міграції МSK2 Устроїння та пакети використовують синхронний хак МSK3 так що implementation only the async one is insufficient. Засадка може виконуватися навіть тоді, коли немає незавершених міграціях ♫ : запуск другого пакету не обов 'язково є беззаперечним ♫-op ♫ МSK7 перевіряємо наявні дані і робимо операцію повторюваною \. \ Створені SQL-скрипти не запускають цих C \ # \ делегатів \ [Практика बीजування](https://learn.microsoft.com/en-us/ef/core/modeling/data-seeding).

## EF Core 10: Назви початкових обмежень годинника

EF Core 10 - це теперішній стабильний LTS реліз, і вимагає .NET МSK2 Одна міграція МSK3конкретне доповнення для SQL Server є експлицимним дефолтом

```csharp
modelBuilder.Entity<Blog>()
    .Property(b => b.Rating)
    .HasDefaultValue(3, "DF_Blog_Rating");
```

Є також `modelBuilder.UseNamedDefaultConstraints()`. Якщо це зробити на існуючій моделі, наступна міграція змінить ім 'я кожного початкового обмеження в цій моделі. . Невелика зміна конфігурації може призвести до великої міграції. [Назви початкових обмежень](https://learn.microsoft.com/en-us/ef/core/modeling/generated-properties#default-value-constraint-name); [Szczegółowі дані про реліз EF Core 10](https://learn.microsoft.com/en-us/ef/core/what-is-new/ef-core-10.0/whatsnew).

## Aspire Can Own the Orchestration

Aspire має перший ресурс міграції klasy - в `Aspire.Hosting.EntityFrameworkCore`. В Апхості МSK1 локальний розвиток може виразити залежність напряму

```csharp
var migrations = api.AddEFMigrations("api-migrations")
    .RunDatabaseUpdateOnStart();

api.WaitForCompletion(migrations);
```

`RunDatabaseUpdateOnStart()` є локальним-поведінка запускуM SK1 Для публікації , `PublishAsMigrationBundle()` і `PublishAsMigrationScript()` виробляти артефакти розгортання; пакет також можна опублікувати як контейнерM SK1 використовувати один - стрічку замість постійного перезапускання сервісу [Ми прагнемо інтеграції міграції](https://aspire.dev/integrations/databases/efcore/migrations/#automated-ef-migrations-with-addefmigrations).

## Кора EF 11 ПредтягуванняM SK1 Залишити їх окремі

На даний момент, [Кора EF 11 досі в розробці](https://learn.microsoft.com/en-us/ef/core/what-is-new/ef-core-11.0/whatsnew). Obecна документація включає в себе характеристики, які **не є варіантами EF Core 10**:

- `.config/dotnet-ef.json` надає повторювані погані CLI, такі як проект, запуск проекту та контексту
- `dotnet ef migrations remove --offline` removes the latest migration without a database connection. You must know it has not been applied `--force`.
- `migrations remove --connection` вибирає зв 'язок з базою даних явно.
- `dotnet ef database update AddFeature --add` матриці, комп 'ютеризує та застосовує миграцію разомM SK1 корисна перевага для розвитку, не замінює релізові миграції

Подивіться [version-labelled CLI reference](https://learn.microsoft.com/en-us/ef/core/cli/dotnet#configuration-file) і [створити- іM SK1 застосувати документацію](https://learn.microsoft.com/en-us/ef/core/managing-schemas/migrations/managing#create-and-apply-a-migration-in-one-step). Pin ваші інструменти, замість того, щоб припустити, що кожна опція на останній сторінці Docs є у вашому zainstalowanому релізі

# Що про це...?

Поширені питання та відхилення

## " Чому б не просто бігати `dotnet ef database update` в CI?"

Обговорена вище, але коротка версіяM SK1 пакети - портативні артефакти . Ваша етапа розгортання не потребує' EF CLI МSK4 вихідного коду МSK5 чи дизайнуMSC6 часової роздільної здатностіMska7 той самий пакет працює в тестіMске8 заміщуванняMска9 і прод MСК10 ті самі компіліфіковані міграціїМСК11 конфігурація підключення та реальне дрейфування бази даних все ще потребують перевіркиMSК12

## "IsnM SK1t this overkill for a small app ?"

Можливо, . Якщо ви МSK1 одинокий МSK2 дані є публічними , і радіус вибуху низький `MigrateAsync()` це добре. Але в той момент, коли ви додаємо другий розробникМSK1 чутливі даніМСК2 або багатооб 'єднані середовищаМ СК3 пакети платять самі за себеM СК4

## " Як щодо зворотнього зв 'язкуM SK1

Неуспішна міграція зазвичай отримує користь від EF/розробки транзакцій постачальникаM SK1, але деякі операції відбуваються поза транзакціями . Це відрізняється від навмисного зниження успішної релізу МSK3 Опції :

- Використовуйте пакет із ранньою міграцією як її позиційну ціль. EF виконує наявні новіші міграції' `Down()` методи; він не генерує нового M SK1Губочна міграція"
- Знову відновити перевірений резервний копій, коли дані потребують відновлення
- Написати і застосувати нову корективну міграцію

Перевертання відкинутих столбів не приwraca їхнього змісту. Проаналізувати і перевірити `Down()` так само ретельно, як `Up()`.

Для критичної системи: перевіряють міграції на основі клону бази даних

## "Чи можу я запустити міграції в контейнері Kubernetes init?"

Контейнер init може запускати пакет,, але він працює один раз **за дошку**, не один раз на застосовування . Для репродуцованих виробничих obciążeń МSK2 краще мати dedykowanу міграцію Робот з портом для застосування . Для одного M SK4 приклад підлозі MSC5

```yaml
initContainers:
  - name: migrate
    image: myapp:latest
    command: ["./efbundle"]
    env:
      - name: ConnectionStrings__Default
        valueFrom:
          secretKeyRef:
            name: db-secrets
            key: connection-string
```

Контейнер aplikacji чекає успішного закінчування входу. Об 'єкт має містити пакет Linux і його відповідну конфігурацію

## " Як щодо FluentMigrator / DbUp МSK2 інші інструменти M SK3

Вони чудово працюють. [Мігратор флюенту](https://fluentmigrator.github.io/) і [ДбАп](https://dbup.readthedocs.io/) мати свої вентилятори. ключова різницяM SK1 це міграція - специфічні інструменти МSK3 тоді як пакети EF походять з вашого існуючого EF-модуля .

## "Мій DBA хоче перевірити всі SQL перед тим, як запускатиM SK1

Використовувати `--idempotent` сценарії:

```bash
dotnet ef migrations script --idempotent --output migrations.sql
```

DBA перевіряє і підтверджує. Якщо підтвердження для точного SQLM SK1 виконати **який переглядав сценарій** і заархивувати його разом з релізом. Бюндл генерує SQL в час виконання, а також може запускати запрограмований код зерна ; він не є упаковником для виконання вашого підтвердженого файлу

## " Як я обходжу міграції з нульовим відходом часуM SK1

Те, що МСК0 - це питання про стратегію використання, МСК1 , а не питання про міграції,

1. Поширити схему з змінами, які стара програма може терпіти,, такі як нова нульова колона
2. Розгортати код, який керує переходом,, включаючи двічі записів, де це потрібно
3. Заповніть існуючі дані і перевіріть їх
4. Перемикає odczytи та обмеження, як тільки код і дані готові
5. Контракт пізніше, видалення старих столбів лише після того, як старі випадки вичерпали

Bundles don't solve this M SK1 they provide a controlled way to deliver the schema steps . Lock duration МSK3 table rewrites and backfills still need measuring

# Еррата

В оригінальній версії було декілька неправильних команд, а деякі твердження були занадто широкими.

- **Жодного сухого потіку пакетів.** `efbundle --dry-run` не піддерюється. Створити SQL скрипт для перевірки, потім перевірити на доступну базу даних або відреставрювати копіюM SK2 `--verbose` все ще виконує міграції.
- **Мета міграції - позиційна.** Використовувати `efbundle PreviousMigration`, не `--target-migration`. Мета `0` повертає всі міграції шляхом виконання `Down()` методи.
- **Само собою-включно з оптомM SK1в.** Для початкового пакету все ще потрібен .NET runtime. `--self-contained` includes it for one target RID; it does not remove OS
- **Дозволяти схемі не є синонімом `db_owner`.** Дозволяйте індивідуальності розгортання, необхідні для його міграції правами, замість того, щоб взяти на себе певну роль SQL Server.
- **Виведення ворот не є автоматичним відновленням.** Непрацьовний пакет зупиняє розгортання,, але транзакціїM SK1перешкоджені операції та втрата даних потребують власного плану відновленняМSK2 Виведення міграції з джерела не означає повернення виробництва.
- **Дизайнер - це не знімок.** Обіцяти міграцію, `.Designer.cs` метадані та окремий знімок контекстної моделі.
- **Шкрипки слідкують за міграціями.** Згенеровані aktualiзації SQL, історія міграції. `--idempotent` додає перевірок на вже застосовані migrations- підтримка ; залежить від постачальникаM SK2 і SQLite не може генерувати ці skriptи.
- **Конфігурація підключення - це додаток-визначенийM SK1** Середня змінна впливає на зв 'язок лише тоді, коли контекст/фабрика читає ключ, який відповідає за з' єднанняM SK1 У прикладі з фабрикою тепер змінні середовища можуть перемикати опціональні секрети користувача.
- **Миграційне заблокування змінює поради щодо співпадіння.** EF Core 9+ захищає виконання міграції за допомогою замика. Він не координує живих запитів або не робить ламаючих змін схем безпечними для старих версій aplikacjiM SK2
- **Помічник для входу в контейнер є за один под.** Це не один раз.
- **Бюндл не виконує ваші перевірені SQL-файли.** Якщо підтвердження obejmuje точний SQL, розгортати, що артефактM SK1 Bundles можуть також запускати конфігуроване поселення , включно з тим, коли не залишилося жодних миграцій.

Нові деталі EF Core 11 мають відокремлене наклеймо з функціями перегляду . Вони не повинні бути прочитані як варіанти, доступні в прикладах EF Core