mirror of
https://github.com/postgres/postgres.git
synced 2025-04-25 21:42:33 +03:00
c05f29e895
capabilities of specifying time zones as intervals per SQL9x. Put refentrytitle contents on the same line as the tag. Otherwise, leading whitespace is propagated into the product, which (at least) messes up the ToC layout. Remove (some) docinfo tags containing dates. Best to omit if the dates are not accurate; maybe use CVS dates instead or leave them out.
172 lines
4.0 KiB
Plaintext
172 lines
4.0 KiB
Plaintext
<!--
|
|
$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_database.sgml,v 1.15 2002/04/21 19:02:39 thomas Exp $
|
|
PostgreSQL documentation
|
|
-->
|
|
|
|
<refentry id="SQL-DROPDATABASE">
|
|
<refmeta>
|
|
<refentrytitle id="SQL-DROPDATABASE-TITLE">DROP DATABASE</refentrytitle>
|
|
<refmiscinfo>SQL - Language Statements</refmiscinfo>
|
|
</refmeta>
|
|
<refnamediv>
|
|
<refname>
|
|
DROP DATABASE
|
|
</refname>
|
|
<refpurpose>
|
|
remove a database
|
|
</refpurpose>
|
|
</refnamediv>
|
|
<refsynopsisdiv>
|
|
<refsynopsisdivinfo>
|
|
<date>1999-12-11</date>
|
|
</refsynopsisdivinfo>
|
|
<synopsis>
|
|
DROP DATABASE <replaceable class="PARAMETER">name</replaceable>
|
|
</synopsis>
|
|
|
|
<refsect2 id="R2-SQL-DROPDATABASE-1">
|
|
<refsect2info>
|
|
<date>1999-12-11</date>
|
|
</refsect2info>
|
|
<title>
|
|
Inputs
|
|
</title>
|
|
<para>
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><replaceable class="PARAMETER">name</replaceable></term>
|
|
<listitem>
|
|
<para>
|
|
The name of an existing database to remove.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</para>
|
|
</refsect2>
|
|
|
|
<refsect2 id="R2-SQL-DROPDATABASE-2">
|
|
<refsect2info>
|
|
<date>1999-12-11</date>
|
|
</refsect2info>
|
|
<title>
|
|
Outputs
|
|
</title>
|
|
<para>
|
|
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
<term><computeroutput>DROP DATABASE</computeroutput></term>
|
|
<listitem>
|
|
<para>
|
|
This message is returned if the command is successful.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><computeroutput>DROP DATABASE: cannot be executed on the currently open database</computeroutput></term>
|
|
<listitem>
|
|
<para>
|
|
You cannot be connected to the database you are about to remove.
|
|
Instead, connect to <literal>template1</literal> or any other
|
|
database and run this command again.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><computeroutput>DROP DATABASE: may not be called in a transaction block</computeroutput></term>
|
|
<listitem>
|
|
<para>
|
|
You must finish the transaction in progress before you can call this command.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
</para>
|
|
</refsect2>
|
|
</refsynopsisdiv>
|
|
|
|
<refsect1 id="R1-SQL-DROPDATABASE-1">
|
|
<refsect1info>
|
|
<date>1999-12-11</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 owner (usually the user that created
|
|
it).
|
|
</para>
|
|
|
|
<para>
|
|
<command>DROP DATABASE</command> cannot be undone. Use it with care!
|
|
</para>
|
|
|
|
<refsect2 id="R2-SQL-DROPDATABASE-3">
|
|
<refsect2info>
|
|
<date>1999-12-11</date>
|
|
</refsect2info>
|
|
<title>
|
|
Notes
|
|
</title>
|
|
|
|
<para>
|
|
This command cannot be executed while connected to the target
|
|
database. Thus, it might be more convenient to use the shell
|
|
script <xref linkend="app-dropdb" endterm="app-dropdb-title">,
|
|
which is a wrapper around this command, instead.
|
|
</para>
|
|
|
|
<para>
|
|
Refer to
|
|
<xref linkend="sql-createdatabase" endterm="sql-createdatabase-title">
|
|
for information on how to create a database.
|
|
</para>
|
|
</refsect2>
|
|
</refsect1>
|
|
|
|
<refsect1 id="R1-SQL-DROPDATABASE-3">
|
|
<title>
|
|
Compatibility
|
|
</title>
|
|
|
|
<refsect2 id="R2-SQL-DROPDATABASE-4">
|
|
<refsect2info>
|
|
<date>1998-04-15</date>
|
|
</refsect2info>
|
|
<title>
|
|
SQL92
|
|
</title>
|
|
|
|
<para>
|
|
<command>DROP DATABASE</command> statement is a
|
|
<productname>PostgreSQL</productname> language extension;
|
|
there is no such command in <acronym>SQL92</acronym>.
|
|
</para>
|
|
</refsect2>
|
|
</refsect1>
|
|
</refentry>
|
|
|
|
<!-- Keep this comment at the end of the file
|
|
Local variables:
|
|
mode: sgml
|
|
sgml-omittag:nil
|
|
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:
|
|
-->
|