ação Exportar para fluxo de arquivos

A ação Exportar para fluxo de arquivo recupera dados de um banco de dados usando uma instrução SELECT ou Procedimento armazenado e exporta o resultado da consulta para uma variável de fluxo de arquivo para manuseio e compartilhamento eficientes em tarefas de automação.

Você pode usar a ação Exportar para fluxo de arquivo tanto para Task Bot quanto para Tarefa de API a fim de manipular arquivos diretamente a partir de um banco de dados. Para obter mais informações, consulte Transmissão de arquivo utilizando a variável de arquivo.

Para automatizar a tarefa de ler dados de um banco de dados e exportá-los para uma variável de fluxo de arquivo, siga estas etapas:

Procedimento

  1. Insira o nome da sessão que você usou para se conectar ao servidor do banco de dados na ação Conectar. Para mais detalhes, consulte Como usar a ação Conectar para banco de dados.
  2. Selecione uma das opções a seguir para ler dados do banco de dados.
    • Instrução SELECT
    • Procedimento armazenado
    Usando instrução SELECT
    1. Insira a instrução SELECT para especificar os nomes de coluna e tabela.
      Este campo suporta a sintaxe SQL. Por exemplo, SELECT CustomerName,City FROM Customers
      Nota: O CTE (Common Table Expression) é suportado usando a palavra-chave WITH nos bancos de dados compatíveis com SQL, tais como Oracle e MySQL. Por exemplo,
      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
    Usando Procedimento armazenado
    1. Insira o nome do procedimento armazenado.
    2. Opcional: Clique em Adicionar parâmetro para fornecer um parâmetro de entrada ou configurar um parâmetro de saída.
      Selecione entre as seguintes opções de parâmetro:
      Opções Parâmetros e descrição Tipos de dados compatíveis
      Entrada O parâmetro é passado do bot para o procedimento armazenado.
      • Nome: Insira o nome do parâmetro no procedimento armazenado.
      • Valor (opcional): Insira um valor ou selecione uma variável.
      • Tipo: Selecione o tipo de dados necessário na lista.
      Por exemplo, se estiver executando a função de exemplo da ação Gerenciar procedimento armazenado, configure os dois parâmetros e valores de entrada a seguir para a função sum_of_two a ser adicionada:
      • Parâmetro 1: num1, 5, TINYINT
      • Parâmetro 2: num2, 10, TINYINT
      • BIGINT (número)
      • BINÁRIO (Booleano)
      • BIT (número)
      • CHAR (string)
      • DATA (data e hora)

        Formato suportado yyyy-mm-dd

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

        Escolha padrão para valores decimais.

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

        Utiliza 4 bytes para armazenar um número inteiro com um valor de -2.147.483.648 a 2.147.483.647

      • LONGVARBINÁRIO (Booleano)
      • LONGVARCHAR (string)
      • NUMERIC (número)
      • REAL (número)
      • SMALLINT (número)

        Utiliza 2 bytes para armazenar um número inteiro com um valor de -32.768 a 32.767

      • TIME (data e hora)

        Formato suportado hh:mm:ss

      • TIMESTAMP (data e hora)

        Formato suportado yyyy-mm-dd hh:mm:ss.f, onde f é fracionário segundos

      • TINYINT (número)

        Utiliza 1 byte para armazenar um número inteiro com um valor de 0 a 255

      • VARBINARY (Booleano)
      • VARCHAR (string)
      Saída O parâmetro é passado do procedimento armazenado para o bot.
      • Nome: Insira o nome do parâmetro no procedimento armazenado.
      • Tipo: Selecione o tipo de dados necessário na lista.

      Quando a automação é executada, a ação converte o tipo de dados do banco de dados em um tipo compatível com o Automation 360.

      Por exemplo, se estiver executando a função de exemplo sum_of_two da ação Gerenciar o procedimento de armazenamento, configure o parâmetro de saída: soma, TINYINT.
      Entrada/Saída O parâmetro pode ser usado para entrada e saída.
      • Nome: Insira o nome do parâmetro no procedimento armazenado.
      • Valor (opcional): Insira um valor ou selecione uma variável.
      • Tipo: Selecione o tipo de dados necessário na lista.
  3. Insira o número máximo de registros que você deseja recuperar.
    Você pode limitar os resultados da execução.
    Nota: Se você não especificar o número máximo de registros a serem buscados, essa ação recuperará todos os registros.
  4. Opcional: Insira um valor de tempo limite.
    Quando o tempo especificado terminar, a execução da instrução será interrompida mesmo que a execução não tenha sido concluída.
    Nota: Se você não especificar o valor de tempo limite, essa ação aguardará a conclusão da execução da consulta. Caso contrário, uma mensagem de erro será exibida se o tempo limite for atingido.
  5. Digite um nome de arquivo válido com extensão .CSV para o qual você deseja exportar o resultado da consulta.
    Nota: Esse é apenas um nome de arquivo de referência para enviar o resultado da consulta para a variável de fluxo de arquivo.
  6. Selecione uma das seguintes opções de codificação de arquivo CSV.
    • ANSI: Opção padrão. Usa a página de código padrão do sistema para codificação. Adequado para inglês e idiomas da Europa Ocidental sem caracteres especiais.
    • UNICODE: permite uma variedade mais ampla de caracteres (UTF-16). Adequado para dados que contêm texto multilíngue ou conjuntos de caracteres estendidos.
    • UTF8: Formato de Transformação Unicode (8 bits). Amplamente compatível com várias plataformas e ferramentas (Excel, Notepad++, etc.). Proporciona um tamanho de arquivo menor em comparação com UNICODE.
  7. Selecione se você deseja incluir os cabeçalhos das colunas no resultado da consulta.

    Sem cabeçalhos de coluna (Seleção padrão)

    Manny Pittsburgh
    Kate Los Angeles
    John Boston

    Com cabeçalhos de coluna

    NomeCliente Cidade
    Manny Pittsburgh
    Kate Los Angeles
    John Boston
  8. Especifique a variável de fluxo de arquivo para armazenar o resultado da consulta.
    Você pode criar uma variável de fluxo de arquivo usando a opção Criar variável ou selecionar uma variável de fluxo de arquivo existente na lista suspensa.
  9. Clique em Salvar.
    Ao executar uma tarefa de API com essa ação, a instrução SELECT ou o Procedimento armazenado obtém dados do banco de dados e salva a saída da consulta na variável de fluxo de arquivo especificada.