Skip to content

sys-dm-fts-memory-pools-transact-sql.md

Latest commit

 

History

History
68 lines (51 loc) · 3.52 KB

sys-dm-fts-memory-pools-transact-sql.md

File metadata and controls

68 lines (51 loc) · 3.52 KB
title sys.dm_fts_memory_pools (Transact-SQL)
description sys.dm_fts_memory_pools returns information about the shared memory pools available to the Full-Text Gatherer component for a full-text crawl or a full-text crawl range.
author rwestMSFT
ms.author randolphwest
ms.date 02/27/2023
ms.service sql
ms.subservice system-objects
ms.topic reference
ms.custom
ignite-2025
f1_keywords
dm_fts_memory_pools_TSQL
sys.dm_fts_memory_pools_TSQL
sys.dm_fts_memory_pools
dm_fts_memory_pools
helpviewer_keywords
sys.dm_fts_memory_pools dynamic management view
dev_langs
TSQL
monikerRange =azuresqldb-current || >=sql-server-2016 || >=sql-server-linux-2017 || =azuresqldb-mi-current || =fabric-sqldb

sys.dm_fts_memory_pools (Transact-SQL)

[!INCLUDE SQL Server Azure SQL Database Azure SQL Managed Instance FabricSQLDB]

Returns information about the shared memory pools available to the Full-Text Gatherer component for a full-text crawl or a full-text crawl range.

Column name Data type Description
pool_id int ID of the allocated memory pool.

0 = Small buffers

1 = Large buffers
buffer_size int Size of each allocated buffer in the memory pool.
min_buffer_limit int Minimum number of buffers allowed in the memory pool.
max_buffer_limit int Maximum number of buffers allowed in the memory pool.
buffer_count int Current number of shared memory buffers in the memory pool.

Permissions

On [!INCLUDEssNoVersion_md] 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.

Physical joins

:::image type="content" source="../../relational-databases/system-dynamic-management-views/media/join-dm-fts-memory-pools-1.svg" alt-text="Diagram of physical joins for sys.dm_fts_memory_pools.":::

Relationship cardinalities

From To Relationship
dm_fts_memory_buffers.pool_id dm_fts_memory_pools.pool_id Many-to-one

Examples

The following example returns the total shared memory owned by the [!INCLUDEmsCoName] Full-Text Gatherer component of the [!INCLUDEssNoVersion] process:

SELECT SUM(buffer_size * buffer_count) AS "total memory"   
    FROM sys.dm_fts_memory_pools;

Next steps

Full-Text Search and Semantic Search Dynamic Management Views and Functions (Transact-SQL)