Oracle - Run custom SQL action

Run custom SQL

This action lets you send a SQL string to the Oracle database 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.

Unlike Select rows using custom SQL, this action is not optimized for easy configuration. For SELECT statements with large number of columns, use that action instead. Using custom SQL is a great way to improve recipe efficiency and balance load between Workato and your database. Find out more in our best practices section how to use custom SQL to make your recipes more efficient.

OPA required

This action requires a connection using Workato on-prem agent. Find out more about on-prem connectivity here.

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 is executed in your Oracle database. If multiple SQL statements are provided, all of them are executed. However, only results from the last statement are 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 is 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 returns nil. When executing a DDL (for example, creating a table), the value 0 is returned.

Limitations

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