Run Command

UiPath.Database.Activities.ExecuteNonQuery

Description

Executa uma instrução SQL em um banco de dados. Para instruções UPDATE, INSERT, e DELETE , o valor de retorno é o número de linhas afetadas pelo comando. Para todos os outros tipos de instruções, o valor de retorno é -1.

Compatibilidade do projeto

Windows - Legada | Windows | Multiplataforma

Windows - Legada, Configuração do Windows

Painel do Designer

• Configurar conexão... - Selecione uma conexão com banco de dados existente ou adicione uma nova usando o Assistente de conexão.
• Comando SQL - Um comando SQL a ser executado. Esse campo deve ser concluído de acordo com a seleção da propriedade Tipo de comando. Este campo é compatível apenas com variáveis String.

Painel de Propriedades

Comum

• Continuar com erro - Especifica se a automação deve continuar mesmo quando a atividade gera um erro. Este campo só aceita Boolean valores (True, False). O valor padrão é False. Como resultado, se o campo estiver em branco e um erro for lançado, a execução do projeto será interrompida. Se o valor for definido como True, a execução do projeto prosseguirá mesmo com erros.
  Observação: se esta atividade estiver incluída na atividade Try Catch e o valor da propriedade Continuar com erro for True, nenhum erro será capturado quando o projeto for executado.
• NomeDeExibição - o nome de exibição da atividade.Este campo é compatível apenas com variáveis String.
• Tempo limite — especifica o tempo (em milissegundos) para aguardar que o comando SQL seja executado antes de gerar um erro. O valor padrão é 30.000 milissegundos (30 segundos) e deve ser maior ou igual a 0. Este campo é compatível apenas com variáveis Int32 .
  Nota: A quantidade de tempo especificada neste campo não inclui o tempo de resposta para a recuperação do resultado da consulta. Isso significa que o tempo total de execução da atividade pode ser maior que o tempo real de execução da consulta, ao qual se aplica a propriedade TimeoutMS .

Configuração de conexão

• String de conexão — a string de conexão usada para estabelecer uma conexão de banco de dados. Este campo é compatível apenas com variáveis String .
• Conexão existente - Uma conexão com banco de dados já aberta. Se uma conexão assim estiver disponível, as propriedades StringDeConexão e SecureConnectionString serão ignoradas. Este campo é compatível apenas com variáveis DatabaseConnection.
• Nome do provedor — o nome do provedor usado para acessar o banco de dados. Este campo é compatível apenas com variáveis String .
• String de conexão segura — a string de conexão usada para estabelecer uma conexão de banco de dados como String Segura. Este campo é compatível apenas com variáveis SecureString .

Entrada

• Parâmetros - Um dicionário de parâmetros nomeados que são associados ao comando SQL. A associação é feita especificando a instrução @parameterName no comando SQL. No runtime, o parameterName é substituído por seu valor do dicionário.
• Comando SQL - Um comando SQL a ser executado. Esse campo deve ser concluído de acordo com a seleção da propriedade Tipo de comando. Este campo é compatível apenas com variáveis String.

Diversos

• Tipo de comando — especifica como uma string de comando é interpretada. As seguintes opções estão disponíveis:

  • Texto - Executa a consulta no parâmetro SQL.
  • StoredProcedure - Chama o nome do procedimento especificado no parâmetro SQL.
  • TableDirect - invoca todos os registros de uma tabela.
• Privado - Se selecionado, os valores de variáveis e argumentos não são mais registrados no nível Verbose.

Saída

• Contagem de linhas afetadas - O resultado da execução do comando SQL. Para instruções UPDATE, INSERT e DELETE, o valor de retorno é o número de linhas afetadas pelo comando. Para todos os outros tipos de instruções, o valor de retorno é -1. Este campo é compatível apenas com variáveis Int32.

Configuração multiplataforma

• Conexão existente - Uma conexão de banco de dados já aberta obtida da atividade Conectar ao banco de dados.
• Tipo de comando — especifica como uma string de comando é interpretada. As seguintes opções estão disponíveis:
  • Texto - Executa o comando SQL.
  • Procedimento armazenado - invoca o nome de procedimento especificado no comando SQL.
  • Tabela direta - invoca todos os registros de uma tabela.
• Comando SQL - Um comando SQL a ser executado. Essa propriedade deve ser concluída de acordo com a seleção da propriedade Tipo de comando.

Opções avançadas

Outro

• Parâmetros - Um dicionário de parâmetros nomeados que são associados ao comando SQL. A associação é feita especificando a instrução @parameterName no comando SQL. No runtime, o parameterName é substituído pela forma de seu valor do dicionário.
• Tempo limite — especifica a quantidade de tempo (em milissegundos) para aguardar que a atividade execute a tarefa antes de gerar um erro. O valor padrão é 30.000 milissegundos (30 segundos). O valor do tempo limite deve ser maior ou igual a 0.
• Continuar com erro - Especifica se a automação deve continuar mesmo quando a atividade gera um erro.

Saída

• Contagem de linhas afetadas - O resultado da execução do comando SQL.