LinkedIn
Copied!

Table of Contents

Creating database instances for prconfig references

Version:

Only available versions of this content are shown in the dropdown

Create a database data instance so that Pega Platform can access a database whose connectivity is defined in the prconfig.xml file.

To use a configured reference, you must have identified the database and its connectivity parameters in the prconfig.xml file under database/databases and restarted the server. For more information, see Changing node settings by modifying the prconfig.xml file.

Not supported in Pega Cloud Services environments.

  1. If the database platform of the additional database differs from the database platform of Pega Platform, or does not use postgresSQL, configure Pega Platform to access the database driver. For more information, see Defining the database driver.

  2. In the header of Dev Studio, click Create SysAdmin Database .

  3. Enter a short description, and in the Database field, enter a name for the external database.

    The database name that you enter must be specified in the prconfig.xml file under database/databases. For example, for an entry that is named database/databases/AcmeDB, enter AcmeDB.
  4. Click Create and open. The Edit <YourNewDatabaseName> Database page appears.

  5. Optional:

    To indicate the system of record, in the Integration system field, press the Down arrow key and select the name of the integration system to associate with this database.

    The value that you select is for informational purposes only, and does not affect the behavior of the database instance. You can use this value to organize rules for integration connectors, data types, and sources for data pages.
  6. In the How to connect list, click Use configuration in preferences.

  7. Optional:

    On the Advanced tab, specify the names of other database instances that should be reachable by views in this database.

    1. Under the Database Name list, click the Add item icon.

    2. In the Database Name field, press the Down arrow key, and select the name of a database instance that views in the external database need to access.

    This database instance describes the EXTERNAL1 database. Your Pega application needs to access a view in EXTERNAL1 that joins data from the DATA1 and DATA2 databases. Do the following steps:
    • Define database instances for DATA1 and DATA2.
    • On the database instance for EXTERNAL1, list DATA1 and DATA2 as other databases.
  8. Click Save.

  9. To test the database connection, on the Database tab, click Test connection.

    • If the test fails, diagnostic information appears in a new window. Modify the database instance until the test succeeds.
    • This test does not test the administrative user, if any, that you might have specified.

Have a question? Get answers now.

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