Oracle.EntityFrameworkCore 8.23.60

Prefix Reserved
dotnet add package Oracle.EntityFrameworkCore --version 8.23.60                
NuGet\Install-Package Oracle.EntityFrameworkCore -Version 8.23.60                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Oracle.EntityFrameworkCore" Version="8.23.60" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Oracle.EntityFrameworkCore --version 8.23.60                
#r "nuget: Oracle.EntityFrameworkCore, 8.23.60"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Oracle.EntityFrameworkCore as a Cake Addin
#addin nuget:?package=Oracle.EntityFrameworkCore&version=8.23.60

// Install Oracle.EntityFrameworkCore as a Cake Tool
#tool nuget:?package=Oracle.EntityFrameworkCore&version=8.23.60                

Oracle Logo

Oracle.EntityFrameworkCore 8.23.60

Release Notes for Oracle Entity Framework Core 8 NuGet Package

September 2024

Oracle Data Provider for .NET (ODP.NET) Entity Framework (EF) Core is a database provider that allows Entity Framework Core to be used with Oracle databases. EF Core is a cross-platform Microsoft object-relational mapper that enables .NET developers to work with relational databases using .NET objects.

This document provides information that supplements the Oracle Data Provider for .NET (ODP.NET) documentation.

New Features

  • None

Bug Fixes since Oracle.EntityFrameworkCore 8.23.50

  • Bug 36218521 - SCHEMA PREPENDED TO MAPPED FUNCTION INSTEAD OF TABLE
  • Bug 36345282 - EF CORE 8.0.2 UPGRADE LEADS TO ORA-00932 EXCEPTION: INCONSISTENT DATATYPES: EXPECTED CHAR; GOT NCLOB
  • Bug 36859898 - STRING LITERALS CAUSING ORA-12704: CHARACTER SET MISMATCH
  • Bug 36882183 - ORACLEDBTYPE VALUE NOT CORRECT FOR SOME DB TYPE

Tips, Limitations, and Known Issues

Code First
  • The HasIndex() Fluent API cannot be invoked on an entity property that will result in a primary key in the Oracle database. Oracle Database does not support index creation for primary keys since an index is implicitly created for all primary keys.
  • The HasFilter() Fluent API is not supported. For example, <pre>modelBuilder.Entity<Blog>().HasIndex(b ⇒ b.Url.HasFilter("Url is not null");</pre>
  • Data seeding using the UseIdentityColumn is not supported.
  • The UseCollation() Fluent API is not supported.
  • The DateOnly and TimeOnly types are not supported.
  • DatabaseTable.Indexes() is not supported for descending indexes.
  • The following usage is not supported because of a limitation in the provider: → HasColumnType("float").HasPrecision(38). As a workaround, set the precision value in the HasColumnType() fluent API instead of explicitly using the HasPrecision() fluent API, e.g., HasColumnType("float (38)"). NOTE: Except for 38 as a precision value, other precision values between 1 and 126 can be set using the HasPrecision() Fluent API. This limitation and workaround also apply when annotations are used instead of the above mentioned fluent API's.
Computed Columns
  • Literal values used for computed columns must be encapsulated by two single-quotes. In the example below, the literal string is the comma. It needs to be surrounded by two single-quotes as shown below. <pre> // C# - computed columns code sample modelBuilder.Entity<Blog>() .Property(b ⇒ b.BlogOwner) .HasComputedColumnSql(""LastName" || '','' || "FirstName"");

</pre>

Database Scalar Function Mapping
  • Database scalar function mapping does not provide a native way to use functions residing within PL/SQL packages. To work around this limitation, map the package and function to an Oracle synonym, then map the synonym to the EF Core function.
LINQ
  • LINQ queries that are used to query or restore historical (temporal) data are not supported.
  • LINQ queries that are used to query the DateOnly and TimeOnly types are not supported.
  • HasRowsAffectedReturnValue is not supported because Oracle does not support having a return value from a stored procedure. For example, <pre>modelBuilder.Entity<Person>() .UpdateUsingStoredProcedure( "People_Update", storedProcedureBuilder ⇒ { storedProcedureBuilder.HasRowsAffectedReturnValue(true) });</pre>
  • Certain LINQs cannot be executed against Oracle Database 21c or lower. Let us first imagine an entity model with the following entity: <pre> public class MyTable { public int Id { get; set; } public int? Value { get; set; } } </pre> The following LINQ will not work against Oracle Database 21c or lower: <pre> var query = from t in context.Table group t.Id by t.Value into tg select new { A = tg.Key, B = context.Table.Where(t ⇒ t.Value == tg.Max() * 6).Max(t ⇒ (int?)t.Id), }; </pre> This is due to LINQ creating the following SQL query: <pre> SELECT "t"."Value" "A", "t"."Id", ( SELECT MAX("t0"."Id") FROM "MyTable" "t0" WHERE (("t0"."Value" = "t"."Id") OR ("t0"."Value" IS NULL AND MAX("t"."Id") IS NULL))) "B" FROM "MyTable" "t" GROUP BY "t"."Value" </pre> The issue is because the inner select query uses a MAX function which refers to a column from the outer select query. Also the way in which the MAX function is used within the WHERE clause is not supported in Oracle Database. The same issue is also applicable when the MIN function is used.
  • Oracle DB doesn't support UPDATE queries with FROM clause in DB 21c or lower. So certain LINQs cannot be executed against Oracle Database which generate UPDATE query with FROM clause. For example, imagine an entity model with the following entities: <pre> public class Blog { public int Id { get; private set; } public string Name { get; set; } public List<Post> Posts { get; } = new(); }

public class Post { public int Id { get; private set; } public string Title { get; set; } public string Content { get; set; } public DateTime PublishedOn { get; set; } } </pre> Trying to update the Blog.Name using below LINQ would throw 'ORA-00933: SQL command not properly ended' <pre> var query = from blog in context.Set<Blog>().Where(c ⇒ c.Name == "MyBlog") join post in context.Set<Post>().Where(p ⇒ p.Title == "Oracle") on blog.Name equals post.Title select new { blog, post }; var updateQuery = query.ExecuteUpdate(s ⇒ s.SetProperty(c ⇒ c.blog.Name, "Updated")); </pre> This is due to LINQ creating the following SQL query, which Oracle database does not support. <pre> UPDATE "Blogs" "b" SET "b"."Name" = N'Updated' FROM ( SELECT "p"."Id", "p"."BlogId", "p"."Content", "p"."PublishedOn", "p"."Title" FROM "Posts" "p" WHERE "p"."Title" = N'Oracle' ) "t" WHERE (("b"."Name" = "t"."Title") AND ("b"."Name" = N'MyBlog')) </pre>

  • The PL/SQL returned by ToQueryString() does not execute successfully if the input to the LINQ query contains a TimeSpan. This is because in PL/SQL, interval value with precision is not accepted. Consider this example, imagine an entity model with the following entity: <pre> public class Author { public int Id { get; set; } public string Name { get; set; } public DateTimeOffset Timeline { get; set; } } </pre> The following LINQ will not work: <pre> var timeSpan = new TimeSpan(1000); var authorsInChigley1 = context.Authors.Where(e ⇒ e.Timeline > DateTimeOffset.Now - timeSpan).ToQueryString(); </pre> Following is the PL/SQL that gets generated. <pre> DECLARE l_sql varchar2(32767); l_cur pls_integer; l_execute pls_integer; BEGIN l_cur := dbms_sql.open_cursor; l_sql := 'SELECT "a"."Id", "a"."Name", "a"."Timeline" FROM "Authors" "a" WHERE "a"."Timeline" > (SYSDATE - :timeSpan_0)'; dbms_sql.parse(l_cur, l_sql, dbms_sql.native); dbms_sql.bind_variable(l_cur, ':timeSpan_0', INTERVAL '0 0:0:0.0001000' DAY(8) TO SECOND(7)); l_execute:= dbms_sql.execute(l_cur); dbms_sql.return_result(l_cur); END; </pre>
Scaffolding
  • ORA-50607 or similar error occurs when a table has multiple identity and/or sequence/trigger columns auto-generated. While scaffolding such a table, the .NET model generated contains the ValueGeneratedOnAdd fluent API for all the auto-generated columns. When executing a LINQ query on this table, an ORA-50607 or similar error is thrown that indicates only one identity column per table is allowed. As a workaround for column values generated by a sequence/trigger, replace the ValueGeneratedOnAdd() fluent API appended to the corresponding property/column with UseSequence(your sequence name). The sequence name is the Oracle database sequence name from which the column gets its value.
  • Scaffolding a table that uses Function Based Indexes is supported. However, the index will NOT be scaffolded.
  • Scaffolding a table that uses Conditional Indexes is not supported.
Sequences
  • A sequence cannot be restarted.
  • Extension methods related to SequenceHiLo is not supported, except for columns with Char, UInt, ULong, and UByte data types.

Copyright (c) 2024, Oracle and/or its affiliates.

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (191)

Showing the top 5 NuGet packages that depend on Oracle.EntityFrameworkCore:

Package Downloads
WalkingTec.Mvvm.Core

WalkingTec.Mvvm

FenixAlliance.ACL.Dependencies

Application Component for the Alliance Business Suite.

MPACKAGE.LibData.Oracle

Package Description

HanaTech.Framework.Dapper

Package Description

devprime.stack.state

DevPrime State

GitHub repositories (27)

Showing the top 5 popular GitHub repositories that depend on Oracle.EntityFrameworkCore:

Repository Stars
abpframework/abp
Open-source web application framework for ASP.NET Core! Offers an opinionated architecture to build enterprise software solutions with best practices on top of the .NET. Provides the fundamental infrastructure, cross-cutting-concern implementations, startup templates, application modules, UI themes, tooling and documentation.
elsa-workflows/elsa-core
A .NET workflows library
danielgerlag/workflow-core
Lightweight workflow engine for .NET Standard
dotnetcore/Util
Util是一个.Net平台下的应用框架,旨在提升中小团队的开发能力,由工具类、分层架构基类、Ui组件,配套代码生成模板,权限等组成。
dotnetcore/WTM
Use WTM to write .netcore app fast !!!
Version Downloads Last updated
8.23.60 104,754 10/2/2024
8.23.50 264,145 7/11/2024
8.23.40 275,521 5/2/2024
8.21.160 5,504 10/2/2024
8.21.150 30,759 7/11/2024
8.21.140 185,627 4/11/2024
8.21.121 629,634 12/8/2023
7.21.13 265,105 1/1/2024
7.21.12 429,263 10/9/2023
7.21.11 442,178 7/25/2023
7.21.9 1,057,546 1/19/2023
7.21.8 204,107 12/19/2022
6.21.160 5,440 10/2/2024
6.21.150 14,898 7/11/2024
6.21.140 36,653 4/11/2024
6.21.130 168,589 1/1/2024
6.21.120 89,198 10/9/2023
6.21.110 77,357 7/25/2023
6.21.90 428,513 1/19/2023
6.21.61 2,060,351 5/4/2022
6.21.5 1,010,281 1/4/2022
6.21.4 256,886 12/7/2021
5.21.90 65,007 1/19/2023
5.21.61 120,681 5/4/2022
5.21.5 192,400 1/4/2022
5.21.4 302,640 10/27/2021
5.21.1 1,021,851 2/12/2021
3.21.90 24,846 1/19/2023
3.21.61 54,470 5/4/2022
3.21.5 83,767 1/4/2022
3.21.4 33,825 10/27/2021
3.19.180 25,871 2/3/2023
3.19.130 121,186 10/8/2021
3.19.110 149,095 3/31/2021
3.19.80 1,238,802 9/8/2020
2.19.180 6,181 2/3/2023
2.19.110 25,820 3/31/2021
2.19.90 107,478 9/8/2020
2.19.80 164,892 7/9/2020
2.19.70 205,943 5/1/2020
2.19.60 569,656 12/6/2019
2.19.50 150,001 10/16/2019
2.19.30 532,830 7/24/2019