sys.dm_fts_outstanding_batches (Transact-SQL)

Applies to: SQL Server Azure SQL Database Azure SQL Managed Instance

Returns information about each full-text indexing batch.

Column name Data type Description
database_id int ID of the database
catalog_id int ID of the full-text catalog
table_id int ID of the table ID that contains the full-text index
batch_id int Batch ID
memory_address varbinary(8) The batch object memory address
crawl_memory_address varbinary(8) Crawl object memory address (parent object)
memregion_memory_address varbinary(8) Memory region memory address of the outbound share memory of the filter daemon host (fdhost.exe)
hr_batch int Most recent error code for the batch
is_retry_batch bit Indicates whether this is a retry batch:

0 = No

1 = Yes
retry_hints int Type of retry needed for the batch:

0 = No retry

1 = Multi thread retry

2 = Single thread retry

3 = Single and multi thread retry

5 = Multi thread final retry

6 = Single thread final retry

7 = Single and multi thread final retry
retry_hints_description nvarchar(120) Description for the type of retry needed:

NO RETRY

MULTI THREAD RETRY

SINGLE THREAD RETRY

SINGLE AND MULTI THREAD RETRY

MULTI THREAD FINAL RETRY

SINGLE THREAD FINAL RETRY

SINGLE AND MULTI THREAD FINAL RETRY
doc_failed bigint Number of documents that failed in the batch
batch_timestamp timestamp The timestamp value obtained when the batch was created

Permissions

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.

Examples

The following example finds out how many batches are currently being processed for each table in the server instance.

SELECT database_id, table_id, COUNT(*) AS batch_count FROM sys.dm_fts_outstanding_batches GROUP BY database_id, table_id ;  
GO  

See Also

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