- <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>
- </refnamediv>
- <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>
- <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>1998-04-15</date>
- </refsect2info>
- <title>
- Outputs
- </title>
- <para>
- <variablelist>
- <varlistentry>
- <term><computeroutput>
- DESTROYDB
- </computeroutput></term>
- <listitem>
- <para>
- This message is returned if the command is successful.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><computeroutput>
- WARN: destroydb: database "<replaceable class="parameter">name</replaceable>" does not exist.
- </computeroutput></term>
- <listitem>
- <para>
- This message occurs if the specified database does not exist.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><computeroutput>
- ERROR: destroydb cannot be executed on an open database
- </computeroutput></term>
- <listitem>
- <para>
- This message occurs if the specified database does not exist.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </para>
- </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>
- <command>DROP DATABASE</command> statement is a <productname>Postgres</productname>
- language extension.
- <tip>
- <para>
- This query cannot be executed while connected to the target
- database. It is usually preferable to use the
- <command>destroydb</command> script instead.
- </para>
- </tip>
- </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 <command>DROP DATABASE</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:
- -->