Dynamischer Daten Import / Export

datenbank

weil Einfach - produktiver ist
Mit der Freeware Version können bis zu 10.000 Datensätze verarbeitet werden!

SQL Server Adapter

Der MS Sql Server Adapter wird zum importieren (Insert), exportieren (Select) bzw. aktualisieren (Update) von Tabellen eines Microsoft SQL Datenbank Servers verwendet. Der Adapter kann sowohl auf der READ (Export) als auch auf der WRITE (Import) Seite vorkommen. Unterstützt werden die SQLServer Versionen ab SQL Server 7.0 bis SQL Server 2016.

Reiter Allgemein

Anmeldeinformationen

MS-SQL Server und Datenbank auswählenMS-SQL Server und Datenbank auswählenServername bzw. IP: hierrüber wird angegeben mit welchem SQL Server der FlowHeater sich verbinden soll und welcher Authentifizierungsmechanismus dabei verwendet werden soll. Als Servername kann sowohl ein DNS Name wie auch eine IP-Adresse verwendet werden. Optional kann zusätzlich noch ein Instanzname (ab SQL Server Version 2000) mit angegeben werden. Wird eine Instanz angegeben muss dies im Format

       Servername/Instanzname

eingetragen werden.

Datenbank: Angabe des Namens der SQL Server Datenbank auf die zugegriffen werden soll. Im Kombinationsfeld werden automatisch alle verfügbaren Datenbanken aufgelistet die auf dem angegebenen SQL Server verfügbar sind.

Authentifizierung: entweder Windows (trusted connection) oder SQL Server. Hiermit bestimmen Sie wie der FlowHeater sich am SQL Server anmelden soll. Dabei bedeuten:

  1. trusted connection = der FlowHeater meldet sich mit dem aktuell angemeldeten Benutzer an der SQL Server Datenbank an.
  2. SQL Server = der FlowHeater meldet sich mit einem SQL Benutzer und Passwort an der SQL Server Datenbank an.

User / Passwort: wurde bei der Authentifizierung "SQL Server" ausgewählt, müssen Sie hier den SQL 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.

 

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 SqlServer 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 SqlServer 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!

Keine Daten ändern oder hinzufügen nur SQL Skript generieren: Hiermit weisen Sie den SqlServer 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 SqlServer Adapter an die Änderungen (Insert, Update) als SQL Skript Datei unter den angegebenen Namen bzw. Pfad zu speichern.

Reiter Felder / Datentypen

SQL: SQL Server Feldnamen und Datentypen angebenSQL Server Feldnamen und Datentypen angebenJe 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 und Procedures 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.

In der zweiten Combobox werden automatisch die vorhandenen Tabellen, Views bzw. Prozeduren 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 Datenbank gelesen. Die Felder werden dann in die links stehende Feldliste eingetragen. Datentypen die vom SqlServer 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 angehackt) oder einfach gelöscht werden.

Feldeigenschaften: Hiermit steuern Sie welche Felder der SqlServer 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!

Reiter Erweitert

Allgemein

Weitere SQL Server 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 vorkommente 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 SQL Server 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 SQL Server 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 N 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!

Spezielle Adapter Einstellungen

Erlaube Auto Inkrement (IDENTITY) Inserts: Wenn Sie diese Option aktivieren wird es ermöglicht vorgegebene Werte für SQL Auto Inkrement Felder zu importieren. Achtung: In diesem Fall müssen Sie auf dem Reiter „Felder / Datentypen“ für das betroffene Feld den Haken für „Auto Inkrement“ Deaktivieren!

 

Der Reiter Format

Der Reiter Format wird im allgemeinen Kapitel für Adapter genauer beschrieben.

 

Folgende Beispiele sind zum SqlServer Adapter bereits verfügbar