Der Oracle Adapter wird zum importieren (Insert), exportieren (Select) bzw. aktualisieren (Update) von Tabellen eines Oracle Datenbank Servers verwendet. Der Adapter kann sowohl auf der READ (Export) als auch auf der WRITE (Import) Seite vorkommen. Unterstützt werden Oracle Datenbanken ab Version 7.3 bis Oracle 21c.
Unterstützte Oracle Datenbank Versionen: 7.3, 8, 8i, 9i, 10g, 11g, 12c, 18c, 19c, 21c
Reiter Allgemein
Anmeldeinformationen
Oracle Adapter - Datenbank auswählenVerbindungsmodus: Hier können Sie zwischen "Oracle TNS Names" oder "Direktverbindungen" auswählen. Haben Sie TNS Names ausgewählt, muss die unten eingegebene Datenbank Name in der tnsnames.ora Datei vorhanden sein! Hinweis: Im „Direkt“ Verbindungsmodus ist keine Installation bzw. Konfiguration von Oracle Client Treibern auf dem Computer notwendig. Der FlowHeater liefert alles mit um auf die Oracle Datenbank zugreifen zu können. Im „TSN Names“ Verbindungsmodus ist ein installierter Oracle Client inkl. funktionierender Konfiguration notwendig!
Datenbank oder TNS: hierrüber wird angegeben mit welcher Oracle Datenbank der FlowHeater sich verbinden soll.
Schema: Standardmäßig verwendet der Oracle Adapter das Schema des Benutzers/Users mit dem die Anmeldung an der Datenbank erfolgt. Ist das Feld hier gesetzt werden in der Tabellen/View Auswahl nur Objekte angezeigt die mit diesem Schema übereinstimmen. Möchten Sie alle Oracle Datenbankobjekte angezeigt bekommen, brauchen Sie nur den Inhalt dieses Feldes leeren.
Authentifizierung: entweder Windows (trusted connection) oder Oracle. Hiermit bestimmen Sie wie der FlowHeater sich an der Oracle Datenbank anmelden soll. Dabei bedeuten
- Oracle = der FlowHeater meldet sich mit einem Oracle Benutzer und Passwort an der Datenbank an.
- Windows (vertraute Verbindung) = Die Anmeldung am Oracle Datenbankserver wird mit dem aktuell angemeldeten Windows Benutzer (Single Sign-on) durchgeführt. In diesem Fall ist keine Angabe von Benutzer und Passwort notwendig. Diese Option ist nur verfügbar wenn für den „Verbindungmodus“ der Eintrag „TNS Names“ aktiviert wurde!
User / Passwort: wurde bei der Authentifizierung "Oracle" ausgewählt, müssen Sie hier den Oracle Datenbank Benutzer sowie das zugehörige Passwort angeben. Wichtig: Das Passwort wird nur gespeichert, wenn das Häkchen bei "Save Passwort" gesetzt wurde. Soll das Passwort gespeichert werden, wird dies verschlüsselt in der Definitionsdatei hinterlegt.
Server / Port: Haben Sie oben beim Verbindungsmodus Direktverbindung ausgewählt, müssen Sie hier den Server (DNS oder IP) sowie eine TCP/IP Port Adresse angeben. Der FlowHeater versucht dann den Oracle Listener bzw. die Datenbank über diese Einstellungen zu erreichen.
Allgemein
Daten anfügen (Insert): Ist diese Option aktiv, werden Insert SQL Statements generiert
Vorhandene Datensätze ignorieren: Hiermit werden beim Import, bereits vorhandene Datensätze in der Tabelle ignoriert!
Tabelle vor dem Import leeren: Hiermit teilen Sie dem Oracle Adapter mit, den Inhalt der Tabelle vor dem ausführen der Definition zu leeren bzw. zu löschen.
Daten aktualisieren (Update): Ist diese Option aktiv werden Update SQL Statements generiert. Hinweis: Sind die Optionen Insert und Update beide aktiv, prüft der Oracle Adapter anhand des PrimaryKeys ob für den jeweiligen Datensatz eine Insert oder Update SQL (Skript) Anweisung erzeugt werden muss. Wenn Sie nur Daten hinzufügen wollen, deaktivieren Sie in jedem Fall die Update Option, der Import wird dann wesentlich schneller durchgeführt!
Datensätze löschen (Delete): Hiermit wird versucht anhand der gemachten Schlüssel „Primary Key“ angaben vorhandene Datensätze zu löschen. Hinweis: Diese Option kann nicht zusammen mit den Optionen INSERT oder UPDATE verwendet werden.
Keine Daten ändern oder hinzufügen nur SQL Skript generieren: Hiermit weisen Sie den Oracle Adapter an keine Änderungen auf der Datenbank vorzunehmen, es wird lediglich ein SQL Skript mit den Insert und/oder Update Anweisungen gespeichert. Ist diese Option aktiv müssen Sie weiter unten einen Dateinamen angeben, in dem die generierten SQL Statements gespeichert werden sollen.
SQL Skript generieren: Hiermit weisen Sie den Oracle Adapter an die Änderungen (Insert, Update) als SQL Skript Datei unter den angegebenen Namen bzw. Pfad zu speichern.
Reiter Felder / Datentypen
Oracle Adapter - Feldnamen und DatentypenSQL: Je nachdem auf welcher Seite der Adapter gerade verwendet wird, stehen hier folgende Varianten zur Verfügung:
Auf der READ Seite: hier können Sie aus Tables Views auswählen.
Auf der WRITE Seite: hier steht nur Tables zur Verfügung.
Auf der READ Seite haben Sie zusätzlich die Möglichkeit Komplexe PL/SQL Statements in der Textbox zu erfassen.
In der zweiten Combobox werden automatisch die vorhandenen Tabellen bzw. Views aufgelistet, die in der angegeben Datenbank verfügbar sind.
Felder Einlesen: Mit diesem Button werden die Schemainformationen (Feldnamen, Feldgrößen, Datentyp, PrimaryKey, etc.) zu dem oben angegeben SQL Statement aus der Oracle Datenbank gelesen. Die Felder werden dann in die links stehende Feldliste eingetragen. Datentypen die vom Oracle Adapter noch nicht unterstütz werden, werden in der Feldliste als nicht Aktiv angezeigt.
Hinweis: Die Felder können in der Feldliste in beliebiger Reihenfolge angeordnet werden. Nicht benötigte Felder können hier entweder ausgeblendet (nicht markiert) oder einfach gelöscht werden.
Feldeigenschaften: Hiermit steuern Sie welche Felder der Oracle Adapter als Primary Key bzw. Auto Increment Felder interpretieren soll. Die Informationen werden nur auf der Write Seite benötigt. Im Normalfall müssen Sie hier keine Änderungen vornehmen, die Informationen werden beim Einlesen der Schemainformationen bereits richtig eingetragen!
PrimaryKey Felder werden für Updates verwendet um einen evtl. bereits vorhandenen Datensatz zu identifizieren.
Auto Increment Felder werden bei Insert/Updates nicht gesetzt bzw. geändert!
Achtung: Wenn Sie hier Änderungen vornehmen, kann es sein, dass beim Update mehr als ein Datensatz geändert wird!
Der Reiter Erweitert
Oracle Adapter - weitere OptionenLeerzeichen automatisch am Anfang und Ende des Inhaltes entfernen: Wenn Sie diese Option aktivieren wird auf Felder vom Datentyp String ein Auto Trim von sog. „Whitespace“ Zeichen durchgeführt. Dies bedeutet, das vorkommende Leerzeichen, Tabulatoren und Zeilenumbrüche automatisch am Anfang und Ende einer Zeichenfolge entfernt werden.
Verwende TRUNCATE TABLE (= schneller) anstatt DELETE FROM: Wurde auf dem Reiter Allgemein die Option „Tabelle vor dem Import leeren aktiviert“ wird wenn Sie diese Option aktivieren ein „TRUNCATE TABLE“ anstatt eines „DELETE FROM“ (=Standard) zum Leeren des Tabelleninhaltes verwendet.
Connection Timeout: Timeout in Sekunden bis auf den Verbindungsaufbau gewartet wird. Konnte die Verbindung in dieser Zeitspanne nicht aufgebaut werden wird der Import/Export Vorgang abgerochen.
Command Timeout: Timeout in Sekunden die auf die Ausführung eines SQL Befehl gewartet wird. Mit dem Wert 0 können Sie diesen Timeout deaktivieren. In dem Fall wird dann unendlich auf die Ausführung des SQL Befehls gewartet. Diese Option ist Interessant wenn Sie für den Export auf der READ Seite große Datenmengen abfragen und der Oracle Datenbankserver sehr lange benötigt um die Daten aufzubereiten.
Verwende Datenbank Transaktionen: Hiermit können Sie steuern wie die Daten importiert werden sollen. In den Standardeinstellungen verwendet der Oracle Adapter eine „große“ Transaktion um den Importvorgang abzusichern. Bei sehr großen zu importierenden Datenmengen kann es vorkommen, dass Sie über die Option „AutoCommit ausführen nach X geschriebenen Datensätzen“ das Transaktionsverhalten an Ihre Bedürfnisse anpassen.
Verwende UNICODE Zeichenfolgen: Mit dieser Option wird an Zeichenketten beim Import vor den Hochkommas das Präfix vorangestellt. Z.B. N’import wert‘ anstatt nur ‘import wert‘.
Verarbeitung fortsetzen falls ein SQL Fehler auftritt: Hiermit können Sie den FlowHeater veranlassen, dass die Verarbeitung auch bei auftretenden Oracle Datenbank Fehlern, nicht abgebrochen wird. Achtung: Diese Option nur in Ausnahmefällen verwenden, es könnten dadurch Dateninkonsistenzen entstehen!
Verbindung vorbereiten
Benutzerdefiniert SQL Anweisungen zum Initialisieren der Verbindung: Hier können Sie beliebige Benutzerdefinierte SQL Befehle platzieren, die nach einem Verbindungsaufbau zum Oracle Server, zur weiteren Initialisierung der Verbindung, verwendet werden.
Der Reiter Format
Der Reiter Format wird im allgemeinen Kapitel für Adapter genauer beschrieben.
Oracle® ist ein eingetragenes Markenzeichen der Oracle® Corporation
