sys.dm_os_process_memory (Transact-SQL)
Applies to: SQL Server Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)
Most memory allocations that are attributed to the SQL Server process space are controlled through interfaces that allow for tracking and accounting of those allocations. However, memory allocations might be performed in the SQL Server address space that bypasses internal memory management routines. Values are obtained through calls to the base operating system. They are not manipulated by methods internal to SQL Server, except when it adjusts for locked or large page allocations.
All returned values that indicate memory sizes are shown in kilobytes (KB). The column total_virtual_address_space_reserved_kb is a duplicate of virtual_memory_in_bytes from sys.dm_os_sys_info.
The following table provides a complete picture of the process address space.
Note
To call this from Azure Synapse Analytics or Analytics Platform System (PDW), use the name sys.dm_pdw_nodes_os_process_memory. This syntax is not supported by serverless SQL pool in Azure Synapse Analytics.
Column name | Data type | Description |
---|---|---|
physical_memory_in_use_kb | bigint | Indicates the process working set in KB, as reported by operating system, as well as tracked allocations by using large page APIs. Not nullable. |
large_page_allocations_kb | bigint | Specifies physical memory allocated by using large page APIs. Not nullable. |
locked_page_allocations_kb | bigint | Specifies memory pages locked in memory. Not nullable. |
total_virtual_address_space_kb | bigint | Indicates the total size of the user mode part of the virtual address space. Not nullable. |
virtual_address_space_reserved_kb | bigint | Indicates the total amount of virtual address space reserved by the process. Not nullable. |
virtual_address_space_committed_kb | bigint | Indicates the amount of reserved virtual address space that has been committed or mapped to physical pages. Not nullable. |
virtual_address_space_available_kb | bigint | Indicates the amount of virtual address space that is currently free. Not nullable. Note: Free regions that are smaller than the allocation granularity can exist. These regions are unavailable for allocations. |
page_fault_count | bigint | Indicates the number of page faults that are incurred by the SQL Server process. Not nullable. |
memory_utilization_percentage | int | Specifies the percentage of committed memory that is in the working set. Not nullable. |
available_commit_limit_kb | bigint | Indicates the amount of memory that is available to be committed by the process. Not nullable. |
process_physical_memory_low | bit | Indicates that the process is responding to low physical memory notification. Not nullable. |
process_virtual_memory_low | bit | Indicates that low virtual memory condition has been detected. Not 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
On SQL Server requires VIEW SERVER STATE permission on the server.
On SQL Server and SQL Managed Instance, requires VIEW SERVER STATE
permission.
On 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.
Permissions for SQL Server 2022 and later
Requires VIEW SERVER PERFORMANCE STATE permission on the server.
See also
Dynamic Management Views and Functions (Transact-SQL)
SQL Server Operating System Related Dynamic Management Views (Transact-SQL)