OBIEE - Purging / Disabling the Query Cache

About

How to purge the Query Cache

Articles Related

• OBIEE 10G/11G - Event Pooling table (Event Table) to purge the cache after ETL process
• OBIEE 10G/11G - BI Server (Logical Query|Result) Cache
• OBIEE - Request variable
• OBIEE - System session variables (reserved variables)
• Professional Experience

Disabling

For the entire application

To disable completly the query cache, you must set to the ENABLE cache parameter the value NO in the file nqsconfig.

[CACHE]

ENABLE = NO;

For one session

For one session, you have to set the session system variable with the value 1:

• DISABLE_CACHE_HIT
• DISABLE_CACHE_SEED

For one request / answer

For one session, you have to set this request variables with the value 1:

• DISABLE_CACHE_HIT
• DISABLE_CACHE_SEED

Example in the advanced tab of an answer :

Purging

Via ODBC functions

Note : Replace OracleBI_Home by your own directory.

Create a file PurgeAllCache.sql and add the SAPurgeAllCache ODBC Function :

{call SAPurgeAllCache()};

And save it in a directory (for instance OracleBI_Home\Cache).

Then from a command dos, call nqcmd with this statement :

OracleBI_Home\server\Bin\nqcmd.exe -d AnalyticsWeb -u Administrator -p Password 
-s "OracleBI_Home\Cache\PurgeAllCache.sql" -o "OracleBI_Home\Cache\PurgeAllCache.log"

You will retrieve then in the PurgeAllCache.log :

{call SAPurgeAllCache()}
----------------------------------------------------------------
RESULT_CODE  RESULT_MESSAGE
----------------------------------------------------------------
1            [59118] Operation SAPurgeAllCache succeeded!
----------------------------------------------------------------
Row count: 1
----------------------------------------------------------------
Processed: 1 queries

You can also use the ODBC Bi Server cache Function in a script that can call the job manager.

When failed:

call SAPurgeAllCache()
----------------------------------------------------------------
RESULT_CODE  RESULT_MESSAGE
----------------------------------------------------------------
59115        [59115] Operation not performed because caching is not enabled.
----------------------------------------------------------------
Row count: 1
----------------------------------------------------------------

With Dynamic Repository Variables

In the Server Administration Guide, section ”Understanding and Creating Repository Variables”, you can read that :

When the value of a dynamic repository variable changes, all cache entries associated with a business model that 
reference the value of that variable will be purged automatically.

This means that the query cache will be purged when the variable is refreshed. By creating a Dynamic Repository Variable that selects a specific value from a table you can easily easily trigger a cache purge.

For instance, from an ETL process :

• create a date column to contain the last update date from your datawarehouse
• then create a dynamic variable to refresh this value (every 10 minutes).
• then when the value change, the cache is automatically purged

Manually via the cache manager

• Open the Administration Tool
• In the Menu : Manage / Cache

Via web service

Obiee as a SOAP API that you can use to purge the cache : OBIEE - Web Services API (SOAP,WSDL)

Via the event pooling table

The use of an Oracle BI Server event polling table (event table) is a way to notify the Oracle BI Server that one or more physical tables have been updated. The Oracle BI Server cache system reads rows from, or polls, the event table, extracts the physical table information from the rows, and purges stale cache entries that reference those physical tables.

More … OBIEE 10G/11G - Event Pooling table (Event Table) to purge the cache after ETL process

by setting the Cache Persistence Time

You can purge the cache automatically for a particular table, by setting the Cache Persistence Time field in the Physical Table.