Abschnitt zur SQL-Schnittstelle

Implementierungshandbuch › Eigenschaften der Adapterkonfiguration › Abschnitt zur SQL-Schnittstelle

Abschnitt zur SQL-Schnittstelle

Mit SQL-Adaptern können Sie Daten mittels SQL-Anweisung von einer Datenbank abrufen.

Die SQL-Schnittstelle legt die Verbindung zur Datenbank und die Abfragen fest, die zum Abrufen der Daten verwendet werden:

XML-Struktur:

	< DataSourceInterface >
		<ConnectionString ConnectionTimeout="60" QueryTimeout="30">
			<![CDATA[ Driver={Microsoft Access Driver (*.mDataBase)};DataBaseq=d:\Oblicore\database1.mdatabase; ]]>
			</ConnectionString>
		<QueryCollection>
		<Query QueryName="cases" InputFormat="cases" SleepTime="3600">
			<SelectStatement AutoCompleteQuery="yes">
			select dateclosed,callid,dateopened,companyname,priority,closedmn,responsemn
			from calls where dateclosed is not NULL
			</SelectStatement>
		<QueryKeyFields>
			<KeyField Name="dateclosed" Sort="asc"/>
			<KeyField Name="callid" Sort="desc"/>
			<SelectInitialValues>
				Select min(dateclosed) , 'min date' from calls
			</SelectInitialValues>
		</QueryKeyFields>
	</Query>
	<Query QueryName="contracts" InputFormat="contracts" SleepTime="3600">
	<ConnectionString>
		<Segment Type="text"
		Text=" Driver={Microsoft Excel Driver (*.xls)}; DriverId=790; DataBaseq="/>
		<Segment Type="File">
		<File Path="d:\Oblicore " NamePattern="Availabilty_*.XLS>
		</Segment>
		<Segment Type="text" Text=";"/>
	</ConnectionString>
<SelectStatement AutoCompleteQuery="yes">….</SelectStatement>
<QueryKeyFields>…..</QueryKeyFields>
</Query>
</QueryCollection>
</DataSourceInterface>

ConnectionString: Verbindungsstring, mit dem auf die Quelldatenbank zugegriffen werden kann.
"ConnectionString" kann im Element "DataSourceInterface" und/oder in den Query-Elementen definiert werden. Die "ConnectionString"-Definition wird standardmäßig im Element "DataSourceInterface" festgelegt und nur bei einer Abfrage ohne eine "ConnectionString"-Definition verwendet.

Er kann in einem String oder segmentweise angelegt werden. Wenn das Element "ConnectionString" keine Segmentelemente enthält, wird der Verbindungsstring aus dem "ConnectionString"-Elementtext entnommen. Enthält es wenigstens ein Segmentelement, wird der Verbindungsstring daraus genommen.

Es gibt zwei Segmenttypen. Der eine Typ ist Text und enthält Text, der als solches mit dem Verbindungsstring verknüpft ist. Der zweite Typ ist eine Datei und enthält einen Dateinamen mit oder ohne Platzhalter. Das Dateisegment kann nur einmal verwendet werden. Es enthält andere Attribute, die die Vorgehensweise bezüglich der Lesedatei definieren.
- ConnectionTimeout: optional. Positiver ganzzahliger Wert, der angibt, wie lange in Sekunden bis zum Öffnen der Verbindung gewartet werden soll. Der Wert 0 bedeutet, unendlich lange zu warten, bis die Verbindung geöffnet wird. Der Standardwert ist 15 Sekunden.
Hinweis: Einige Anbieter unterstützen diese Funktionalität nicht.
- QueryTimeout: optional. Positiver ganzzahliger Wert, der angibt, wie lange in Sekunden bis zum Ausführen der Abfrage gewartet werden soll. Der Wert 0 bedeutet, dass bis zum Abschluss der Ausführung unendlich lange gewartet werden soll. Der Standardwert ist 30 Sekunden.
Hinweis: Einige Anbieter unterstützen diese Funktionalität nicht.
- Segment: Gibt die Segmentattribute an.
- Type: optional (text, file), Segmenttyp
- Text: Text des Textsegments.
- File: Gibt die Dateiattribute an.
- Path: Pfad zum Speicherort der Quelldatendateien.
- NamePattern: Gibt den Datenquelldateinamen an, Verwendung von Platzhaltern möglich.
- InitialFileName: optional. Gibt dem Anbieter an, bei welcher Datei die Suche gestartet werden soll und nach welchem Muster gesucht werden soll.
- UsePath: optional [yes, no]. Wenn Sie "yes" wählen, wird der Dateipfad an den Verbindungsstring angehängt.
- UseFileName: optional [yes/no]. Wenn Sie "yes" wählen, wird der Dateiname an den Verbindungsstring angehängt (erforderlich für Excel-Dateien).
- UpdateSchemaFile: optional [yes/no]. Wird der Wert auf "yes" gesetzt, aktualisiert der Adapter die Datei "schema.ini" mit dem aktuellen Dateinamen.
Hinweis: Verwenden Sie dieses Attribut nur, wenn der Adapter die Datei "schema.ini" ändern soll (Datenbank für Textdateien).
QueryCollection: Abfragesammlung (In einem Adapter kann mehr als eine Abfrage angegeben werden.)
- PreliminaryCheck-: (optional [ja/nein]). Der Adapter überprüft die Abfragen, wenn er eine Verbindung zur Datenbank herstellt. Wenn für dieses Attribut "no" gewählt wird, prüft der Adapter die Abfragen, indem er sie ohne Änderung ausführt. Der Adapter wird später für die Rückgabe-Datensätze ausgeführt, die er nicht mehr liest. Wenn "yes" gewählt wird, ersetzt der Adapter jeden "where"-String in der Select-Anweisung durch "where 1=2 and". Erst dann werden die Abfragen ausgeführt. Verwenden Sie diese Option, um alle Abfragen zu prüfen, bevor der Adapter die Datensätze durchläuft und wenn dieser Zusatz die Abfragezeit erheblich verkürzt. Hinweis: Einige Anbieter optimieren den Abfrageprozess nicht. Bei einer zulässigen Abfrage erfordert die Ausführung genau so viel Zeit wie ohne den Zusatz.
- ExternalCommand: optional. Externer Befehl, der ausgeführt wird, bevor der Adapter einen neuen Lesezyklus startet.
- Command: Name der Batch-Datei, die ausgeführt werden soll.
- SleepTime: Positiver ganzzahliger Wert, der angibt, wie lange in Sekunden bis zur Ausführung der Abfrage gewartet werden soll.
Query: Gibt die Abfrageattribute an.
- QueryName: Name für die Abfrage.
- IsActive: optional [yes/no] "no": Der Adapter liest keine Datensätze aus dieser Datei.
- InputFormat: Das mit dieser Abfrage verknüpfte Eingabeformat. Der Adapter verwendet "InputFormat", um die Daten aus dem Quelldatensatz zu extrahieren.
- SleepTime: Zeit in Sekunden, in der der Adapter herunterfährt, um auf neue Daten zu warten.
- Critical: optional [yes/no]. "yes": Der Adapter wird angehalten, wenn er einen Fehler in der Abfrage identifiziert. "no": Wählen Sie diese Einstellung, wenn der Fehler bekannt ist und ohne Ändern der Konfigurationsdatei gelöst wird.
- TransactionMode: optional [implicit/explicit]. "explicit": Der Adapter initiiert vor der Abfrage eine Datenbanktransaktion. Diese Option löst verschiedene Probleme im Zusammenhang mit umfangreichen und komplizierten Abfragen.
- RollbackSegementName: optional. Definiert, welches Rollback-Segment der Adapter verwendet. Andernfalls wählt die Datenbank das Rollback-Segment.
SelectStatement: Enthält eine ausgewählte Anweisung, die auf der Quelldatenbank ausgeführt werden muss.
- AutoCompleteQuery: optional [yes/no]. Wenn diese Option auf "yes" gesetzt wurde, verknüpft der Adapter automatisch wie folgt eine Where-Anweisung mit der gewählten Abfrage:
- Erstellt eine Where-Anweisung, die nur neue Werte basierend auf den Schlüsselfeldern abruft.
- Fordert die auf den Schlüsselfeldern basierte Ergebnisanweisung an.
Abfrageschlüsselfelder - Definiert die Felder, um den weitern Datenabruf zu starten:
- KeyField:
- Name - Name des Feldes, von den Abfragefeldern übernommenen.
- Sort - (optional) [auf/ab]. Daten-Sortierverfahren (aufsteigend/absteigend).
- Funktion - (optional). Verwenden Sie dieses Attribut, wenn eine Sonderfunktion auf dieses Feld angewendet werden soll, zum Kombinieren vom Feldwert in der Funktion mit (:fieldname). Zum Beispiel die Verwendung der Oracle-Datumsfunktion mit einem Feldnamen: Ts-Function="to_date(':ts','dd/mm/yyy')"
- ValueLeftWrapper - (optional). Verwenden Sie dieses Attribut, um Zeichen vor dem Wert des Feldes zu verketten. Der Standard für die Zeichenfolge und Datumsfelder ist"'" (Apostroph).
- ValueRightWrapper - (optional). Verwenden Sie dieses Attribut, um nach dem Wert des Feldes Zeichen zu verketten. Der Standard für die Zeichenfolge und Datumsfelder ist"'" (Apostroph).
- NameLeftWrapper - (optional). Verwenden Sie dieses Attribut, um Zeichen vor dem Namen des Feldes zu verketten. Der Standard ist Null-String.
- NameRightWrapper - (optional). Verwenden Sie dieses Attribut, um nach dem Namen des Feldes Zeichen zu verketten. Der Standard ist Null-String.
- IsPrimaryKey - (optional) [yes/no]. Wenn auf "no" festgelegt, wird dieser Schlüssel vom Adapter nicht in der automatischen WHERE-Anweisung in der Abfrage verwendet.
- DefaultInitialValue - (optional). Wenn die SelectInitialValues-Abfrage Datensätze nicht zurückgibt, übernimmt der Adapter den Standard von hier. Wenn es einige Schlüsselfelder gibt, müssen alle Schlüsselfelder dieses Attribut haben.
- SelectInitialValues - Eine Select-Anweisung, die die Initialwerte für die erste Where-Anweisung liefert (bei leerer Steuerungsdatei).
Hinweis: Die Reihenfolge der Werte muss dieselbe wie diejenige der Feld-Elemente für dieses QueryKeyFields-Element sein und für jedes Feld ein Ergebnis zurückgeben.