sys.dm_os_memory_cache_entries (Transact-SQL)
Applies to: SQL Server Azure Synapse Analytics Analytics Platform System (PDW)
Returns information about all entries in caches in SQL Server. Use this view to trace cache entries to their associated objects. You can also use this view to obtain statistics on cache entries.
Note
To call this from Azure Synapse Analytics or Analytics Platform System (PDW), use the name sys.dm_pdw_nodes_os_memory_cache_entries
. This syntax is not supported by serverless SQL pool in Azure Synapse Analytics.
Column name | Data type | Description |
---|---|---|
cache_address |
varbinary(8) | Address of the cache. Not nullable. |
name |
nvarchar(256) | Name of the cache. Not nullable. |
type |
varchar(60) | Type of cache. Not nullable. |
entry_address |
varbinary(8) | Address of the descriptor of the cache entry. Not nullable. |
entry_data_address |
varbinary(8) | Address of the user data in the cache entry. 0x00000000 = Entry data address isn't available. Not nullable. |
in_use_count |
int | Number of concurrent users of this cache entry. Not nullable. |
is_dirty |
bit | Indicates whether this cache entry is marked for removal. 1 = marked for removal. Not nullable. |
disk_ios_count |
int | Number of I/Os incurred while this entry was created. Not nullable. |
context_switches_count |
int | Number of context switches incurred while this entry was created. Not nullable. |
original_cost |
int | Original cost of the entry. This value is an approximation of the number of I/Os incurred, CPU instruction cost, and the amount of memory consumed by entry. The greater the cost, the lower the chance that the item will be removed from the cache. Not nullable. |
current_cost |
int | Current cost of the cache entry. This value is updated during the process of entry purging. Current cost is reset to its original value on entry reuse. Not nullable. |
memory_object_address |
varbinary(8) | Address of the associated memory object. Nullable. |
pages_allocated_count |
bigint | Applies to: SQL Server 2008 (10.0.x) through SQL Server 2008 R2 (10.50.x). Number of 8-KB pages to store this cache entry. Not nullable. |
pages_kb |
bigint | Applies to: SQL Server 2012 (11.x) and later versions. Amount of memory in kilobytes (KB) used by this cache entry. Not nullable. |
entry_data |
nvarchar(2048) | Serialized representation of the cached entry. This information is cache store dependant. Nullable. |
pool_id |
int | Applies to: SQL Server 2008 R2 (10.50.x) and later versions. Resource pool ID associated with entry. Nullable. |
pdw_node_id |
int | Applies to: Azure Synapse Analytics, Analytics Platform System (PDW) The identifier for the node that this distribution is on. |
Permissions
For SQL Server and Azure SQL Managed Instance, you require VIEW SERVER STATE
permission.
SQL Server 2022 (16.x) and later versions, you require VIEW SERVER PERFORMANCE STATE
permission on the server.
On Azure SQL Database Basic, S0, and S1 service objectives, and for databases in elastic pools, the server admin account, the Microsoft Entra admin account, or membership in the ##MS_ServerStateReader##
server role is required. On all other SQL Database service objectives, either the VIEW DATABASE STATE
permission on the database, or membership in the ##MS_ServerStateReader##
server role is required.