diff options
Diffstat (limited to 'doc/src/sgml/ref/drop_rule.sgml')
| -rw-r--r-- | doc/src/sgml/ref/drop_rule.sgml | 191 |
1 files changed, 191 insertions, 0 deletions
diff --git a/doc/src/sgml/ref/drop_rule.sgml b/doc/src/sgml/ref/drop_rule.sgml new file mode 100644 index 0000000000..fce6095f18 --- /dev/null +++ b/doc/src/sgml/ref/drop_rule.sgml @@ -0,0 +1,191 @@ +<REFENTRY ID="SQL-DROPRULE"> + <REFMETA> + <REFENTRYTITLE> + DROP RULE + </REFENTRYTITLE> + <REFMISCINFO>SQL - Language Statements</REFMISCINFO> + </REFMETA> + <REFNAMEDIV> + <REFNAME> + DROP RULE + </REFNAME> + <REFPURPOSE> + Removes an existing rule from the database + </REFPURPOSE> + <REFSYNOPSISDIV> + <REFSYNOPSISDIVINFO> + <DATE>1998-04-15</DATE> + </REFSYNOPSISDIVINFO> + <SYNOPSIS> + DROP RULE <REPLACEABLE CLASS="PARAMETER">name</REPLACEABLE> + </SYNOPSIS> + + <REFSECT2 ID="R2-SQL-DROPRULE-1"> + <REFSECT2INFO> + <DATE>1998-04-15</DATE> + </REFSECT2INFO> + <TITLE> + Inputs + </TITLE> + <PARA> + </PARA> + <VARIABLELIST> + <VARLISTENTRY> + <TERM> + </TERM> + <LISTITEM> + <PARA> + <VARIABLELIST> + <VARLISTENTRY> + <TERM> + <ReturnValue><replaceable class="parameter">name</replaceable></ReturnValue> + </TERM> + <LISTITEM> + <PARA> + The name of an existing rule to drop. + </PARA> + </LISTITEM> + </VARLISTENTRY> + </variablelist> + </LISTITEM> + </VARLISTENTRY> + </VARIABLELIST> + </REFSECT2> + + <REFSECT2 ID="R2-SQL-DROPRULE-2"> + <REFSECT2INFO> + <DATE>1998-04-15</DATE> + </REFSECT2INFO> + <TITLE> + Outputs + </TITLE> + <PARA> + </PARA> + <VARIABLELIST> + <VARLISTENTRY> + <TERM> + </TERM> + <LISTITEM> + <PARA> + <VARIABLELIST> + <VARLISTENTRY> + <TERM> + <ReturnValue>DROP</ReturnValue> + </TERM> + <LISTITEM> + <PARA> + Message returned if successfully. + </PARA> + </LISTITEM> + </VARLISTENTRY> + <VARLISTENTRY> + <TERM> + <ReturnValue>ERROR: RewriteGetRuleEventRel: rule "<replaceable class="parameter">name</replaceable>" not found</ReturnValue> + </TERM> + <LISTITEM> + <PARA> + This message occurs if the specified rule does not exist. + </PARA> + </LISTITEM> + </VARLISTENTRY> + </variablelist> + </LISTITEM> + </VARLISTENTRY> + </VARIABLELIST> + </REFSECT2> + </REFSYNOPSISDIV> + + <REFSECT1 ID="R1-SQL-DROPRULE-1"> + <REFSECT1INFO> + <DATE>1998-04-15</DATE> + </REFSECT1INFO> + <TITLE> + Description + </TITLE> + <PARA> + <command>DROP RULE</command> drops a rule from the specified PostgreSQL rule + system. PostgreSQL will immediately cease enforcing it and + will purge its definition from the system catalogs. + </PARA> + + <REFSECT2 ID="R2-SQL-DROPRULE-3"> + <REFSECT2INFO> + <DATE>1998-04-15</DATE> + </REFSECT2INFO> + <TITLE> + Notes + </TITLE> + <PARA> + The <command>DROP RULE</command> statement is a PostgreSQL + language extension. + </PARA> + <PARA> + Refer to the <command>CREATE RULE</command> statement for + information on how to create rules. + </PARA> + </refsect2> + + <REFSECT2 ID="R2-SQL-DROPRULE-4"> + <REFSECT2INFO> + <DATE>1998-04-15</DATE> + </REFSECT2INFO> + <TITLE> + Bugs + </TITLE> + <PARA> + Once a rule is dropped, access to historical information + the rule has written may disappear. + </PARA> + </REFSECT2> + </refsect1> + + <REFSECT1 ID="R1-SQL-DROPRULE-2"> + <TITLE> + Usage + </TITLE> + <PARA> + To drop the rewrite rule <literal>newrule</literal>: + </PARA> + <ProgramListing> + DROP RULE newrule + </ProgramListing> + </REFSECT1> + + <REFSECT1 ID="R1-SQL-DROPRULE-3"> + <TITLE> + Compatibility + </TITLE> + <PARA> + </PARA> + + <REFSECT2 ID="R2-SQL-DROPRULE-5"> + <REFSECT2INFO> + <DATE>1998-04-15</DATE> + </REFSECT2INFO> + <TITLE> + SQL92 + </TITLE> + <PARA> + There is no DROP RULE statement in SQL92. + </PARA> + </refsect2> + </refsect1> +</REFENTRY> + + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +sgml-parent-document:nil +sgml-default-dtd-file:"../reference.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:"/usr/lib/sgml/catalog" +sgml-local-ecat-files:nil +End: +--> |