sys.dm_os_buffer_pool_extension_configuration (Transact-SQL)

APPLIES TO: yes SQL Server Azure SQL Database Azure Synapse Analytics (SQL DW) Parallel Data Warehouse

Returns configuration information about the buffer pool extension in SQL Server. Returns one row for each buffer pool extension file.

Column name	Data type	Description
path	nvarchar(256)	Path and file name of the buffer pool extension cache. Nullable.
file_id	int	ID of the buffer pool extension file. Is not nullable.
state	int	The state of the buffer pool extension feature. Is not nullable. 0 - Buffer pool extension disabled 1 - Buffer pool extension disabling 2 - Reserved for the future use 3 - Buffer pool extension enabling 4 - Reserved for the future use 5 - Buffer pool extension enabled
state_description	nvarchar(60)	Describes the state of the buffer pool extension feature. Is nullable. 0 = BUFFER POOL EXTENSION DISABLED 5 = BUFFER POOL EXTENSION ENABLED
current_size_in_kb	bigint	Current size of the buffer pool extension file. Is not nullable.

Permissions

Requires VIEW SERVER STATE permission on the server.

The following example returns all columns from the sys.dm_os_buffer_pool_extension_configruation DMV.

SELECT path, file_id, state, state_description, current_size_in_kb  
FROM sys.dm_os_buffer_pool_extension_configuration;

The following example returns the number of cached pages in each buffer pool extension file.

SELECT COUNT(*) AS cached_pages_count  
FROM sys.dm_os_buffer_descriptors  
WHERE is_in_bpool_extension <> 0  
;