Run Query

UiPath.Database.Activities.ExecuteQuery

Description

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

Windows - Legada | Windows | Multiplataforma

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.

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 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 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.
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:
- Texto - Executa a consulta dada no parâmetro SQL.
- StoredProcedure - Chama o nome do procedimento especificado no parâmetro SQL.
- TableDirect - Chama 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

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 .

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 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.
- Tabela direta - 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.

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 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