Nachrichtenschemas für die Vorgänge „ExecuteNonQuery“, „ExecuteReader“ und „ExecuteScalar“
Der Microsoft BizTalk-Adapter für SQL Server macht die ausgehenden Vorgänge ExecuteNonQuery, ExecuteReader und ExecuteScalar auf Stammebene verfügbar, um beliebige SQL-Anweisungen in SQL Server auszuführen.
Weitere Informationen:
Diese Vorgänge finden Sie unter Unterstützung für ExecuteNonQuery, ExecuteReader und ExecuteScalar-Vorgänge.
Ausführen dieser Vorgänge mithilfe des SQL-Adapters finden Sie unter ExecuteReader, ExecuteScalar oder ExecuteNonQuery-Vorgänge in SQL mit BizTalk Server.
Nachrichtenstruktur für die Vorgänge ExecuteNonQuery, ExecuteReader und ExecuteScalar
Die Nachrichten in diesen Vorgängen folgen einem Anforderungs-Antwort-Nachrichtenaustauschmuster, und die folgende Tabelle zeigt die Struktur dieser Anforderungs- und Antwortnachrichten.
| Vorgang | XML-Nachricht | BESCHREIBUNG |
|---|---|---|
| ExecuteNonQuery-Anforderung | <ExecuteNonQuery xmlns="http://schemas.microsoft.com/Sql/2008/05/GenericTableOp/"> <Query>[PL/SQL STATEMENT1];[PL/SQL STATEMENT2];…</Query> </ExecuteNonQuery> |
Innerhalb des <Query> Tags können Sie mehrere PL/SQL-Anweisungen angeben, die durch ein Semikolon getrennt sind. |
| ExecuteNonQuery Response | <?xml version="1.0" encoding="utf-8" ?> <ExecuteNonQueryResponse xmlns="http://schemas.microsoft.com/Sql/2008/05/GenericTableOp/"> <ExecuteNonQueryResult>[value]</ExecuteNonQueryResult> </ExecuteNonQueryResponse> |
Für die UPDATE-, INSERT- und DELETE-Anweisungen stellt die Anzahl der Zeilen dar, [value] die von den PL/SQL-Anweisungen in der ExecuteNonQuery-Anforderungsnachricht betroffen sind. Für alle anderen Typen von Anweisungen [value] ist -1. |
| ExecuteReader-Anforderung | <ExecuteReader xmlns="http://schemas.microsoft.com/Sql/2008/05/GenericTableOp/"> <Query>[PL/SQL STATEMENT1];[PL/SQL STATEMENT2];…</Query> </ExecuteReader> |
Innerhalb des <Query> Tags können Sie mehrere PL/SQL-Anweisungen angeben, die durch ein Semikolon getrennt sind. |
| ExecuteReader-Antwort | <?xml version="1.0" encoding="utf-8" ?> <ExecuteReaderResponse xmlns="http://schemas.microsoft.com/Sql/2008/05/GenericTableOp/"> <ExecuteReaderResult> <DataSet> <Any>[value]</Any> <Any>[value]</Any> … </DataSet> </ExecuteReaderResult> </ExecuteReaderResponse> |
Das Resultset ist die Antwortnachricht der PL/SQL-Anweisungen, die in der ExecuteReader-Anforderungsnachricht ausgeführt werden, und wird als Array von DataSet zurückgegeben. Informationen zu DataSet finden Sie unter "DataSet-Klasse" unter https://go.microsoft.com/fwlink/?LinkID=196853. |
| ExecuteScalar Request | <ExecuteScalar xmlns="http://schemas.microsoft.com/Sql/2008/05/GenericTableOp/"> <Query>[PL/SQL STATEMENT1];[PL/SQL STATEMENT2];…</Query> </ExecuteScalar> |
Innerhalb des <Query> Tags können Sie mehrere PL/SQL-Anweisungen angeben, die durch ein Semikolon getrennt sind. |
| ExecuteScalar Response | <?xml version="1.0" encoding="utf-8" ?> <ExecuteScalarResponse xmlns="http://schemas.microsoft.com/Sql/2008/05/GenericTableOp/"> <ExecuteScalarResult>[value]</ExecuteScalarResult> </ExecuteScalarResponse> |
Stellt [value] den Wert in der ersten Spalte der ersten Zeile im Resultset dar, der von den PL/SQL-Anweisungen in der ExecuteScalar Request-Nachricht zurückgegeben wird. |
[PL/SQL-ANWEISUNG] = Die gesamte auszuführende PL/SQL-Anweisung.
Nachrichtenaktion für die ExecuteNonQuery-, ExecuteReader- und ExecuteScalar-Vorgänge
Die folgende Tabelle zeigt die Nachrichtenaktionen, die von den Vorgängen ExecuteNonQuery, ExecuteReader und ExecuteScalar verwendet werden.
| Vorgang | Aktion |
|---|---|
| ExecuteNonQuery-Anforderung | GenericOp/ExecuteNonQuery |
| ExecuteNonQuery Response | GenericOp/ExecuteNonQuery/response |
| ExecuteReader-Anforderung | GenericOp/ExecuteReader |
| ExecuteReader-Antwort | GenericOp/ExecuteReader/response |
| ExecuteScalar Request | GenericOp/ExecuteScalar |
| ExecuteScalar Response | GenericOp/ExecuteScalar/response |
Weitere Informationen
Nachrichten- und Nachrichtenschemas für Den BizTalk-Adapter für SQL Server