Schemi di messaggio per routine e funzioni
L'adapter Microsoft BizTalk per SQL Server superfici SQL Server stored procedure di database e funzioni scalari e con valori di tabella come operazioni. In questa sezione vengono descritte la struttura dei messaggi e le azioni usate per richiamare routine e funzioni.
Struttura dei messaggi di procedure e funzioni
Le operazioni illustrate per le procedure e le funzioni seguono un modello di scambio di messaggi di richiesta-risposta. Nella tabella seguente viene illustrata la struttura di questi messaggi di richiesta e risposta.
| Operazione | Messaggio XML | Descrizione |
|---|---|---|
| Richiesta stored procedure | <[SP_NAME] xmlns="http://schemas.microsoft.com/Sql/2008/05/Procedures/[SCHEMA]"> <[PRM1_NAME]>value1</[PRM1_NAME]> <[PRM2_NAME]>value2</[PRM2_NAME]> … </[SP_NAME]> |
- |
| Risposta stored procedure | <[SP_NAME]Response xmlns="http://schemas.microsoft.com/Sql/2008/05/Procedures/[SCHEMA]"> <[SP_NAME]Result> <DataSet> <any>[Value]</any> <any>[Value]</any> … </DataSet> </[SP_NAME]Result> <ReturnValue>[Value]</ReturnValue> </[SP_NAME]Response> |
Il valore restituito di una stored procedure è una matrice di DataSet. |
| Strongly-Typed richiesta stored procedure | <[STRNG_SP_NAME] xmlns="http://schemas.microsoft.com/Sql/2008/05/TypedProcedures/[SCHEMA]"> <[PRM1_NAME]>value1<[PRM1_NAME]> <[PRM2_NAME]>value2</[PRM2_NAME]> … </[STRNG_SP_NAME]> |
- |
| Strongly-Typed risposta stored procedure | <[STRNG_SP_NAME]Response xmlns="http://schemas.microsoft.com/Sql/2008/05/TypedProcedures/[SCHEMA]"> <StoredProcedureResultSet0> <StoredProcedureResultSet0 xmlns:ns1="http://schemas.microsoft.com/Sql/2008/05/ProcedureResultSets/[SCHEMA]/[STRNG_SP_NAME]"> <[PRM1_NAME]>value1<[PRM1_NAME]> <[PRM2_NAME]>value2</[PRM2_NAME]> … </StoredProcedureResultSet0> </StoredProcedureResultSet0> <ReturnValue>[Value]</ReturnValue> </[STRNG_SP_NAME]Response> |
Il valore restituito di una stored procedure fortemente tipizzata è una matrice di dati fortemente tipizzata. |
| Richiesta di funzione scalare | <[SCLR_FN_NAME] xmlns="http://schemas.microsoft.com/Sql/2008/05/ScalarFunctions/[SCHEMA]"> <[PRM_NAME]>value</[PRM_NAME]> </[SCLR_FN_NAME]> |
- |
| Risposta della funzione scalare | <[SCLR_FN_NAME]Response xmlns="http://schemas.microsoft.com/Sql/2008/05/ScalarFunctions/[SCHEMA]"> <[SCLR_FN_NAME]Result>return_value</[SCLR_FN_NAME]Result> <[PRM_NAME]>value</[PRM_NAME]> </[SCLR_FN_NAME]Response> |
- |
| Richiesta di funzione con valori di tabella | <[TBL_FN_NAME] xmlns="http://schemas.microsoft.com/Sql/2008/05/TableValuedFunctions/[SCHEMA]"> <[PRM1_NAME]>value1</[PRM1_NAME]> <[PRM2_NAME]>value2</[PRM2_NAME]> … </[TBL_FN_NAME]> |
- |
| Risposta della funzione con valori di tabella | <[TBL_FN_NAME]Response xmlns="http://schemas.microsoft.com/Sql/2008/05/TableValuedFunctions/[SCHEMA]"> <[TBL_FN_NAME]Result> <[TBL_FN_NAME] xmlns="http://schemas.microsoft.com/Sql/2008/05/TableValuedFunctions/[SCHEMA]"> <[PRM1_NAME]>value1</[PRM1_NAME]> <[PRM2_NAME]>value2</[PRM2_NAME]> ... </[TBL_FN_NAME]"> ... </[TBL_FN_NAME]Result> </[TBL_FN_NAME]Response> |
[SCHEMA] = Raccolta di SQL Server artefatti, ad esempio dbo.
[SP_NAME] = Stored procedure da eseguire; ad esempio, ADD_EMP_DETAILS.
[STRNG_SP_NAME] = Stored procedure fortemente tipizzata da eseguire; ad esempio, GET_EMP_DETAILS.
[SCLR_FN_NAME] = Funzione scalare da eseguire; ad esempio, GET_EMP_ID.
[TBL_FN_NAME] = Funzione con valori di tabella da eseguire; ad esempio, TVF_EMPLOYEE.
[PRM_NAME] = Nome del parametro SQL Server.
Azioni dei messaggi di funzioni e procedure
L'adapter SQL usa le azioni del messaggio seguenti per le operazioni di stored procedure e funzioni.
| Messaggio | Azione | Esempio |
|---|---|---|
| Richiesta stored procedure | Procedura/[SCHEMA]/[SP_NAME] | Procedura/dbo/ADD_EMP_DETAILS |
| Risposta stored procedure | Procedure/[SCHEMA]/[SP_NAME]/response | Procedura/dbo/ADD_EMP_DETAILS/risposta |
| Strongly-Typed richiesta stored procedure | TypedProcedure/[SCHEMA]/[STRNG_SP_NAME] | TypedProcedure/dbo/GET_EMP_DETAILS |
| Strongly-Typed risposta stored procedure | TypedProcedure/[SCHEMA]/[STRNG_SP_NAME]/response | TypedProcedure/dbo/GET_EMP_DETAILS/response |
| Richiesta di stored procedure FOR XML | XmlProcedure/[SCHEMA]/[SP_NAME] | XmlProcedure/dbo/GET_EMP_DETAILS_FOR_XML |
| Risposta della stored procedure FOR XML | XmlProcedure/[SCHEMA]/[SP_NAME]/resp | XmlProcedure/dbo/GET_EMP_DETAILS_FOR_XML/response |
| Richiesta di funzione scalare | ScalarFunction/[SCHEMA]/[SCLR_FN_NAME] | ScalarFunction/dbo/GET_EMP_ID |
| Risposta della funzione scalare | ScalarFunction/[SCHEMA]/[SCLR_FN_NAME]/response | ScalarFunction/dbo/GET_EMP_ID/response |
| Richiesta di funzione con valori di tabella | TableFunction/[SCHEMA]/[TBL_FN_NAME] | TableFunction/dbo/TVF_EMPLOYEE |
| Risposta della funzione con valori di tabella | TableFunction/[SCHEMA]/[TBL_FN_NAME]/response | TableFunction/dbo/TVF_EMPLOYEE/response |
[SP_NAME] = Stored procedure da eseguire; ad esempio, ADD_EMP_DETAILS.
[STRNG_SP_NAME] = Stored procedure fortemente tipizzata da eseguire; ad esempio, GET_EMP_DETAILS.
[SCLR_FN_NAME] = Funzione scalare da eseguire; ad esempio, GET_EMP_ID.
[TBL_FN_NAME] = Nome della funzione con valori di tabella da eseguire; ad esempio, TVF_EMPLOYEE.
Vedere anche
Messaggi e schemi di messaggio per l'adapter BizTalk per SQL Server