Українська
Контрольна точка
Що має працювати
powershell
dotnet buildpowershell
./Run.ps1 dbpowershell
dotnet ef migrations has-pending-model-changes --project Source/Chatex.DataПорівняйте з еталоном. Конфігурації, контекст, фабрика й перехоплювач мають бути ідентичними:
powershell
git diff --no-index Source/Chatex.Data/Configurations D:\Work\Chatex-Reference\Source\Chatex.Data\ConfigurationsДля міграції порівняйте тіло Up у вашому *_InitialCreate.cs з еталонним файлом; відрізнятися можуть лише часова мітка в іменах файлу й класу. DependencyInjection.cs поки коротший за еталонний: решта з’явиться в темі 5.
Закомітьте:
powershell
git add .powershell
git commit -m "Map the model to PostgreSQL with EF Core and add the initial migration"Типові помилки
Таблиця 4.2. Типові помилки з EF Core і міграціями
| Симптом | Причина | Виправлення |
|---|---|---|
Could not execute because the specified command or file was not found для dotnet ef | локальний інструмент не відновлено | dotnet tool restore |
Unable to create a 'DbContext' of type 'ChatexDbContext' | фабрики часу проєктування немає або вона не реалізує IDesignTimeDbContextFactory<ChatexDbContext> | додайте ChatexDbContextFactory |
The entity type 'ChatMember' requires a primary key to be defined | складений ключ не налаштовано | builder.HasKey(m => new { m.ChatId, m.UserId }) у ChatMemberConfiguration |
| конфігурація ніби ігнорується | клас не реалізує IEntityTypeConfiguration<T> або бракує ApplyConfigurationsFromAssembly | перевірте обидва |
таблиці називаються AspNetUsers, asp_net_users | викликів ToTable немає або вони стоять перед base.OnModelCreating | перейменовуйте після виклику бази, головні таблиці першими |
стовпці називаються LastActivityAt | бракує UseSnakeCaseNamingConvention() | додайте його в DependencyInjection.Configure; видаліть міграцію й створіть її знову |
Failed to connect to 127.0.0.1:5432 | PostgreSQL не запущено | docker compose up --detach --wait |
has-pending-model-changes повідомляє про зміни одразу після створення міграції | проєкт змінили після міграції або міграцію відредагували вручну | видаліть останню міграцію (dotnet ef migrations remove) і додайте її знову |
Питання для самоперевірки
- Що робить ORM? Які частини EF Core загальні, а які походять від провайдера?
- Чому
ChatexDbContextуспадковується відIdentityDbContext<User, IdentityRole<Guid>, Guid>? Що означають три аргументи типів? - Чому
DbContextотримує параметри через конструктор, а не налаштовує себе сам? - Трьома способами EF Core дізнається модель; який із них переважає?
- Чому кожен рядковий стовпець має мати максимальну довжину?
- Як працює обмеження перевірки
ck_chats_direct_key? Чому його записано зtypeіdirect_key, а не зTypeіDirectKey? - Чому багато особистих чатів можуть мати
public_handle = NULL, хоча стовпець має унікальний індекс? - Який запит обслуговує індекс
(chat_id, id DESC)і чому він швидкий для будь-якої сторінки історії? - Поясніть правила видалення для
Message.SenderId,Message.ReplyToMessageIdіChatMember.UserId. - Чому часові мітки задає перехоплювач? Чому він приймає
TimeProvider? - Чому застосунок і фабрика часу проєктування спільно використовують
DependencyInjection.Configure? - Що зберігається в міграції, у файлі Designer і в знімку? Чому згенеровану міграцію треба прочитати, перш ніж комітити?
- Від чого захищає
has-pending-model-changes?
Вправи
Подивіться на SQL. Виконайте
dotnet ef migrations script --project Source/Chatex.Dataі прочитайте SQL, який виконавdatabase update. Знайдіть обмеження перевірки та індексix_messages_chat_id_id.Друга міграція. Додайте властивість
string? WebsiteдоUserProfileі задайте їй максимальну довжину 200 вUserProfileConfiguration. Створіть міграціюAddProfileWebsite, прочитайте її, застосуйте, перевірте стовпець через\d user_profiles. Потім відкотіть командоюdotnet ef database update InitialCreate --project Source/Chatex.Data, видаліть міграцію командоюdotnet ef migrations remove --project Source/Chatex.Dataі властивість. Чому базу даних треба відкотити, перш ніж видаляти міграцію?План запиту. У
psqlзапитайте в PostgreSQL, як він виконав би запит історії:sqlexplain select * from messages where chat_id = '01a1e0ce-526e-742b-8216-1fab814b067a' and id < '01a1e0ce-526e-742b-8216-1fab814b0670' order by id desc limit 50;На порожній таблиці він читає таблицю напряму (
Seq Scan), бо це дешевше за індекс. Спершу виконайтеset enable_seqscan = off;, знову попросіть пояснення й знайдіть індекс у плані (Index Scan using ix_messages_chat_id_id). Чому плану не потрібен крокSort?