Durante el tiempo de ejecución, la actividad Ejecutar consulta ejecuta una sentencia SQL seleccionada.
La actividad Ejecutar consulta admite consultas parametrizadas - una consulta que contiene parámetros de entrada o de entrada y salida. Cuando se especifican parámetros de entrada en una consulta, el valor del parámetro se suministra durante el tiempo de ejecución. El carácter ?
de la siguiente sentencia SELECT especifica que hay un parámetro de entrada:
select * from myUserSchema.mySourceTable donde myUserSchema.mySourceTable.myColumn=?
En la sentencia SELECT anterior, el carácter
* especifica que la consulta devuelve la columna o columnas encontradas en la tabla
mySourceTable como parámetro o parámetros de salida. Por ejemplo, si
mySource
table contiene dos columnas, una del tipo CHAR y una del tipo VARCHAR, la actividad
Ejecutar consulta devuelve dos parámetros de salida, uno del tipo CHAR y otro del tipo VARCHAR.
Nota: Sólo se admite la sentencia SQL SELECT en la actividad Ejecutar consulta.
La sentencia SQL INSERT no se admite en la actividad Ejecutar consulta.
Los pasos para añadir y configurar una actividad
Ejecutar consulta en una orquestación se describen en los siguientes procedimientos:
Añadir una actividad Ejecutar consulta en la orquestación
- Cree o
abra una orquestación. Se visualiza una representación de la orquestación.
- Seleccione el separador Actividades y expanda la carpeta Base de datos.
- Arrastre la actividad Ejecutar consulta hacia la orquestación.
- Seleccione la actividad Ejecutar consulta
Crear, seleccionar o editar un punto final de base de datos
- Pulse la tarea Elegir punto final en la Lista de comprobación y
seleccione una de las siguientes acciones:
- Seleccione un punto final existente:
- Seleccione Examinar. Se abre el Explorador de proyectos.
- Seleccione un punto final existente y pulse Aceptar.
Salte al procedimiento Especificar la sentencia SQL QUERY.
- Seleccione un punto final existente y edítelo:
- Seleccione Examinar. Se abre el Explorador de proyectos.
- Seleccione un punto final existente y pulse Aceptar
- Pulse Editar. Se abre el panel Editar punto final.
- Cree un punto final: seleccione Nuevo. Se abre el panel Crear punto final.
- Cree o edite un punto final de base de datos
Especificar la sentencia SQL QUERY
- Seleccione la tarea Especificar consulta en
Lista de comprobación.
Se abre el panel Especificar consulta.
- Introduzca la consulta en el espacio en blanco visualizado en el panel. No coloque puntos y coma al final de la consulta.
- Pulse Visualizar columnas para revisar detalles de la columna a fin de que una tabla seleccionada le asista en la creación de la sentencia SQL al introducir columnas y nombres de tabla válidos.
- Seleccione un valor de codificación de caracteres alternativo para los parámetros de entrada y salida si la codificación deseada difiere de la codificación predeterminada para la base de datos utilizando una de las siguientes opciones:
- En la lista Codificación, seleccione uno de los tipos de codificación predeterminados.
- Introduzca directamente el tipo de codificación pulsando el campo Codificación y escribiendo el tipo de codificación.
- Pulse Validar consulta. Esta acción comprueba si la consulta es válida y llena los parámetros de entrada y salida en las tareas
Correlacionar entradas y Correlacionar salidas.
- Introduzca un valor en el campo FilasMáx. El campo FilasMáx especifica el número máximo de filas que deben devolverse desde la consulta durante el tiempo de ejecución.
Nota: Si se inicia la misma consulta varias veces en el mismo día/fecha, se devuelve el mismo conjunto de filas. Por ejemplo, si FilasMáx es igual a 1, la misma fila (la primera fila) siempre se devuelve cada vez que se inicia la consulta; no se produce ninguna iteración a pesar del conjunto de filas.
Especificar opciones de reintento para la consulta
Para especificar las opciones de reintento de la consulta:
- Configure las Opciones de reintento.
Nota: Para la actividad Consulta de ejecución de base de datos, si establece la opción de reintento en cero, el Dispositivo de integración reintentará la conexión indefinidamente.
Correlacionar la salida de la actividad
- Seleccione la tarea Correlacionar salidas en la Lista de comprobación.
Las columnas devueltas por la sentencia SELECT son los elementos que se visualizan bajo el elemento rows/row en el panel De actividad.
- No es necesario
correlacionar los parámetros de salida de esta actividad.
Consulte Creación de una correlación para obtener instrucciones
generales sobre las correlaciones.