Ejecución de operaciones compuestas en SQL Server mediante BizTalk Server

Artículo
05/04/2023

El adaptador de SQL permite a los clientes del adaptador realizar operaciones compuestas en la base de datos SQL Server. Una operación compuesta puede incluir:

Operaciones de inserción, actualización y eliminación. No se admite una operación Select como parte de una operación compuesta.
Procedimientos almacenados ejecutados como operaciones.

Una sola operación compuesta puede tener cualquier número de estas operaciones, en cualquier orden. Por ejemplo, puede tener dos operaciones de inserción seguidas de una operación Delete y, por último, una ejecución de procedimiento almacenado. Además, puede tener diferentes operaciones destinadas a distintas tablas o vistas de base de datos. Para obtener más información sobre cómo el adaptador admite operaciones compuestas, consulte Ejecución de operaciones compuestas en SQL Server mediante el adaptador de SQL. Para obtener información sobre la estructura del mensaje SOAP para las operaciones compuestas, vea Esquemas de mensaje para operaciones compuestas.

Nota

Si está realizando operaciones en tablas que tienen columnas de tipos definidos por el usuario, asegúrese de consultar Operaciones en tablas y vistas con User-Defined Tipos mediante el adaptador de SQL antes de empezar a desarrollar la aplicación.

Cómo realizar operaciones compuestas en SQL Server

Realizar una operación en 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 realizar operaciones compuestas en la base de datos SQL Server, estas tareas son:

Cree un proyecto de BizTalk y genere esquema para todas las operaciones que desea invocar.
Cree manualmente un archivo de esquema que incluya referencias a todos los esquemas que generó en el paso anterior.
Cree mensajes en el proyecto de BizTalk para enviar y recibir mensajes de la base de datos SQL Server. Estos mensajes deben ajustarse al esquema de solicitud y respuesta que creó en el paso anterior.
Cree una orquestación para invocar la operación compuesta en la base de datos 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 sobre cómo realizar estas tareas.

Ejemplo basado en este tema

Se proporciona un ejemplo, CompositeOperations, basado en este tema con el paquete de adaptadores de BizTalk. Para obtener más información, vea Ejemplos para el adaptador de SQL.

Generación de esquema

En este tema, para demostrar cómo realizar operaciones compuestas, se realizarán las siguientes tareas en el orden especificado:

Inserte el registro en la tabla EMPLOYEE.
Recupere todas las columnas del último registro insertado invocando el procedimiento almacenado GET_LAST_EMP_DATA.
Elimine el registro de la tabla EMPLOYEE.

Ejecute los scripts proporcionados con los ejemplos para crear la tabla EMPLOYEE. Para obtener más información sobre los ejemplos, vea Ejemplos de esquema.

Debe crear un proyecto de BizTalk y usar el complemento consumir servicio adaptador para generar el esquema para estas operaciones. 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.

Creación de una definición de esquema compuesto

Ahora debe crear un esquema compuesto que haga referencia a los esquemas que creó para las operaciones individuales. Realice los pasos siguientes para crear una definición de esquema compuesto.

Para agregar una definición de esquema compuesto

Agregue un archivo de esquema al proyecto de BizTalk. Haga clic con el botón derecho en el nombre del proyecto, seleccione Agregar y, a continuación, haga clic en Nuevo elemento. En el cuadro de diálogo Agregar nuevo elemento , en el cuadro Categorías , haga clic en Archivos de esquema. En el cuadro Plantillas , haga clic en Esquema. Especifique un nombre para el archivo de esquema y, a continuación, haga clic en Aceptar.

En este ejemplo, especifique el nombre del archivo de esquema como CompositeSchema.xsd.
Agregue referencias al esquema generado para las distintas operaciones que desea realizar. En este ejemplo, los distintos esquemas generados para las operaciones son:
- TableOperation.dbo.Employee.xsd, para las operaciones insertar y eliminar.
- Procedure.dbo.xsd, para el procedimiento almacenado de GET_LAST_EMP_DATA.
  
  Para agregar referencias:
1. Haga clic con el botón derecho en el nodo Esquema> raíz< en CompositeSchema.xsd y haga clic en Propiedades.
2. En el cuadro Propiedad , haga clic en el botón de puntos suspensivos (...) en la propiedad Imports .
3. En el cuadro de diálogo Importaciones , en la lista Importar nuevo esquema como , seleccione Importación XSD y, a continuación, haga clic en Agregar.
4. En el cuadro de diálogo Selector de tipos de BizTalk , expanda el nodo Nombre del proyecto de BizTalk, expanda Esquemas y, a continuación, seleccione el esquema que desea importar. En este ejemplo, seleccione <BizTalk_project_name>. TableOperation_dbo_Employee. Haga clic en OK.
  
  Repita este paso para importar <BizTalk_project_name>. Procedure_dbo también.
5. En el cuadro de diálogo Importaciones , haga clic en Aceptar.
Agregue dos nodos secundarios al nodo de esquema raíz. Un nodo secundario corresponde al esquema de solicitud para realizar la operación compuesta. El otro nodo secundario corresponde al esquema de respuesta. El nodo que corresponde al esquema de solicitud puede tener cualquier nombre. El nodo que corresponde al esquema de respuesta debe llamarse <request_schema_node>Response. En este ejemplo, llamaremos al nodo de esquema de solicitud como Solicitud. Por lo tanto, el nodo de esquema de respuesta se denomina RequestResponse.

Nota

De forma predeterminada, también se agrega un nodo raíz a un nuevo archivo de esquema. Puede cambiar el nombre del nodo raíz a Solicitud. Para cambiar el nombre de un nodo, haga clic con el botón derecho en el nombre del nodo y haga clic en Cambiar nombre.

Para agregar un nodo en el <nodo Esquema> :
1. Haga clic con el botón derecho en el <nodo Esquema> , seleccione Insertar nodo de esquema y haga clic en Registro secundario.
2. Cambie el nombre del nuevo nodo a RequestResponse.
Agregue nodos secundarios en el nodo Solicitud que corresponda al esquema de solicitud para cada operación que realizará como parte de la operación compuesta. En este ejemplo, debe agregar nodos secundarios correspondientes a lo siguiente:
- Insertar y eliminar operaciones en la tabla EMPLOYEE.
- GET_LAST_EMP_DATA procedimiento almacenado.
Importante

Debe agregar los nodos en el mismo orden en el que desea realizar las operaciones. Por ejemplo, si desea insertar un registro, ejecute un procedimiento almacenado y, a continuación, elimine un registro, primero debe agregar un nodo para la operación Insertar, seguido de un nodo para el procedimiento almacenado y, por último, un nodo para la operación Delete.

Para agregar nodos secundarios al nodo Solicitud :
1. Haga clic con el botón derecho en el nodo Solicitud , seleccione Insertar nodo de esquema y, a continuación, haga clic en Registro secundario.
2. Cambie el nombre del registro para que corresponda a un esquema de solicitud para una operación que realice como parte de la operación compuesta. Por ejemplo, cambie el nombre del nodo a "Insertar".
3. Asigne el nodo Insertar al esquema de solicitud para la operación Insertar en la tabla EMPLOYEE. Para ello, haga clic con el botón derecho en el nodo Insertar y haga clic en Propiedades. En el cuadro Propiedades, en la lista Tipo de estructura de datos, seleccione Insertar (referencia).
4. Repita estos pasos para agregar nodos para los esquemas de solicitud para GET_LAST_EMP_DATA procedimiento almacenado y la operación Eliminar. Especifique los nombres de nodo y asígnelos al esquema correspondiente, tal como se mencionó en la tabla siguiente.
  
  nombre del nodo Asignado al esquema
  
  GET_LAST_EMP_DATA GET_LAST_EMP_DATA (referencia)
  
  Eliminar Eliminar (referencia)
Agregue nodos secundarios en el nodo RequestResponse que corresponda al esquema de respuesta de cada operación que realizará como parte de la operación compuesta. En este ejemplo, debe agregar nodos secundarios correspondientes a lo siguiente:
- Insertar y eliminar operaciones en la tabla EMPLOYEE.
- GET_LAST_EMP_DATA procedimiento almacenado.
Importante

Debe agregar los nodos secundarios en el mismo orden que los nodos secundarios en el nodo Solicitud .

Para agregar nodos secundarios al nodo RequestResponse :
1. Haga clic con el botón derecho en el nodo RequestResponse , seleccione Insertar nodo de esquema y haga clic en Registro secundario.
2. Cambie el nombre del registro para que corresponda a un esquema de respuesta para una operación que se realiza como parte de la operación compuesta. Por ejemplo, cambie el nombre del nodo a "InsertResponse".
3. Asigne el nodo InsertResponse al esquema de respuesta de la operación Insertar en la tabla EMPLOYEE. Para ello, haga clic con el botón derecho en el nodo InsertarResponse y haga clic en Propiedades. En el cuadro Propiedades, en la lista Tipo de estructura de datos, seleccione InsertarResponse (Referencia).
4. Repita estos pasos para agregar nodos para los esquemas de respuesta para el procedimiento almacenado GET_LAST_EMP_DATA y la operación Delete. Especifique los nombres de nodo y asígnelos al esquema correspondiente, tal como se mencionó en la tabla siguiente.
  
  nombre del nodo Asignado al esquema
  
  GET_LAST_EMP_DATAResponse GET_LAST_EMP_DATAResponse (Referencia)
  
  DeleteResponse DeleteResponse (Referencia)
Guarde el archivo CompositeSchema.xsd .

nombre del nodo	Asignado al esquema
GET_LAST_EMP_DATA	GET_LAST_EMP_DATA (referencia)
Eliminar	Eliminar (referencia)

nombre del nodo	Asignado al esquema
GET_LAST_EMP_DATAResponse	GET_LAST_EMP_DATAResponse (Referencia)
DeleteResponse	DeleteResponse (Referencia)

Definición de mensajes y tipos de mensajes

El esquema compuesto que creó en el último paso describe los "tipos" necesarios para los mensajes de una orquestación. Normalmente, un mensaje es una variable, el tipo para el que se define mediante el esquema correspondiente. Ahora debe crear mensajes para la orquestación y vincularlos al esquema que creó en el paso anterior.

Para crear mensajes y vincular al esquema

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 `Request`
Tipo de mensaje	En la lista desplegable, expanda Esquemas y seleccione CompositeOp.CompositeSchema.Request, donde CompositeOp es el nombre del proyecto de BizTalk. CompositeSchema es el esquema que creó manualmente para las operaciones compuestas.

Repita el paso 2 para crear un mensaje. En el panel Propiedades del nuevo mensaje, haga lo siguiente:

Use Para hacer esto

Identificador Escriba Response

Tipo de mensaje En la lista desplegable, expanda Esquemas y seleccione CompositeOp.CompositeSchema.RequestResponse.

Use	Para hacer esto
Identificador	Escriba `Response`
Tipo de mensaje	En la lista desplegable, expanda Esquemas y seleccione CompositeOp.CompositeSchema.RequestResponse.

Configuración de la orquestación

Debe crear una orquestación de BizTalk para usar BizTalk Server para realizar operaciones compuestas en SQL Server. En esta orquestación, quitará un mensaje de solicitud en una ubicación de recepción definida. El mensaje de solicitud debe ajustarse al esquema compuesto que creó anteriormente. 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 básica para realizar operaciones compuestas es similar a la siguiente:

Orquestación para realizar operaciones compuestas peform

Agregar formas de mensaje

Asegúrese de especificar 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

Adición de 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 el identificador en ResponseOut - Establecer el tipo en ResponseOutType - Establecer el patrón de comunicación en unidireccional - Establecer la dirección de comunicación en enviar

Especificar mensajes para formas de acción y conectarlos 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 la operación en MessageIn.CompositeOp.Request
SendMessage	- Establecer mensaje en solicitud - Establecer operación en LOBPort.CompositeOp.Request
ReceiveResponse	- Establecer mensaje en respuesta - Establecer operación en LOBPort.CompositeOp.Response
SendResponse	- Establecer mensaje en respuesta - Establecer la operación en ResponseOut.CompositeOp.Request

Después de especificar estas propiedades, se conectan las formas y los puertos del mensaje y se completa la orquestación.

Ahora debe compilar la solución de BizTalk e implementarla en un BizTalk Server. Para obtener más información, vea Compilar y ejecutar orquestaciones.

Configuración de 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 ver un tutorial, consulte Tutorial: Implementación de una aplicación básica de BizTalk.

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 de 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 de SQL Server. Dado que las operaciones que forman parte de la operación compuesta se ejecutan en una sola transacción, asegúrese de que la propiedad de enlace UseAmbientTransaction esté establecida en True.
  
  También debe especificar la acción en el puerto de envío. La acción de una operación compuesta es "CompositeOperation". Para obtener información sobre cómo crear puertos, consulte Configuración manual de un enlace de puerto físico al adaptador de SQL. Para obtener más información sobre cómo especificar acciones para los puertos, consulte Configuración de la acción SOAP para el adaptador de SQL.
  
  Nota
  
  La generación del esquema mediante el complemento de proyecto de BizTalk del servicio consumir adaptador también crea un archivo de enlace que contiene información sobre los puertos y las acciones que se van a establecer 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. Si importa este archivo de enlace, la acción en el puerto de envío de WCF-Custom o WCF-SQL se establece en una acción dinámica que implique todas las operaciones que seleccionó en el complemento Consumir servicio de adaptador al generar el esquema. Para una operación compuesta, debe reemplazar la acción dinámica por "CompositeOperation".

Iniciar la aplicación

Debe iniciar la aplicación de BizTalk para realizar operaciones compuestas 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:

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.
El puerto de envío WCF-Custom o WCF-SQL para enviar mensajes a la base de datos SQL Server se está ejecutando.
La orquestación de BizTalk para la operación se está ejecutando.

Ejecución de la operación

Después de ejecutar la aplicación, debe quitar un mensaje de solicitud en la ubicación de recepción del archivo. El esquema del mensaje de solicitud debe ajustarse al esquema de las operaciones compuestas que creó anteriormente. Por ejemplo, un mensaje de solicitud que inserta un registro en la tabla EMPLOYEE, invoca el GET_LAST_EMP_DATA procedimiento almacenado y elimina un registro de la tabla EMPLOYEE es:

<Request xmlns="http://CompositeTest.CompositeSchema">  
  <Insert xmlns="http://schemas.microsoft.com/Sql/2008/05/TableOp/dbo/Employee">  
    <Rows>  
      <Employee xmlns="http://schemas.microsoft.com/Sql/2008/05/Types/Tables/dbo">  
        <Name>John</Name>  
        <Designation>Manager</Designation>  
        <Salary>100000</Salary>  
      </Employee>  
    </Rows>  
  </Insert>  
  <GET_LAST_EMP_DATA xmlns="http://schemas.microsoft.com/Sql/2008/05/Procedures/dbo" />  
  <Delete xmlns="http://schemas.microsoft.com/Sql/2008/05/TableOp/dbo/Employee">  
    <Rows>  
      <Employee xmlns="http://schemas.microsoft.com/Sql/2008/05/Types/Tables/dbo">  
        <Name>John</Name>  
      </Employee>  
    </Rows>  
  </Delete>  
</Request>

Consulte Esquemas de mensajes para operaciones compuestas para obtener más información sobre el esquema de mensajes de solicitud para realizar operaciones compuestas en la base de datos de SQL Server mediante el adaptador de SQL.

La orquestación consume el mensaje y lo envía a la base de datos 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. 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" ?>   
<RequestResponse xmlns="http://CompositeTest.CompositeSchema">  
  <InsertResponse xmlns="http://schemas.microsoft.com/Sql/2008/05/TableOp/dbo/Employee">  
    <InsertResult>  
      <long xmlns="http://schemas.microsoft.com/2003/10/Serialization/Arrays">10080</long>   
    </InsertResult>  
  </InsertResponse>  
  <GET_LAST_EMP_DATAResponse xmlns="http://schemas.microsoft.com/Sql/2008/05/Procedures/dbo">  
    <GET_LAST_EMP_DATAResult>  
      <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:element minOccurs="0" name="Name" type="xs:string" />   
                      <xs:element minOccurs="0" name="DOJ" type="xs:dateTime" />   
                      <xs:element minOccurs="0" name="Designation" type="xs:string" />   
                      <xs:element minOccurs="0" name="Job_Description" type="xs:string" />   
                      <xs:element minOccurs="0" name="Photo" type="xs:base64Binary" />   
                      <xs:element minOccurs="0" name="Rating" type="xs:string" />   
                      <xs:element minOccurs="0" name="Salary" type="xs:decimal" />   
                      <xs:element minOccurs="0" name="Last_Modified" type="xs:base64Binary" />   
                    </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>10080</Employee_ID>   
              <Name>John</Name>   
              <Designation>Manager</Designation>   
              <Salary>100000.00</Salary>   
              <Last_Modified>AAAAAAAAF40=</Last_Modified>   
            </NewTable>  
          </NewDataSet>  
        </diffgr:diffgram>  
      </DataSet>  
    </GET_LAST_EMP_DATAResult>  
    <ReturnValue>0</ReturnValue>   
  </GET_LAST_EMP_DATAResponse>  
  <DeleteResponse xmlns="http://schemas.microsoft.com/Sql/2008/05/TableOp/dbo/Employee">  
    <DeleteResult>1</DeleteResult>   
  </DeleteResponse>  
</RequestResponse>

La respuesta anterior contiene varios conjuntos de resultados que corresponden a las distintas operaciones realizadas como parte de la operación compuesta. Por ejemplo, el InsertResult elemento contiene 10080, que es el identificador único del registro recién agregado.

Prácticas recomendadas

Después de haber implementado y configurado el proyecto de BizTalk, puede exportar las opciones 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 necesite crear elementos como puertos de envío y puertos de recepción para la misma orquestación. Para obtener más información sobre los archivos de enlace, consulte Reutilización de enlaces de adaptador.

Consulte también

Desarrollar aplicaciones de BizTalk con el adaptador de SQL

Compartir vía