Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/PomeloFoundation/Pomelo.EntityFrameworkCore.MySql

Entity Framework Core provider for MySQL and MariaDB built on top of MySqlConnector
https://github.com/PomeloFoundation/Pomelo.EntityFrameworkCore.MySql

aurora database dotnet dotnet-core entity-framework entity-framework-core mariadb mysql mysqlconnector orm

Last synced: 12 days ago
JSON representation

Entity Framework Core provider for MySQL and MariaDB built on top of MySqlConnector

Host: GitHub
URL: https://github.com/PomeloFoundation/Pomelo.EntityFrameworkCore.MySql
Owner: PomeloFoundation
License: mit
Created: 2016-07-11T16:05:17.000Z (over 8 years ago)
Default Branch: main
Last Pushed: 2024-07-31T15:35:58.000Z (3 months ago)
Last Synced: 2024-08-04T10:28:46.640Z (3 months ago)
Topics: aurora, database, dotnet, dotnet-core, entity-framework, entity-framework-core, mariadb, mysql, mysqlconnector, orm
Language: C#
Homepage:
Size: 6.38 MB
Stars: 2,673
Watchers: 106
Forks: 380
Open Issues: 170
Metadata Files:
- Readme: README.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

stars - PomeloFoundation/Pomelo.EntityFrameworkCore.MySql
awesome-dotnet-core - Pomelo.EntityFrameworkCore.MySql - Entity Framework Core provider for MySql built on top of mysql-net/MySqlConnector. (Frameworks, Libraries and Tools / ORM)
awesome-dotnet-core - Pomelo.EntityFrameworkCore.MySql - mysql的EF驱动程序。 (框架, 库和工具 / 对象关系映射ORM)
fucking-awesome-dotnet-core - Pomelo.EntityFrameworkCore.MySql - Entity Framework Core provider for MySql built on top of mysql-net/MySqlConnector. (Frameworks, Libraries and Tools / ORM)
awesome-dotnet - Pomelo.EntityFrameworkCore.MySql - Entity Framework Core provider for MySQL and MariaDB built on top of MySqlConnector (Libraries, Frameworks and Tools / Database Drivers)
awesome-dotnet-core - Pomelo.EntityFrameworkCore.MySql - Entity Framework Core provider for MySql built on top of mysql-net/MySqlConnector. (Frameworks, Libraries and Tools / ORM)

README

        # Pomelo.EntityFrameworkCore.MySql

[![Build status](https://github.com/PomeloFoundation/Pomelo.EntityFrameworkCore.MySql/actions/workflows/build.yml/badge.svg?branch=main)](https://github.com/PomeloFoundation/Pomelo.EntityFrameworkCore.MySql/actions/workflows/build.yml)

[![Stable release feed for official builds](https://img.shields.io/nuget/v/Pomelo.EntityFrameworkCore.MySql.svg?style=flat-square&label=Stable)](https://www.nuget.org/packages/Pomelo.EntityFrameworkCore.MySql/)

[![Nightly build feed for release builds](https://img.shields.io/myget/pomelo/vpre/Pomelo.EntityFrameworkCore.MySql.svg?label=Nightly)](https://www.myget.org/feed/pomelo/package/nuget/Pomelo.EntityFrameworkCore.MySql)

[![Nightly build feed for debugging enabled builds](https://img.shields.io/myget/pomelo-debug/vpre/Pomelo.EntityFrameworkCore.MySql.svg?label=Debug)](https://www.myget.org/feed/pomelo-debug/package/nuget/Pomelo.EntityFrameworkCore.MySql)

`Pomelo.EntityFrameworkCore.MySql` is the most popular Entity Framework Core provider for MySQL compatible databases. It supports EF Core up to its latest version and uses [MySqlConnector](https://mysqlconnector.net/) for high-performance database server communication.

## Compatibility

### Dependencies

The following versions of MySqlConnector, EF Core, .NET (Core), .NET Standard and .NET Framework are compatible with published releases of `Pomelo.EntityFrameworkCore.MySql`:

Release | Branch                                                                                           | MySqlConnector     |        EF Core        | .NET (Core) | .NET Standard | .NET Framework

--- |--------------------------------------------------------------------------------------------------|--------------------|:---------------------:|:-----------:| :---: | :---:

[9.0.0-
preview.1](https://www.nuget.org/packages/Pomelo.EntityFrameworkCore.MySql/9.0.0-preview.1) | [main](https://github.com/PomeloFoundation/Pomelo.EntityFrameworkCore.MySql/tree/main)       | >= 2.3.5           | 9.0.0-
preview.1 |    8.0+     | - | -

[8.0.2](https://www.nuget.org/packages/Pomelo.EntityFrameworkCore.MySql/8.0.2) | [8.0-maint](https://github.com/PomeloFoundation/Pomelo.EntityFrameworkCore.MySql/tree/8.0-maint) | >= 2.3.5           |         8.0.2         |    8.0+     | - | -

[7.0.0](https://www.nuget.org/packages/Pomelo.EntityFrameworkCore.MySql/7.0.0) | [7.0-maint](https://github.com/PomeloFoundation/Pomelo.EntityFrameworkCore.MySql/tree/7.0-maint) | >= 2.2.5           |         7.0.x         |    6.0+     | - | -

[6.0.3](https://www.nuget.org/packages/Pomelo.EntityFrameworkCore.MySql/6.0.3) | [6.0-maint](https://github.com/PomeloFoundation/Pomelo.EntityFrameworkCore.MySql/tree/6.0-maint) | >= 2.1.2           |         6.0.x         |    6.0+     | - | -

[5.0.4](https://www.nuget.org/packages/Pomelo.EntityFrameworkCore.MySql/5.0.4) | [5.0-maint](https://github.com/PomeloFoundation/Pomelo.EntityFrameworkCore.MySql/tree/5.0-maint) | >= 1.3.13          |         5.0.x         |    3.0+     | 2.1 | -

[3.2.7](https://www.nuget.org/packages/Pomelo.EntityFrameworkCore.MySql/3.2.7) | [3.2-maint](https://github.com/PomeloFoundation/Pomelo.EntityFrameworkCore.MySql/tree/3.2-maint) | >= 0.69.10 < 1.0.0 |         3.1.x         |    2.0+     | 2.0 | 4.6.1+

### Packages

* [Pomelo.EntityFrameworkCore.MySql](https://www.nuget.org/packages/Pomelo.EntityFrameworkCore.MySql/)

* [Pomelo.EntityFrameworkCore.MySql.Json.Microsoft](https://www.nuget.org/packages/Pomelo.EntityFrameworkCore.MySql.Json.Microsoft/)

* [Pomelo.EntityFrameworkCore.MySql.Json.Newtonsoft](https://www.nuget.org/packages/Pomelo.EntityFrameworkCore.MySql.Json.Newtonsoft/)

* [Pomelo.EntityFrameworkCore.MySql.NetTopologySuite](https://www.nuget.org/packages/Pomelo.EntityFrameworkCore.MySql.NetTopologySuite/)

### Supported Database Servers and Versions

`Pomelo.EntityFrameworkCore.MySql` is tested against all actively maintained versions of `MySQL` and `MariaDB`. Older versions (e.g. MySQL 5.7) and other server implementations (e.g. Amazon Aurora) are usually compatible to a high degree as well, but are not tested as part of our CI.

Officially supported versions are:

- MySQL 8.0

- MariaDB 11.3

- MariaDB 11.2

- MariaDB 11.1

- MariaDB 11.0

- MariaDB 10.11 (LTS)

- MariaDB 10.6 (LTS)

- MariaDB 10.5 (LTS)

- MariaDB 10.4 (LTS)

## Schedule and Roadmap

Milestone | Status   | Release Date

----------|----------|-------------

9.0.0-preview.1 | Released | 2024-02-28 (see [#1841](https://github.com/PomeloFoundation/Pomelo.EntityFrameworkCore.MySql/issues/1841))

8.0.2 | Released | 2024-03-16

7.0.0 | Released | 2023-01-16

6.0.3 | Released | 2024-03-16

5.0.4 | Released | 2022-01-22

3.2.7 | Released | 2021-10-04

## Nightly Builds

To use nightly builds from our Azure DevOps feed, add a `NuGet.config` file to your solution root with the following content and enable _prereleases_:

```xml

    

        

        

    

```

### Feeds

Feeds that contain optimized (`Release` configuration) builds:

* `https://pkgs.dev.azure.com/pomelo-efcore/Pomelo.EntityFrameworkCore.MySql/_packaging/pomelo-efcore-public/nuget/v3/index.json`

* `https://www.myget.org/F/pomelo/api/v3/index.json`

Feeds that contain debugging enabled unoptimized (`Debug` configuration) builds:

* `https://pkgs.dev.azure.com/pomelo-efcore/Pomelo.EntityFrameworkCore.MySql/_packaging/pomelo-efcore-debug/nuget/v3/index.json`

* `https://www.myget.org/F/pomelo-debug/api/v3/index.json`

The AZDO `nupkg` packages always contain `.pdb` files.

The MyGet `nupkg` packages only contain `.pdb` files for their debug builds. For optimized builds, the symbols are packed in a `snupkg` file and are available via the `https://www.myget.org/F/pomelo/api/v2/symbolpackage/` symbol server URL.

All `.pdb` files use Source Link.

## Getting Started

### 1. Project Configuration

Ensure that your `.csproj` file contains the following reference:

```xml

```

### 2. Services Configuration

Add `Pomelo.EntityFrameworkCore.MySql` to the services configuration in your the `Startup.cs` file of your ASP.NET Core project:

```c#

public class Startup

{

    public void ConfigureServices(IServiceCollection services)

    {

        // Replace with your connection string.

        var connectionString = "server=localhost;user=root;password=1234;database=ef";

        // Replace with your server version and type.

        // Use 'MariaDbServerVersion' for MariaDB.

        // Alternatively, use 'ServerVersion.AutoDetect(connectionString)'.

        // For common usages, see pull request #1233.

        var serverVersion = new MySqlServerVersion(new Version(8, 0, 36));

        // Replace 'YourDbContext' with the name of your own DbContext derived class.

        services.AddDbContext(

            dbContextOptions => dbContextOptions

                .UseMySql(connectionString, serverVersion)

                // The following three options help with debugging, but should

                // be changed or removed for production.

                .LogTo(Console.WriteLine, LogLevel.Information)

                .EnableSensitiveDataLogging()

                .EnableDetailedErrors()

        );

    }

}

```

View our [Configuration Options Wiki Page](https://github.com/PomeloFoundation/Pomelo.EntityFrameworkCore.MySql/wiki/Configuration-Options) for a list of common options.

### 3. Sample Application

Check out our [Integration Tests](https://github.com/PomeloFoundation/Pomelo.EntityFrameworkCore.MySql/tree/main/test/EFCore.MySql.IntegrationTests) for an example repository that includes an ASP.NET Core MVC Application.

There are also many complete and concise console application samples posted in the issue section (some of them can be found by searching for `Program.cs`).

### 4. Read the EF Core Documentation

Refer to Microsoft's [EF Core Documentation](https://docs.microsoft.com/en-us/ef/core/) for detailed instructions and examples on using EF Core.

## Scaffolding / Reverse Engineering

Use the [EF Core tools](https://docs.microsoft.com/en-us/ef/core/cli/dotnet) to execute scaffolding commands:

```

dotnet ef dbcontext scaffold "Server=localhost;User=root;Password=1234;Database=ef" "Pomelo.EntityFrameworkCore.MySql"

```

## Contribute

One of the easiest ways to contribute is to report issues, participate in discussions and update the wiki docs. You can also contribute by submitting pull requests with code changes and supporting tests.

We are always looking for additional core contributors. If you got a couple of hours a week and know your way around EF Core and MySQL, give us a nudge.

## License

[MIT](https://github.com/PomeloFoundation/Pomelo.EntityFrameworkCore.MySql/blob/main/LICENSE)