acción Exportar a flujo de archivos

La acción Exportar a flujo de archivos recupera datos de una base de datos mediante una declaración SELECT o un procedimiento almacenado, y exporta el resultado de la consulta en una variable de flujo de archivos para un manejo y una compartición eficientes entre las tareas de automatización.

Puede utilizar la acción Exportar a flujo de archivos tanto para Bot de tarea como para Tarea API para gestionar archivos directamente desde una base de datos. Para obtener más información, consulte Transmisión de archivos mediante la variable de archivo.

Para automatizar la tarea de leer datos de una base de datos y exportarlos a una variable de flujo de archivos, siga estos pasos:

Procedimiento

  1. Escriba el nombre de la sesión que usó para conectarse al servidor de base de datos en la acción Conectar. Para obtener más información, consulte Uso de la acción Conectar para la base de datos.
  2. Seleccione una de las siguientes opciones para leer datos de la base de datos.
    • Declaración SELECT
    • Procedimiento almacenado
    Con la declaración SELECT
    1. Introduzca la declaración SELECT para especificar los nombres de columna y tabla.
      Este campo admite la sintaxis SQL. Por ejemplo, SELECT CustomerName,City FROM Customers
      Nota: La expresión de tabla común (CTE, del inglés Common Table Expression) es compatible con el uso de la palabra clave WITH en las bases de datos compatibles con SQL, como Oracle y MySQL. Por ejemplo:
      WITH customers_in_usa AS (SELECT CustomerName, state FROM customers WHERE country = 'USA') 
SELECT cName FROM customers_in_usa WHERE state = 'LA' ORDER BY CustomerName
    Con el procedimiento almacenado
    1. Escriba el nombre del procedimiento almacenado.
    2. 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:
      Opciones Parámetros y descripción Tipos de datos admitidos
      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 dato requerido de la lista.
      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 suma_de_dos para agregar:
      • Parámetro 1: num1, 5, TINYINT
      • Parámetro 2: num2, 10, TINYINT
      • BIGINT (número)
      • BINARY (booleano)
      • BIT (número)
      • CHAR (string)
      • DATE (fecha y hora)

        Formato compatible aaaa-mm-dd

      • DECIMAL (número)
      • DOBLE (número)

        Opción predeterminada para los valores decimales.

      • FLOTANTE (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 (string)
      • NUMERIC (número)
      • REAL (número)
      • SMALLINT (número)

        Utiliza 2 bytes para almacenar un número entero con un valor desde -32 768 hasta 32 767

      • TIEMPO (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)
      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 dato requerido de la lista.

      Cuando se ejecuta la automatización, 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 suma_de_dos de ejemplo desde la acción Administrar procedimiento almacenado, configure el parámetro de salida: suma, TINYINT.
      Entrada/salida 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 dato requerido de la lista.
  3. Ingrese el número máximo de registros que desea recuperar.
    Puede limitar los resultados de la ejecución.
    Nota: Si no especifica el valor máximo de registros para obtener, la acción recupera todos los registros.
  4. 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.
    Nota: Si no especifica el valor de tiempo de espera, entonces la acción espera a que se complete la ejecución de la consulta. De lo contrario, encuentra un mensaje de error si ocurre el tiempo de espera.
  5. Ingrese un nombre de archivo válido con la extensión .CSV al que desea exportar el resultado de la consulta.
    Nota: Este es solo un nombre de archivo de referencia para pasar el resultado de la consulta a la variable de flujo de archivos.
  6. Seleccione una de las siguientes opciones de codificación de archivos CSV.
    • ANSI: Opción predeterminada. Utiliza la página de códigos predeterminada del sistema para la codificación. Adecuado para inglés e idiomas de Europa Occidental sin caracteres especiales.
    • UNICODE: Admite una gama más amplia de caracteres (UTF-16). Adecuado para datos que contienen texto multilingüe o conjuntos de caracteres extendidos.
    • UTF8: Formato de Transformación Unicode (8 bits). Ampliamente compatible en varias plataformas y herramientas (Excel, Notepad++, etc.). Proporciona un tamaño de archivo más pequeño en comparación con UNICODE.
  7. Seleccione si desea incluir los encabezados de columna en el resultado de la consulta.

    Sin encabezados de columna (Selección predeterminada)

    Manny Pittsburgh
    Kate Los Ángeles
    John Boston

    Con encabezados de columna

    Nombredelcliente Ciudad
    Manny Pittsburgh
    Kate Los Ángeles
    John Boston
  8. Especifique la variable de flujo de archivos para almacenar el resultado de la consulta.
    Puede crear una variable de flujo de archivos mediante la opción Crear variable o seleccionar una variable de flujo de archivos existente desde la lista desplegable.
  9. Haga clic en Guardar.
    Cuando ejecuta una Tarea de API con esta acción, la declaración SELECT o el procedimiento almacenado obtiene datos de la base de datos y guarda la salida de la consulta en la variable de flujo de archivos especificada.