Der OleDB Adapter wird zum importieren (Insert), exportieren (Select) bzw. aktualisieren (Update) von Tabellen aus beliebigen OleDB Datenquellen verwendet. Der Adapter kann sowohl auf der READ (Export) als auch auf der WRITE (Import) Seite vorkommen. Einzige Voraussetzung ist ein für Ihre Datenquelle installierter OleDB Treiber.
Achtung: 32 Bit oder 64 Bit Version? Je nachdem welche OleDB Treiber (32 Bit / 64 Bit) bei Ihnen auf dem System installiert sind müssen Sie zur Anbindung an die OleDB Datenquelle die passende FlowHeater Variante einsetzen. Die FlowHeater 64 Bit Version kann nicht mit 32 Bit OleDB Treibern umgehen und umgekehrt. Falls eine Fehlermeldung bzgl. nicht installierten bzw. vorhandenen OleDB Treiber erscheint, versuchen Sie einfach einmal die jeweilig andere FlowHeater Version (32 Bit /64 Bit) zu verwenden. Es können problemlos beide FlowHeater Varianten parallele auf einem Rechner installiert werden.
Reiter Allgemein
Anmeldeinformationen
OleDB Adapter - Datenquelle konfigurierenOleDB Datenquelle: Hier geben Sie den OleDB Connectionstring an um auf Ihre gewünschte Datenquelle zugreifen zu können. Mit dem Connection String
Provider=Microsoft.Jet.OLEDB.4.0; Data Source=C:\Verzeichnis; Extended Properties=dBASE IV; User;Password=;
können Sie z.B. auf dBASE (dbf) IV Datenbank Dateien im Ordner C:Verzeichnis zugreifen.
Beispiele über verschiedene Connectionstrings/Datenquellen können Sie sich hier ansehen.
http://www.connectionstrings.com/
User/Passwort: Falls Ihre OleDB Datenquelle Benutzer und/oder Passwort für eine evtl. Authentifizierung benötigt, können Sie diese hier eintragen. Das Passwort wird dabei verschlüsselt abgespeichert. Im Connection String müssen Sie dann nur den Platzhalter $USER bzw. $PASSWORD verwenden.
z.B.
…User ID=$USER; Password=$PASSWORD
Der OleDB Adapter ersetzt dann diese Platzhalter mit den hier eingegebenen werten.
Wichtig: Das Passwort wird nur gespeichert, wenn die Option "Save Passwort" aktiviert wurde. Soll das Passwort gespeichert werden, wird dies verschlüsselt in der Definitionsdatei hinterlegt.
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!
Daten aktualisieren (Update): Ist diese Option aktiv werden Update SQL Statements generiert. Hinweis: Sind die Optionen Insert und Update beide aktiv, prüft der OleDB 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 OleDB 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 FlowHeater an die Änderungen (Insert, Update) als SQL Skript Datei unter den angegebenen Namen bzw. Pfad zu speichern.
Reiter Felder / Datentypen
OleDB 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 SQL Statements in der Textbox zu erfassen. Die Syntax muss der der gewählten OleDB Datenquelle entsprechen.
In der zweiten Combobox werden automatisch die vorhandenen Tabellen, 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 OleDB Datenquelle gelesen. Die Felder werden dann in die links stehende Feldliste eingetragen. Datentypen die vom OleDB 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 angehakt) oder einfach gelöscht werden.
Feldeigenschaften: Hiermit steuern Sie welche Felder der OleDB 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
OleDB Adapter - weitere EinstellungenLeerzeichen 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 die OleDB Datenquelle 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 OleDB 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 SQL 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 zur OleDB Datenquelle, zur weiteren Initialisierung der Verbindung, verwendet werden.
Reiter Format
Der Reiter Format wird im allgemeinen Kapitel für Adapter genauer beschrieben.
Folgende Beispiele stehen für den OleDB Adapter zur Verfügung
