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.

Observação: o pacote de atividades Database agora é compatível com o .NET 6 Windows.

Compatibilidade do projeto

Windows - Legada | Windows | Multiplataforma

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. O campo deve estar completo de acordo com a seleção de uma propriedade Tipo de comando.

Opções avançadas

Outro

• Parâmetros — um dicionário de parâmetros nomeados que estão vinculados ao comando SQL. A associação é feita especificando a instrução @parameterName no comando SQL. No ambiente de execução, parameterName será substituído por 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.

Windows, Windows - configuração herdada

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 valores booleanos (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 de 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 estão vinculados ao comando SQL. A associação é feita especificando a instrução @parameterName no comando SQL. No ambiente de execução, parameterName será substituído por seu valor do dicionário.
• Comando SQL — um comando SQL a ser executado. O campo deve estar completo de acordo com a seleção de uma propriedade TipoDeComando. 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

• Registros afetados - 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 .