feat: Add Oracle Database support with CI configuration and tests

Author: AGiorgetti

.github/workflows/ci.yml

@@ -81,6 +81,7 @@ jobs:
           - postgresql
           - mysql
           - sqlite
+          - oracle
 
     services:
       postgresql:
@@ -109,11 +110,25 @@ jobs:
           --health-retries 5
         ports:
           - 3306:3306
+      
+      oracle:
+        image: gvenzl/oracle-xe:latest
+        env:
+          ORACLE_ALLOW_REMOTE: true
+          ORACLE_PASSWORD: Password12!
+        options: >-
+          --health-cmd "sqlplus -L -S / as sysdba @/dev/null"
+          --health-interval 15s
+          --health-timeout 10s
+          --health-retries 10
+        ports:
+          - 1521:1521
 
     env:
       NEventStore.PostgreSql: Server=localhost;Database=NEventStore;Uid=postgres;Pwd=Password12!;Enlist=false;
       NEventStore.MySql: Server=localhost;Database=NEventStore;Uid=root;Pwd=Password12!;AutoEnlist=false;
       NEventStore.Sqlite: Data Source=:memory:;Cache=Shared;
+      NEventStore.Oracle: Data Source=localhost:1521/XE;User Id=system;Password=Password12!;Persist Security Info=True;
 
     steps:
       - name: Checkout

Changelog.md

@@ -5,6 +5,10 @@
 - Added explicit support for net8.0,net9.0,net10.0
 - Updated NEventStore 10.2.0
 - Updated Microsoft.Data.SqlClient 7.0.1
+- Updated Oracle.ManagedDataAccess 23.26.200
+- Fixed Oracle Database connector.
+  - added tests and CI support for Oracle Database (using Oracle XE in docker)
+- Research and enable Oracle integration test infrastructure [#58](https://github.com/NEventStore/NEventStore.Persistence.SQL/issues/58)
 
 ### Breaking Changes
 

README.md

@@ -14,7 +14,7 @@ NEventStore.Persistence.Sql currently supports:
 - SqlLite
 - MySql
 - PostgreSQL
-- Oracle (not tested)
+- Oracle
 
 Build Status
 ===
@@ -66,7 +66,7 @@ To build the project locally on a Windows Machine:
   NEventStore.MsSql="Server=localhost,50001;Database=NEventStore;User Id=sa;Password=Password1;TrustServerCertificate=True;"
   NEventStore.MySql="Server=localhost;Port=50003;Database=NEventStore;Uid=sa;Pwd=Password1;AutoEnlist=false;"
   NEventStore.PostgreSql="Server=localhost;Port=50004;Database=NEventStore;Uid=sa;Pwd=Password1;Enlist=false;"
-  NEventStore.Oracle="Data Source=localhost:1521/XE;User Id=system;Password=Password1;Persist Security Info=True;"
+  NEventStore.Oracle="Data Source=localhost:50005/XE;User Id=system;Password=Password1;Persist Security Info=True;"
   ```
 
 ## How to contribute
@@ -122,4 +122,4 @@ This means, that we need a NEventStore greater than the latest published, but le
 5.4.0
 5.4.1
 6.0.0-unstable00001
-6.0.0
+6.0.0

docker/Readme.md

@@ -15,7 +15,4 @@ NEventStore.MsSql="Server=localhost,50001;Database=NEventStore;User Id=sa;Passwo
 NEventStore.MongoDB="mongodb://localhost:50002/NEventStore"
 NEventStore.MySql="Server=localhost;Port=50003;Database=NEventStore;Uid=sa;Pwd=Password1;AutoEnlist=false;"
 NEventStore.PostgreSql="Server=localhost;Port=50004;Database=NEventStore;Uid=sa;Pwd=Password1;Enlist=false;"
-
-## To be tested
-
-NEventStore.Oracle="Data Source=[host]:1521/XE;User Id=system;Password=NEventStore;Persist Security Info=True;"
+NEventStore.Oracle="Data Source=localhost:50005/XE;User Id=system;Password=Password1;Persist Security Info=True;"

docker/docker-compose.ci.linux.db.yml

@@ -53,6 +53,17 @@ services:
     ports:
       - "50004:5432"
 
+  oracle:
+    container_name: nesci-oracle-1
+    platform: linux
+    image: gvenzl/oracle-xe
+    restart: always
+    environment:
+      - ORACLE_ALLOW_REMOTE=true
+      - ORACLE_PASSWORD=Password1
+    ports:
+      - "50005:1521"
+
 #volumes:
 #  nes_sqldata_linux_ci:
 #  nes_mongodata_linux_ci:

docker/docker-compose.ci.windows.db.yml

@@ -53,6 +53,17 @@ services:
     ports:
       - "50004:5432"
 
+  oracle:
+    container_name: nesci-oracle-1
+    platform: linux
+    image: gvenzl/oracle-xe:23
+    restart: always
+    environment:
+      - ORACLE_ALLOW_REMOTE=true
+      - ORACLE_PASSWORD=Password1
+    ports:
+      - "50005:1521"
+
 #volumes:
 #  nes_sqldata_windows_ci:
 #  nes_sqllog_windows_ci:

docs/Project-Analysis-Issue-Drafts.md

@@ -234,3 +234,26 @@ For implementation issues created from this document:
 3. Run `dotnet build ./src/NEventStore.Persistence.Sql.Core.sln -c Release --no-restore /p:ContinuousIntegrationBuild=true`.
 4. Run `dotnet test ./src/NEventStore.Persistence.Sql.Core.sln -c Release --no-build` when DB prerequisites are available.
 
+## Handoff Notes
+
+### Issue #58: Oracle Support And Tests
+
+Status: completed on 2026-06-11.
+
+Oracle support and tests are back. The Oracle Docker setup was validated with the `gvenzl/oracle-xe` container exposed on `localhost:50005`, using:
+
+```text
+NEventStore.Oracle="Data Source=localhost:50005/XE;User Id=system;Password=Password1;Persist Security Info=True;"
+```
+
+Implementation notes:
+
+- Modern .NET Oracle tests use `Oracle.ManagedDataAccess.Core`; `net472` keeps `Oracle.ManagedDataAccess`.
+- Oracle payload binding now uses the active `OracleConnection` directly.
+- Oracle parameter binding avoids unsupported provider `DbType` assignments and uses `DbType.DateTime` instead of `DbType.DateTime2`.
+- Oracle snapshot candidate paging was fixed so `GetStreamsToSnapshot` behaves like the other providers.
+
+Validation:
+
+- `dotnet test .\src\NEventStore.Persistence.Oracle.Tests\NEventStore.Persistence.Oracle.Core.Tests.csproj -c Release --no-build -f net8.0`
+- Result: 137 passed, 0 failed, 0 skipped.

src/NEventStore.Persistence.Oracle.Tests/NEventStore.Persistence.Oracle.Core.Tests.csproj

@@ -13,9 +13,12 @@
     <DefineConstants Condition="'$(Configuration)|$(Platform)'=='Release|AnyCPU'">NUNIT</DefineConstants>
   </PropertyGroup>
 
-  <ItemGroup>
+  <ItemGroup Condition="'$(TargetFramework)' == 'net472'">
     <PackageReference Include="Oracle.ManagedDataAccess" Version="23.26.200" />
   </ItemGroup>
+  <ItemGroup Condition="'$(TargetFramework)' != 'net472'">
+    <PackageReference Include="Oracle.ManagedDataAccess.Core" Version="23.26.0" />
+  </ItemGroup>
   <ItemGroup Condition="'$(TargetFramework)' == 'net472'">
     <Reference Include="System.Data" />
     <Reference Include="System.Transactions" />

src/NEventStore.Persistence.Oracle.Tests/app.config

@@ -2,7 +2,7 @@
 <configuration>
     <configSections>
         <section name="oracle.manageddataaccess.client"
-          type="OracleInternal.Common.ODPMSectionHandler, Oracle.ManagedDataAccess, Version=4.121.2.0, Culture=neutral, PublicKeyToken=89b483f429c47342"/>
+          type="OracleInternal.Common.ODPMSectionHandler, Oracle.ManagedDataAccess"/>
     </configSections>
     <system.data>
         <DbProviderFactories>
@@ -11,21 +11,12 @@
                 type="Oracle.ManagedDataAccess.Client.OracleClientFactory, Oracle.ManagedDataAccess"/>
             <remove invariant="Oracle.ManagedDataAccess.Client"/>
             <add name="ODP.NET, Managed Driver" invariant="Oracle.ManagedDataAccess.Client" description="Oracle Data Provider for .NET, Managed Driver"
-                type="Oracle.ManagedDataAccess.Client.OracleClientFactory, Oracle.ManagedDataAccess, Version=4.121.2.0, Culture=neutral, PublicKeyToken=89b483f429c47342"/>
+                type="Oracle.ManagedDataAccess.Client.OracleClientFactory, Oracle.ManagedDataAccess"/>
         </DbProviderFactories>
     </system.data>
     <startup>
         <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.5"/>
     </startup>
-    <runtime>
-        <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
-            <dependentAssembly>
-                <publisherPolicy apply="no"/>
-                <assemblyIdentity name="Oracle.ManagedDataAccess" publicKeyToken="89b483f429c47342" culture="neutral"/>
-                <bindingRedirect oldVersion="4.121.0.0 - 4.65535.65535.65535" newVersion="4.121.2.0"/>
-            </dependentAssembly>
-        </assemblyBinding>
-    </runtime>
     <oracle.manageddataaccess.client>
         <version number="*">
             <dataSources>

src/NEventStore.Persistence.Sql.Core.sln

@@ -49,6 +49,8 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "docker", "docker", "{C68C81
 EndProject
 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "NEventStore.Serialization.Binary.Core", "..\dependencies\NEventStore\src\NEventStore.Serialization.Binary\NEventStore.Serialization.Binary.Core.csproj", "{F61C5A0D-19AA-A699-E2E6-6707B9455C12}"
 EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "NEventStore.Persistence.Oracle.Core.Tests", "NEventStore.Persistence.Oracle.Tests\NEventStore.Persistence.Oracle.Core.Tests.csproj", "{E9B5C2A0-F241-C417-EFE2-69CC4C1CBB19}"
+EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU
@@ -91,6 +93,10 @@ Global
 		{F61C5A0D-19AA-A699-E2E6-6707B9455C12}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{F61C5A0D-19AA-A699-E2E6-6707B9455C12}.Release|Any CPU.ActiveCfg = Release|Any CPU
 		{F61C5A0D-19AA-A699-E2E6-6707B9455C12}.Release|Any CPU.Build.0 = Release|Any CPU
+		{E9B5C2A0-F241-C417-EFE2-69CC4C1CBB19}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{E9B5C2A0-F241-C417-EFE2-69CC4C1CBB19}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{E9B5C2A0-F241-C417-EFE2-69CC4C1CBB19}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{E9B5C2A0-F241-C417-EFE2-69CC4C1CBB19}.Release|Any CPU.Build.0 = Release|Any CPU
 	EndGlobalSection
 	GlobalSection(SolutionProperties) = preSolution
 		HideSolutionNode = FALSE