Run Query

UiPath.Database.Activities.ExecuteQuery

Description

Executa uma consulta em um banco de dados e retorna o resultado da consulta como um DataTable.

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.
• Consulta 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 that the total execution time of the activity may be greater than the actual query execution time, to which the TimeoutMS property applies.

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 obtida das atividades Connect ou Start Transaction. Se essa conexão for fornecida, as propriedades ConnectionString 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.
• Consulta 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

• Tabela de dados — a saída do comando SQL envolvido em uma variável DataTable .
  Observação:

  Quando você consulta uma tabela que possui colunas com tipo de dados Date , as colunas correspondentes na saída DataTable serão do tipo de dados DateTime .

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 consulta é 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.
• Consulta 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 por 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

• Tabela de dados — a saída do comando SQL envolvido em uma variável DataTable .