Pular para o conteúdo principal
Docs
Acessar Studio
Roberty Studio
RPAMySQL

MySQL - Query

MySQL - Query

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


Opções​

ID da conexão​

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

Query a ser executada​

Instrução SQL a ser executada, por exemplo SELECT * FROM usuarios WHERE ativo = 1.

Opções avançadas​

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 MySQL: 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"].resultsCount  // quantidade de registros retornados (Número)
actions["id-da-acao"].query         // query executada (Texto)
actions["id-da-acao"].results       // resultados da query (Lista)
actions["id-da-acao"].insertedId    // id do registro inserido, se aplicável (Número)
actions["id-da-acao"].affectedRows  // quantidade de linhas afetadas (Número)
actions["id-da-acao"].changedRows   // quantidade de linhas alteradas (Número)

Seleção de campos​

  • resultsCount — quantidade de registros retornados pela query (Número)
  • query — query executada (Texto)
  • results — resultados da query (Lista)
  • insertedId — id do registro inserido, se aplicável (Número)
  • affectedRows — quantidade de linhas afetadas (Número)
  • changedRows — quantidade de linhas alteradas (Número)

Regras e Condições​

  • Os campos ID da conexão e Query são obrigatórios.
  • insertedId, affectedRows e changedRows são relevantes para instruções INSERT, UPDATE ou DELETE.
  • results e resultsCount são relevantes para instruções SELECT.
  • Na Versão 2.0, o campo Tempo limite da query é opcional e o valor é em segundos; 0 significa sem limite.
  • Na Versão 2.0, quando o Tempo limite da query fica vazio, vale o tempo limite padrão das queries definido na conexão.
  • Na Versão 1.0, o campo Tempo de espera é em segundos e o valor padrão é 120.