Skip to main content

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

This content has been archived and is no longer being updated.

Links may not function; however, this content may be relevant to outdated versions of the product.

Setting up reports database

Updated on April 5, 2022

In some cases, running reports can impact performance because of high demands on database processing. To reduce the performance impact of running reports, you can specify that some reports obtain data from a separate reports database, which can be a copy of all or part of the PegaRULES database.

Pega Platform provides support only for the separate reports database that include the same schema as the original database. A reports database might contain only a subset of the tables needed for reporting, and might contain old data.

  1. Work with a database administrator to create the reports database, identifying the tables, indexes, and views to include.
  2. Work with a database administrator to set up database replication, which uses a mirroring technique.
  3. Create a database data instance ( Data-Admin-DB-Name ) for the reports database and establish connectivity. For more information, see Creating database data instances.
  4. Update the Database Table data instances to identify this database on the Database tab in the Reports Database field.
  5. In the report definition rule that obtains data from the reports database, on the Data Access tab, select the Prefer reporting data source if defined option in the Reporting database field.
    Note: To require the use of a reports database for standard list view and summary view reports when the Prefer reporting data source if defined option is not selected, set the pyUseAlternateDb parameter to true when calling the Rule-Obj-ListView.ShowView or Rule-Obj-SummaryView.ShowView activities.
  • Disabling usage of a reports database

    You can disable a report from obtaining data from a reports database, even if the Prefer reporting data source if defined option is selected on the report definition rule form.

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