sys.dm_xtp_system_memory_consumers (Transact-SQL)
Applies to: 
SQL Server
Azure SQL Database
Azure SQL Managed Instance
Reports system level memory consumers for In-Memory OLTP. The memory for these consumers comes either from the default pool (when the allocation is in the context of a user thread) or from the internal pool (if the allocation is in the context of a system thread).
SELECT *
FROM sys.dm_xtp_system_memory_consumers;
For more information, see In-Memory OLTP (In-Memory Optimization).
| Column name | Type | Description |
|---|---|---|
| memory_consumer_id | bigint | Internal ID for memory consumer. |
| memory_consumer_type | int | An integer that represents the type of the memory consumer with one of the following values: 0 - Shouldn't be displayed. Aggregates memory usage of two or more consumers. 1 - LOOKASIDE: Tracks memory consumption for a system lookaside. 2 - VARHEAP: Tracks memory consumption for a variable-length heap. 4 - IO page pool: Tracks memory consumption for a system page pool used for IO operations. |
| memory_consumer_type_desc | nvarchar(16) | The description of the type of memory consumer: 0 - Shouldn't be displayed 1 - LOOKASIDE 2 - VARHEAP 4 - PGPOOL |
| memory_consumer_desc | nvarchar(64) | Description of the memory consumer instance: VARHEAP: System heap. General purpose. Currently only used to allocate garbage collection work items. -OR- Lookaside heap. Used by lookasides when the number of items contained in the lookaside list reaches a predetermined cap (usually around 5,000 items). PGPOOL: For IO system pools there are three different sizes: System 4K page pool, System 64-K page pool, and System 256-K page pool. |
| lookaside_id | bigint | The ID of the thread-local, lookaside memory provider. |
| pagepool_id | bigint | The ID of the thread-local, page pool memory provider. |
| allocated_bytes | bigint | Number of bytes reserved for this consumer. |
| used_bytes | bigint | Bytes used by this consumer. Applies only to varheap memory consumers. Starting with SQL Server 2022 (16.x), applies to varheap and lookaside memory consumers. |
| allocation_count | int | Number of allocations. Starting with SQL Server 2022 (16.x), the number of allocations from the system heap for lookaside memory consumers. |
| partition_count | int | Internal use only. |
| sizeclass_count | int | Internal use only. |
| min_sizeclass | int | Internal use only. |
| max_sizeclass | int | Internal use only. |
| memory_consumer_address | varbinary | Internal address of the consumer. |
Permissions
Requires VIEW SERVER STATE permissions on the server.
Permissions for SQL Server 2022 and later
Requires VIEW SERVER PERFORMANCE STATE permission on the server.
Remarks
In SQL Server 2022 (16.x), this DMV has additional columns specific to Memory-optimized TempDB metadata memory improvements.
Examples
This example outputs the system memory consumers for the SQL Server instance:
SELECT memory_consumer_type_desc,
memory_consumer_desc,
allocated_bytes / 1024 as allocated_bytes_kb,
used_bytes / 1024 as used_bytes_kb,
allocation_count
FROM sys.dm_xtp_system_memory_consumers;
The output shows all memory consumers at system level. For example, there are consumers for transaction look aside.
memory_consumer_type_desc memory_consumer_desc allocated_bytes_kb used_bytes_kb allocation_count
------------------------------- --------------------- ------------------- -------------- ----------------
VARHEAP Lookaside heap 0 0 0
VARHEAP System heap 768 0 2
LOOKASIDE GC transaction map entry 64 64 910
LOOKASIDE Redo transaction map entry 128 128 1260
LOOKASIDE Recovery table cache entry 448 448 8192
LOOKASIDE Transaction recent rows 3264 3264 4444
LOOKASIDE Range cursor 0 0 0
LOOKASIDE Hash cursor 3200 3200 11070
LOOKASIDE Transaction save-point set entry 0 0 0
LOOKASIDE Transaction partially-inserted rows set 704 704 1287
LOOKASIDE Transaction constraint set 576 576 1940
LOOKASIDE Transaction save-point set 0 0 0
LOOKASIDE Transaction write set 704 704 672
LOOKASIDE Transaction scan set 320 320 156
LOOKASIDE Transaction read set 704 704 343
LOOKASIDE Transaction 4288 4288 1459
PGPOOL System 256K page pool 5120 5120 20
PGPOOL System 64K page pool 0 0 0
PGPOOL System 4K page pool 24 24 6
To see the total memory consumed by system allocators:
SELECT SUM(allocated_bytes) / (1024 * 1024) AS total_allocated_MB,
SUM(used_bytes) / (1024 * 1024) AS total_used_MB
FROM sys.dm_xtp_system_memory_consumers;
Here is the result set.
total_allocated_MB total_used_MB
-------------------- --------------------
2 2