Pular para o conteúdo principal
Docs
Acessar Studio
Roberty Studio
RPASQL Server

SQL Server - Query

SQL Server - Query

Executa uma instrução SQL em um banco de dados SQL Server. Suporta SELECT, INSERT, UPDATE, DELETE e outras instruções SQL padrão. Os resultados podem ser iterados com SQL Server: Para cada resultado ou acessados diretamente pelos retornos da ação.


Opções​

Conexão​

Referência à ação SQL Server: Conexão que será utilizada para executar a query.

Query a ser executada​

Instrução SQL a ser executada no banco SQL Server, por exemplo SELECT * FROM dbo.Clientes WHERE Ativo = 1.

Opções avançadas​

Transação​

Opção para selecionar uma transação previamente criada para ser utilizada junto com a execução desta query.

Tempo limite da query​

Tempo máximo, em segundos, de execução desta query. Quando vazio, vale o Tempo limite padrão das queries definido na SQL Server: Conexão. O valor 0 significa sem limite. Quando o limite é atingido, a ação falha; o que acontece com a query e com a conexão está descrito na seção Tempo limite da conexão. Campo opcional.

Retornos​

Código Javascript​

js
actions["id-da-acao"].query         // query executada (Texto)
actions["id-da-acao"].results       // resultados da query (Qualquer)
actions["id-da-acao"].resultsCount  // quantidade de registros retornados (Número)

Seleção de campos​

  • query — query executada (Texto)
  • results — resultados da query (Qualquer)
  • resultsCount — quantidade de registros retornados (Número)

Regras e Condições​

  • Os campos Conexão e Query são obrigatórios.
  • results e resultsCount são relevantes para instruções SELECT.
  • Para instruções INSERT, UPDATE ou DELETE, resultsCount retornará 0.
  • O campo Tempo limite da query é opcional e o valor é em segundos; 0 significa sem limite.
  • Quando o Tempo limite da query fica vazio, vale o tempo limite padrão das queries definido na conexão.
  • Se nenhum campo do grupo Tempo limite estiver preenchido na conexão, a query continua limitada a 15 segundos (ou ao Request Timeout da string de conexão), mesmo que o Tempo limite da query seja maior que esse valor ou 0.