MS SQLServer Adapter

Der SqlServer 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: 7.0, 2000, 2005, MSDE, SQL 2005 Express Edition, 2008 sowie SQL 2008 Express Edition.


MS SQL Server und Datenbank auswählen

Reiter Allgemein


Anmeldeinformationen

Servername 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.



 
Feldnamen und Datentypen angeben

Der Reiter Felder / Datentypen

SQL: 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 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!



 
Derzeit werden folgende Datentypen unterstützt
  • bigint, wird intern als Double (mit Nachkommastellen) verarbeitet!
  • bit
  • char (x)
  • datetime
  • decimal
  • float
  • int
  • money
  • nchar (x)
  • ntext
  • numeric
  • nvarchar (x)
  • real
  • smaldatetime
  • smalint
  • smalmoney
  • sql_variant (eingeschränkt, lediglich die hier aufgeführten typen)
  • text
  • tinyint
  • uniqueidentifier
  • varchar (x)
  • xml (es findet keine XML Prüfung statt)

Nicht unterstützte Datentypen (daran wird noch gearbeitet)
  • binary (x)
  • image
  • timestamp

Der Reiter Format

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


Folgende Beispiele sind zum SqlServer Adapter bereits verfügbar

Copyright © 2009-2010 by FlowHeater GmbH. Alle Rechte vorbehalten.