DROP STATISTICS (Transact-SQL)

Applies to: 👁 Image
SQL Server 👁 Image
Azure SQL Database 👁 Image
Azure SQL Managed Instance 👁 Image
Azure Synapse Analytics 👁 Image
Analytics Platform System (PDW) 👁 Image
SQL analytics endpoint in Microsoft Fabric 👁 Image
Warehouse in Microsoft Fabric 👁 Image
SQL database in Microsoft Fabric

Drops statistics for multiple collections within the specified tables in the current database.

👁 Image
Transact-SQL syntax conventions

Syntax

-- Syntax for SQL Server and Azure SQL Database 
 
DROP STATISTICS table.statistics_name | view.statistics_name [ ,...n ] 

-- Syntax for Azure Synapse Analytics and Parallel Data Warehouse and Microsoft Fabric
 
DROP STATISTICS [ schema_name . ] table_name.statistics_name 
[;] 

Arguments

table | view
Is the name of the target table or indexed view for which statistics should be dropped. Table and view names must comply with the rules for Database Identifiers. Specifying the table or view owner name is optional.

statistics_name
Is the name of the statistics group to drop. Statistics names must comply with the rules for identifiers

Remarks

Be careful when you drop statistics. Doing so may affect the execution plan chosen by the query optimizer.

Statistics on indexes cannot be dropped by using DROP STATISTICS. Statistics remain as long as the index exists.

For more information about displaying statistics, see DBCC SHOW_STATISTICS (Transact-SQL).

Permissions

Requires ALTER permission on the table or view.

Examples

A. Dropping statistics from a table

The following example drops the statistics groups (collections) of two tables. The VendorCredit statistics group (collection) of the Vendor table and the CustomerTotal statistics (collection) of the SalesOrderHeader table are dropped.

-- Create the statistics groups. 
USE AdventureWorks2022; 
GO 
CREATE STATISTICS VendorCredit 
 ON Purchasing.Vendor (Name, CreditRating) 
 WITH SAMPLE 50 PERCENT 
CREATE STATISTICS CustomerTotal 
 ON Sales.SalesOrderHeader (CustomerID, TotalDue) 
 WITH FULLSCAN; 
GO 
DROP STATISTICS Purchasing.Vendor.VendorCredit, Sales.SalesOrderHeader.CustomerTotal; 

Examples: Azure Synapse Analytics and Analytics Platform System (PDW)

B. Dropping statistics from a table

The following examples drop the CustomerStats1 statistics from table Customer.

DROP STATISTICS Customer.CustomerStats1; 
DROP STATISTICS dbo.Customer.CustomerStats1; 

See Also

ALTER DATABASE (Transact-SQL)
CREATE INDEX (Transact-SQL)
CREATE STATISTICS (Transact-SQL)
sys.stats (Transact-SQL)
sys.stats_columns (Transact-SQL)
DBCC SHOW_STATISTICS (Transact-SQL)
sp_autostats (Transact-SQL)
sp_createstats (Transact-SQL)
UPDATE STATISTICS (Transact-SQL)
EVENTDATA (Transact-SQL)
USE (Transact-SQL)
Statistics in Microsoft Fabric