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 aceita apenas valores Boolean (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 em Try Catch e o valor da propriedade Continuar com erro for Verdadeiro, nenhum erro será capturado quando o projeto for executado.

• DisplayName - The display name of the activity. This field supports only String variables.
• Tempo limite - Especifica a quantidade de tempo (em milissegundos) para esperar 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 .
  Observação:

  The amount of time specified in this field does not include the response time for the query result retrieval. This means the total execution time of the activity may be greater than the actual query execution time, which the TimeoutMS property applies to.

Configuração de conexão

• String de conexão - A string de conexão usada para estabelecer uma conexão com 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 de banco de dados 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 com 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:
  • Text - Executes the query given in the SQL parameter.
  • StoredProcedure - Invokes the procedure name specified in the SQL parameter.
  • TableDirect - Invokes all records from a table.
• 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 com 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.
  • Table diretamente - 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 esperar que a atividade execute a tarefa antes de gerar um erro. O valor padrão é 30.000 milissegundos (30 segundos). O valor de 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.