About the Refresh Interval for XML Data Sources

Managing Performance Tuning and Query Caching 7-13

7.5.1 Using Fusion Middleware Control to Enable and Disable Query Caching

You can use Fusion Middleware Control to enable or disable query caching. The query cache is enabled by default. Before you begin this procedure, ensure that you are familiar with the information in Section 3.2, Using Fusion Middleware Control to Update Oracle Business Intelligence Configuration Settings. To use Fusion Middleware Control to enable or disable query caching: 1. Go to the Business Intelligence Overview page, as described in Section 2.2.2, Using Fusion Middleware Control to Manage Oracle Business Intelligence System Components.

2. Display the Performance tab of the Capacity Management page.

3. Click Lock and Edit Configuration to allow changes to be made.

4. To enable query caching, select Cache enabled. To disable query caching, deselect

Cache enabled . Click the Help button on the page to access the page-level help. 5. Click Apply, then click Activate Changes. 6. Return to the Business Intelligence Overview page and click Restart. For information about using methods in the Oracle BI Systems Management API to change configuration settings, see Chapter 22, Introducing the Oracle BI Systems Management API.

7.5.2 Using Fusion Middleware Control to Set Query Cache Parameters

You can use Fusion Middleware Control to set the maximum number of cache entries in the query cache and the maximum size for a single cache entry. Before you begin this procedure, ensure that you are familiar with the information in Section 3.2, Using Fusion Middleware Control to Update Oracle Business Intelligence Configuration Settings. To use Fusion Middleware Control to set query cache parameters: 1. Go to the Business Intelligence Overview page, as described in Section 2.2.2, Using Fusion Middleware Control to Manage Oracle Business Intelligence System Components. 2. Display the Performance tab of the Capacity Management page.

3. Click Lock and Edit Configuration to allow changes to be made.

4. Complete the elements using the descriptions in the Help topic for the page. Click the Help button on the page to access the page-level help for the following options: ■ Maximum cache entry size ■ Maximum cache entries 5. Click Apply, then click Activate Changes. 6. Return to the Business Intelligence Overview page and click Restart. For information about using methods in the Oracle BI Systems Management API to change configuration settings, see Chapter 22, Introducing the Oracle BI Systems Management API. 7-14 System Administrators Guide for Oracle Business Intelligence Enterprise Edition

7.5.3 Manually Editing Additional Query Cache Parameters

You can set additional query cache parameters in the NQSConfig.INI file, including the following: ■ The DATA_STORAGE_PATHS parameter specifies one or more directories for query cache storage, and the maximum size for each storage directory. These directories are used to store the cached query results and are accessed when a cache hit occurs. See Section 7.7.1, About Cache Hits for more information about when cache is hit. The cache storage directories should reside on high performance storage devices, ideally devoted solely to cache storage. When the cache storage directories begin to fill up, the entries that are least recently used LRU are discarded to make space for new entries. ■ The MAX_ROWS_PER_CACHE_ENTRY parameter controls the maximum number of rows for any cache entry. Limiting the number of rows is a useful way to avoid using up the cache space with runaway queries that return large numbers of rows. If the number of rows a query returns is greater than the value specified in the MAX_ROWS_PER_CACHE_ENTRY parameter, then the query is not cached. ■ Typically, if a query gets a cache hit from a previously executed query, then the new query is not added to the cache. The POPULATE_AGGREGATE_ROLLUP_HITS parameter overrides this default when the cache hit occurs by rolling up an aggregate from a previously executed query. See Appendix A, NQSConfig.INI File Configuration Settings for more information about the additional query cache parameters.

7.5.4 Using Fusion Middleware Control to Set Global Cache Parameters

Before you begin this procedure, ensure that you are familiar with the information in Section 3.2, Using Fusion Middleware Control to Update Oracle Business Intelligence Configuration Settings. To use Fusion Middleware Control to set global cache parameters: 1. Go to the Business Intelligence Overview page, as described in Section 2.2.2, Using Fusion Middleware Control to Manage Oracle Business Intelligence System Components. 2. Display the Performance tab of the Capacity Management page.

3. Click Lock and Edit Configuration to allow changes to be made.

4. Complete the elements using the descriptions in the Help topic for the page. Click the Help button on the page to access the page-level help for the following options: ■ Global cache path ■ Global cache size 5. Click Apply, then click Activate Changes. 6. Return to the Business Intelligence Overview page and click Restart. For information about using methods in the Oracle BI Systems Management API to change configuration settings, see Chapter 22, Introducing the Oracle BI Systems Management API.