7.2 Entity Framework Core Support — MySQL Connectors 1.0

7.2 Поддержка Entity Framework Core

MySQL Connector/NET интегрирует поддержку Entity Framework Core (EF Core). Требования и конфигурация EF Core зависят от версии установленного Connector/NET и необходимых функций. Используйте следующую таблицу для оценки минимальных требований.

Таблица 7.2 Версии Connector/NET и поддержка Entity Framework Core

Таблица 7.2 Версии Connector/NET и поддержка Entity Framework Core
Connector/NET	EF Core 9.0	EF Core 8.0	EF Core 7.0	EF Core 6.0
9.2.0	.NET 9, .NET 8	Не поддерживается	Не поддерживается
9.1.0	Предварительная версия .NET 9, .NET 8, .NET 6	Не поддерживается	.NET 6
9.0.0	.NET 8, .NET 6	Не поддерживается	.NET 6
8.3.0 и 8.4.0	Не поддерживается	.NET 8, .NET 7, .NET 6	.NET 7, .NET 6	.NET 6
8.2.0	Не поддерживается	Предварительная версия .NET 8	.NET 7	.NET 6
8.1.0	Не поддерживается	Не поддерживается	.NET 7	.NET 6
8.0.33	Не поддерживается	Не поддерживается	.NET 7	.NET 6
8.0.28	Не поддерживается	Не поддерживается	Не поддерживается	.NET 6
8.0.23 до 8.0.27	Не поддерживается	Не поддерживается	Не поддерживается	Предварительная версия EF Core 6.0

В этом разделе:

Общие требования для поддержки EF Core

Версия сервера: MySQL 8.0 или более поздняя
Пакеты Entity Framework Core (замените n на действительное число, чтобы завершить полную версию пакета):
- MySql.EntityFrameworkCore 8.0.n+MySQL8.n
- MySql.EntityFrameworkCore 6.0.n+MySQL8.n
Реализация .NET Standard или .NET Framework, поддерживаемая Connector/NET (см. таблицу 7.2 «Версии Connector/NET и поддержка Entity Framework Core»)
.NET | .NET Core SDK
- .NET 8.0 для всех поддерживаемых платформ: https://dotnet.microsoft.com/es-es/download/dotnet/8.0
- .NET 6.0 для всех поддерживаемых платформ: https://dotnet.microsoft.com/download/dotnet/6.0
- .NET Core для Microsoft Windows: https://www.microsoft.com/net/core#windowscmd
- .NET Core для Linux: https://www.microsoft.com/net/core#linuxredhat
- .NET Core для macOS: https://www.microsoft.com/net/core#macos
- Docker: https://www.microsoft.com/net/core#dockercmd
Дополнительно: Microsoft Visual Studio 2017, 2019, 2022 или Code

Примечание

См. таблицу 2.1 «Требования к Connector/NET для связанных продуктов» для минимальной версии Visual Studio, используемой с Connector/NET.

Конфигурация с MySQL

Для использования Entity Framework Core с базой данных MySQL выполните следующие действия:

Установите пакет NuGet.

При установке пакета MySql.EntityFrameworkCore или MySql.Data.EntityFrameworkCore все необходимые для работы приложения пакеты устанавливаются автоматически. Инструкции по добавлению пакета NuGet см. в соответствующей документации Microsoft.
В классе, производном от класса DbContext, переопределите метод OnConfiguring, чтобы установить поставщик данных MySQL с помощью UseMySQL. Следующий пример демонстрирует, как настроить поставщика с использованием универсальной строки подключения в C#.
```
protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
     #warning To protect potentially sensitive information in your connection string,
     you should move it out of source code. See http://go.microsoft.com/fwlink/?LinkId=723263
     for guidance on storing connection strings.

   optionsBuilder.UseMySQL("server=localhost;database=library;user=user;password=password");
}
```

Ограничения

Реализация EF Core с помощью Connector/NET имеет следующие ограничения:

Не поддерживаются таблицы с оптимизацией памяти.

Максимальная длина строки

В следующей таблице показана максимальная длина поддерживаемых типов строк в реализации EF Core с помощью Connector/NET. Значения длины указаны в байтах для небинарных и бинарных типов строк, в зависимости от используемого набора символов.

Таблица 7.3 Максимальная длина строк, используемых с Entity Framework Core

Таблица 7.3 Максимальная длина строк, используемых с Entity Framework Core
Тип данных	Максимальная длина	Тип .NET
`CHAR`	255	`string`
`BINARY`	255	`byte[]`
`VARCHAR`, `VARBINARY`	65 535	`string`, `byte[]`
`TINYBLOB`, `TINYTEXT`	255	`byte[]`
`BLOB`, `TEXT`	65 535	`byte[]`
`MEDIUMBLOB`, `MEDIUMTEXT`	16 777 215	`byte[]`
`LONGBLOB`, `LONGTEXT`	4 294 967 295	`byte[]`
`ENUM`	65 535	`string`
`SET`	65 535	`string`

Дополнительную информацию о требованиях к хранению типов строк см. .