Use the SQL component

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 1 minute de lecture

    • Write custom SQL queries to perform various operations by using the SQL component in RPA Desktop Design Studio.

    Avant de commencer

    Role required: none

    Pourquoi et quand exécuter cette tâche

    You can configure the properties for the SQL component. For more information about these properties, see Properties of the General components.

    Procédure

    1. In the Toolbox pane, navigate to General > SQL.
    2. Drag the SQL component to the Design surface.
    3. Click the component settings icon (Component settings icon.).
    4. Under the SCRIPT (SQL) heading, write the custom SQL query.
    5. Facultatif : To add a parameter to the query, do the following.
      1. Click the add parameter icon (Add parameter icon.).
      2. Update the data type of the parameter.
      3. Repeat the steps to add more parameters.
      A Data In Port is added with each parameter you add.
    6. Click OK.
    7. To configure the input fields, see Configure port properties.
    8. To close the PORT PROPERTIES dialog, click OK.
    9. 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
    10. To view the output, right-click the Return field and click Preview Data.
    11. Facultatif : To test the component, under the DESIGN tab, click Run.