<HTML
><HEAD
><TITLE
>DROP RULE</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.73
"><LINK
REV="MADE"
HREF="mailto:pgsql-docs@postgresql.org"><LINK
REL="HOME"
TITLE="PostgreSQL 7.3.2 Documentation"
HREF="index.html"><LINK
REL="UP"
TITLE="SQL Commands"
HREF="sql-commands.html"><LINK
REL="PREVIOUS"
TITLE="DROP OPERATOR CLASS"
HREF="sql-dropopclass.html"><LINK
REL="NEXT"
TITLE="DROP SCHEMA"
HREF="sql-dropschema.html"><LINK
REL="STYLESHEET"
TYPE="text/css"
HREF="stylesheet.css"><META
NAME="creation"
CONTENT="2003-02-03T20:17:34"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>PostgreSQL 7.3.2 Documentation</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="sql-dropopclass.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="sql-dropschema.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><H1
><A
NAME="SQL-DROPRULE"
>DROP RULE</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN42948"
></A
><H2
>Name</H2
> DROP RULE
-- remove a rewrite rule
</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN42951"
></A
><H2
>Synopsis</H2
><PRE
CLASS="SYNOPSIS"
>DROP RULE <TT
CLASS="REPLACEABLE"
><I
>name</I
></TT
> ON <TT
CLASS="REPLACEABLE"
><I
>relation</I
></TT
> [ CASCADE | RESTRICT ]
</PRE
><DIV
CLASS="REFSECT2"
><A
NAME="R2-SQL-DROPRULE-1"
></A
><H3
> Inputs
</H3
><P
> <P
></P
></P><DIV
CLASS="VARIABLELIST"
><DL
><DT
><TT
CLASS="REPLACEABLE"
><I
>name</I
></TT
></DT
><DD
><P
> The name of an existing rule to drop.
</P
></DD
><DT
><TT
CLASS="REPLACEABLE"
><I
>relation</I
></TT
></DT
><DD
><P
> The name (optionally schema-qualified) of the relation the rule
applies to.
</P
></DD
><DT
>CASCADE</DT
><DD
><P
> Automatically drop objects that depend on the rule.
</P
></DD
><DT
>RESTRICT</DT
><DD
><P
> Refuse to drop the rule if there are any dependent objects.
This is the default.
</P
></DD
></DL
></DIV
><P>
</P
></DIV
><DIV
CLASS="REFSECT2"
><A
NAME="R2-SQL-DROPRULE-2"
></A
><H3
> Outputs
</H3
><P
> <P
></P
></P><DIV
CLASS="VARIABLELIST"
><DL
><DT
><TT
CLASS="COMPUTEROUTPUT"
>DROP RULE
</TT
></DT
><DD
><P
> Message returned if successful.
</P
></DD
><DT
><TT
CLASS="COMPUTEROUTPUT"
>ERROR: Rule "<TT
CLASS="REPLACEABLE"
><I
>name</I
></TT
>" not found
</TT
></DT
><DD
><P
> This message occurs if the specified rule does not exist.
</P
></DD
></DL
></DIV
><P>
</P
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="R1-SQL-DROPRULE-1"
></A
><H2
> Description
</H2
><P
> <TT
CLASS="COMMAND"
>DROP RULE</TT
> drops a rule from the specified
<SPAN
CLASS="PRODUCTNAME"
>PostgreSQL</SPAN
> rule
system. <SPAN
CLASS="PRODUCTNAME"
>PostgreSQL</SPAN
>
will immediately cease enforcing it and
will purge its definition from the system catalogs.
</P
><DIV
CLASS="REFSECT2"
><A
NAME="R2-SQL-DROPRULE-3"
></A
><H3
> Notes
</H3
><P
> The <TT
CLASS="COMMAND"
>DROP RULE</TT
> statement is a
<SPAN
CLASS="PRODUCTNAME"
>PostgreSQL</SPAN
>
language extension.
</P
><P
> Refer to <TT
CLASS="COMMAND"
>CREATE RULE</TT
> for
information on how to create rules.
</P
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="R1-SQL-DROPRULE-2"
></A
><H2
> Usage
</H2
><P
> To drop the rewrite rule <TT
CLASS="LITERAL"
>newrule</TT
>:
</P><PRE
CLASS="PROGRAMLISTING"
>DROP RULE newrule ON mytable;
</PRE
><P>
</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="R1-SQL-DROPRULE-3"
></A
><H2
> Compatibility
</H2
><DIV
CLASS="REFSECT2"
><A
NAME="R2-SQL-DROPRULE-5"
></A
><H3
> SQL92
</H3
><P
> There is no <TT
CLASS="COMMAND"
>DROP RULE</TT
> in SQL92.
</P
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="sql-dropopclass.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="sql-dropschema.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>DROP OPERATOR CLASS</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="sql-commands.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>DROP SCHEMA</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
