DBCC FREESYSTEMCACHE (Transact-SQL)
Applies To: SQL Server 2014, SQL Server 2016 Preview
Releases all unused cache entries from all caches. The SQL Server Database Engine proactively cleans up unused cache entries in the background to make memory available for current entries. However, you can use this command to manually remove unused entries from all caches or from a specified Resource Governor pool cache.
Applies to: SQL Server (SQL Server 2008 through current version).
- ( 'ALL' [, pool_name ] )
ALL specifies all supported caches.
pool_name specifies a Resource Governor pool cache. Only entries associated with this pool will be freed.
Asynchronously frees currently used entries from their respective caches after they become unused. New entries created in the cache after the DBCC FREESYSTEMCACHE WITH MARK_IN_USE_FOR_REMOVAL is executed are not affected.
Suppresses all informational messages.
DBCC FREESYSTEMCACHE returns:
"DBCC execution completed. If DBCC printed error messages, contact your system administrator."
Executing DBCC FREESYSTEMCACHE clears the plan cache for the instance of SQL Server. Clearing the plan cache causes a recompilation of all subsequent execution plans and can cause a sudden, temporary decrease in query performance. For each cleared cachstore in the plan cache, the SQL Server error log will contain the following informational message: "SQL Server has encountered %d occurrence(s) of cachestore flush for the '%s' cachestore (part of plan cache) due to 'DBCC FREEPROCCACHE' or 'DBCC FREESYSTEMCACHE' operations." This message is logged every five minutes as long as the cache is flushed within that time interval.
Requires ALTER SERVER STATE permission on the server.
The following example illustrates how to clean caches that are dedicated to a specified Resource Governor resource pool.
-- Clean all the caches with entries specific to the resource pool named "default". DBCC FREESYSTEMCACHE ('ALL', default);
The following example uses the MARK_IN_USE_FOR_REMOVAL clause to release entries from all current caches once the entries become unused.
DBCC FREESYSTEMCACHE ('ALL') WITH MARK_IN_USE_FOR_REMOVAL;