Use the SQL component
- UpdatedJan 30, 2025
- 2 minutes to read
- Yokohama
- RPA Hub
Write custom SQL queries to perform various operations by using the SQL component in RPA Desktop Design Studio.
Before you begin
Role required: none
About this task
You can configure the properties for the SQL component. For more information about these properties, see Properties of the General components.
Procedure
- In the Toolbox pane, navigate to General > SQL.
- Drag the SQL component to the Design surface.
-
Click the component settings icon (
).
- Under the SCRIPT (SQL) heading, write the custom SQL query.
- (Optional)
To add a parameter to the query, do the following.
-
Click the add parameter icon (
).
- Update the data type of the parameter.
- Repeat the steps to add more parameters.
A Data In Port is added with each parameter you add. -
Click the add parameter icon (
- Click OK.
- To configure the input fields, see Configure port properties.
- To close the PORT PROPERTIES dialog, click OK.
-
Connect the data and control ports of the SQL component to the corresponding
ports of the other component as described in the following table.
Parameter Description Data Port type Connection Provider Takes the data table connection provider that enables an application to communicate with a database. - Example:
- SqlClient, MySqlClient
Data In Connection String Connection string helps in connecting to the required data source using the details, such as server name, username, and password. In the following connection strings for each authentication type, replace the placeholder parameter values (for example, <myUser> and <myPassword>) with actual values: - Example:
- For SQL authentication:
Server=<MY_SERVER>;Database=<MyDatabase>;User Id=<myUser>;Password=<myPassword>;
- For Windows authentication:
Server=MY_SERVER;Database=MyDatabase;Trusted_Connection=True;
- For Oracle database:
Data Source=MyTnsName;User Id=myUsername;Password=myPassword;
- For MySQL database:
Server=MY_SERVER;Database=MyDatabase;User Id=myUsername;Password=myPassword;
- For ODBC database:
Driver={SQL Server};Server=MY_SERVER;Database=MyDatabase;Uid=myUsername;Pwd=myPassword;
- For OLEDB database:
Provider=SQLOLEDB;Data Source=MY_SERVER;Initial Catalog=MyDatabase;User Id=myUsername;Password=myPassword;
Data In Parameter Takes the value of the parameter from a previously executed component. Data In DataTable Returns the data table and passes to the next component. Data Out - To view the output, right-click the Return field and click Preview Data.
- (Optional) To test the component, under the DESIGN tab, click Run.