Skip to content

Latest commit

 

History

History
59 lines (48 loc) · 3.4 KB

File metadata and controls

59 lines (48 loc) · 3.4 KB
title sys.dm_os_memory_pools (Transact-SQL) | Microsoft Docs
ms.custom
ms.date 03/13/2017
ms.prod sql-non-specified
ms.reviewer
ms.suite
ms.technology
database-engine
ms.tgt_pltfrm
ms.topic language-reference
f1_keywords
sys.dm_os_memory_pools_TSQL
dm_os_memory_pools
dm_os_memory_pools_TSQL
sys.dm_os_memory_pools
dev_langs
TSQL
helpviewer_keywords
sys.dm_os_memory_pools dynamic management view
ms.assetid 1ef053f3-c6f3-456e-82b6-26e4bd630d46
caps.latest.revision 25
author JennieHubbard
ms.author jhubbard
manager jhubbard

sys.dm_os_memory_pools (Transact-SQL)

[!INCLUDEtsql-appliesto-ss2008-all_md]

Returns a row for each object store in the instance of [!INCLUDEssNoVersion]. You can use this view to monitor cache memory use and to identify bad caching behavior

Note

To call this from [!INCLUDEssSDWfull] or [!INCLUDEssPDW], use the name sys.dm_pdw_nodes_os_memory_pools.

Column name Data type Description
memory_pool_address varbinary(8) Memory address of the entry that represents the memory pool. Is not nullable.
pool_id int ID of a specific pool within a set of pools. Is not nullable.
type nvarchar(60) Type of object pool. Is not nullable. For more information, see sys.dm_os_memory_clerks (Transact-SQL).
name nvarchar(256) System-assigned name of this memory object. Is not nullable.
max_free_entries_count bigint Maximum number of free entries that a pool can have. Is not nullable.
free_entries_count bigint Number of free entries currently in the pool. Is not nullable.
removed_in_all_rounds_count bigint Number of entries removed from the pool since the instance of [!INCLUDEssNoVersion] was started. Is not nullable.
pdw_node_id int Applies to: [!INCLUDEssSDWfull], [!INCLUDEssPDW]

The identifier for the node that this distribution is on.

Permissions

On [!INCLUDEssNoVersion_md], requires VIEW SERVER STATE permission.
On [!INCLUDEssSDS_md] Premium Tiers, requires the VIEW DATABASE STATE permission in the database. On [!INCLUDEssSDS_md] Standard and Basic Tiers, requires the Server admin or an Azure Active Directory admin account.

Remarks

[!INCLUDEssNoVersion] components sometimes use a common pool framework to cache homogeneous, stateless types of data. The pool framework is simpler than cache framework. All entries in the pools are considered equal. Internally, pools are memory clerks and can be used in places where memory clerks are used.

See Also

SQL Server Operating System Related Dynamic Management Views (Transact-SQL)