Run Query

mysql.query
ActionDatabases & warehousesconnection required

Executes SQL via aiomysql using the connection's credentials; returns rows.

Run a parameterised SQL query against a MySQL database.

Connection

Required
Yes — the node will not save without one
Auth type
Username & password
Providers
MySQL
Secret shape
the password, or {"password": "…"}
Config it needs
host, port, user, database
Resolved by
config.connection_id, else node.connection_id

Configuration

2 fields, 1 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.

FieldTypeRequiredDefaultConstraintsExample
sql
SQL with %s placeholders.
stringYes———
params
Values for %s placeholders (bound by the driver).
arrayNo———

Output

One shape.

result

FieldTypeExample
rows
Result rows (objects). Empty for a write.
array—
row_count
Rows returned, or rows affected for a write.
number—
{
  "row_count": 0,
  "rows": []
}

Notes

  • Use %s placeholders with params — never string-build SQL from untrusted input.
  • One statement per step. For a transaction across steps, model it in SQL.

See Run Query run in a workflow.

In a technical demo we add the MySQL connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.