9/13/2016

Home

CacheManagement

AboutAdiva

Services

Training

Careers

Blog

ContactUs

Sitemap

Testimonials

Videos

WHENCLIENTSNEEDTHEBESTITTALENT:

Youarehere: OBIEE

CacheManagement

CacheManagement
WrittenbySK

Ratethisitem

(3votes)

PopularPostinOBBIE
Cacheisthemostimportantfeatureusedforobtaininganoptimizedreportanddashboardperformance.Howeverwhenmanagedpoorly,
itmightleadtostaledataappearinginreports.Hencecachemustbepurgedatintervalsbasedontherightperception.E.g.cachemust
bedeletedafterETLhascompletedthedataloadtothewarehousetables.
CachemanagementinOBIEEisdonefrommultiplepointsandthisisdeterminedbywhoispurgingit.

OBIEE11gInstallation
OBIEEServer
Administration
OBIEEVariables
CacheManagement
Categories
OBIEE
BIPublisher
OracleApplication
Framework

CacheAccessPoint

OBIEERole

OnlineRPDfile

Developer

BIAPPS

AnalysisPage

ReportEndUsersandDevelopers

JDEdwardsBIPublisher

Scripts

Administrators

Hyperion

Enablingcache

Cachingmustbeenabledfirstforthistobemanaged.Todothisopenthenqsconfigfileandeditthefollowing(inred)
###############################################################################
#
#QueryResultCacheSection
#
###############################################################################
[CACHE]
ENABLE=YES#ThisConfigurationsettingismanagedbyOracleBusinessIntelligenceEnterpriseManager

Asthisop oniscontrolledfromEnterpriseManager,restar ngtheBIServicewillresetthisop ontowhatisdeneis

EnterpriseManager.Henceforpermanentlyse ngthisop ontoYes/NOthismustbedoneinEM.Naviga on:OpenEM>
BusinessIntelligence>Coreapplica on>CapacityManagement>Performance
SeeScreenshot
http://www.adivaconsulting.com/blogobiee/item/60cache_manage.html

1/9

9/13/2016

CacheManagement

DeletingcachefromRPD

Openrpdinonlinemode

NavigatetoManage>Cache

ThecachemanagerscreenshowsthevariousSQLstoredinCache

http://www.adivaconsulting.com/blogobiee/item/60cache_manage.html

2/9

9/13/2016

CacheManagement

OnemayseethesqlrelatedtoeachcacheentryusingShowSQL.

ShowSQLoptionoftheabovestepopensupawindowwiththeLogicalSQLofthecachedquery

Purgecanbeusedtodeleteoneormorecacheentries.

http://www.adivaconsulting.com/blogobiee/item/60cache_manage.html

3/9

9/13/2016

CacheManagement

CreateaconnectionasshownabovewithDatabaseasODBCBasic

CreateaconnectionpoolcalledAnalyticsWebwithcallinterfaceasODBC2.0

CreateanewAnalysis

http://www.adivaconsulting.com/blogobiee/item/60cache_manage.html

4/9

9/13/2016

CacheManagement

SelectCreateDirectDatabaseRequest

SpecifytheConnectionPoolcreatedinfirststep(thisconnectionpooliscreatedinrpdexclusivelyforcachemanagement,dontusethe
oneforreports)
SQLStatement:SpecifytheOBIEEcommandfordeletingcache,itcanbeeitherofthefollowing:
CallSAPurgeAllCache()Deletesallcacheinfo
CallSAPurgeCacheByTable('Datwarehouse','','DWH','XW_SALES_F')deletesspecifictablecache
CallSAPurgeCacheByDatabase('Datwarehouse')Deletesallcacherelatedtoaspecificdatabase
CallSAPurgeCacheByQuery('SELECT0s_0,"SalesSubjectArea"."TimeDimension"."MONTH_NAME"s_1,"SalesSubject
Area"."FactSales"."COST_PRICE"s_2FROM"SalesSubjectArea"ORDERBY1,2ASCNULLSLAST')DeletesspecificlogicalSQL
Cache
ValidateSQLandRetrieveColumns:Thiswillvalidatethecommandissuedinpreviousstep

ClickonresultsTab,ThemessageinRESULT_MESSAGEcolumnindicatesthesuccessofcachedeletionoperation.
ClickonresultsTab,ThemessageinRESULT_MESSAGEcolumnindicatesthesuccessofcachedeletionoperation.
DeletingCacheusingascript
Onecancreateasimple.txtfileandspecifythecachedeletioncommand,whichcanbeoneormoreofthefollowing:
CallSAPurgeAllCache()Deletesallcacheinfo

http://www.adivaconsulting.com/blogobiee/item/60cache_manage.html

5/9

9/13/2016

CacheManagement

CallSAPurgeCacheByTable('Datwarehouse','','DWH','XW_SALES_F')deletesspecifictablecache
CallSAPurgeCacheByDatabase('Datwarehouse')Deletesallcacherelatedtoaspecificdatabase
CallSAPurgeCacheByQuery('SELECT0s_0,"SalesSubjectArea"."TimeDimension"."MONTH_NAME"s_1,"SalesSubject
Area"."FactSales"."COST_PRICE"s_2FROM"SalesSubjectArea"ORDERBY1,2ASCNULLSLAST')DeletesspecificlogicalSQL
Cache
e.g.c:\del_cache.txthasthecommandCallSAPurgeAllCache()
Thisscriptcanberunusingthefollowingcommand:
D:\OBIEE11G\Oracle_BI1\bifoundation\server\bin\nqcmddcoreapplication_OH833456789uadminpweblogics
c:\del_cache.txt
d:OBIEEDriverName:CopufromwindowsDSNNames
u:Administratorusername
p:Administratorpassword
s:scriptpath
NQConfig.inifileparametersrelatedtocachemanagement
QueryResultCacheSectionParameters
TheparametersintheQueryResultCacheSectionprovideconfigurationinformationforOracleBIServercaching.Thequerycacheis
enabledbydefault.Afterdecidingonastrategyforflushingoutdatedentries,youshouldconfigurethecachestorageparametersin
FusionMiddlewareControlandintheNQSConfig.INIfile.
Notethatquerycachingisprimarilyaruntimeperformanceimprovementcapability.Asthesystemisusedoveraperiodoftime,
performancetendstoimproveduetocachehitsonpreviouslyexecutedqueries.Themosteffectiveandpervasivewaytooptimizequery
performanceistousetheAggregatePersistencewizardandaggregatenavigation.
Thissectiondescribesonlytheparametersthatcontrolquerycaching.ForinformationabouthowtousecachinginOracleBusiness
Intelligence,includinginformationabouthowtouseagentstoseedtheOracleBIServercache
ENABLE
Note:
TheENABLEparameteriscentrallymanagedbyFusionMiddlewareControlandcannotbechangedbymanuallyeditingNQSConfig.INI,
unlessallconfigurationthroughFusionMiddlewareControlhasbeendisabled(notrecommended).
TheCacheenabledoptiononthePerformancetaboftheCapacityManagementpageinFusionMiddlewareControlcorrespondstothe
ENABLEparameter.
Specifieswhetherthecachesystemisenabled.WhensettoNO,cachingisdisabled.WhensettoYES,cachingisenabled.Thequery
cacheisenabledbydefault.
Example:ENABLE=YES
DATA_STORAGE_PATHS
Specifiesoneormorepathsforwherethecachedqueryresultsdataisstoredandareaccessedwhenacachehitoccursandthe
maximumcapacityinbytes,kilobytes,megabytes,orgigabytes.Themaximumcapacityforeachpathis4GB.Foroptimalperformance,
thepathsspecifiedshouldbeonhighperformancestoragesystems.
Eachpathlistedmustbeanexisting,writablepathname,withdoublequotationmarks(")surroundingthepathname.Specifymapped
directoriesonly.UNCpathnamesandnetworkmappeddrivesareallowedonlyiftheservicerunsunderaqualifieduseraccount.
Youcanspecifyeitherfullyqualifiedpaths,orrelativepaths.Whenyouspecifyapaththatdoesnotstartwith"/"(onUNIX)or"<drive>:"(on
Windows),theOracleBIServerassumesthatthepathisrelativetothelocalwritabledirectory.Forexample,ifyouspecifythepath
"cache,"thenatruntime,theOracleBIServerusesthefollowing:
ORACLE_INSTANCE/bifoundation/OracleBIServerComponent/coreapplication_obisn/cache
Note:
MultipleOracleBIServersacrossaclusterdonotsharecacheddata.Therefore,theDATA_STORAGE_PATHSentrymustbeuniquefor
eachclusteredserver.Toensurethisuniqueentry,enterarelativepathsothatthecacheisstoredinthelocalwritabledirectoryforeach
OracleBIServer,orenterdifferentfullyqualifiedpathsforeachserver.

http://www.adivaconsulting.com/blogobiee/item/60cache_manage.html

6/9

9/13/2016

CacheManagement

Specifymultipledirectorieswithacommadelimitedlist.Whenyouspecifymultipledirectories,theyshouldresideondifferentphysical
drives.(Ifyouhavemultiplecachedirectorypathsthatallresolvetothesamephysicaldisk,thenbothavailableandusedspacemightbe
doublecounted.)
Syntax:DATA_STORAGE_PATHS="path_1"sz[,"path_2"sz{,"path_n"sz}]
Example:DATA_STORAGE_PATHS="cache"256MB
Note:
Specifyingmultipledirectoriesforeachdrivedoesnotimproveperformance,becausefileinputandoutput(I/O)occursthroughthesame
I/Ocontroller.Ingeneral,specifyonlyonedirectoryforeachdiskdrive.Specifyingmultipledirectoriesondifferentdrivesmightimprove
theoverallI/OthroughputoftheOracleBIServerinternallybydistributingI/Oacrossmultipledevices.
Thediskspacerequirementforthecacheddatadependsonthenumberofqueriesthatproducecachedentries,andthesizeoftheresult
setsforthosequeries.Thequeryresultsetsizeiscalculatedasrowsize(orthesumofthemaximumlengthsofallcolumnsintheresult
set)timestheresultsetcardinality(thatis,thenumberofrowsintheresultset).Theexpectedmaximumshouldbetheguidelineforthe
spaceneeded.
Thiscalculationgivesthehighendestimate,nottheaveragesizeofallrecordsinthecachedresultset.Therefore,ifthesizeofaresult
setisdominatedbyvariablelengthcharacterstrings,andifthelengthofthosestringsaredistributednormally,youwouldexpectthe
averagerecordsizetobeabouthalfthemaximumrecordsize.
Note:
Itisabestpracticetouseavaluethatislessthan4GB.Otherwise,thevaluemightexceedthemaximumallowablevalueforanunsigned
32bitinteger,becausevaluesover4GBcannotbeprocessedon32bitsystems.Itisalsoabestpracticetousevalueslessthan4GBon
64bitsystems.
Createmultiplepathsifyouhavevaluesinexcessof4GB.
MAX_ROWS_PER_CACHE_ENTRY
Specifiesthemaximumnumberofrowsinaqueryresultsettoqualifyforstorageinthequerycache.Limitingthenumberofrowsisa
usefulwaytoavoidconsumingthecachespacewithrunawayqueriesthatreturnlargenumbersofrows.Ifthenumberofrowsaquery
returnsisgreaterthanthevaluespecifiedintheMAX_ROWS_PER_CACHE_ENTRYparameter,thenthequeryisnotcached.
Whensetto0,thereisnolimittothenumberofrowspercacheentry.
Example:MAX_ROWS_PER_CACHE_ENTRY=100000
MAX_CACHE_ENTRY_SIZE
Note:
TheMAX_CACHE_ENTRY_SIZEparameteriscentrallymanagedbyFusionMiddlewareControlandcannotbechangedbymanually
editingNQSConfig.INI,unlessallconfigurationthroughFusionMiddlewareControlhasbeendisabled(notrecommended).
TheMaximumcacheentrysizeoptiononthePerformancetaboftheCapacityManagementpageinFusionMiddlewareControl
correspondstotheMAX_CACHE_ENTRY_SIZEparameter.
Specifiesthemaximumsizeforacacheentry.Potentialentriesthatexceedthissizearenotcached.Thedefaultsizeis20MB.
SpecifyGBforgigabytes,KBforkilobytes,MBformegabytes,andnounitsforbytes.
Example:MAX_CACHE_ENTRY_SIZE=20MB
MAX_CACHE_ENTRIES
Note:
TheMAX_CACHE_ENTRIESparameteriscentrallymanagedbyFusionMiddlewareControlandcannotbechangedbymanuallyediting
NQSConfig.INI,unlessallconfigurationthroughFusionMiddlewareControlhasbeendisabled(notrecommended).
TheMaximumcacheentriesoptiononthePerformancetaboftheCapacityManagementpageinFusionMiddlewareControlcorresponds
totheMAX_CACHE_ENTRIESparameter.
Specifiesthemaximumnumberofcacheentriesallowedinthequerycachetohelpmanagecachestorage.Theactuallimitofcache
entriesmightvaryslightlydependingonthenumberofconcurrentqueries.Thedefaultvalueis1000.
Example:MAX_CACHE_ENTRIES=1000
POPULATE_AGGREGATE_ROLLUP_HITS

http://www.adivaconsulting.com/blogobiee/item/60cache_manage.html

7/9

9/13/2016

CacheManagement

Specifieswhethertoaggregatedatafromanearliercachedqueryresultsetandcreateanewentryinthequerycacheforrollupcache
hits.ThedefaultvalueisNO.
Typically,ifaquerygetsacachehitfromapreviouslyexecutedquery,thenthenewqueryisnotaddedtothecache.Ausermighthavea
cachedresultsetthatcontainsinformationataparticularlevelofdetail(forexample,salesrevenuebyZIPcode).Asecondquerymight
askforthissameinformation,butatahigherlevelofdetail(forexample,salesrevenuebystate).The
POPULATE_AGGREGATE_ROLLUP_HITSparameteroverridesthisdefaultwhenthecachehitoccursbyrollingupanaggregatefroma
previouslyexecutedquery(inthisexample,byaggregatingdatafromthefirstresultsetstoredinthecache).Thatis,OracleBusiness
IntelligencesalesrevenueforallZIPcodesinaparticularstatecanbeaddedtoobtainthesalesrevenuebystate.Thisisreferredtoasa
rollupcachehit.
Normally,anewcacheentryisnotcreatedforqueriesthatresultincachehits.Youcanoverridethisbehaviorspecificallyforcacherollup
hitsbysettingPOPULATE_AGGREGATE_ROLLUP_HITStoYES.Nonrollupcachehitsarenotaffectedbythisparameter.Ifaqueryresult
issatisfiedbythecachethatis,thequerygetsacachehitthenthisqueryisnotaddedtothecache.WhenthisparameterissettoYES,
thenwhenaquerygetsanaggregaterolluphit,thentheresultisputintothecache.SettingthisparametertoYESmightresultinbetter
performance,butresultsinmoreentriesbeingaddedtothecache.
Example:POPULATE_AGGREGATE_ROLLUP_HITS=NO
USE_ADVANCED_HIT_DETECTION
Whencachingisenabled,eachqueryisevaluatedtodeterminewhetheritqualifiesforacachehit.Acachehitmeansthattheserverwas
abletousecachetoanswerthequeryanddidnotgotothedatabaseatall.TheOracleBIServercanusequerycachetoanswerqueries
atthesameorlaterlevelofaggregation.
TheparameterUSE_ADVANCED_HIT_DETECTIONenablesanexpandedsearchofthecacheforhits.Theexpandedsearchhasa
performanceimpact,whichisnoteasilyquantifiedbecauseofvariablecustomerrequirements.Customersthatrelyheavilyonquery
cachingandareexperiencingmissesmightwanttotestthetradeoffbetweenbetterquerymatchingandoverallperformanceforhigh
userloads.
MAX_SUBEXPR_SEARCH_DEPTH
Letsyouconfigurehowdeepthehitdetectorlooksforaninexactmatchinanexpressionofaquery.Thedefaultis5.
Forexample,atlevel5,aqueryontheexpressionSIN(COS(TAN(ABS(ROUND(TRUNC(profit))))))missesonprofit,whichisatlevel7.
Changingthesearchdepthto7opensupprofitforapotentialhit.
DISABLE_SUBREQUEST_CACHING
WhensettoYES,disablescachingatthesubrequest(subquery)level.ThedefaultvalueisNO.
Cachingsubrequestsimprovesperformanceandthecachehitratio,especiallyforqueriesthatcombinerealtimeandhistoricaldata.In
somecases,however,youmightdisablesubrequestcaching,suchaswhenothermethodsofqueryoptimizationprovidebetter
performance.
Example:DISABLE_SUBREQUEST_CACHING=NO
GLOBAL_CACHE_STORAGE_PATH
Note:
TheGLOBAL_CACHE_STORAGE_PATHparameteriscentrallymanagedbyFusionMiddlewareControlandcannotbechangedby
manuallyeditingNQSConfig.INI,unlessallconfigurationthroughFusionMiddlewareControlhasbeendisabled(notrecommended).
TheGlobalcachepathandGlobalcachesizeoptionsonthePerformancetaboftheCapacityManagementpageinFusionMiddleware
ControlcorrespondtotheGLOBAL_CACHE_STORAGE_PATHparameter.
Inaclusteredenvironment,OracleBIServerscanbeconfiguredtoaccessasharedcachethatisreferredtoastheglobalcache.The
globalcacheresidesonasharedfilesystemstoragedeviceandstoresseedingandpurgingeventsandtheresultsetsthatare
associatedwiththeseedingevents.
Thisparameterspecifiesthephysicallocationforstoringcacheentriessharedacrossclustering.Thispathmustpointtoanetworkshare.
Allclusteringnodessharethesamelocation.
YoucanspecifythesizeinKB,MB,orGB,orenteranumberwithnosuffixtospecifybytes.
Syntax:GLOBAL_CACHE_STORAGE_PATH="directoryname"SIZE
Example:GLOBAL_CACHE_STORAGE_PATH="C:\cache"250MB
MAX_GLOBAL_CACHE_ENTRIES
ThemaximumnumberofcacheentriesstoredinthelocationthatisspecifiedbyGLOBAL_CACHE_STORAGE_PATH.

http://www.adivaconsulting.com/blogobiee/item/60cache_manage.html

8/9

9/13/2016

CacheManagement

Example:MAX_GLOBAL_CACHE_ENTRIES=1000
CACHE_POLL_SECONDS
TheintervalinsecondsthateachnodepollsfromthesharedlocationthatisspecifiedinGLOBAL_CACHE_STORAGE_PATH.
Example:CACHE_POLL_SECONDS=300
CLUSTER_AWARE_CACHE_LOGGING
Turnsonloggingfortheclustercachingfeature.Usedonlyfortroubleshooting.ThedefaultisNO.
Example:CLUSTER_AWARE_CACHE_LOGGING=NO
"Ifyoufoundthisarticleuseful,pleaseratethesame"
Read7039times

Publishedin OBIEE

2comments
Monday,31December201210:01 postedbyGauravMisra

CommentLink

Goodone&WellExplained.
Report

Friday,26October201214:19 postedbyKrishna

CommentLink

Comprehensive,wellwritten.Thanks
Report

Leaveacomment
Makesureyouenterthe(*)requiredinformationwhereindicated.
BasicHTMLcodeisallowed.
Message*
enteryourmessagehere...

Name*
enteryourname...
Email*
enteryouremailaddress...
Enterthetwowordsyouseebelow

Submitcomment

backtotop

MobileVersion

Home | About Adiva | Services | Training | Careers | Blog | Contact Us | Site Map|Subscribe

http://www.adivaconsulting.com/blogobiee/item/60cache_manage.html

Top

Designed & Developed by aricentideas

9/9