diff --git a/doc/src/sgml/ref/commands.sgml b/doc/src/sgml/ref/commands.sgml index 8b87a9857d..23b25a91de 100644 --- a/doc/src/sgml/ref/commands.sgml +++ b/doc/src/sgml/ref/commands.sgml @@ -1,8 +1,8 @@ -<chapter Id="sql-commands"> -<title>Commands</title> +<Chapter> +<Title>Commands</Title> -<para> -</para> +<Para> +</Para> &alterTable; &alterUser; @@ -26,7 +26,19 @@ &createView; &declare; &delete; +&dropAggregate; +&dropDatabase; &dropFunction; +&dropIndex; +&dropLanguage; +&dropOperator; +&dropRule; +&dropSequence; +&dropTable; +&dropTrigger; +&dropType +&dropUser; +&dropView; &explain; &fetch; &grant; @@ -44,7 +56,7 @@ &show; &update; -</chapter> +</Chapter> <chapter Id="sql-functions"> <title>SQL Functions</title> @@ -59,6 +71,7 @@ </chapter> + <!-- Keep this comment at the end of the file Local variables: mode: sgml diff --git a/doc/src/sgml/ref/drop_aggregate.sgml b/doc/src/sgml/ref/drop_aggregate.sgml new file mode 100644 index 0000000000..6bf9fe2c9d --- /dev/null +++ b/doc/src/sgml/ref/drop_aggregate.sgml @@ -0,0 +1,193 @@ +<REFENTRY ID="SQL-DROPAGGREGATE"> + <REFMETA> + <REFENTRYTITLE> + DROP AGGREGATE + </REFENTRYTITLE> + <REFMISCINFO>SQL - Language Statements</REFMISCINFO> + </REFMETA> + <REFNAMEDIV> + <REFNAME> + DROP AGGREGATE + </REFNAME> + <REFPURPOSE> + Removes the definition of an aggregate function + </REFPURPOSE> + <REFSYNOPSISDIV> + <REFSYNOPSISDIVINFO> + <DATE>1998-04-15</DATE> + </REFSYNOPSISDIVINFO> + <SYNOPSIS> + DROP AGGREGATE <REPLACEABLE CLASS="PARAMETER">name</REPLACEABLE> <REPLACEABLE CLASS="PARAMETER">type</REPLACEABLE> + </SYNOPSIS> + + <REFSECT2 ID="R2-SQL-DROPAGGREGATE-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 aggregate function. + </PARA> + </LISTITEM> + </VARLISTENTRY> + <VARLISTENTRY> + <TERM> + <ReturnValue><replaceable class="parameter">type</replaceable></ReturnValue> + </TERM> + <LISTITEM> + <PARA> + The type of an existing aggregate function. + (Refer to PostgreSQL User's Guide chapter 4 for + further information about data types). + <comment>This should become a cross-reference rather than a + hard-coded chapter number</comment> + </PARA> + </LISTITEM> + </VARLISTENTRY> + </variablelist> + </LISTITEM> + </VARLISTENTRY> + </VARIABLELIST> + </REFSECT2> + + <REFSECT2 ID="R2-SQL-DROPAGGREGATE-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 the command is successful. + </PARA> + </LISTITEM> + </VARLISTENTRY> + <VARLISTENTRY> + <TERM> + <ReturnValue>WARN RemoveAggregate: aggregate '<replaceable class="parameter">name</replaceable>' for 'type' does not exist</ReturnValue> + </TERM> + <LISTITEM> + <PARA> + This message occurs if the aggregate function specified does not + exist in the database. + </PARA> + </LISTITEM> + </VARLISTENTRY> + </variablelist> + </LISTITEM> + </VARLISTENTRY> + </VARIABLELIST> + </REFSECT2> + </REFSYNOPSISDIV> + + <REFSECT1 ID="R1-SQL-DROPAGGREGATE-1"> + <REFSECT1INFO> + <DATE>1998-04-15</DATE> + </REFSECT1INFO> + <TITLE> + Description + </TITLE> + <PARA> + <command>DROP AGGREGATE</command> will remove all references to an existing + aggregate definition. To execute this command the current + user must be the owner of the aggregate. + </PARA> + + <REFSECT2 ID="R2-SQL-DROPAGGREGATE-3"> + <REFSECT2INFO> + <DATE>1998-04-15</DATE> + </REFSECT2INFO> + <TITLE> + Notes + </TITLE> + <PARA> + The <command>DROP AGGREGATE</command> statement is a PostgreSQL + language extension. + </PARA> + <PARA> + Refer to the <command>CREATE AGGREGATE</command> statement to + create aggregate functions. + </PARA> + </REFSECT2> + </REFSECT1> + + <REFSECT1 ID="R1-SQL-DROPAGGREGATE-2"> + <TITLE> + Usage + </TITLE> + <PARA> + To remove the <literal>myavg</literal> aggregate for type + <literal>int4</literal>: + </PARA> + <ProgramListing> + DROP AGGREGATE myavg int4; + </ProgramListing> + </REFSECT1> + + <REFSECT1 ID="R1-SQL-DROPAGGREGATE-3"> + <TITLE> + Compatibility + </TITLE> + <PARA> + </PARA> + + <REFSECT2 ID="R2-SQL-DROPAGGREGATE-4"> + <REFSECT2INFO> + <DATE>1998-04-15</DATE> + </REFSECT2INFO> + <TITLE> + SQL92 + </TITLE> + <PARA> + There is no DROP AGGREGATE 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: +--> diff --git a/doc/src/sgml/ref/drop_database.sgml b/doc/src/sgml/ref/drop_database.sgml new file mode 100644 index 0000000000..d99d7d43e8 --- /dev/null +++ b/doc/src/sgml/ref/drop_database.sgml @@ -0,0 +1,174 @@ +<REFENTRY ID="SQL-DROPDATABASE"> + <REFMETA> + <REFENTRYTITLE> + DROP DATABASE + </REFENTRYTITLE> + <REFMISCINFO>SQL - Language Statements</REFMISCINFO> + </REFMETA> + <REFNAMEDIV> + <REFNAME> + DROP DATABASE + </REFNAME> + <REFPURPOSE> + Destroys an existing database + </REFPURPOSE> + <REFSYNOPSISDIV> + <REFSYNOPSISDIVINFO> + <DATE>1998-04-15</DATE> + </REFSYNOPSISDIVINFO> + <SYNOPSIS> + DROP DATABASE <REPLACEABLE CLASS="PARAMETER">name</REPLACEABLE> + </SYNOPSIS> + + <REFSECT2 ID="R2-SQL-DROPDATABASE-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 database to remove. + </PARA> + </LISTITEM> + </VARLISTENTRY> + </variablelist> + </LISTITEM> + </VARLISTENTRY> + </VARIABLELIST> + </REFSECT2> + + <REFSECT2 ID="R2-SQL-DROPDATABASE-2"> + <REFSECT2INFO> + <DATE>1998-04-15</DATE> + </REFSECT2INFO> + <TITLE> + Outputs + </TITLE> + <PARA> + </PARA> + <VARIABLELIST> + <VARLISTENTRY> + <TERM> + </TERM> + <LISTITEM> + <PARA> + <VARIABLELIST> + <VARLISTENTRY> + <TERM> + <ReturnValue>DESTROYDB</ReturnValue> + </TERM> + <LISTITEM> + <PARA> + This message is returned if the command is successful. + </PARA> + </LISTITEM> + </VARLISTENTRY> + <VARLISTENTRY> + <TERM> + <ReturnValue>WARN: destroydb: database "<replaceable class="parameter">name</replaceable>" does not exist.</ReturnValue> + </TERM> + <LISTITEM> + <PARA> + This message occurs if the specified database does not exist. + </PARA> + </LISTITEM> + </VARLISTENTRY> + </variablelist> + </LISTITEM> + </VARLISTENTRY> + </VARIABLELIST> + </REFSECT2> + </REFSYNOPSISDIV> + + <REFSECT1 ID="R1-SQL-DROPDATABASE-1"> + <REFSECT1INFO> + <DATE>1998-04-15</DATE> + </REFSECT1INFO> + <TITLE> + Description + </TITLE> + <PARA> + <command>DROP DATABASE</command> removes the catalog entries for an existing + database and deletes the directory containing the data. + It can only be executed by the database administrator + (See the <command>CREATE DATABASE</command> command for details). + </PARA> + + <REFSECT2 ID="R2-SQL-DROPDATABASE-3"> + <REFSECT2INFO> + <DATE>1998-04-15</DATE> + </REFSECT2INFO> + <TITLE> + Notes + </TITLE> + <PARA> + <warning> + <para> + This query should NOT be executed interactively. + The <command>destroydb</command> script should be used instead. + </para> + </warning> + <comment>Some explanation would be desirable here!</comment> + </PARA> + <para> + DROP DATABASE statement is a PostgreSQL language extension. + </para> + <para> + Refer to the <command>CREATE DATABASE</command> statement for + information on how to create a database. + </para> + </refsect2> + </REFSECT1> + + <REFSECT1 ID="R1-SQL-DROPDATABASE-3"> + <TITLE> + Compatibility + </TITLE> + <PARA> + </PARA> + + <REFSECT2 ID="R2-SQL-DROPDATABASE-4"> + <REFSECT2INFO> + <DATE>1998-04-15</DATE> + </REFSECT2INFO> + <TITLE> + SQL92 + </TITLE> + <PARA> + There is no DROP DATABASE 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: +--> diff --git a/doc/src/sgml/ref/drop_index.sgml b/doc/src/sgml/ref/drop_index.sgml new file mode 100644 index 0000000000..726487356e --- /dev/null +++ b/doc/src/sgml/ref/drop_index.sgml @@ -0,0 +1,177 @@ +<REFENTRY ID="SQL-DROPINDEX"> + <REFMETA> + <REFENTRYTITLE> + DROP INDEX + </REFENTRYTITLE> + <REFMISCINFO>SQL - Language Statements</REFMISCINFO> + </REFMETA> + <REFNAMEDIV> + <REFNAME> + DROP INDEX + </REFNAME> + <REFPURPOSE> + Removes an index from a database + </REFPURPOSE> + <REFSYNOPSISDIV> + <REFSYNOPSISDIVINFO> + <DATE>1998-04-15</DATE> + </REFSYNOPSISDIVINFO> + <SYNOPSIS> + DROP INDEX <REPLACEABLE CLASS="PARAMETER">index_name</REPLACEABLE> + </SYNOPSIS> + + <REFSECT2 ID="R2-SQL-DROPINDEX-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">index_name</REPLACEABLE></ReturnValue> + </TERM> + <LISTITEM> + <PARA> + The name of the index to remove. + </PARA> + </LISTITEM> + </VARLISTENTRY> + </variablelist> + </LISTITEM> + </VARLISTENTRY> + </VARIABLELIST> + </REFSECT2> + + <REFSECT2 ID="R2-SQL-DROPINDEX-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> + The message returned if the index is successfully dropped. + </PARA> + </LISTITEM> + </VARLISTENTRY> + <VARLISTENTRY> + <TERM> + <ReturnValue>ERROR: index "<REPLACEABLE CLASS="PARAMETER">index_name</REPLACEABLE>" nonexistent</ReturnValue> + </TERM> + <LISTITEM> + <PARA> + This message occurs if it is impossible to drop the index + because it does not exist. + </PARA> + </LISTITEM> + </VARLISTENTRY> + </variablelist> + </LISTITEM> + </VARLISTENTRY> + </VARIABLELIST> + </REFSECT2> + </REFSYNOPSISDIV> + + <REFSECT1 ID="R1-SQL-DROPINDEX-1"> + <REFSECT1INFO> + <DATE>1998-04-15</DATE> + </REFSECT1INFO> + <TITLE> + Description + </TITLE> + <PARA> + <command>DROP INDEX</command> drops an existing index from the database + system. To execute this command you must be the owner of + the index. + </PARA> + + <REFSECT2 ID="R2-SQL-DROPINDEX-3"> + <REFSECT2INFO> + <DATE>1998-04-15</DATE> + </REFSECT2INFO> + <TITLE> + Notes + </TITLE> + <PARA> + <command>DROP INDEX</command> is a PostgreSQL language extension. + </PARA> + <PARA> + Refer to the <command>CREATE INDEX</command> statement for + inforamtion on how to create indexes. + </PARA> + </REFSECT2> + + <REFSECT1 ID="R1-SQL-DROPINDEX-2"> + <TITLE> + Usage + </TITLE> + <PARA> + This command will remove the <literal>title_idx</literal> index: + </PARA> + <ProgramListing> + DROP INDEX title_idx; + </ProgramListing> + </REFSECT1> + + <REFSECT1 ID="R1-SQL-DROPINDEX-3"> + <TITLE> + Compatibility + </TITLE> + <PARA> + </PARA> + + <REFSECT2 ID="R2-SQL-DROPINDEX-4"> + <REFSECT2INFO> + <DATE>1998-04-15</DATE> + </REFSECT2INFO> + <TITLE> + SQL92 + </TITLE> + <PARA> + There is no <command>DROP INDEX</command> statement on 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: +--> diff --git a/doc/src/sgml/ref/drop_language.sgml b/doc/src/sgml/ref/drop_language.sgml new file mode 100644 index 0000000000..09f0cc34d7 --- /dev/null +++ b/doc/src/sgml/ref/drop_language.sgml @@ -0,0 +1,197 @@ +<REFENTRY ID="SQL-DROPLANGUAGE"> + <REFMETA> + <REFENTRYTITLE> + DROP LANGUAGE + </REFENTRYTITLE> + <REFMISCINFO>SQL - Language Statements</REFMISCINFO> + </REFMETA> + <REFNAMEDIV> + <REFNAME> + DROP LANGUAGE + </REFNAME> + <REFPURPOSE> + Removes a user-defined procedural language + </REFPURPOSE> + <REFSYNOPSISDIV> + <REFSYNOPSISDIVINFO> + <DATE>1998-04-15</DATE> + </REFSYNOPSISDIVINFO> + <SYNOPSIS> + DROP PROCEDURAL LANGUAGE '<REPLACEABLE CLASS="PARAMETER">langname</REPLACEABLE>' + </SYNOPSIS> + + <REFSECT2 ID="R2-SQL-DROPLANGUAGE-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">langname</REPLACEABLE></ReturnValue> + </TERM> + <LISTITEM> + <PARA> + The name of an existing language. + </PARA> + </LISTITEM> + </VARLISTENTRY> + </variablelist> + </LISTITEM> + </VARLISTENTRY> + </VARIABLELIST> + </REFSECT2> + + <REFSECT2 ID="R2-SQL-DROPLANGUAGE-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> + This message is returned if the language is successfully dropped. + </PARA> + </LISTITEM> + </VARLISTENTRY> + <VARLISTENTRY> + <TERM> + <ReturnValue> + ERROR: Language "<replaceable class="parameter">langname</replaceable>" doesn't exist</ReturnValue> + </TERM> + <LISTITEM> + <PARA> + This message occurs if the language + "<replaceable class="parameter">langname</replaceable>" is + not found. + </PARA> + </LISTITEM> + </VARLISTENTRY> + </variablelist> + </LISTITEM> + </VARLISTENTRY> + </VARIABLELIST> + </REFSECT2> + </REFSYNOPSISDIV> + + <REFSECT1 ID="R1-SQL-DROPLANGUAGE-1"> + <REFSECT1INFO> + <DATE>1998-04-15</DATE> + </REFSECT1INFO> + <TITLE> + Description + </TITLE> + <PARA> + <command>DROP PROCEDURAL LANGUAGE</command> will remove the definition + of the previously registered procedural language with the name + '<replaceable class="parameter">langname</replaceable>'. + </PARA> + + <REFSECT2 ID="R2-SQL-DROPLANGUAGE-3"> + <REFSECT2INFO> + <DATE>1998-04-15</DATE> + </REFSECT2INFO> + <TITLE> + Notes + </TITLE> + <PARA> + The <command>DROP PROCEDURAL LANGUAGE</command> statement is + a PostgreSQL language extension. + </PARA> + <PARA> + Refer to the <command>CREATE PROCEDURAL LANGUAGE</command> statement + for information on how to create procedural languages. + </PARA> + </refsect2> + + <REFSECT2 ID="R2-SQL-DROPLANGUAGE-4"> + <REFSECT2INFO> + <DATE>1998-04-15</DATE> + </REFSECT2INFO> + <TITLE> + Bugs + </TITLE> + <PARA> + No checks are made if functions or trigger procedures registered + in this language still exist. To re-enable them without having + to drop and recreate all the functions, the pg_proc's prolang + attribute of the functions must be adjusted to the new object + ID of the recreated pg_language entry for the PL. + </PARA> + </REFSECT2> + </refsect1> + + <REFSECT1 ID="R1-SQL-DROPLANGUAGE-2"> + <TITLE> + Usage + </TITLE> + <PARA> + This command removes the PL/Sample language: + </PARA> + <ProgramListing> + DROP PROCEDURAL LANGUAGE 'plsample' + </ProgramListing> + </REFSECT1> + + <REFSECT1 ID="R1-SQL-DROPLANGUAGE-3"> + <TITLE> + Compatibility + </TITLE> + <PARA> + </PARA> + + <REFSECT2 ID="R2-SQL-DROPLANGUAGE-5"> + <REFSECT2INFO> + <DATE>1998-04-15</DATE> + </REFSECT2INFO> + <TITLE> + SQL92 + </TITLE> + <PARA> + There is no DROP PROCEDURAL LANGUAGE statement on 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: +--> diff --git a/doc/src/sgml/ref/drop_operator.sgml b/doc/src/sgml/ref/drop_operator.sgml new file mode 100644 index 0000000000..4aa87863bf --- /dev/null +++ b/doc/src/sgml/ref/drop_operator.sgml @@ -0,0 +1,209 @@ +<REFENTRY ID="SQL-DROPOPERATOR"> + <REFMETA> + <REFENTRYTITLE> + DROP OPERATOR + </REFENTRYTITLE> + <REFMISCINFO>SQL - Language Statements</REFMISCINFO> + </REFMETA> + <REFNAMEDIV> + <REFNAME> + DROP OPERATOR + </REFNAME> + <REFPURPOSE> + Removes an operator from the database + </REFPURPOSE> + + + <REFSYNOPSISDIV> + <REFSYNOPSISDIVINFO> + <DATE>1998-04-15</DATE> + </REFSYNOPSISDIVINFO> + <SYNOPSIS> + DROP OPERATOR <REPLACEABLE CLASS="PARAMETER">id</REPLACEABLE> ( <REPLACEABLE CLASS="PARAMETER">type</REPLACEABLE> | NONE [,...] ); + </SYNOPSIS> + + <REFSECT2 ID="R2-SQL-DROPOPERATOR-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">id</replaceable></ReturnValue> + </TERM> + <LISTITEM> + <PARA> + The identifier of an existing operator. + </PARA> + </LISTITEM> + </VARLISTENTRY> + <VARLISTENTRY> + <TERM> + <ReturnValue><replaceable class="parameter">type</replaceable></ReturnValue> + </TERM> + <LISTITEM> + <PARA> + The type of function parameters. + </PARA> + </LISTITEM> + </VARLISTENTRY> + </variablelist> + </LISTITEM> + </VARLISTENTRY> + </VARIABLELIST> + </REFSECT2> + + <REFSECT2 ID="R2-SQL-DROPOPERATOR-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> + The message returned if the command is successful. + </PARA> + </LISTITEM> + </VARLISTENTRY> + <VARLISTENTRY> + <TERM> + <ReturnValue>ERROR: RemoveOperator: ... does not exist</ReturnValue> + </TERM> + <LISTITEM> + <PARA> + This message occurs if the operator specified doesn't exist. + </PARA> + </LISTITEM> + </VARLISTENTRY> + </variablelist> + </LISTITEM> + </VARLISTENTRY> + </VARIABLELIST> + </REFSECT2> + </REFSYNOPSISDIV> + + <REFSECT1 ID="R1-SQL-DROPOPERATOR-1"> + <REFSECT1INFO> + <DATE>1998-04-15</DATE> + </REFSECT1INFO> + <TITLE> + Description + </TITLE> + <PARA> + The DROP OPERATOR statement drops an existing operator from the + database. + To execute this command you must be the owner of the operator. + </PARA> + <PARA> + The left or right type of a left or right unary + operator, respectively, may be specified as NONE. + </PARA> + + <REFSECT2 ID="R2-SQL-DROPOPERATOR-3"> + <REFSECT2INFO> + <DATE>1998-04-15</DATE> + </REFSECT2INFO> + <TITLE> + Notes + </TITLE> + <PARA> + The <command>DROP OPERATOR</command> statement is a PostgreSQL + language extension. + </PARA> + <PARA> + Refer to the <command>CREATE OPERATOR</command> statement for + information on how to create operators. + </PARA> + <PARA> + It is the user's responsibility to remove any access methods, + operator classes, and so on, that rely on the deleted operator. + </PARA> + </REFSECT2> + + <REFSECT1 ID="R1-SQL-DROPOPERATOR-2"> + <TITLE> + Usage + </TITLE> + <PARA> + Remove power operator <literal>a^n</literal> for <literal>int4</literal>: + </PARA> + <ProgramListing> + DROP OPERATOR ^ (int4, int4); + </ProgramListing> + <PARA> + Remove left unary operator <literal>!a</literal> for booleans: + </PARA> + <ProgramListing> + DROP OPERATOR ! (none, bool); + </ProgramListing> + <PARA> + Remove right unary factorial operator <literal>a!</literal> for + <literal>int4</literal>: + </PARA> + <ProgramListing> + DROP OPERATOR ! (int4, none); + </ProgramListing> + </REFSECT1> + + <REFSECT1 ID="R1-SQL-DROPOPERATOR-3"> + <TITLE> + Compatibility + </TITLE> + <PARA> + </PARA> + + <REFSECT2 ID="R2-SQL-DROPOPERATOR-4"> + <REFSECT2INFO> + <DATE>1998-04-15</DATE> + </REFSECT2INFO> + <TITLE> + SQL92 + </TITLE> + <PARA> + There is no DROP OPERATOR 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: +--> 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: +--> diff --git a/doc/src/sgml/ref/drop_sequence.sgml b/doc/src/sgml/ref/drop_sequence.sgml new file mode 100644 index 0000000000..f60a1159c6 --- /dev/null +++ b/doc/src/sgml/ref/drop_sequence.sgml @@ -0,0 +1,178 @@ +<REFENTRY ID="SQL-DROPSEQUENCE"> + <REFMETA> + <REFENTRYTITLE> + DROP SEQUENCE + </REFENTRYTITLE> + <REFMISCINFO>SQL - Language Statements</REFMISCINFO> + </REFMETA> + <REFNAMEDIV> + <REFNAME> + DROP SEQUENCE + </REFNAME> + <REFPURPOSE> + Removes an existing sequence + </REFPURPOSE> + <REFSYNOPSISDIV> + <REFSYNOPSISDIVINFO> + <DATE>1998-04-15</DATE> + </REFSYNOPSISDIVINFO> + <SYNOPSIS> + DROP SEQUENCE <REPLACEABLE CLASS="PARAMETER">seqname</REPLACEABLE> [, ...] + </SYNOPSIS> + + <REFSECT2 ID="R2-SQL-DROPSEQUENCE-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">seqname</REPLACEABLE></ReturnValue> + </TERM> + <LISTITEM> + <PARA> + The name of a sequence. + </PARA> + </LISTITEM> + </VARLISTENTRY> + </variablelist> + </LISTITEM> + </VARLISTENTRY> + </VARIABLELIST> + </REFSECT2> + + <REFSECT2 ID="R2-SQL-DROPSEQUENCE-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> + The message returned if the sequence is successfully dropped. + </PARA> + </LISTITEM> + </VARLISTENTRY> + <VARLISTENTRY> + <TERM> + <ReturnValue>WARN: Relation "<replaceable class="parameter">seqname</replaceable>" does not exist.</ReturnValue> + </TERM> + <LISTITEM> + <PARA> + This message occurs if the sequence specified does not exist. + </PARA> + </LISTITEM> + </VARLISTENTRY> + </variablelist> + </LISTITEM> + </VARLISTENTRY> + </VARIABLELIST> + </REFSECT2> + </REFSYNOPSISDIV> + + <REFSECT1 ID="R1-SQL-DROPSEQUENCE-1"> + <REFSECT1INFO> + <DATE>1998-04-15</DATE> + </REFSECT1INFO> + <TITLE> + Description + </TITLE> + <PARA> + <command>DROP SEQUENCE</command> removes sequence number generators from the + data base. With the current implementation of sequences as + special tables it works just like the <command>DROP TABLE</command> + statement. + </PARA> + + <REFSECT2 ID="R2-SQL-DROPSEQUENCE-3"> + <REFSECT2INFO> + <DATE>1998-04-15</DATE> + </REFSECT2INFO> + <TITLE> + Notes + </TITLE> + <PARA> + The <command>DROP SEQUENCE</command> statement is a PostgreSQL + language extension. + </PARA> + <PARA> + Refer to the <command>CREATE SEQUENCE</command> statement for + information on how to create a sequence. + </PARA> + </REFSECT2> + + <REFSECT1 ID="R1-SQL-DROPSEQUENCE-2"> + <TITLE> + Usage + </TITLE> + <PARA> + To remove sequence <literal>serial</literal> from database: + </PARA> + <ProgramListing> + DROP SEQUENCE serial + </ProgramListing> + </REFSECT1> + + <REFSECT1 ID="R1-SQL-DROPSEQUENCE-3"> + <TITLE> + Compatibility + </TITLE> + <PARA> + </PARA> + + <REFSECT2 ID="R2-SQL-DROPSEQUENCE-4"> + <REFSECT2INFO> + <DATE>1998-04-15</DATE> + </REFSECT2INFO> + <TITLE> + SQL92 + </TITLE> + <PARA> + There is no <command>DROP SEQUENCE</command> 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: +--> diff --git a/doc/src/sgml/ref/drop_table.sgml b/doc/src/sgml/ref/drop_table.sgml new file mode 100644 index 0000000000..d913d74091 --- /dev/null +++ b/doc/src/sgml/ref/drop_table.sgml @@ -0,0 +1,210 @@ +<REFENTRY ID="SQL-DROPTABLE"> + <REFMETA> + <REFENTRYTITLE> + DROP TABLE + </REFENTRYTITLE> + <REFMISCINFO>SQL - Language Statements</REFMISCINFO> + </REFMETA> + <REFNAMEDIV> + <REFNAME> + DROP TABLE + </REFNAME> + <REFPURPOSE> + Removes existing tables from a database + </REFPURPOSE> + + <REFSYNOPSISDIV> + <REFSYNOPSISDIVINFO> + <DATE>1998-04-15</DATE> + </REFSYNOPSISDIVINFO> + <SYNOPSIS> + DROP TABLE <REPLACEABLE CLASS="PARAMETER">table</REPLACEABLE> [, ...] + </SYNOPSIS> + + <REFSECT2 ID="R2-SQL-DROPTABLE-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">table</REPLACEABLE></ReturnValue> + </TERM> + <LISTITEM> + <PARA> + The name of an existing table or view to drop. + </PARA> + </LISTITEM> + </VARLISTENTRY> + </variablelist> + </LISTITEM> + </VARLISTENTRY> + </VARIABLELIST> + </REFSECT2> + + <REFSECT2 ID="R2-SQL-DROPTABLE-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> + The message returned if the command completes successfully. + </PARA> + </LISTITEM> + </VARLISTENTRY> + <VARLISTENTRY> + <TERM> + <ReturnValue> ERROR Relation "<replaceable class="parameter">table</replaceable>" Does Not Exist!</ReturnValue> + </TERM> + <LISTITEM> + <PARA> + If table/view specified doesn't exist into database. + </PARA> + </LISTITEM> + </VARLISTENTRY> + </variablelist> + </LISTITEM> + </VARLISTENTRY> + </VARIABLELIST> + </REFSECT2> + </REFSYNOPSISDIV> + + <REFSECT1 ID="R1-SQL-DROPTABLE-1"> + <REFSECT1INFO> + <DATE>1998-04-15</DATE> + </REFSECT1INFO> + <TITLE> + Description + </TITLE> + <PARA><command> + </command>DROP TABLE removes tables and views from the database. + Only its owner may destroy a table or view. A table + may be emptied of rows, but not destroyed, by using DELETE. + </PARA> + <PARA> + If a table being destroyed has secondary indices on it, + they will be removed first. The removal of just a + secondary index will not affect the indexed table. + </PARA> + + <REFSECT2 ID="R2-SQL-DROPTABLE-3"> + <REFSECT2INFO> + <DATE>1998-04-15</DATE> + </REFSECT2INFO> + <TITLE> + Notes + </TITLE> + <PARA> + Refer to the <command>CREATE TABLE</command> and + <command>ALTER TABLE</command> statements for information on + how to create or modify tables. + </PARA> + </REFSECT2> + </refsect1> + + <REFSECT1 ID="R1-SQL-DROPTABLE-2"> + <TITLE> + Usage + </TITLE> + <PARA> + To destroy the <literal>films</literal> and + <command>distributors</command> tables: + </PARA> + <ProgramListing> + DROP TABLE films, distributors + </ProgramListing> + </REFSECT1> + + <REFSECT1 ID="R1-SQL-DROPTABLE-3"> + <TITLE> + Compatibility + </TITLE> + <PARA> + </PARA> + + <REFSECT2 ID="R2-SQL-DROPTABLE-4"> + <REFSECT2INFO> + <DATE>1998-04-15</DATE> + </REFSECT2INFO> + <TITLE> + SQL92 + </TITLE> + <PARA> + SQL92 specifies some additional capabilities for DROP TABLE: + </PARA> + <synopsis> + DROP TABLE <replaceable class="parameter">table</replaceable> { RESTRICT | CASCADE } + </synopsis> + <variablelist> + <varlistentry> + <term>RESTRICT</term> + <listitem> + <para> + Ensures that only a table with no dependent views or + integrity constraints can be destroyed. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>CASCADE</term> + <listitem> + <para> + Any referencing views or integrity constraints + will also be dropped. + </para> + </listitem> + </varlistentry> + </variablelist> + <tip> + <para> + At present, to remove a referenced view you must drop + it by hand. + </para> + </tip> + </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: +--> diff --git a/doc/src/sgml/ref/drop_trigger.sgml b/doc/src/sgml/ref/drop_trigger.sgml new file mode 100644 index 0000000000..bc0c5924ed --- /dev/null +++ b/doc/src/sgml/ref/drop_trigger.sgml @@ -0,0 +1,207 @@ +<REFENTRY ID="SQL-DROPTRIGGER"> + <REFMETA> + <REFENTRYTITLE> + DROP TRIGGER + </REFENTRYTITLE> + <REFMISCINFO>SQL - Language Statements</REFMISCINFO> + </REFMETA> + <REFNAMEDIV> + <REFNAME> + DROP TRIGGER + </REFNAME> + <REFPURPOSE> + Removes the definition of a trigger + </REFPURPOSE> + <REFSYNOPSISDIV> + <REFSYNOPSISDIVINFO> + <DATE>1998-04-15</DATE> + </REFSYNOPSISDIVINFO> + <SYNOPSIS> + DROP TRIGGER <REPLACEABLE CLASS="PARAMETER">name</REPLACEABLE> ON <REPLACEABLE CLASS="PARAMETER">table</REPLACEABLE> + </SYNOPSIS> + + <REFSECT2 ID="R2-SQL-DROPTRIGGER-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 trigger. + </PARA> + </LISTITEM> + </VARLISTENTRY> + <VARLISTENTRY> + <TERM> + <ReturnValue><REPLACEABLE CLASS="PARAMETER">table</REPLACEABLE></ReturnValue> + </TERM> + <LISTITEM> + <PARA> + The name of a table. + </PARA> + </LISTITEM> + </VARLISTENTRY> + </variablelist> + </LISTITEM> + </VARLISTENTRY> + </VARIABLELIST> + </REFSECT2> + + <REFSECT2 ID="R2-SQL-DROPTRIGGER-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> + The message returned if the trigger is successfully dropped. + </PARA> + </LISTITEM> + </VARLISTENTRY> + <VARLISTENTRY> + <TERM> + <ReturnValue>ERROR: DropTrigger: there is no trigger <REPLACEABLE CLASS="PARAMETER">name</REPLACEABLE> on relation "<replaceable class="parameter">table</replaceable>"</ReturnValue> + </TERM> + <LISTITEM> + <PARA> + This message occurs if the trigger specified does not exist. + </PARA> + </LISTITEM> + </VARLISTENTRY> + </variablelist> + </LISTITEM> + </VARLISTENTRY> + </VARIABLELIST> + + </REFSECT2> + </REFSYNOPSISDIV> + + <REFSECT1 ID="R1-SQL-DROPTRIGGER-1"> + <REFSECT1INFO> + <DATE>1998-04-15</DATE> + </REFSECT1INFO> + <TITLE> + Description + </TITLE> + <PARA> + <command>DROP TRIGGER</command> will remove all references to an existing + trigger definition. To execute this command the current + user must be the owner of the trigger. + </PARA> + + <REFSECT2 ID="R2-SQL-DROPTRIGGER-3"> + <REFSECT2INFO> + <DATE>1998-04-15</DATE> + </REFSECT2INFO> + <TITLE> + Notes + </TITLE> + <PARA> + The <command>DROP TRIGGER</command> statement is a PostgreSQL + language extension. + </PARA> + <PARA> + Refer to the <command>CREATE TRIGGER</command> statement for + information on how to create triggers. + </PARA> + </REFSECT2> + + <REFSECT1 ID="R1-SQL-DROPTRIGGER-2"> + <TITLE> + Usage + </TITLE> + <PARA> + Destroy the <literal>if_dist_exists</literal> trigger on table <literal>films</literal>: + </PARA> + <ProgramListing> + DROP TRIGGER if_dist_exists ON films; + </ProgramListing> + </REFSECT1> + + <REFSECT1 ID="R1-SQL-DROPTRIGGER-3"> + <TITLE> + Compatibility + </TITLE> + <PARA> + </PARA> + + <REFSECT2 ID="R2-SQL-DROPTRIGGER-4"> + <REFSECT2INFO> + <DATE>1998-04-15</DATE> + </REFSECT2INFO> + <TITLE> + SQL92 + </TITLE> + <PARA> + There is no <command>DROP TRIGGER</command> statement in SQL92. + </PARA> + </refsect2> + </refsect1> +</REFENTRY> + +<!-- +<REPLACEABLE CLASS="PARAMETER"> +</REPLACEABLE> +<ReturnValue></ReturnValue> +<PARA> +</PARA> +<VARIABLELIST> +<VARLISTENTRY> +<TERM>• +</TERM> +<LISTITEM> +<PARA> +</PARA> +</LISTITEM> +</VARLISTENTRY> +</VARIABLELIST> +<PARA> +</PARA> +--> + +<!-- 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: +--> diff --git a/doc/src/sgml/ref/drop_type.sgml b/doc/src/sgml/ref/drop_type.sgml new file mode 100644 index 0000000000..4f900e5b11 --- /dev/null +++ b/doc/src/sgml/ref/drop_type.sgml @@ -0,0 +1,196 @@ +<REFENTRY ID="SQL-DROPTYPE"> + <REFMETA> + <REFENTRYTITLE> + DROP TYPE + </REFENTRYTITLE> + <REFMISCINFO>SQL - Language Statements</REFMISCINFO> + </REFMETA> + <REFNAMEDIV> + <REFNAME> + DROP TYPE + </REFNAME> + <REFPURPOSE> + Removes a user-defined type from the system catalogs + </REFPURPOSE> + <REFSYNOPSISDIV> + <REFSYNOPSISDIVINFO> + <DATE>1998-04-15</DATE> + </REFSYNOPSISDIVINFO> + <SYNOPSIS> + DROP TYPE <REPLACEABLE CLASS="PARAMETER">typename</REPLACEABLE> + </SYNOPSIS> + + <REFSECT2 ID="R2-SQL-DROPTYPE-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">typename</REPLACEABLE></ReturnValue> + </TERM> + <LISTITEM> + <PARA> + The name of an existing type. + </PARA> + </LISTITEM> + </VARLISTENTRY> + </variablelist> + </LISTITEM> + </VARLISTENTRY> + </VARIABLELIST> + </REFSECT2> + + <REFSECT2 ID="R2-SQL-DROPTYPE-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> + The message returned if the command is successful. + </PARA> + </LISTITEM> + </VARLISTENTRY> + <VARLISTENTRY> + <TERM> + <ReturnValue>ERROR: RemoveType: type '<replaceable class="parameter">typename</replaceable>' does not exist</ReturnValue> + </TERM> + <LISTITEM> + <PARA> + This message occurs if the specified type is not found. + </PARA> + </LISTITEM> + </VARLISTENTRY> + </variablelist> + </LISTITEM> + </VARLISTENTRY> + </VARIABLELIST> + </REFSECT2> + </REFSYNOPSISDIV> + + <REFSECT1 ID="R1-SQL-DROPTYPE-1"> + <REFSECT1INFO> + <DATE>1998-04-15</DATE> + </REFSECT1INFO> + <TITLE> + Description + </TITLE> + <PARA> + <command>DROP TYPE</command> will remove a user type from the + system catalogs. + </PARA> + <PARA> + Only the owner of a type can remove it. + </PARA> + + <REFSECT2 ID="R2-SQL-DROPTYPE-3"> + <REFSECT2INFO> + <DATE>1998-04-15</DATE> + </REFSECT2INFO> + <TITLE> + Notes + </TITLE> + <PARA> + DROP TYPE statement is a PostgreSQL language extension. + </PARA> + <PARA> + Refer to the <command>CREATE TYPE</command> statement for + inforamation on how to create types. + </PARA> + <PARA> + It is the user's responsibility to remove any operators, + functions, aggregates, access methods, subtypes, classes, + and so on, that use a deleted type. + </PARA> + </refsect2> + + <REFSECT2 ID="R2-SQL-DROPTYPE-4"> + <REFSECT2INFO> + <DATE>1998-04-15</DATE> + </REFSECT2INFO> + <TITLE> + Bugs + </TITLE> + <PARA> + If a built-in type is removed, the behavior of the backend + is unpredictable. + </PARA> + </refsect2> + + <REFSECT1 ID="R1-SQL-DROPTYPE-2"> + <TITLE> + Usage + </TITLE> + <PARA> + To remove the <literal>box</literal> type: + </PARA> + <ProgramListing> + DROP TYPE box + </ProgramListing> + </REFSECT1> + + <REFSECT1 ID="R1-SQL-DROPTYPE-3"> + <TITLE> + Compatibility + </TITLE> + <PARA> + </PARA> + + <REFSECT2 ID="R2-SQL-DROPTYPE-5"> + <REFSECT2INFO> + <DATE>1998-04-15</DATE> + </REFSECT2INFO> + <TITLE> + SQL3 + </TITLE> + <PARA> + DROP TYPE is a SQL3 statement. + </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: +--> diff --git a/doc/src/sgml/ref/drop_user.sgml b/doc/src/sgml/ref/drop_user.sgml new file mode 100644 index 0000000000..a99e5005b7 --- /dev/null +++ b/doc/src/sgml/ref/drop_user.sgml @@ -0,0 +1,183 @@ +<REFENTRY ID="SQL-DROPUSER"> + <REFMETA> + <REFENTRYTITLE> + DROP USER + </REFENTRYTITLE> + <REFMISCINFO>SQL - Language Statements</REFMISCINFO> + </REFMETA> + <REFNAMEDIV> + <REFNAME> + DROP USER + </REFNAME> + <REFPURPOSE> + Removes an user account information + </REFPURPOSE> + + <REFSYNOPSISDIV> + <REFSYNOPSISDIVINFO> + <DATE>1998-04-15</DATE> + </REFSYNOPSISDIVINFO> + <SYNOPSIS> + DROP USER <REPLACEABLE CLASS="PARAMETER">username</REPLACEABLE> + </SYNOPSIS> + + <REFSECT2 ID="R2-SQL-DROPUSER-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">username</REPLACEABLE></ReturnValue> + </TERM> + <LISTITEM> + <PARA> + The name of an existing user. + </PARA> + </LISTITEM> + </VARLISTENTRY> + </variablelist> + </LISTITEM> + </VARLISTENTRY> + </VARIABLELIST> + </REFSECT2> + + <REFSECT2 ID="R2-SQL-DROPUSER-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> + The message returned if the user is successfully deleted. + </PARA> + </LISTITEM> + </VARLISTENTRY> + <VARLISTENTRY> + <TERM> + <ReturnValue>ERROR: removeUser: user "<replaceable class="parameter">username</replaceable>" does not exist.</ReturnValue> + </TERM> + <LISTITEM> + <PARA> + This message occurs if the username is not found. + </PARA> + </LISTITEM> + </VARLISTENTRY> + </variablelist> + </LISTITEM> + </VARLISTENTRY> + </VARIABLELIST> + </REFSECT2> + </REFSYNOPSISDIV> + + <REFSECT1 ID="R1-SQL-DROPUSER-1"> + <REFSECT1INFO> + <DATE>1998-04-15</DATE> + </REFSECT1INFO> + <TITLE> + Description + </TITLE> + <PARA> + The <command>DROP USER</command> statement removes the named + user from the database, + along with any databases owned by the user. It + does not remove tables, views, or triggers owned by the + named user in databases not owned by the user. This statement + can be used in the place of the <command>destroyuser</command> + script, regardless of how the user was created. + </PARA> + + <REFSECT2 ID="R2-SQL-DROPUSER-3"> + <REFSECT2INFO> + <DATE>1998-04-15</DATE> + </REFSECT2INFO> + <TITLE> + Notes + </TITLE> + <PARA> + The <command>DROP USER</command> statement is a PostgreSQL + language extension. + </PARA> + <PARA> + Refer to the <command>CREATE USER</command> and + <command>ALTER USER</command> statements for information on + how to create or modify user accounts. + </PARA> + </REFSECT2> + + <REFSECT1 ID="R1-SQL-DROPUSER-2"> + <TITLE> + Usage + </TITLE> + <PARA> + To drop a user account: + </PARA> + <ProgramListing> + DROP USER Jonathan; + </ProgramListing> + </REFSECT1> + + <REFSECT1 ID="R1-SQL-DROPUSER-3"> + <TITLE> + Compatibility + </TITLE> + <PARA> + </PARA> + + <REFSECT2 ID="R2-SQL-DROPUSER-4"> + <REFSECT2INFO> + <DATE>1998-04-15</DATE> + </REFSECT2INFO> + <TITLE> + SQL92 + </TITLE> + <PARA> + There is no <command>DROP USER</command> statement on 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: +--> diff --git a/doc/src/sgml/ref/drop_view.sgml b/doc/src/sgml/ref/drop_view.sgml new file mode 100644 index 0000000000..9be7a94610 --- /dev/null +++ b/doc/src/sgml/ref/drop_view.sgml @@ -0,0 +1,207 @@ +<REFENTRY ID="SQL-DROPVIEW"> + <REFMETA> + <REFENTRYTITLE> + DROP VIEW + </REFENTRYTITLE> + <REFMISCINFO>SQL - Language Statements</REFMISCINFO> + </REFMETA> + <REFNAMEDIV> + <REFNAME> + DROP VIEW + </REFNAME> + <REFPURPOSE> + Removes an existing view from a database + </REFPURPOSE> + <REFSYNOPSISDIV> + <REFSYNOPSISDIVINFO> + <DATE>1998-04-15</DATE> + </REFSYNOPSISDIVINFO> + <SYNOPSIS> + DROP VIEW <REPLACEABLE CLASS="PARAMETER">view</REPLACEABLE> + </SYNOPSIS> + + <REFSECT2 ID="R2-SQL-DROPVIEW-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">view</REPLACEABLE></ReturnValue> + </TERM> + <LISTITEM> + <PARA> + The name of an existing view to drop. + </PARA> + </LISTITEM> + </VARLISTENTRY> + </variablelist> + </LISTITEM> + </VARLISTENTRY> + </VARIABLELIST> + </REFSECT2> + + <REFSECT2 ID="R2-SQL-DROPVIEW-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> + The message returned if the command is successful. + </PARA> + </LISTITEM> + </VARLISTENTRY> + <VARLISTENTRY> + <TERM> + <ReturnValue> + ERROR: RewriteGetRuleEventRel: rule "_RET<REPLACEABLE CLASS="PARAMETER">view</REPLACEABLE>" not found</ReturnValue> + </TERM> + <LISTITEM> + <PARA> + This message occurs if the specified view does not exist in + the database. + </PARA> + </LISTITEM> + </VARLISTENTRY> + </variablelist> + </LISTITEM> + </VARLISTENTRY> + </variablelist> + </REFSECT2> + </REFSYNOPSISDIV> + + <REFSECT1 ID="R1-SQL-DROPVIEW-1"> + <REFSECT1INFO> + <DATE>1998-04-15</DATE> + </REFSECT1INFO> + <TITLE> + Description + </TITLE> + <PARA> + <command>DROP VIEW</command> drops an existing view from the database. + To execute this command you must be the owner of the + view. + </PARA> + + <REFSECT2 ID="R2-SQL-DROPVIEW-3"> + <REFSECT2INFO> + <DATE>1998-04-15</DATE> + </REFSECT2INFO> + <TITLE> + Notes + </TITLE> + <PARA> + The PostgreSQL <command>DROP TABLE</command> statement also drops views. + </PARA> +<PARA> + Refer to the<command> CREATE VIEW</command> statement for information on how to create views. + </PARA> + </REFSECT2> + + <REFSECT1 ID="R1-SQL-DROPVIEW-2"> + <TITLE> + Usage + </TITLE> + <PARA> + This command will remove the view called <literal>kinds</literal>: + </PARA> + <ProgramListing> + DROP VIEW kinds + </ProgramListing> + </REFSECT1> + + <REFSECT1 ID="R1-SQL-DROPVIEW-3"> + <TITLE> + Compatibility + </TITLE> + <PARA> + </PARA> + + <REFSECT2 ID="R2-SQL-DROPVIEW-4"> + <REFSECT2INFO> + <DATE>1998-04-15</DATE> + </REFSECT2INFO> + <TITLE> + SQL92 + </TITLE> + <PARA> + SQL92 specifies some additional capabilities for + <command>DROP VIEW</command>: + </PARA> + + <synopsis> + DROP VIEW <replaceable class="parameter">view</replaceable> {RESTRICT | CASCADE} + </synopsis> + <variablelist> + <varlistentry> + <term>RESTRICT</term> + <listitem> + <para> + Ensures that only a view with no dependent views or + integrity constraints can be destroyed. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>CASCADE</term> + <listitem> + <para> + Any referencing views and integrity constraints + will be dropped as well. + </para> + </listitem> + </varlistentry> + </variablelist> + <tip> + <para> + At present, to remove a referenced view from a PostgreSQL database, + you must drop it by hand. + </para> + </tip> + </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: +-->