DROP_RULE(7)

DROP_RULE7

Remove a rewrite rule

Usage

DROP RULE [ IF EXISTS ] name ON table_name [ CASCADE | RESTRICT ]

Overview

DROP RULE drops a rewrite rule.

Parameters

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.

Examples

To drop the rewrite rule newrule:

DROP RULE newrule ON mytable;

Compatibility

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

From postgresql 18.6-4 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.