Oracle — Oracle Database

Konnektor für Oracle Database. Preview — derzeit nicht für den produktiven Einsatz geeignet.

Preview — nicht produktionsreif

Der Oracle-Konnektor ist als Vorabversion eingestuft und für den produktiven Einsatz derzeit nicht geeignet. Er ist weder freigegeben noch für den Regelbetrieb abgesichert.

Wer eine Oracle-Datenbank anbinden möchte, wendet sich bitte vorab an WYSA — dort wird der konkrete Anwendungsfall geprüft und der aktuelle Stand mitgeteilt.

Der Oracle-Konnektor ist für das Lesen von Daten aus Oracle-Database-Instanzen vorgesehen.

Eigenschaft	Wert
Lesen	⚠️ Preview, nicht produktionsreif
Schreiben	— nicht unterstützt
Job-Filter	✅ wird als `WHERE`-Klausel übernommen
Status	Preview

Wie beim MSSQL-Konnektor wird der Inhalt des Feldes Filter am Job — nach Ersetzung des Platzhalters %watermark% — wörtlich hinter WHERE eingesetzt. Ohne Eintrag im Feld Filter entsteht keine WHERE-Klausel und der Job liest bei jedem Lauf die vollständige Tabelle. Der Ausdruck muss gültiges PL/SQL sein; es findet keine Parametrisierung statt. Details zur Filter-Syntax siehe MSSQL — Filter.

Schreiben wird nicht unterstützt

Ein Oracle-System als TargetConnection führt zur Laufzeit zu einem Abbruch. Auch das Löschen von Datensätzen ist nicht implementiert.

Verbindungsparameter

{
  "connectionstring": "<Oracle Connection String>"
}

Beispiel (TNS):

Data Source=<tns-alias>;User Id=<user>;Password=<password>;

Beispiel (Easy Connect):

Data Source=<server>:<port>/<service>;User Id=<user>;Password=<password>;

Optionale Parameter

Parameter	Standardwert	Beschreibung
`commandTimeOut`	`30`	Zeitlimit für einzelne SQL-Befehle in Sekunden
`maxPageSize`	`5000`	Anzahl Datensätze je Seite
`language`	`de-DE`	Kultur, in der gelesene Zahlen- und Datumswerte formatiert werden
`keyVaultUrl`	(leer)	Key-Vault-Secret-URL; ersetzt sämtliche übrigen Parameter

Tabellen- und Feldnamen

Einstellung	Wert
SourceTable	Tabellenname, ggf. mit Schema-Präfix (`SCHEMA.TABLENAME`)
SourceField	Spaltenname, wie in Oracle definiert (üblicherweise Großbuchstaben)

Änderungserkennung (Watermark)

Eigenschaft	Wert
WatermarkType	`date` oder `datetime`
WatermarkField	Name der Zeitstempel-Spalte

Die Spalte aus WatermarkField wird zusätzlich zu den gemappten Feldern abgefragt und für die Sortierung verwendet.

Empfehlung: echtes Datum als Watermark-Spalte

Geeignet sind DATE und TIMESTAMP — der Wert wird dann als ISO-Zeitstempel weitergereicht. Eine Spalte anderen Typs, etwa NUMBER, führt nicht mehr zu einem Abbruch, wird aber unverändert über ToString() weitergegeben.

Datentypen — gelesene Werte

Da Schreiben nicht unterstützt wird, ist allein der Lesepfad relevant. Der Typ ergibt sich aus dem ADO.NET-Spaltentyp; der so ermittelte Typname wird zusammen mit dem formatierten Wert an den Zielkonnektor weitergereicht und dort für die Auswahl der Umwandlung verwendet.

ADO.NET-Spaltentyp	Weitergegebener Typ	Formatierung des Wertes
`Int32`	`int32`	Wird als Ganzzahl gelesen und in der Kultur aus `language` ausgegeben
`Decimal`	`decimal`	Wird als Dezimalzahl gelesen und in der Kultur aus `language` ausgegeben
`Double`	`double`	Wie `Decimal` — Umwandlung über einen Dezimalwert
`DateTime`	`datetime`	Format `u`, also `yyyy-MM-dd HH:mm:ssZ`
alle übrigen	Name des .NET-Typs (z. B. `string`, `boolean`, `guid`)	Unveränderte Textdarstellung

Oracle liefert Zahlen häufig als NUMBER

Oracle bildet NUMBER je nach Präzision auf unterschiedliche .NET-Typen ab. Welcher Typ tatsächlich weitergegeben wird, ist daher vom Spaltenaufbau abhängig und im Einzelfall zu prüfen.

Welche Quelltypen ein Zielsystem akzeptiert, steht auf der jeweiligen Zielkonnektor-Seite: D365BC, D365CE, D365NAV.