SQL COMMANDS / TRIGGERS & RULES

DROP RULE

remove a rewrite rule

Syntax

DROP RULE [ IF EXISTS ] name ON table_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.

DROP RULE drops a rewrite rule.

IF EXISTS: Do not throw an error if the rule does not exist. A notice is issued in this case.
name: The name of the rule to drop.
table_name: The name (optionally schema-qualified) of the table or view that the rule applies to.
CASCADE: Automatically drop objects that depend on the rule, and in turn all objects that depend on those objects (see Section 5.15).
RESTRICT: Refuse to drop the rule if any objects depend on it. This is the default.

To drop the rewrite rule newrule:

DROP RULE newrule ON mytable;

DROP RULE is a PostgreSQL language extension, as is the entire query rewrite system.

Definition snapshot: 2026-09-14T13:14:25.700916+00:00@99e6866c · English manual source