# MySQL - Run custom SQL action

# Run custom SQL

This action lets you send a SQL string to the MySQL instance to be executed. It can be used to execute Data Manipulation Language (DML) statements like INSERT, UPDATE, SELECT and DELETE, as well as Data Definition Language (DDL) commands, like CREATE, ALTER and DROP.

This action requires a connection using OPA version 2.4.3 or newer.

Run custom SQL action Run custom SQL action

# Input fields

Input field Description
SQL

This field is required. Provide a valid SQL string to be executed. This SQL string will be executed in your MySQL instance.

If multiple SQL statements are provided, all of them will be executed. However, only results from the last statement will be returned. Make sure each statement is separated by a ; character.

You can map datapills here to execute dynamically changing SQL statements. Remember to wrap datapills in quotes ('').

Output fields

Use this input to describe the columns that you are expecting from your SQL statement.

If you do not expect any return values or do not need any, you may ignore this input field.

# Output fields

Input field Description
Rows

List of rows returned from the SQL execution. The fields in this list are defined by the Output fields input field.

If left blank, this row will be available in the datatree as an array datapill.

Rows affected

This is an integer value indicating the number of rows inserted/updated/deleted from the SQL string.

When executing SELECT statements, this will return nil.

When executing a DDL (for example, creating a table), the value 0 will be returned.

# Limitations

There is a size limit of 50000 rows when your custom SQL statement returns data.


Last updated: 4/7/2021, 4:36:34 AM