SQL Commands / Indexes & Statistics

DROP STATISTICS

remove extended statistics

Reading PG 18current·documented in 11 of 30 versions, 10 to 20

6.4 6.5 7.0 7.1 7.2 7.3 7.4 8.0 8.1 8.2 8.3 8.4 9.0 9.1 9.2 9.3 9.4 9.5 9.6 10 11 12 13 14 15 16 17 18 19 20

Syntax

DROP STATISTICS [ IF EXISTS ] name [, ...] [ CASCADE | RESTRICT ]

Syntax diagrams

Read left to right. Branches are choices, bypasses are optional, loops repeat. Select an underlined parameter to open its rule.

Description

DROP STATISTICS removes statistics object(s) from the database. Only the statistics object's owner, the schema owner, or a superuser can drop a statistics object.

Parameters

IF EXISTS: Do not throw an error if the statistics object does not exist. A notice is issued in this case.
name: The name (optionally schema-qualified) of the statistics object to drop.
CASCADE RESTRICT: These key words do not have any effect, since there are no dependencies on statistics.

Examples

To destroy two statistics objects in different schemas, without failing if they don't exist:

DROP STATISTICS IF EXISTS
    accounting.users_uid_creation,
    public.grants_user_role;

Compatibility

There is no DROP STATISTICS command in the SQL standard.

Related entries

CREATE STATISTICS ALTER STATISTICS

Definition snapshot: b7bd9cda · English manual source