DBCC DROPCLEANBUFFERS (Transact-SQL)
Applies to: SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)
Removes all clean buffers from the buffer pool, and columnstore objects from the columnstore object pool.
Transact-SQL syntax conventions
Syntax
Syntax for SQL Server, Azure SQL Database, and serverless SQL pool in Azure Synapse Analytics:
DBCC DROPCLEANBUFFERS [ WITH NO_INFOMSGS ]
Syntax for Azure Synapse Analytics and Analytics Platform System (PDW):
DBCC DROPCLEANBUFFERS ( COMPUTE | ALL ) [ WITH NO_INFOMSGS ]
Arguments
WITH NO_INFOMSGS
Suppresses all informational messages. Informational messages are always suppressed on Azure Synapse Analytics and Analytics Platform System (PDW).
COMPUTE
Purge the data cache in memory from each Compute node.
ALL
Purge the data cache in memory from each Compute node and from the Control node. This setting is the default if you don't specify a value.
Remarks
Use DBCC DROPCLEANBUFFERS
to test queries with a cold buffer cache without shutting down and restarting the server.
To drop clean buffers from the buffer pool and columnstore objects from the columnstore object pool, first use CHECKPOINT to produce a cold buffer cache. CHECKPOINT forces all dirty pages for the current database to be written to disk and cleans the buffers. After you checkpoint the database, you can issue DBCC DROPCLEANBUFFERS
command to remove all buffers from the buffer pool.
In Azure SQL Database, DBCC DROPCLEANBUFFERS
acts on the database engine instance hosting the current database or elastic pool. Executing DBCC DROPCLEANBUFFERS
in a user database drops clean buffers for that database. If the database is in an elastic pool, it also drops clean buffers in all other databases in that elastic pool. Executing the command in the master
database has no effect on other databases on the same logical server. Executing this command in a database using Basic, S0, or S1 service objective may drop clean buffers in other databases using these service objectives on the same logical server.
Result sets
DBCC DROPCLEANBUFFERS
on SQL Server returns:
DBCC execution completed. If DBCC printed error messages, contact your system administrator.
Permissions
Applies to: SQL Server, Analytics Platform System (PDW)
- Requires sysadmin permission on the server
Applies to: SQL Server 2022 and later
- Requires ALTER SERVER STATE permission on the server
Applies to: Azure SQL Database
- Requires membership in server role ##MS_ServerStateManager##
Applies to: Azure Synapse Analytics
- Requires membership in the db_owner fixed server role