Oracle.EntityFrameworkCore 9.23.60

Prefix Reserved
dotnet add package Oracle.EntityFrameworkCore --version 9.23.60                
NuGet\Install-Package Oracle.EntityFrameworkCore -Version 9.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="9.23.60" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Oracle.EntityFrameworkCore --version 9.23.60                
#r "nuget: Oracle.EntityFrameworkCore, 9.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=9.23.60

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

Oracle Logo

Oracle.EntityFrameworkCore 9.23.60

Release Notes for Oracle Entity Framework Core 9 NuGet Package

December 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

  • Entity Framework Core 9 Support
  • VectorDistance(), VectorEmbedding(), and ToVector() DbContext Extension Method Support

Bug Fixes since Oracle.EntityFrameworkCore 8.23.60

  • Bug 37181655 - IDEMPOTENT SCRIPT MISSING EXECUTE IMMEDIATE FOR TRIGGERS
  • Bug 37265049 - VECTOR COLUMNS MAP TO STRING INTEAD OF TO PRIMITIVE ARRAYS (BYTE[]/INT16[]/FLOAT[]/DOUBLE[]) BY DEFAULT

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,
modelBuilder.Entity<Blog>()
    .HasIndex(b => b.Url)
    .HasFilter("Url is not null");
  • 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.
// C# - computed columns code sample
modelBuilder.Entity<Blog>()
    .Property(b => b.BlogOwner)
    .HasComputedColumnSql("\"LastName\" || '','' || \"FirstName\"");
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,
modelBuilder.Entity<Person>()
    .UpdateUsingStoredProcedure(
        "People_Update",
        storedProcedureBuilder =>
        {
            storedProcedureBuilder.HasRowsAffectedReturnValue(true)
        });
  • Certain LINQs cannot be executed against Oracle Database 21c or lower. Let us first imagine an entity model with the following entity:
public class MyTable
{
    public int Id { get; set; }
    public int? Value { get; set; }
}

The following LINQ will not work against Oracle Database 21c or lower:

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)
    };

This is due to LINQ creating the following SQL query:

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"

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:
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; }
}

Trying to update the Blog.Name using below LINQ would throw 'ORA-00933: SQL command not properly ended'

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"));

This is due to LINQ creating the following SQL query, which Oracle database does not support.

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'))
  • 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:
public class Author
{
    public int Id { get; set; }
    public string Name { get; set; }
    public DateTimeOffset Timeline { get; set; }
}

The following LINQ will not work:

var timeSpan = new TimeSpan(1000);
var authorsInChigley1 = context.Authors.Where(e => e.Timeline > DateTimeOffset.Now - timeSpan).ToQueryString();

Following is the PL/SQL that gets generated.

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;
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 (193)

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
9.23.60 9,639 12/6/2024
8.23.60 202,626 10/2/2024
8.23.50 312,743 7/11/2024
8.23.40 306,445 5/2/2024
8.21.160 11,253 10/2/2024
8.21.150 35,968 7/11/2024
8.21.140 208,624 4/11/2024
8.21.121 679,066 12/8/2023
7.21.13 297,061 1/1/2024
7.21.12 452,868 10/9/2023
7.21.11 459,214 7/25/2023
7.21.9 1,078,858 1/19/2023
7.21.8 213,140 12/19/2022
6.21.160 13,540 10/2/2024
6.21.150 18,344 7/11/2024
6.21.140 41,690 4/11/2024
6.21.130 182,200 1/1/2024
6.21.120 94,078 10/9/2023
6.21.110 80,789 7/25/2023
6.21.90 438,515 1/19/2023
6.21.61 2,089,231 5/4/2022
6.21.5 1,025,938 1/4/2022
6.21.4 266,037 12/7/2021
5.21.90 69,529 1/19/2023
5.21.61 122,412 5/4/2022
5.21.5 195,558 1/4/2022
5.21.4 306,937 10/27/2021
5.21.1 1,029,066 2/12/2021
3.21.90 26,107 1/19/2023
3.21.61 55,229 5/4/2022
3.21.5 84,909 1/4/2022
3.21.4 34,120 10/27/2021
3.19.180 27,976 2/3/2023
3.19.130 123,453 10/8/2021
3.19.110 149,983 3/31/2021
3.19.80 1,246,751 9/8/2020
2.19.180 6,524 2/3/2023
2.19.110 25,993 3/31/2021
2.19.90 108,074 9/8/2020
2.19.80 165,432 7/9/2020
2.19.70 206,994 5/1/2020
2.19.60 571,494 12/6/2019
2.19.50 150,479 10/16/2019
2.19.30 535,561 7/24/2019