-
Notifications
You must be signed in to change notification settings - Fork 2k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
1411db3
commit 2941730
Showing
5 changed files
with
184 additions
and
0 deletions.
There are no files selected for viewing
11 changes: 11 additions & 0 deletions
11
entity-framework/core/what-is-new/ef-core-8.0/breaking-changes.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,11 @@ | ||
| --- | ||
| title: Breaking changes in EF Core 8.0 (EF8) - EF Core | ||
| description: Complete list of breaking changes introduced in Entity Framework Core 8.0 (EF7) | ||
| author: ajcvickers | ||
| ms.date: 12/13/2022 | ||
| uid: core/what-is-new/ef-core-8.0/breaking-changes | ||
| --- | ||
|
|
||
| # Breaking changes in EF Core 8.0 (EF8) | ||
|
|
||
| This page will dcoument API and behavior changes that have the potential to break existing applications updating to EF Core 8.0. |
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,160 @@ | ||
| --- | ||
| title: Plan for Entity Framework Core 8 | ||
| description: The themes and features planned for EF Core 8 | ||
| author: ajcvickers | ||
| ms.date: 12/13/2022 | ||
| uid: core/what-is-new/ef-core-8.0/plan | ||
| --- | ||
|
|
||
| # Plan for Entity Framework Core 8 | ||
|
|
||
|  | ||
|
|
||
| As described in the [planning process](xref:core/what-is-new/release-planning), we have gathered input from stakeholders into a plan for Entity Framework Core 8 (EF Core 8) and other .NET Data Access work for the .NET 8 timeframe. For brevity, EF Core 8 is also referred to as just EF8. | ||
|
|
||
| > [!IMPORTANT] | ||
| > This plan is not a commitment; it will evolve as we continue to learn throughout the release. Some things not currently planned for EF8 may get pulled in. Some things currently planned for EF8 may get punted out. | ||
| ## General information | ||
|
|
||
| EF Core 8 is the next release after EF Core 7 and is scheduled for release in November 2023, at the same time as .NET 8. There are no plans for an EF Core 7.1 release. | ||
|
|
||
| ### Supported platforms | ||
|
|
||
| EF8 currently targets .NET 6. This will likely be updated to .NET 8 as we near the release. EF8 does not target any .NET Standard version; for more information see [the future of .NET Standard](https://devblogs.microsoft.com/dotnet/the-future-of-net-standard/). EF8 will not run on .NET Framework. | ||
|
|
||
| EF8 will align with .NET 8 as a long-term support (LTS) release. See the [.NET support policy](https://dotnet.microsoft.com/platform/support/policy/dotnet-core) for more information. | ||
|
|
||
| ### Breaking changes | ||
|
|
||
| EF8 will contain a small number of [breaking changes](xref:core/what-is-new/ef-core-8.0/breaking-changes) as we continue to evolve both EF Core and the .NET platform. Our goal is to minimize breaking changes as much as possible without stagnating the platform. | ||
|
|
||
| ## Themes | ||
|
|
||
| Large investments for EF8 amd data access in .NET 8 fall under the following themes: | ||
|
|
||
| - Highly requested features | ||
| - Cloud native and devices | ||
| - Performance | ||
| - Visual tooling | ||
| - Developer experience | ||
|
|
||
| Each of these themes is described in detail below. The high-level status of each theme can be tracked in the [.NET Data Biweekly Updates](https://github.com/dotnet/efcore/issues/27185). Please comment on [GitHub Issue #26994](https://github.com/dotnet/efcore/issues/26994) with any feedback or suggestions. | ||
|
|
||
| ## Theme: Highly requested features | ||
|
|
||
| As always, a major input into the [planning process](xref:core/what-is-new/release-planning) comes from [votes (👍) for features on GitHub](https://github.com/dotnet/efcore/issues?q=is%3Aissue+is%3Aopen+sort%3Areactions-%2B1-desc). Based on these votes and user input, we plan to work on the following highly requested features for EF8. | ||
|
|
||
| ### JSON columns | ||
|
|
||
| Tracked by [issues labeled with 'area-json' and 'consider-for-current-release'](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+label%3Aconsider-for-current-release+label%3Aarea-json) | ||
|
|
||
| Value proposition: Build on EF7 JSON support to further power the document/relational hybrid pattern. | ||
|
|
||
| EF7 introduced mapping of [SQL Server JSON columns to aggregate types](xref:core/what-is-new/ef-core-7#json-columns) in the EF model, but with some limitations. In EF8, we plan to address many of these limitations, and also test and improve performance. In EF7, JSON mapping to aggregates is limited to SQL Server. In EF8, we plan to bring support to SQLite and work with the owners of other providers to align JSON columns support across all providers. | ||
|
|
||
| ### Value objects | ||
|
|
||
| Tracked by [Issue #9906: Use C# structs or classes as value objects](https://github.com/dotnet/efcore/issues/9906) | ||
|
|
||
| Value proposition: Applications can use DDD-style value objects in EF models. | ||
|
|
||
| It was previously the team view that owned entities, intended for [aggregate support](https://www.martinfowler.com/bliki/DDD_Aggregate.html), would also be a reasonable approximation to [value objects](https://www.martinfowler.com/bliki/ValueObject.html). Experience has shown this not to be the case. Therefore, in EF8, we plan to introduce a better experience focused on the needs of value objects in domain-driven design. This approach will be based on value converters rather than owned entities. | ||
|
|
||
| ### SQL queries for unmapped types | ||
|
|
||
| Tracked by [Issue #10753: Support raw SQL queries without defining an entity type for the result](https://github.com/dotnet/efcore/issues/10753) | ||
|
|
||
| Value proposition: Applications can execute more types of SQL query without dropping down to ADO.NET or using third-party libraries. | ||
|
|
||
| Currently SQL queries must return a type in the model or a scalar type. In EF8, we plan to allow SQL queries that directly return types that are not contained in the EF model. | ||
|
|
||
| ## Theme: Cloud native and devices | ||
|
|
||
| EF Core is most often used in traditional ASP.NET Core web applications. However, EF Core is increasingly used in microservices and on mobile devices. These environments generally favor smaller application size, faster start-up times, and no reliance on dynamic code generation. We significantly improved [trimming for EF Core apps in EF7](https://github.com/dotnet/efcore/issues/29092), and we plan further investment in these areas for EF8. | ||
|
|
||
| ### AOT and trimming with EF Core | ||
|
|
||
| Tracked by [issues labeled with 'area-aot' and 'consider-for-current-release'](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+label%3Aconsider-for-current-release+label%3Aarea-aot) | ||
|
|
||
| Value proposition: Small, fast-starting EF Core applications with no dynamic code generation. | ||
|
|
||
| EF Core has several characteristics that are a challenge for trimmed, ahead-of-time (AOT) compiled applications: | ||
|
|
||
| - Use of imperative application code and reflection to discover the EF model and mappings | ||
| - Use of reflection and dynamically generated types for queries and change tracking | ||
| - Dynamically generated code for imperatively constructed arbitrary LINQ queries | ||
|
|
||
| In EF8, we plan to investigate and prototype these areas to find a way forward for AOT and trimming that retains the current EF Core user experience. | ||
|
|
||
| ### AOT and trimming for ADO.NET | ||
|
|
||
| Value proposition: Low-level data access can be used in cloud native applications. | ||
|
|
||
| Higher-level data access technologies such as EF Core make use of ADO.NET data providers, such as [Microsoft.Data.SqlClient](https://www.nuget.org/packages/Microsoft.Data.SqlClient), [Microsoft.Data.Sqlite](https://www.nuget.org/packages/Microsoft.Data.Sqlite), and [Npgsql](https://www.nuget.org/packages/Npgsql). For .NET 8, we will ensure that the Npgsql provider for PostgreSQL and the Microsoft.Data.Sqlite provider for SQLite are full working in trimmed and AOT-compiled applications. We will also work with the authors of other ADO.NET data providers to help make them AOT and trimming friendly. | ||
|
|
||
| ## Theme: Performance | ||
|
|
||
| Great performance is a fundamental for all of .NET, including both EF Core and lower-level data access. Woodstar (see below) will be our primary performance push in the .NET 8 timeframe. However, we also plan to work on performance in some other areas, such as in JSON columns, as described above. In addition, the work on AOT and trimming (see above) has a strong relationship to performance. | ||
|
|
||
| ### Woodstar | ||
|
|
||
| Tracked in the [.NET Data Lab repo](https://github.com/dotnet/datalab/) | ||
|
|
||
| Value proposition: Fast, fully managed access to SQL Server and Azure SQL for .NET applications. | ||
|
|
||
| [Microsoft.Data.SqlClient](https://www.nuget.org/packages/Microsoft.Data.SqlClient/) is a fully-featured ADO.NET database provider for SQL Server. It supports a broad range of SQL Server features on both .NET and .NET Framework. However, it is also a large and old codebase with many complex interactions between its behaviors. This makes it difficult to leverage newer .NET performance features such as Pipelines. It also has several performance issues (most notably for [reading large data](https://github.com/dotnet/SqlClient/issues/593)) that have proved very hard to fix. | ||
|
|
||
| We plan to invest more heavily on Woodstar in the .NET 8 timeframe. Our tentative goal is to run the TechEmpower Fortunes benchmark using Woodstar by the end of the release. | ||
|
|
||
| > [!IMPORTANT] | ||
| > Investment in Microsoft.Data.SqlClient is not changing. It will continue to be the recommended way to connect to SQL Server and Azure SQL, both with and without EF Core. It will continue to support new SQL Server features as they are introduced. | ||
| ## Theme: Visual Tooling | ||
|
|
||
| EF Core features powerful, cross-platform command line tooling for database migrations, reverse engineering, and more. In addition, the [EF Core Power Tools](https://marketplace.visualstudio.com/items?itemName=ErikEJ.EFCorePowerTools&ssr=false#overview) offer a visual experience for some of these things. However, EF Core is virtually absent from the default Visual Studio UI experience. In the .NET 8 timeframe, we plan to make EF Core tooling a built-in part of the Visual Studio experience. | ||
|
|
||
| ### First-class T4 templates in Visual Studio | ||
|
|
||
| Value proposition: Leverage T4 templating across multiple areas in Visual Studio. | ||
|
|
||
| EF7 introduced [T4 templates for scaffolding (reverse engineering) an EF model](xref:core/what-is-new/ef-core-7#custom-reverse-engineering-templates) from an existing database. However, editing T4 templates can be difficult without a good editor experience. In the .NET 8 timeframe, we plan to bring a better T4 editing experience to Visual Studio so that it can be used for both EF and other templates. | ||
|
|
||
| ### EF Core Database First in Visual Studio | ||
|
|
||
| Value proposition: Out-of-the-box Database First tooling in Visual Studio. | ||
|
|
||
| The [EF Core Power Tools](https://marketplace.visualstudio.com/items?itemName=ErikEJ.EFCorePowerTools&ssr=false#overview) offer a great visual experience for EF Core tooling. However, the Power Tools are not installed out-of-the-box with Visual Studio and so can be hard to discover. In the .NET 8 timeframe, we plan to make EF Core tooling easily discoverable in Visual Studio. The primary focus of this work will be scaffolding (reverse engineering) an EF model from an existing database, otherwise known as "Database First", but may also include other areas. | ||
|
|
||
| ## Theme: Developer experience | ||
|
|
||
| Creating a great experience for developers has always been a primary driving force for the team. Almost everything in the themes outlined here above relates to this in some way. In addition, a large part of the work planned for EF8 involves improving the developer experience in many small ways across multiple areas. | ||
|
|
||
| All the issues that we may potentially work on for EF8 are [tracked on GitHub by the 'consider-for-current-release' label](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+label%3Aconsider-for-current-release). We will reassess these issues throughout the release and move issues into the [8.0 milestone](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+milestone%3A8.0.0) as we commit to working on them. Make sure to vote for issues that are important to you (👍) so that we can use this information when deciding with issues to work on. | ||
|
|
||
| EF Core GitHub issues are all assigned to one or more "areas". The queries below filter issues we are considering for EF8 by major areas: | ||
|
|
||
| - [Queries](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+label%3Aconsider-for-current-release+label%3Aarea-query) | ||
| - [Model building and metadata](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+label%3Aconsider-for-current-release+label%3Aarea-model-building) | ||
| - [Change tracking](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+label%3Aconsider-for-current-release+label%3Aarea-change-tracking) | ||
| - [Performance](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+label%3Aconsider-for-current-release+label%3Aarea-perf) | ||
| - [Migrations](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+label%3Aconsider-for-current-release+label%3Aarea-migrations) | ||
| - [DbContext and related APIs](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+label%3Aconsider-for-current-release+label%3Aarea-dbcontext) | ||
| - [Tooling](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+label%3Aconsider-for-current-release+label%3Aarea-tools) | ||
| - [Azure Cosmos provider](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+label%3Aconsider-for-current-release+label%3Aarea-cosmos) | ||
| - [Model building conventions](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+label%3Aconsider-for-current-release+label%3Aarea-conventions) | ||
| - [Relational-specific mapping](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+label%3Aconsider-for-current-release+label%3Aarea-relational-mapping) | ||
| - [SQL Server provider](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+label%3Aconsider-for-current-release+label%3Aarea-sqlserver) | ||
| - [SaveChanges](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+label%3Aconsider-for-current-release+label%3Aarea-save-changes) | ||
| - [Model to database mapping](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+label%3Aconsider-for-current-release+label%3Aarea-o/c-mapping) | ||
| - [SQLite provider](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+label%3Aconsider-for-current-release+label%3Aarea-sqlite) | ||
| - [Scaffolding (reverse engineering)](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+label%3Aconsider-for-current-release+label%3Aarea-scaffolding) | ||
| - [Logging](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+label%3Aconsider-for-current-release+label%3Aarea-logging) | ||
| - [Dynamic proxies](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+label%3Aconsider-for-current-release+label%3Aarea-proxies) | ||
| - [Type mapping](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+label%3Aconsider-for-current-release+label%3Aarea-type-mapping) | ||
| - [ADO.NET SQLite provider](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+label%3Aconsider-for-current-release+label%3Aarea-adonet-sqlite) | ||
| - [Temporal tables](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+label%3Aconsider-for-current-release+label%3Aarea-temporal-tables) | ||
|
|
||
| ## Suggestions | ||
|
|
||
| Your feedback on planning is important. Please comment on [GitHub Issue #26994](https://github.com/dotnet/efcore/issues/26994) with any feedback or general suggestions about the plan. The best way to indicate the importance of an issue is to vote (👍) for that [issue on GitHub](https://github.com/dotnet/efcore/issues). This data will then feed into the [planning process](xref:core/what-is-new/release-planning) for the next release. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,11 @@ | ||
| --- | ||
| title: What's New in EF Core 8 | ||
| description: Overview of new features in EF Core 8 | ||
| author: ajcvickers | ||
| ms.date: 12/13/2022 | ||
| uid: core/what-is-new/ef-core-8 | ||
| --- | ||
|
|
||
| # What's New in EF Core 8 | ||
|
|
||
| This page will document new features in EF Core 8 (EF8). |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters