Freigeben über


SQL-Abschnitt der Anpassungsdatei

Der SQL-Abschnitt kann eine neue SQL-Zeichenfolge enthalten, die die Clientbefehlszeichenfolge ersetzt. Wenn im Abschnitt keine SQL-Zeichenfolge vorhanden ist, wird der Abschnitt ignoriert.

Wichtig

Ab Windows 8 und Windows Server 2012 sind RDS-Serverkomponenten nicht mehr im Windows-Betriebssystem enthalten (weitere Informationen finden Sie in den jeweiligen Kompatibilitäts-Cookbooks zu Windows 8 und Windows Server 2012). RDS-Clientkomponenten werden in einer zukünftigen Version von Windows entfernt. Nutzen Sie diese Funktionen bei Neuentwicklungen nicht mehr, und planen Sie die Änderung von Anwendungen, die diese Funktion zurzeit verwenden. Anwendungen, die RDS verwenden, sollten zu WCF Data Service migriert werden.

Die neue SQL-Zeichenfolge kann parametrisiert werden. Das bedeutet, dass Parameter im Abschnitt sql der SQL-Zeichenfolge (durch das Zeichen „?“ gekennzeichnet) durch entsprechende Argumente in einem Bezeichner in der Clientbefehlszeichenfolge ersetzt werden können (durch eine durch Komma getrennte Liste in Klammern gekennzeichnet). Die Bezeichner- und Argumentliste verhält sich wie ein Funktionsaufruf.

Angenommen, die Clientbefehlszeichenfolge lautet "CustomerByID(4)", der SQL-Abschnittsheader ist [SQL CustomerByID], und die neue SQL-Abschnittszeichenfolge ist "SELECT * FROM Customers WHERE CustomerID = ?".. Der Handler generiert dann "SELECT * FROM Customers WHERE CustomerID = 4" und verwendet diese Zeichenfolge, um die Datenquelle abzufragen.

Wenn die neue SQL-Anweisung die NULL-Zeichenfolge ("") ist, wird der Abschnitt ignoriert.

Wenn die neue SQL-Anweisungszeichenfolge ungültig ist, ist die Ausführung der Anweisung fehlerhaft. Der Clientparameter wird effektiv ignoriert. Dies kann absichtlich geschehen, um alle SQL-Clientbefehle zu „deaktivieren“, indem Sie Folgendes angeben:

[SQL default]   
SQL = " "  

Syntax

Eine SQL-Zeichenfolge, die als Ersatz dient, weißt folgendes Format auf:

SQL=
sqlString

Teil Beschreibung
SQL Eine Literalzeichenfolge, die angibt, dass dies ein SQL-Abschnittseintrag ist.
sqlString Eine SQL-Zeichenfolge, die die Clientzeichenfolge ersetzt.

Weitere Informationen

Connect-Abschnitt der Anpassungsdatei
Logs-Abschnitt der Anpassungsdatei
UserList-Abschnitt der Anpassungsdatei
DataFactory-Anpassung
Erforderliche Clienteinstellungen
Grundlegendes zu der Anpassungsdatei
Schreiben Ihres eigenen benutzerdefinierten Handlers