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 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 ]
To view Transact-SQL syntax for SQL Server 2014 and earlier, see Previous versions documentation.
Suppresses all informational messages. Informational messages are always suppressed on Azure Synapse Analytics and Analytics Platform System (PDW).
Purge the data cache in memory from each Compute node.
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.
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.
DBCC DROPCLEANBUFFERS on SQL Server returns:
DBCC execution completed. If DBCC printed error messages, contact your system administrator.
Applies to: SQL Server, Analytics Platform System (PDW)
- 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