Schémas de message pour les procédures et les fonctions
L’adaptateur Microsoft BizTalk pour SQL Server surfaces SQL Server des procédures stockées de base de données et des fonctions scalaires et table en tant qu’opérations. Cette section décrit la structure des messages et les actions utilisées pour appeler des procédures et des fonctions.
Structure des messages des procédures et des fonctions
Les opérations exposées pour les procédures et les fonctions suivent un modèle d’échange de messages demande-réponse. Le tableau suivant montre la structure de ces messages de demande et de réponse.
| Opération | Message XML | Description |
|---|---|---|
| Demande de procédure stockée | <[SP_NAME] xmlns="http://schemas.microsoft.com/Sql/2008/05/Procedures/[SCHEMA]"> <[PRM1_NAME]>value1</[PRM1_NAME]> <[PRM2_NAME]>value2</[PRM2_NAME]> … </[SP_NAME]> |
- |
| Réponse de procédure stockée | <[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> |
La valeur de retour d’une procédure stockée est un tableau de DataSet. |
| Strongly-Typed demande de procédure stockée | <[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 réponse de procédure stockée | <[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> |
La valeur de retour d’une procédure stockée fortement typée est un tableau de données fortement typées. |
| Demande de fonction scalaire | <[SCLR_FN_NAME] xmlns="http://schemas.microsoft.com/Sql/2008/05/ScalarFunctions/[SCHEMA]"> <[PRM_NAME]>value</[PRM_NAME]> </[SCLR_FN_NAME]> |
- |
| Réponse de la fonction scalaire | <[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> |
- |
| Demande de fonction table | <[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]> |
- |
| Réponse de fonction table | <[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] = Collection d’artefacts SQL Server ; par exemple, dbo.
[SP_NAME] = Procédure stockée à exécuter ; par exemple, ADD_EMP_DETAILS.
[STRNG_SP_NAME] = Procédure stockée fortement typée à exécuter ; par exemple, GET_EMP_DETAILS.
[SCLR_FN_NAME] = Fonction scalaire à exécuter ; par exemple, GET_EMP_ID.
[TBL_FN_NAME] = Fonction table à exécuter ; par exemple, TVF_EMPLOYEE.
[PRM_NAME] = Nom du paramètre SQL Server.
Actions de message des fonctions et procédures
L’adaptateur SQL utilise les actions de message suivantes pour les opérations de procédure stockée et de fonction.
| Message | Action | Exemple |
|---|---|---|
| Demande de procédure stockée | Procédure/[SCHEMA]/[SP_NAME] | Procédure/dbo/ADD_EMP_DETAILS |
| Réponse de procédure stockée | Procédure/[SCHEMA]/[SP_NAME]/response | Procédure/dbo/ADD_EMP_DETAILS/réponse |
| Strongly-Typed demande de procédure stockée | TypedProcedure/[SCHEMA]/[STRNG_SP_NAME] | TypedProcedure/dbo/GET_EMP_DETAILS |
| Strongly-Typed réponse de procédure stockée | TypedProcedure/[SCHEMA]/[STRNG_SP_NAME]/response | TypedProcedure/dbo/GET_EMP_DETAILS/response |
| Demande de procédure stockée FOR XML | XmlProcedure/[SCHEMA]/[SP_NAME] | XmlProcedure/dbo/GET_EMP_DETAILS_FOR_XML |
| Réponse de procédure stockée FOR XML | XmlProcedure/[SCHEMA]/[SP_NAME]/resp | XmlProcedure/dbo/GET_EMP_DETAILS_FOR_XML/response |
| Demande de fonction scalaire | ScalarFunction/[SCHEMA]/[SCLR_FN_NAME] | ScalarFunction/dbo/GET_EMP_ID |
| Réponse de la fonction scalaire | ScalarFunction/[SCHEMA]/[SCLR_FN_NAME]/response | ScalarFunction/dbo/GET_EMP_ID/response |
| Demande de fonction table | TableFunction/[SCHEMA]/[TBL_FN_NAME] | TableFunction/dbo/TVF_EMPLOYEE |
| Réponse de fonction table | TableFunction/[SCHEMA]/[TBL_FN_NAME]/response | TableFunction/dbo/TVF_EMPLOYEE/response |
[SP_NAME] = Procédure stockée à exécuter ; par exemple, ADD_EMP_DETAILS.
[STRNG_SP_NAME] = Procédure stockée fortement typée à exécuter ; par exemple, GET_EMP_DETAILS.
[SCLR_FN_NAME] = Fonction scalaire à exécuter ; par exemple, GET_EMP_ID.
[TBL_FN_NAME] = Nom de la fonction table à exécuter ; par exemple, TVF_EMPLOYEE.
Voir aussi
Messages et schémas de message pour l’adaptateur BizTalk pour SQL Server