sp_query_store_flush_db (Transact-SQL)
Applies to: SQL Server 2016 (13.x) and later Azure SQL Database Azure SQL Managed Instance
Flushes the in-memory portion of the Query Store data to disk.
Transact-SQL syntax conventions
Syntax
sp_query_store_flush_db
[ ; ]
Return code values
0
(success) or 1
(failure).
Remarks
If Query Store for secondary replicas is enabled, when sys.sp_query_store_flush_db
is executed on a secondary replica, that secondary replica's cache is forced to flush to the cache on the primary replica. This can accelerate the Query Store cache data being synced to the primary replica, if the secondary replica cache flush is otherwise delayed under heavy workload.
Permissions
Requires the ALTER permission on the database.
Examples
The following example flushes the in-memory portion of the Query Store data to disk.
EXEC sp_query_store_flush_db;
Related content
- Monitor performance by using the Query Store
- Query Store for secondary replicas
- sp_query_store_force_plan (Transact-SQL)
- sp_query_store_remove_query (Transact-SQL)
- sp_query_store_unforce_plan (Transact-SQL)
- sp_query_store_reset_exec_stats (Transact-SQL)
- sp_query_store_remove_plan (Transact-SQL)
- Query Store catalog views (Transact-SQL)