Como usar a ação Executar procedimento armazenado

Os procedimentos armazenados são um conjunto de declarações SQL que são criadas e armazenadas no banco de dados. Essas declarações SQL podem ser complexas e ter de ser executadas várias vezes. Use a ação Executar procedimento armazenado para executar os procedimentos armazenados existentes.

Nota:
  • Essa ação não é compatível com os tipos de banco de dados Microsoft Access ou SQLite.
  • A partir do Automation 360 v.22 (Versão 10526), para procedimentos armazenados, o limite de 32 caracteres para parâmetros de entrada e saída foi removido.

Procedimento

Para automatizar uma tarefa de executar um procedimento armazenado, execute as seguintes etapas:

  1. Insira o nome da sessão que você usou para conectar-se ao servidor do banco de dados na ação Conectar.
    Você não precisa fornecer os detalhes do servidor de banco de dados aqui porque você já associou esses detalhes com o nome da sessão ao usar a ação Conectar.
  2. Insira o nome do procedimento armazenado.
  3. 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çãoPassos
    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 dado entre as seguintes opções
      • 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)
    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:
    • Parâmetro 1: num1, 5, TINYINT
    • Parâmetro 2: num2, 10, TINYINT
    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 dado entre as seguintes opções
      • 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)

    Quando o bot funciona, a ação converte o tipo de dados do banco de dados em um Automation 360-tipo de dados suportados.

    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: sum, TINYINT.

    EntradaSaí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 dado entre as seguintes opções
      • 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)
  4. Insira o número máximo de registros a recuperar.
    Você pode limitar os resultados da execução.
  5. 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.
  6. Opcional: Selecione a opção Exportar dados para CSV para salvar os dados recuperados.
    Nota: A opção Exportar dados para CSV não é compatível com os tipos de banco de dados Banco de dados Oracle ou PostgreSQL Server. Use parâmetros de saída para recuperar valores.
    1. Selecione o caminho do arquivo da pasta Bots, o dispositivo local ou uma variável de arquivo existente.
    2. Selecione a codificação do arquivo CSV para ANSI, UNICODE, ou UTF8.
    3. Selecione se deseja exportar o arquivo CSV com ou sem os cabeçalhos das colunas.

      Com cabeçalhos de coluna

      NomeCliente Cidade
      Manny Pittsburgh
      Kate Los Angeles
      John Boston

      Sem cabeçalhos de coluna

      Manny Pittsburgh
      Kate Los Angeles
      John Boston
    4. Especifique se deseja substituir o arquivo ou anexar os dados ao arquivo existente se existir um arquivo CSV com o mesmo nome.
  7. Opcional: Selecione uma variável de dicionário para manter a saída se o procedimento armazenado retornar um valor.
    Cada nome de parâmetro de saída é uma chave de dicionário que contém o valor do parâmetro correspondente.
    Por exemplo, se você atribuir o sum_of_two função de saída para $Output$, quando o bot ligações $Output{sum}$ a variável retorna 15.
    Nota: Se você não souber o nome do parâmetro de saída, use a chave padrão Output anexado pelo número de índice do parâmetro.
  8. Clique em Salvar.