Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

About Connect SQL rules

Updated on August 16, 2022

Use Connect SQL rules when your application needs to run complex Structured Query Language statements such as joins or stored procedures to update or extract information from an external database.

The following tabs are available on this form:

  • Open
  • Delete
  • Save
  • Browse

As an alternative, if your application needs to perform a simple browse, open, delete, or update operation against an external database, use the Connector and Metadata wizard to configure external table access. When external table access is configured for an external table, you can use the Obj-Open, Obj-Browse, and other Obj- methods to interact with that table through a class that represents it and you do not need to create SQL connector rules.


Use the Application Explorer to list the Connect SQL rules in your application. Use the Records Explorer to list all Connect SQL rules that are available to you.


To configure an SQL connection to an external database, use the following elements along with the Connect-SQL rule:

  • An activity that references one or more of four standard methods for operating on relational databases — RDB-Open, RDB-List, RDB-Delete, and RDB-Save. The names of the methods match the names of the tabs in the connector rule. An activity that uses RDB-Open to call a connector rule runs the SQL statement on that connectors Open tab, and so on.
  • A Database instance and one or more Database Table instances that provide access to the tables or views of the external database.
  • A JDBC library that provides access to the external database software.
  • Special data mapping syntax to associate properties with database columns.

Where referenced

Connect SQL rules can be referenced in an Integrator shape ( Integrator ) of a flow rule .

Note: As of Pega 7.1.8, this rule is deprecated for data pages. Existing data pages that reference the rule will still work, but you cannot reference it when you create or edit a data page.


Connect SQL rules are instances of the Rule-Connect-SQL class. They belong to the Integration-Connectors category.

  • Previous topic Connect JMS rules – Completing the Create, Save As, or Specialization form
  • Next topic Connect SQL form - Data Mapping

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us