sp_helpcache

Description

Displays information about the objects that are bound to a data cache or the amount of overhead required for a specified cache size.

Syntax

sp_helpcache {cache_name | "cache_size[P | K | M | G]" ,
	‘instance instance_name’}

Parameters

cache_name

is the name of an existing data cache.

cache_size

specifies the size of the cache, specified by P for pages, K for kilobytes, M for megabytes, or G for gigabytes. The default is K.

instance_name

name of the instance whose cache you are investigating.

Examples

Example 1

Displays information about items bound to pub_cache:

sp_helpcache pub_cache

Example 2

Shows the amount of overhead required to create an 80MB data cache:

sp_helpcache "80M"

Example 3

Displays information about all caches and all items bound to them:

sp_helpcache

Example 4

For cluster environments – displays the overhead for the cache C2 on instance “blade1” for size 10M:

sp_helpcache 'C2', '10M', 'instance blade1'

Usage

Permissions

Any user can execute sp_helpcache. Permission checks do not differ based on the granular permissions settings.

Auditing

Values in event and extrainfo columns from the sysaudits table are:

Event

Audit option

Command or access audited

Information in extrainfo

38

exec_procedure

Execution of a procedure

  • Roles – Current active roles

  • Keywords or options – NULL

  • Previous value – NULL

  • Current value – NULL

  • Other information – All input parameters

  • Proxy information – Original login name, if set proxy in effect

See also

System procedures sp_bindcache, sp_cacheconfig, sp_poolconfig, sp_unbindcache, sp_unbindcache_all