Operaciones ExecuteReader, ExecuteScalar o ExecuteNonQuery en SQL mediante BizTalk Server
El adaptador de SQL expone operaciones genéricas de SQL Server como ExecuteNonQuery, ExecuteReader y ExecuteScalar. Puede usar estas operaciones para ejecutar cualquier instrucción SQL en una base de datos de SQL Server. Estas operaciones difieren en función del tipo de respuesta que obtiene para la instrucción SQL. Para obtener más información sobre cómo el adaptador admite estas operaciones, vea Compatibilidad con las operaciones ExecuteNonQuery, ExecuteReader y ExecuteScalar.
En este tema se muestra cómo realizar una operación ExecuteReader mediante el adaptador de SQL con BizTalk Server. Puede seguir el mismo conjunto de procedimientos descritos en este tema para realizar operaciones ExecuteNonQuery y ExecuteScalar .
Requisitos previos
Cree un archivo de clave de nombre seguro y aprenda las herramientas.
Configure MSDTC en equipos que ejecutan el adaptador de SQL y SQL Server.
Invocación de la operación ExecuteReader en una base de datos de SQL Server
Realizar una operación en una base de datos de SQL Server mediante el adaptador de SQL con BizTalk Server implica tareas de procedimientos descritas en Bloques de creación para desarrollar aplicaciones de BizTalk con el adaptador de SQL. Para invocar la operación ExecuteReader en SQL Server, estas tareas son:
Cree un proyecto de BizTalk y genere un esquema para la operación ExecuteReader .
Cree mensajes en el proyecto de BizTalk para enviar y recibir mensajes de SQL Server.
Cree una orquestación para invocar la operación en SQL Server.
Compile e implemente el proyecto de BizTalk.
Configure la aplicación de BizTalk mediante la creación de puertos físicos de envío y recepción.
Inicie la aplicación de BizTalk.
En este tema se proporcionan instrucciones para realizar estas tareas.
Generar esquema
En este tema se muestra cómo invocar la operación ExecuteReader en SQL Server mediante el adaptador de SQL con BizTalk Server. La operación ExecuteReader toma cualquier instrucción SQL como parámetro y devuelve el conjunto de resultados para la operación como una matriz de DataSet. En este tema se muestra cómo ejecutar el procedimiento almacenado ADD_EMP_DETAILS mediante la operación ExecuteReader . Este procedimiento almacenado agrega un registro a la tabla Employee y devuelve el identificador del empleado recién agregado. Las tablas y los procedimientos almacenados usados en el tema se crean ejecutando los scripts proporcionados con los ejemplos. Para obtener más información sobre el script, vea Ejemplos para el adaptador de SQL.
Para demostrar cómo invocar la operación ExecuteReader , se genera el esquema para la operación ExecuteReader . Debe crear un proyecto de BizTalk y usar el complemento consumir servicio adaptador para generar el esquema. Consulte Recuperación de metadatos para SQL Server operaciones en Visual Studio mediante el adaptador de SQL para obtener más información sobre cómo generar esquemas.
Definir mensajes y tipos de mensajes
El esquema que ha generado anteriormente describe los "tipos" necesarios para los mensajes de la orquestación. Normalmente, un mensaje es una variable, el tipo para el que se define mediante el esquema correspondiente. Ahora, cree mensajes para la orquestación y vincúlelos a esquemas generados en el paso anterior.
Agregue una orquestación al proyecto de BizTalk. En Explorador de soluciones, haga clic con el botón derecho en el nombre del proyecto de BizTalk, seleccione Agregar y, a continuación, haga clic en Nuevo elemento. Escriba un nombre para la orquestación de BizTalk y, a continuación, haga clic en Agregar.
Abra la ventana Vista orquestación del proyecto de BizTalk si no está abierta. Para ello, haga clic en Ver, seleccione Otras ventanas y, a continuación, haga clic en Vista de orquestación.
En la vista Orquestación, haga clic con el botón derecho en Mensajes y, a continuación, haga clic en Nuevo mensaje.
Haga clic con el botón derecho en el mensaje recién creado y, a continuación, seleccione Ventana Propiedades.
En el panel Propiedades del Message_1, haga lo siguiente:
Use Para hacer esto Identificador Escriba RequestTipo de mensaje En la lista desplegable, expanda Esquemas y, a continuación, seleccione Execute_Reader.GenericOperation.ExecuteReader, donde Execute_Reader es el nombre del proyecto de BizTalk. GenericOperation es el esquema generado para la operación ExecuteReader . Repita el paso 2 para crear un mensaje. En el panel Propiedades del nuevo mensaje, haga lo siguiente:
Use Para hacer esto Identificador Escriba ResponseTipo de mensaje En la lista desplegable, expanda Esquemas y, a continuación, seleccione Execute_Reader.GenericOperation.ExecuteReaderResponse.
Configuración de la orquestación
Cree una orquestación de BizTalk para usar BizTalk Server para realizar una operación en SQL Server. En esta orquestación, quitará un mensaje de solicitud en una ubicación de recepción definida. El adaptador de SQL consume este mensaje y lo pasa a SQL Server. La respuesta de SQL Server se guarda en otra ubicación. Debe incluir formas enviar y recibir para enviar mensajes a SQL Server y recibir respuestas, respectivamente. Una orquestación de ejemplo para invocar una operación ExecuteReader es similar a la siguiente:
Agregar formas de mensaje
Escriba las siguientes propiedades para cada una de las formas de mensaje. Los nombres enumerados en la columna Shape son los nombres de las formas de mensaje que se muestran en la orquestación mencionada.
| Forma | Tipo de forma | Propiedades |
|---|---|---|
| ReceiveMessage | Recepción | - Establecer nombre en ReceiveMessage - Establecer Activar en True |
| SendMessage | Envío | - Establecer nombre en SendMessage |
| ReceiveResponse | Recepción | - Establecer nombre en ReceiveResponse - Establecer Activar en False |
| SendResponse | Envío | - Establecer el nombre en SendResponse |
Agregar puertos
Asegúrese de especificar las siguientes propiedades para cada uno de los puertos lógicos. Los nombres enumerados en la columna Puerto son los nombres de los puertos como se muestra en la orquestación.
| Port | Propiedades |
|---|---|
| MessageIn | - Establecer identificadoren MessageIn - Establecer el tipo en MessageInType - Establecer el patrón de comunicación en unidireccional - Establecer la dirección de comunicación para recibir |
| LOBPort | - Establecer identificador en LOBPort - Establecer tipo en LOBPortType - Establecer el patrón de comunicación en Solicitud-respuesta - Establecer la dirección de comunicación en enviar y recibir |
| ResponseOut | - Establecer identificador enResponseOut - Establecer tipo en ResponseOutType - Establecer el patrón de comunicación en unidireccional - Establecer la dirección de comunicación en Enviar |
Escriba mensajes para formas de acción y conéctelos a puertos.
En la tabla siguiente se especifican las propiedades y sus valores que se deben establecer para especificar mensajes para las formas de acción y para vincular los mensajes a los puertos. Los nombres enumerados en la columna Shape son los nombres de las formas de mensaje tal como se muestran en la orquestación mencionada anteriormente.
| Forma | Propiedades |
|---|---|
| ReceiveMessage | - Establecer mensaje en solicitud - Establecer operación en MessageIn.ExecuteReader.Request |
| SendMessage | - Establecer mensaje en solicitud - Establecer operación en LOBPort.ExecuteReader.Request |
| ReceiveResponse | - Establecer mensaje en respuesta - Establecer la operación en LOBPort.ExecuteReader.Response |
| SendResponse | - Establecer mensaje en respuesta - Establecer la operación en ResponseOut.ExecuteReader.Request |
Después de especificar estas propiedades, se conectan las formas y los puertos de mensaje y se completa la orquestación.
Ahora debe compilar la solución de BizTalk e implementarla en BizTalk Server. Para obtener más información, vea Compilar y ejecutar orquestaciones.
Configurar la aplicación de BizTalk
Después de implementar el proyecto de BizTalk, la orquestación que creó anteriormente aparece en el panel Orquestaciones de la consola de administración de BizTalk Server. Debe usar la consola de administración de BizTalk Server para configurar la aplicación. Para obtener más información sobre cómo configurar una aplicación, vea Walkthrough: Deploying a Basic BizTalk Application.
La configuración de una aplicación implica:
Selección de un host para la aplicación.
Asignación de los puertos que creó en la orquestación a puertos físicos en la consola de administración de BizTalk Server. Para esta orquestación, debe:
Defina una ubicación en el disco duro y un puerto de archivo correspondiente donde quitará un mensaje de solicitud. La orquestación de BizTalk consumirá el mensaje de solicitud y lo enviará a la base de datos SQL Server.
Defina una ubicación en el disco duro y un puerto de archivo correspondiente donde la orquestación de BizTalk quitará el mensaje de respuesta que contiene la respuesta de la base de datos de SQL Server.
Defina un puerto de envío físico WCF-Custom o WCF-SQL para enviar mensajes a la base de datos SQL Server. También debe especificar la acción en el puerto de envío. Para obtener información sobre cómo crear puertos, consulte Configuración manual de un enlace de puerto físico al adaptador de SQL.
Nota
La generación del esquema mediante el complemento de proyecto consumir servicio de adaptador de BizTalk también crea un archivo de enlace que contiene información sobre los puertos y las acciones que se establecerán para esos puertos. Puede importar este archivo de enlace desde la consola de administración de BizTalk Server para crear puertos de envío (para llamadas salientes) o puertos de recepción (para llamadas entrantes). Para obtener más información, consulte Configuración de un enlace de puerto físico mediante un archivo de enlace de puertos para usar el adaptador de SQL.
Iniciar la aplicación
Inicie la aplicación de BizTalk para invocar la operación ExecuteReader en la base de datos SQL Server. Para obtener instrucciones sobre cómo iniciar una aplicación de BizTalk, vea Cómo iniciar una orquestación.
En esta fase, asegúrese de que:
El puerto de recepción FILE para recibir mensajes de solicitud para la orquestación se está ejecutando.
El puerto de envío FILE para recibir los mensajes de respuesta de la orquestación se está ejecutando.
Se está ejecutando el puerto de envío de WCF-Custom o WCF-SQL para enviar mensajes a la base de datos SQL Server.
La orquestación de BizTalk para la operación se está ejecutando.
Ejecutar la operación
Después de ejecutar la aplicación, debe quitar un mensaje de solicitud a la ubicación de recepción del archivo. El esquema del mensaje de solicitud debe ajustarse al esquema de la operación ExecuteReader que generó anteriormente. Por ejemplo, el mensaje de solicitud para invocar el ADD_EMP_DETAILS mediante una operación ExecuteReader es:
<ExecuteReader xmlns="http://schemas.microsoft.com/Sql/2008/05/GenericTableOp/">
<Query>EXEC ADD_EMP_DETAILS Tom,Manager,100000</Query>
</ExecuteReader>
Consulte Esquemas de mensajes para las operaciones ExecuteNonQuery, ExecuteReader y ExecuteScalar para obtener más información sobre el esquema de mensajes de solicitud para invocar una operación ExecuteReader mediante el adaptador de SQL.
Nota
Dentro de la <Query> etiqueta , puede especificar varias instrucciones SQL separadas por un punto y coma.
La orquestación consume el mensaje y lo envía a la base de datos de SQL Server. La respuesta de la base de datos SQL Server se guarda en la otra ubicación FILE definida como parte de la orquestación. La respuesta de la operación ExecuteReader contiene un conjunto de resultados como una matriz DataSet. Por ejemplo, la respuesta de la base de datos SQL Server para el mensaje de solicitud anterior es:
<?xml version="1.0" encoding="utf-8" ?>
<ExecuteReaderResponse xmlns="http://schemas.microsoft.com/Sql/2008/05/GenericTableOp/">
<ExecuteReaderResult>
<DataSet xmlns="http://schemas.datacontract.org/2004/07/System.Data">
<xs:schema id="NewDataSet" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">
<xs:element msdata:IsDataSet="true" name="NewDataSet">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="0" maxOccurs="unbounded" name="NewTable">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="0" name="Employee_ID" type="xs:int" />
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
<diffgr:diffgram xmlns:diffgr="urn:schemas-microsoft-com:xml-diffgram-v1">
<NewDataSet xmlns="">
<NewTable>
<Employee_ID>10767</Employee_ID>
</NewTable>
</NewDataSet>
</diffgr:diffgram>
</DataSet>
</ExecuteReaderResult>
</ExecuteReaderResponse>
En la respuesta, 10767 es el identificador del empleado recién creado.
Prácticas recomendadas
Una vez implementado y configurado el proyecto de BizTalk, puede exportar los valores de configuración a un archivo XML denominado archivo de enlace. Una vez que genere un archivo de enlace, puede importar los valores de configuración del archivo, de modo que no sea necesario crear elementos como los puertos de envío y recibir puertos para la misma orquestación. Para obtener más información sobre los archivos de enlace, consulte Reutilización de enlaces de adaptador.