Uso de laacción Ejecutar procedimiento almacenado

Los procedimientos almacenados son un conjunto de instrucciones SQL que se crean y almacenan en la base de datos. Estas instrucciones SQL pueden ser complejas y se las debe ejecutar varias veces. Use la acción Ejecutar procedimiento almacenado para ejecutar procedimientos almacenados existentes.

Nota:
  • Esta acción no es compatible con los tipos de base de datos de Microsoft Access o SQLite.
  • A partir de la versión v.22 de Automation 360 (Compilación 10526), para los procedimientos almacenados, se eliminó el límite de 32 caracteres para los parámetros de entrada y salida.

Procedimiento

Para automatizar la tarea de ejecución de un procedimiento almacenado, siga estos pasos:

  1. Escriba el nombre de la sesión que usó para conectarse al servidor de base de datos en la acción Conectar.
    No necesita proporcionar los detalles del servidor de base de datos aquí porque ya asoció esos detalles con el nombre de la sesión al usar la acción Conectar.
  2. Escriba el nombre del procedimiento almacenado.
  3. Opcional: Haga clic en Agregar parámetro para proporcionar un parámetro de entrada o configurar un parámetro de salida.
    Seleccione entre las siguientes opciones de parámetro:
    OpciónPasos
    Entrada El parámetro se pasa del bot al procedimiento almacenado.
    • Nombre: Escriba el nombre del parámetro del procedimiento almacenado.
    • Valor (opcional): Ingrese un valor o seleccione una variable.
    • Tipo: Seleccione el tipo de datos de las siguientes opciones
      • BIGINT (número)
      • BINARY (booleano)
      • BIT (número)
      • CHAR (cadena)
      • DATE (fecha y hora)

        Formato compatible aaaa-mm-dd

      • DECIMAL (número)
      • DOUBLE (número)

        Opción predeterminada para los valores decimales.

      • FLOAT (número)
      • INTEGER (número)

        Utiliza 4 bytes para almacenar un integer con un valor desde-2.147.483.648 hasta 2.147.483.647

      • LONGVARBINARY (booleano)
      • LONGVARCHAR (cadena)
      • NUMERIC (número)
      • REAL (número)
      • SMALLINT (número)

        Utiliza 2 bytes para almacenar un integer con un valor desde-32.768 hasta 32.767

      • TIME (fecha y hora)

        Formato compatible hh:mm:ss

      • TIMESTAMP (fecha y hora)

        Formato compatible aaaa-mm-dd hh:mm:ss.f, donde f son segundos fraccionarios

      • TINYINT (número)

        Utiliza 1 byte para almacenar un integer con un valor desde 0 hasta 255

      • VARBINARY (booleano)
      • VARCHAR (cadena)
    Por ejemplo, si se ejecuta la función de ejemplo desde la acción Administrar procedimiento almacenado, configure los siguientes dos parámetros de entrada y valores para la función sum_of_two a agregar:
    • Parámetro 1: num1, 5, TINYINT
    • Parámetro 2: num2, 10, TINYINT
    Salida El parámetro se pasa del procedimiento almacenado al bot.
    • Nombre: Escriba el nombre del parámetro del procedimiento almacenado.
    • Tipo: Seleccione el tipo de datos de las siguientes opciones
      • BIGINT (número)
      • BINARY (booleano)
      • BIT (número)
      • CHAR (cadena)
      • DATE (fecha y hora)

        Formato compatible aaaa-mm-dd

      • DECIMAL (número)
      • DOUBLE (número)

        Opción predeterminada para los valores decimales.

      • FLOAT (número)
      • INTEGER (número)

        Utiliza 4 bytes para almacenar un integer con un valor desde-2.147.483.648 hasta 2.147.483.647

      • LONGVARBINARY (booleano)
      • LONGVARCHAR (cadena)
      • NUMERIC (número)
      • REAL (número)
      • SMALLINT (número)

        Utiliza 2 bytes para almacenar un integer con un valor desde-32.768 hasta 32.767

      • TIME (fecha y hora)

        Formato compatible hh:mm:ss

      • TIMESTAMP (fecha y hora)

        Formato compatible aaaa-mm-dd hh:mm:ss.f, donde f son segundos fraccionarios

      • TINYINT (número)

        Utiliza 1 byte para almacenar un integer con un valor desde 0 hasta 255

      • VARBINARY (booleano)
      • VARCHAR (cadena)

    Cuando se ejecuta el bot, la acción convierte el tipo de datos de base de datos en un tipo de datos compatible con Automation 360.

    Por ejemplo, si se ejecuta la función sum_of_two desde la acción Administrar procedimiento almacenado, configure el parámetro de salida: sum, TINYINT.

    EntradaSalida El parámetro se puede utilizar tanto para la entrada como para la salida.
    • Nombre: Escriba el nombre del parámetro del procedimiento almacenado.
    • Valor (opcional): Ingrese un valor o seleccione una variable.
    • Tipo: Seleccione el tipo de datos de las siguientes opciones
      • BIGINT (número)
      • BINARY (booleano)
      • BIT (número)
      • CHAR (cadena)
      • DATE (fecha y hora)

        Formato compatible aaaa-mm-dd

      • DECIMAL (número)
      • DOUBLE (número)

        Opción predeterminada para los valores decimales.

      • FLOAT (número)
      • INTEGER (número)

        Utiliza 4 bytes para almacenar un integer con un valor desde-2.147.483.648 hasta 2.147.483.647

      • LONGVARBINARY (booleano)
      • LONGVARCHAR (cadena)
      • NUMERIC (número)
      • REAL (número)
      • SMALLINT (número)

        Utiliza 2 bytes para almacenar un integer con un valor desde-32.768 hasta 32.767

      • TIME (fecha y hora)

        Formato compatible hh:mm:ss

      • TIMESTAMP (fecha y hora)

        Formato compatible aaaa-mm-dd hh:mm:ss.f, donde f son segundos fraccionarios

      • TINYINT (número)

        Utiliza 1 byte para almacenar un integer con un valor desde 0 hasta 255

      • VARBINARY (booleano)
      • VARCHAR (cadena)
  4. Ingrese el número máximo de registros que desea recuperar.
    Puede limitar los resultados de la ejecución.
  5. Opcional: Introduzca un valor de tiempo de espera.
    Cuando transcurra el tiempo especificado, la ejecución de la instrucción se detendrá, incluso si no se completa la ejecución.
  6. Opcional: Seleccione la opción Exportar datos a CSV para guardar los archivos recuperados.
    Nota: La opción Exportar datos a CSV no es compatible con Base de datos de Oracle ni tipos de base de datos Servidor PostgreSQL. Utilice los parámetros de salida para recuperar valores.
    1. Seleccione la ruta del archivo desde la carpeta Bots, el dispositivo local o una variable de archivo existente.
    2. Seleccione la codificación del archivo CSV: ANSI, UNICODE o UTF8.
    3. Seleccione si desea exportar el archivo CSV con o sin los encabezados de columna.

      Con encabezados de columna

      Nombredelcliente Ciudad
      Manny Pittsburgh
      Kate Los Angeles
      John Boston

      Sin encabezados de columna

      Manny Pittsburgh
      Kate Los Angeles
      John Boston
    4. Especifique si desea sobrescribir el archivo o anexar los datos al archivo existente si ya hay un archivo CSV con el mismo nombre.
  7. Opcional: Seleccione una variable de diccionario para mantener la salida si el procedimiento almacenado devuelve un valor.
    Cada nombre de parámetro de salida es una clave de diccionario que contiene el valor del parámetro correspondiente.
    Por ejemplo, si se asigna la salida de función sum_of_two a $Output$, cuando el bot llama a $Output{sum}$, la variable devuelve 15.
    Nota: Si no conoce el nombre del parámetro de salida, utilice la clave predeterminada Output agregada por el número de índice del parámetro.
  8. Haga clic en Guardar.