This is a viewer only at the moment see the article on how this works.
To update the preview hit Ctrl-Alt-R (or ⌘-Alt-R on Mac) or Enter to refresh. The Save icon lets you save the markdown file to disk
This is a preview from the server running through my markdig pipeline
Ви, напевно, не робите правильної Migrations EF
Tuesday, 27 October 2026
Обновлено - М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 неправильна наприкінці для виправ до оригінальної версії.
Працюючи MigrateAsync() на старті? ВиM SK1 даєте схему вашої додатки - змінюєте права і сподіваєтесь, що нічого не станеться не так МSK3 Там' є кращий спосіб MSC5 пакети EF міграції дають вам змогу виконувати міграцію як контрольований крок до CI M SK6 зберігати вашу виробничу додатку в безпеці . Але ось тутМSK8 це те, що ми маємо в головному пункті МСК9 інколи шлях МСК10 неправильний М СК11 насправді правильнийMСК12 ДозвольтеМ СЦК13 дослідити, коли використовувати кожен підхідM СЦк14
офіційні документи: Обзор міграції | Застосування міграції | Об 'єднання
МSK0Неправильний" Спосіб МSK2Я використовую )
Цей блог використовує MigrateAsync() на старті - підхід Я МSK1 я зараз скажу вам не використовувати МSK2 Тут ' чому це Ми звісно вийде для мене СМСК5 і чому це, ймовірно, не вийdzie для вас СМСК6
У моєму Program.cs у мене є наступне:
using (var scope = app.Services.CreateScope())
{
var blogContext = scope.ServiceProvider.GetRequiredService<IMostlylucidDBContext>();
await blogContext.Database.MigrateAsync();
}
MigrateAsync() застосовує очікувані міграції і створює базу даних, якщо це необхідно. Проста M SK1 але проблематична:
- Відлежність від запуску - Далішня база даних знизилась ? Міграція не спрацювала МSK2 Ваша програма виграла M SK3 не почалася .
- Збільшені права - Ваша програма потребує прав на 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 в стартапному проекті. Робот збудування відновлює інструменти і створює артефакт; робота з захищеним розгортанням отримує секрет виробництва
# 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 Якщо створення контексту читає файли настроїв, надсилайте необхідні не секретні файли також з пакетом інструкція щодо використання та конфігурації.
Локальні Bundles
Ні CI? Потрібно перевірити перед тим, як поштовхнути ? Сконструювати пакети локально МSK2
Використовуйте cases: Тестування перед запуском CI, DBA ( самі МSK2 вбудований exe M SK3 не потрібен SDK ), розгортання стенджів MSC5 виправлення з --verbose.
Створювання пакету
# 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.
# 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:
$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
./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 показує справжній аналізатор.
Немає пляшки для сухого запуску
./efbundle --dry-run робить не існує. І не існує --verbose перетворити виконання на попередження. генерувати SQL, не застосовуючи його
dotnet ef migrations script PreviousMigration AddNewFeature \
--project Mostlylucid.DbContext \
--startup-project Mostlylucid \
--output migrations.sql
Використовувати 0 як перший аргумент для нової бази даних
Щоб побачити міграції проекту', які чекають на конфігуровану базу даних:
dotnet ef migrations list \
--project Mostlylucid.DbContext \
--startup-project Mostlylucid
Додайте --no-connect для того, щоб ввести список маніпурів конструкції' без зв 'язку з базою даних
локальний тест робочого потоку
# 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, використовуючи всі необхідні вхідні дані: міграції
Якщо ви дійсно хочете автоматизовану генерацію
<Target Name="BuildMigrationBundle">
<Exec Command="dotnet ef migrations bundle --output $(OutputPath)efbundle.exe --force" />
</Target>
Тоді: dotnet build -t:BuildMigrationBundle
Гібридний підхід
Найкраще з обох світів МСК0 зручность локально МSK1 безпека в процесі виробництва .
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 та існуючих процесів управління змінами.
# 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.
Подивіться офіційні доки про скрипти SQL.
Скрипки SQL в CI
Для SQL Server, зробити SQL помилки неможливими
sqlcmd -S "$DB_SERVER" -d "$DB_NAME" -b -i migrations.sql
Для PostgreSQL, зробити те ж саме явно:
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 і Управлення проблемою psql. Не треба слепо додавати інший конвертер для транзакцій : генеровані скрипти можуть вже управляти транзакціями МSK3, а деякі операції не можуть працювати всередині одного
DACPAC (SQL Server Only)
DACPAC є на основі не міграція-на основі. Ви визначаєте схему, яку хочете , і SqlPackage відокремлює її від цільової бази даних
SqlPackage.exe /Action:Publish /SourceFile:MyDatabase.dacpac /TargetConnectionString:"..."
Прос: Сchéма як код, автономноM SK1 генерація дисків , поєднує таблички МSK3 перегляди M SK4 збережені процедури та індиктори MSC5 інструментарій для підприємств .
Згоди: Лише SQL Server, схема в двох місцях M SK1 моделі EF + SQL-проект МSK3 дискретний двигун робить сумнівні вибірки М SK4 переименовання столбів схожі на падіння
Подивіться Доки 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 відкрити міграцію; позбавлений або застарілий знімок спричиняє неправильні майбутні розбіжності управління міграціями.
Don' не змішувати стратегії створенняM SK1
EnsureCreated()мигнорує міграції та їх історію. використати його для одноразових баз даних, які будуть залишатися на тій стратегіїMigrateAsync()і сподівається, що EF прийме схему Руководство для створення бази даних EF.
Багато контекстів Db
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 постачальники конфігурації та замовлення.
IDesignTimeDbContextFactory
EF знаряддя потрібні для інстамінації вашого DbContext. Якщо ваш DbKontext є у окремому проекті або має складний стартM SK1 реалізація IDesignTimeDbContextFactory<T>:
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.
EF Core 9 також починає відкидати програму міграції, коли у моделі відсутні зміни з знімка.
dotnet ef migrations has-pending-model-changes \
--project Mostlylucid.DbContext \
--startup-project Mostlylucid
Це перевіряє модель проти кадру, не враховує, чи виробництво використовувало кожну міграцію . Це не розпізнавання дрейфів схем МSK2 Невідоме HasData такі як DateTime.Now або Guid.NewGuid() може призвести до повторних змін моделі; виправити їх, а не придушити перевіркуM SK1 Різні зміни EF Core 9.
UseSeeding і UseAsyncSeeding, застосовується в EF Core 9, запускається під блокуванням міграції МSK2 Устроїння та пакети використовують синхронний хак МSK3 так що implementation only the async one is insufficient. Засадка може виконуватися навіть тоді, коли немає незавершених міграціях ♫ : запуск другого пакету не обов 'язково є беззаперечним ♫-op ♫ МSK7 перевіряємо наявні дані і робимо операцію повторюваною . \ Створені SQL-скрипти не запускають цих C \ # \ делегатів \ Практика बीजування.
EF Core 10: Назви початкових обмежень годинника
EF Core 10 - це теперішній стабильний LTS реліз, і вимагає .NET МSK2 Одна міграція МSK3конкретне доповнення для SQL Server є експлицимним дефолтом
modelBuilder.Entity<Blog>()
.Property(b => b.Rating)
.HasDefaultValue(3, "DF_Blog_Rating");
Є також modelBuilder.UseNamedDefaultConstraints(). Якщо це зробити на існуючій моделі, наступна міграція змінить ім 'я кожного початкового обмеження в цій моделі. . Невелика зміна конфігурації може призвести до великої міграції. Назви початкових обмежень; Szczegółowі дані про реліз EF Core 10.
Aspire Can Own the Orchestration
Aspire має перший ресурс міграції klasy - в Aspire.Hosting.EntityFrameworkCore. В Апхості МSK1 локальний розвиток може виразити залежність напряму
var migrations = api.AddEFMigrations("api-migrations")
.RunDatabaseUpdateOnStart();
api.WaitForCompletion(migrations);
RunDatabaseUpdateOnStart() є локальним-поведінка запускуM SK1 Для публікації , PublishAsMigrationBundle() і PublishAsMigrationScript() виробляти артефакти розгортання; пакет також можна опублікувати як контейнерM SK1 використовувати один - стрічку замість постійного перезапускання сервісу Ми прагнемо інтеграції міграції.
Кора EF 11 ПредтягуванняM SK1 Залишити їх окремі
На даний момент, Кора EF 11 досі в розробці. Obecна документація включає в себе характеристики, які не є варіантами EF Core 10:
.config/dotnet-ef.jsonнадає повторювані погані CLI, такі як проект, запуск проекту та контекстуdotnet ef migrations remove --offlineremoves 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 і створити- іM SK1 застосувати документацію. 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
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
Вони чудово працюють. Мігратор флюенту і ДбАп мати свої вентилятори. ключова різницяM SK1 це міграція - специфічні інструменти МSK3 тоді як пакети EF походять з вашого існуючого EF-модуля .
"Мій DBA хоче перевірити всі SQL перед тим, як запускатиM SK1
Використовувати --idempotent сценарії:
dotnet ef migrations script --idempotent --output migrations.sql
DBA перевіряє і підтверджує. Якщо підтвердження для точного SQLM SK1 виконати який переглядав сценарій і заархивувати його разом з релізом. Бюндл генерує SQL в час виконання, а також може запускати запрограмований код зерна ; він не є упаковником для виконання вашого підтвердженого файлу
" Як я обходжу міграції з нульовим відходом часуM SK1
Те, що МСК0 - це питання про стратегію використання, МСК1 , а не питання про міграції,
- Поширити схему з змінами, які стара програма може терпіти,, такі як нова нульова колона
- Розгортати код, який керує переходом,, включаючи двічі записів, де це потрібно
- Заповніть існуючі дані і перевіріть їх
- Перемикає odczytи та обмеження, як тільки код і дані готові
- Контракт пізніше, видалення старих столбів лише після того, як старі випадки вичерпали
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-containedincludes 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