Adaptador de BizTalk para la configuración de DB2: HIS

  • Artículo

Información general

El adaptador de Microsoft BizTalk para DB2 conecta BizTalk Server a los datos vitales almacenados en el sistema central de IBM DB2 para z/OS, IBM midrange DB2 para IBM i e IBM server DB2 que se ejecutan en sistemas operativos Linux, UNIX y Windows. El adaptador se basa en el proveedor de datos de Microsoft ADO.NET para DB2 y admite una amplia gama de funciones, incluidos los puertos de envío y recepción con transacciones distribuidas entre conexiones de red SNA y TCP/IP. Con los comandos SQL definidos en los asistentes de configuración de puertos, los profesionales de TI pueden crear fácilmente soluciones que integren de forma eficaz bases de datos DB2 sin escribir código.

El adaptador sirve dos funciones principales:

  • En el caso de las operaciones de envío (one way y solicitar respuesta), el adaptador envía comandos SQL y procedimientos almacenados a una instancia de DB2, con la opción de solicitar una respuesta.

  • En el caso de las operaciones receive (solo One Way), el adaptador crea un comando SQL o un procedimiento almacenado que sondea objetos DB2 y crea mensajes por fila, que luego se envían al sistema de mensajes de BizTalk.

    Además, el adaptador de BizTalk para DB2 usa la herramienta estándar de seguimiento del adaptador de BizTalk como mecanismo de solución de problemas.

Creación de un puerto de envío de DB2

Inicie sesión con una cuenta que sea miembro del grupo administradores de BizTalk Server.

  1. En BizTalk Server Administración, expanda Grupo de BizTalk, expanda Aplicaciones y, a continuación, seleccione la aplicación.

  2. Haga clic con el botón derecho en Puertos de envío, seleccione Nuevoy, a continuación, seleccione Puerto de envío unidireccional estático.

  3. En Propiedades de puerto de envío, establezca el tipo de transporte en DB2. Seleccione Configurar y escriba las siguientes propiedades:

    Use Para hacer esto
    BulkCopyBatchSize La propiedad BulkCopyBatchSize indica al adaptador el número de filas que se van a procesar por transacción por lotes. Esta propiedad opcional acepta un valor entero . El valor predeterminado es 20. Un valor de 0 indica al adaptador que procese todas las filas de un solo lote.
    CommandTimeout La propiedad CommandTimeout establece el tiempo de espera antes de que el adaptador finalice un intento de ejecutar un comando y, a continuación, genere un error. Esta propiedad opcional acepta un valor entero . El valor predeterminado es de 30 segundos. Un valor de 0 indica ningún límite (un intento de ejecutar un comando esperará indefinidamente).
    Cadena de conexión Nombre de un cadena de conexión que se usa para conectarse a la base de datos DB2.

    Para configurar una cadena de conexión nueva o existente, haga clic en los puntos suspensivos (...). Esto inicia el Asistente para orígenes de datos.

    Para acceder a la Ayuda, haga clic en Ayuda en las páginas del asistente o abra la Ayuda de Host Integration Server y busque en el Asistente para orígenes de datos (DB2).
    Conjunto de registros de DB2 La propiedad DB2 Set Registers indica al adaptador que ejecute una o varias instrucciones SET de SQL. Esta propiedad opcional acepta un valor de cadena . El valor predeterminado es una cadena vacía, que indica que no hay ninguna instrucción. La sintaxis admitida es una lista delimitada por punto y coma de comandos de instrucción SET con una lista separada por comas de valores de instrucción SET "<SET command 1> space <SET value 1> semi-colon; <Comando SET 2> espacio <SET valor un> valor SET coma <SET valor b> punto y coma"). Por ejemplo, escriba "SET CURRENT PATH 'DSN8910', 'HISDEMO'".
    Target Namespace de documento Espacio de nombres de destino que se usa en los documentos XML que se envían a DB2.
    Nombre de elemento raíz de respuesta Nombre del elemento raíz que se usa en los documentos XML que se reciben de DB2. (Esta propiedad puede estar vacía para un puerto unidireccional).
    URI Identificador uniforme de recursos. Nombre para identificar la ubicación del puerto de envío. El valor predeterminado es DB2://.
    UseBulkCopy La propiedad UseBulkCopy indica al adaptador que procese los comandos INSERT del puerto de envío en modo de copia masiva para mejorar el rendimiento. Esta propiedad opcional acepta un valor booleano . El valor predeterminado es false.

  4. Seleccione Aceptar para guardar los cambios.

  5. En El controlador de envío, seleccione la instancia de host para ejecutar el adaptador y seleccione la canalización de envío.

  6. Seleccione Aceptar para guardar los cambios.

  7. En Puertos de envío, haga clic con el botón derecho en el nuevo puerto de envío y seleccione Inscribir y, a continuación, Iniciar.

Creación de un puerto de recepción de DB2

Inicie sesión con una cuenta que sea miembro del grupo administradores de BizTalk Server.

  1. En BizTalk Server Administración, expanda Grupo de BizTalk, expanda Aplicaciones y, a continuación, seleccione la aplicación.

  2. Haga clic con el botón derecho en Puertos de recepción, seleccione Nuevoy, a continuación, seleccione Puerto de recepción unidireccional. Configure las propiedades y seleccione Aceptar.

  3. Haga clic con el botón derecho en Ubicaciones de recepción, seleccione Nuevoy, a continuación, seleccione Ubicación de recepción unidireccional. Seleccione el puerto de recepción que acaba de crear y haga clic en Aceptar.

  4. En Propiedades de ubicación de recepción, establezca el tipo de transporte en DB2. Seleccione Configurar y escriba las siguientes propiedades:

    Use Para hacer esto
    CommandTimeout La propiedad CommandTimeout establece el tiempo de espera antes de que el adaptador finalice un intento de ejecutar un comando y, a continuación, genere un error. Esta propiedad opcional acepta un valor entero. El valor predeterminado es 30 segundos. Un valor de 0 indica ningún límite (un intento de ejecutar un comando esperará indefinidamente).
    Cadena de conexión Escriba el nombre de un cadena de conexión que se usará para conectarse a la base de datos DB2.

    Para configurar una cadena de conexión nueva o existente, haga clic en los puntos suspensivos (...). Esto inicia el Asistente para orígenes de datos. Para acceder a la Ayuda, haga clic en Ayuda en las páginas del asistente o abra la Ayuda de Host Integration Server y busque en el Asistente para orígenes de datos (DB2).
    Conjunto de registros de DB2 La propiedad DB2 Set Registers indica al adaptador que ejecute una o varias instrucciones SET de SQL. Esta propiedad opcional acepta un valor booleano. El valor predeterminado es una cadena vacía, que indica que no hay ninguna instrucción. La sintaxis admitida es una lista delimitada por punto y coma de comandos de instrucción SET con una lista separada por comas de valores de instrucción SET "<SET command 1> space <SET value 1> semi-colon; <Comando SET 2> espacio <SET valor un> valor SET coma <SET valor b> punto y coma"). Por ejemplo, escriba "SET CURRENT PATH 'DSN8910', 'HISDEMO'".
    Nombre de elemento raíz de documento Nombre del elemento raíz que se usa en los documentos XML que se reciben de DB2.
    Target Namespace de documento Espacio de nombres de destino que se usa en los documentos XML que se reciben de DB2.
    Comando SQL Comando select o stored procedure que se ejecuta una vez para cada intervalo de sondeo.
    Comando Update El comando que se ejecuta después de procesar cada fila de la operación de recepción. Puede ser una instrucción delete que elimine la fila de la tabla en el comando SQL o un comando de actualización que modifique estáticamente una o varias filas. Cuando se especifica esta opción, el comando SQL debe ser una instrucción Select y debe tener acceso a una sola tabla.
    URI Nombre que identifica la ubicación del puerto de recepción. El valor predeterminado es DB2://.
    Intervalo de sondeo Número de unidades entre solicitudes de sondeo. El intervalo permitido es de 1 a 65535.
    Unidad de sondeo de medida Unidad de medida (segundos, minutos o horas) usadas entre solicitudes de sondeo. El valor predeterminado es segundos.

  5. Seleccione Aceptar para guardar los cambios.

  6. En Controlador de recepción, seleccione la instancia de host para ejecutar el adaptador. El controlador de recepción debe estar en ejecución en este host. Seleccione la canalización de recepción. . Seleccione Aceptar para guardar los cambios.

  7. En Ubicaciones de recepción, haga clic con el botón derecho en la ubicación de recepción y, a continuación, en Habilitar.

Creación de un esquema de adaptador de DB2

  1. Abra el proyecto de Visual Studio de BizTalk.

  2. Haga clic con el botón derecho en el proyecto, seleccione Agregar, Agregar elementos generados y, a continuación, seleccione Agregar.

  3. En el cuadro de diálogo Agregar elementos generados , seleccione Agregar metadatos de adaptador.

  4. En el Asistente para agregar adaptador, en la página Seleccionar adaptador , seleccione DB2. En la lista Puerto, seleccione un puerto de envío configurado o una ubicación de recepción y, a continuación, seleccione Siguiente.

  5. En el Asistente para generación de esquemas del adaptador de DB2:

    1. En Información de base de datos, cree un cadena de conexión o seleccione un cadena de conexión existente.

    2. En Información de esquema, defina el espacio de nombres predeterminado, los elementos raíz y el tipo de puerto que se usará en el esquema.

      Si selecciona Puerto de recepción, solo se necesita un nombre de elemento raíz del documento de solicitud. Si selecciona Enviar puerto, se requieren nombres de elemento raíz de documento de solicitud y respuesta.

    3. En Información de tipo de instrucción, seleccione el tipo de comando de base de datos que se va a emitir.

      Si seleccionó recibir puertos en la página anterior, puede elegir una instrucción SQL SELECT o un procedimiento almacenado. Si seleccionó puertos de envío en la página anterior, puede elegir emitir un diagrama de actualización, un procedimiento almacenado o una instrucción SELECT.

    4. En Información de instrucciones, escriba los detalles sobre la base de datos DB2. Dependiendo de la información especificada anteriormente, están disponibles las siguientes propiedades:

      1. Recibir instrucción Select en el cuadro de diálogo Información de instrucciones, escriba una instrucción SELECT de SQL en el cuadro de edición del script SQL . Opcionalmente, haga clic en Examinar para cargar un archivo de texto que contiene una instrucción .

      2. Recibir procedimiento almacenado en el cuadro de diálogo Información de instrucciones , haga clic en un nombre de procedimiento almacenado. En la lista Parámetros, haga clic en la casilla Valor para cada parámetro necesario.

      3. Enviar diagrama de actualización en el cuadro de diálogo Información de la instrucción, haga clic en un nombre de tabla. En la lista Parámetros , haga clic en la casilla Valor de cada columna necesaria. Al usar BulkCopy, debe hacer clic en cada casilla Valor para seleccionar todas las columnas.

      4. Enviar procedimiento almacenado en el cuadro de diálogo Información de instrucción, haga clic en un nombre de procedimiento almacenado. En la lista Parámetros , haga clic en la casilla Valor para cada parámetro necesario.

      5. Enviar instrucción Select en el cuadro de diálogo Información de la instrucción, escriba instrucción SELECT de SQL en el cuadro de edición del script SQL. Opcionalmente, haga clic en Examinar para cargar un archivo de texto que contiene una instrucción .

  6. Seleccione Finalizar para completar el asistente.

Ahora tiene un esquema.