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

See also