применяется для удаления миграций из проекта и всегда работает с последней миграцией (основываясь на отметках времени миграций). При удалении миграции исполняющая среда EF Core проверяет, не была ли миграция применена к базе данных, с помощью таблицы
__EFMigrationsHistory
. Если миграция применялась, тогда процесс терпит неудачу. Если же миграция не применялась или была подвергнута откату, то она удаляется, а файл моментального
снимка модели обновляется.
Команда
remove
не принимает какие-либо параметры (поскольку всегда работает с последней миграцией) и использует те же самые параметры, что и команда
add
, плюс дополнительный параметр
force(—f || --force)
, который обеспечивает выполнение отката последней миграции и ее удаление за один шаг.
Команда list
Команда
list
позволяет получить все миграции для класса, производного от
DbContext
. По умолчанию она выводит список всех миграций и запрашивает базу данных с целью выяснения, были ли они применены. Если миграции не применялись, то они будут помечены как ожидающие. Один из параметров команды
list
предназначен для передачи специальной строки подключения, а другой позволяет вообще не подключаться к базе данных и просто вывести список миграций (табл. 22.12).
Команда script
Команда
script
создает сценарий SQL на основе одной или большего количества миграций и принимает два необязательных параметра, которые указывают, с какой миграции начинать и на какой миграции заканчивать. Если ни один параметр не задан, то сценарий создается для всех миграций. Параметры описаны в табл. 22.13.
Если миграции не указаны, тогда созданный сценарий станет совокупным итогом всех миграций. В случае предоставления миграций сценарий будет содержать изменения между двумя миграциями (включительно). Каждая миграция помещается внутрь транзакции. Если в базе данных, где запускается команда
script
, таблица
__EFMigrationsHistory
нe существует, то она создается. Кроме того, она будет обновляться для соответствия выполненным миграциям. Вот несколько примеров:
// Создать сценарий для всех миграций.
dotnet ef migrations script
// Создать сценарий для миграций от начальной до Мапу2Мапу включительно.
dotnet ef migrations script 0 Many2Many
В табл. 22.14 представлены дополнительные параметры. Параметр
– о
позволяет указать файл для сценария (в каталоге, относительном к тому, где запускается команда), а параметр
– i
создает идемпотентный сценарий (который содержит проверку, применялась ли уже миграция, и если применялась, то пропускает ее). Параметр
– -no-transaction
отключает добавление транзакций в сценарий.
Команды для управления базой данных
Для управления базой данных предназначены две команды,
drop
и
update
. Команда
drop
удаляет базу данных, если она существует, а команда
update
обновляет базу данных с использованием миграций.
Команда drop
Команда
drop
удаляет базу данных, указанную в строке подключения внутри метода
OnConfiguring
производного от
DbContext
класса. С помощью параметра
force
можно отключить запрос на подтверждение и принудительно закрыть все подключения (табл. 22.15).
Команда update
Команда
update
принимает параметр с именем миграции и обычные параметры. Она имеет один
дополнительный параметр
– -connection <подключение>
, позволяющий использовать строку подключения, которая не была сконфигурирована заранее.
Если команда запускается без имени миграции, тогда она обновляет базу данных до самой последней миграции, при необходимости создавая саму базу. Если указано имя миграции, то база данных обновляется до этой миграции. Все предшествующие миграции, которые пока не применялись, также будут применены. Имена примененных миграций сохраняются в таблице
__EFMigrationsHistory
.
Если имя миграции имеет отметку времени, которая соответствует более раннему моменту, чем другие примененные миграции, тогда выполняется откат всех более поздних миграций. Когда в качестве имени миграции указывается
0
, происходит откат всех миграций и база данных становится пустой (не считая таблицы
__EFMigrationsHistory
).
Команды для управления типами DbContext
Доступны четыре команды для управления типами
DbContext
. Три из них (
list
,
info
,
script
) работают с классами, производными от
DbContext
, в вашем проекте. Команда
scaffold
создает производный от
DbContext
класс и сущности из существующей базы данных. Все четыре команды описаны в табл. 22.16.
Для команд
list
и
info
доступны обычные параметры. Команда
list
выдает список классов, производных от
DbContext
, в целевом проекте. Команда
info
предоставляет детали об указанном производном от
DbContext
классе, в том числе строку подключения, имя поставщика и источник данных. Команда
script
генерирует сценарий SQL, который создает вашу базу данных на основе объектной модели, игнорируя любые имеющиеся миграции. Команда
scaffold
используется для анализа существующей базы данных и рассматривается в следующем разделе.
Команда scaffold
Команда
scaffold
создает из существующей базы данных классы C# (производные от
DbContext
и сущностные классы ), дополненные аннотациями данных (если требуется) и командами Fluent API. В табл. 22.17 описаны два обязательных параметра: строка подключения к базе данных и полностью заданный поставщик (например,
Microsoft.EntityFrameworkCore.SqlServer
).
Кроме того, есть параметры, которые позволяют выбирать специфические схемы и таблицы, имя и пространство имен создаваемого класса, выходной каталог и пространство имен для генерируемых сущностных классов, а также многое другое. Предусмотрены и стандартные параметры. В табл. 22.18 перечислены расширенные параметры, которые далее обсуждаются более подробно.
В версии EF Core 5.0 команда
scaffold
стала работать гораздо надежнее. Как видите, на выбор предлагается довольно много вариантов. Если выбран вариант с аннотациями данных (
– d
), тогда EF Core будет применять аннотации данных там, где это возможно, и заполнять отличия с использованием Fluent API. Если вариант с
– d
не выбран, то вся конфигурация (отличающаяся от соглашений) кодируется с помощью Fluent API. Вы можете указывать пространство имен, схему и местоположение для генерируемых файлов с сущностными классами и классом, производным от
DbContext
. Если вы не хотите создавать шаблон для целой базы данных, тогда можете выбрать определенные схемы и таблицы. Параметр
– -no-onconfiguring
позволяет исключить метод
OnConfiguring
из шаблонного класса, а параметр
– -no-pluralize
отключает средство перевода имен в множественное число. Упомянутое средство превращает имена сущностей в единственном числе (
Car
) в имена таблиц во множественном числе (
Cars
) при создании миграций и имена таблиц во множественном числе в имена сущностей в единственном числе при создании шаблона.