Database data instances

Complete the Database form to define each relational database to which the Pega Platform connects. After you identify a database and install a suitable JDBC library on the Pega Platform server, the Pega Platform can connect to and interact with that database.

The following tabs are available on this form:

Where referenced

Database data instances are referenced in database table data instances as a first key part.

Database Table data instances for the PegaRULES database are referenced implicitly by class rules. Database Table data instances for external relational databases are referenced in Connect SQL rules.


Use the Records Explorer to list database data instances on your system.


The Data-Admin-DB-Name class contains database data instances. They are part of the SysAdmin category.

Database table

Database data instances are always stored as rows of the pr4_base table.

Associated Ruleset

When you save a database data instance, or open an existing one, it is automatically associated with the ruleset of the Application rule for the current application. This association assists with application packaging. You can update the associated ruleset using the field in the upper right corner of the form. See Identifying parts of rule and data forms.

If there is no ruleset associated with the data instance (for example, for existing instances not previously associated with a ruleset), the Associated ruleset displays [none].