ExecuteNonQuery、ExecuteReader 和 ExecuteScalar 作業的訊息結構描述
Microsoft BizTalk Adapter for SQL Server會公開根層級的 ExecuteNonQuery、ExecuteReader 和 ExecuteScalar 輸出作業，以在 SQL Server 中執行任何任意 SQL 語句。
如需下列詳細資訊︰
這些作業請參閱 ExecuteNonQuery、ExecuteReader 和 ExecuteScalar 作業的支援。
使用 SQL 配接器執行這些作業，請參閱使用 BizTalk Server 在 SQL 中執行 ExecuteReader、ExecuteScalar 或 ExecuteNonQuery 作業。
ExecuteNonQuery、ExecuteReader 和 ExecuteScalar 作業的訊息結構
這些作業中的訊息會遵循要求-回應訊息交換模式，下表顯示這些要求和回應訊息的結構。
| 作業 | XML 訊息 | Description |
|---|---|---|
| ExecuteNonQuery 要求 | <ExecuteNonQuery xmlns="http://schemas.microsoft.com/Sql/2008/05/GenericTableOp/"> <Query>[PL/SQL STATEMENT1];[PL/SQL STATEMENT2];…</Query> </ExecuteNonQuery> |
在 標籤內 <Query> ，您可以指定以分號分隔的多個 PL/SQL 語句。 |
| ExecuteNonQuery 回應 | <?xml version="1.0" encoding="utf-8" ?> <ExecuteNonQueryResponse xmlns="http://schemas.microsoft.com/Sql/2008/05/GenericTableOp/"> <ExecuteNonQueryResult>[value]</ExecuteNonQueryResult> </ExecuteNonQueryResponse> |
針對 UPDATE、INSERT 和 DELETE 子句， [value] 代表 ExecuteNonQuery 要求 訊息中 PL/SQL 語句所影響的資料列數目。 針對所有其他類型的語句， [value] 為 -1。 |
| ExecuteReader 要求 | <ExecuteReader xmlns="http://schemas.microsoft.com/Sql/2008/05/GenericTableOp/"> <Query>[PL/SQL STATEMENT1];[PL/SQL STATEMENT2];…</Query> </ExecuteReader> |
在 標籤內 <Query> ，您可以指定以分號分隔的多個 PL/SQL 語句。 |
| ExecuteReader 回應 | <?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> |
結果集是 ExecuteReader 要求 訊息中所執行 PL/SQL 語句的回應訊息，並以 DataSet 的陣列的形式傳回。 如需 DataSet 的相關資訊，請參閱 中的 https://go.microsoft.com/fwlink/?LinkID=196853 「DataSet 類別」。 |
| ExecuteScalar 要求 | <ExecuteScalar xmlns="http://schemas.microsoft.com/Sql/2008/05/GenericTableOp/"> <Query>[PL/SQL STATEMENT1];[PL/SQL STATEMENT2];…</Query> </ExecuteScalar> |
在 標籤內 <Query> ，您可以指定以分號分隔的多個 PL/SQL 語句。 |
| ExecuteScalar 回應 | <?xml version="1.0" encoding="utf-8" ?> <ExecuteScalarResponse xmlns="http://schemas.microsoft.com/Sql/2008/05/GenericTableOp/"> <ExecuteScalarResult>[value]</ExecuteScalarResult> </ExecuteScalarResponse> |
[value]代表ExecuteScalar Request訊息中 PL/SQL 語句所傳回之結果集中第一個資料列之第一個資料行中的值。 |
[PL/SQL STATEMENT] = 要執行的整個 PL/SQL 語句。
ExecuteNonQuery、ExecuteReader 和 ExecuteScalar 作業的訊息動作
下表顯示 ExecuteNonQuery、ExecuteReader 和 ExecuteScalar 作業所使用的訊息動作。
| 作業 | 動作 |
|---|---|
| ExecuteNonQuery 要求 | GenericOp/ExecuteNonQuery |
| ExecuteNonQuery 回應 | GenericOp/ExecuteNonQuery/response |
| ExecuteReader 要求 | GenericOp/ExecuteReader |
| ExecuteReader 回應 | GenericOp/ExecuteReader/response |
| ExecuteScalar 要求 | GenericOp/ExecuteScalar |
| ExecuteScalar 回應 | GenericOp/ExecuteScalar/response |