=============
DROP DATABASE
=============


.. container:: refentry
   :name: SQL-DROPDATABASE

   .. container:: titlepage

   .. container:: refnamediv

      .. rubric:: DROP DATABASE
         :name: drop-database

      DROP DATABASE — 移除一个数据库

   .. container:: refsynopsisdiv

      .. rubric:: 大纲
         :name: 大纲

      .. code:: synopsis

         DROP DATABASE [ IF EXISTS ] name

   .. container:: refsect1
      :name: id-1.9.3.108.5

      .. rubric:: 描述
         :name: 描述

      ``DROP DATABASE``\ 移除一个数据库。它会
      移除该数据库的系统目录项并且删除包含数据的文件目录。它只能由数据库
      拥有者执行。还有，当你或者任何其他人已经连接到目标数据库时，它不能
      被执行（连接到\ ``postgres``\ 或者任何其他数据库来发出这
      个命令）。

      ``DROP DATABASE``\ 不能被撤销。请小心使用！

   .. container:: refsect1
      :name: id-1.9.3.108.6

      .. rubric:: 参数
         :name: 参数

      .. container:: variablelist

         ``IF EXISTS``
            如果该数据库不存在则不要抛出一个错误，而是发出一个提示。

         *``name``*
            要移除的数据库的名称。

   .. container:: refsect1
      :name: id-1.9.3.108.7

      .. rubric:: 注解
         :name: 注解

      ``DROP DATABASE``\ 不能在一个事务块内执行。

      在连接到目标数据库时，这个命令不能被执行。因此，使用程序
      `dropdb <app-dropdb.html>`__\ 会更方便，它是这个命令的一个包装器。

   .. container:: refsect1
      :name: id-1.9.3.108.8

      .. rubric:: 兼容性
         :name: 兼容性

      SQL 标准中没有\ ``DROP DATABASE``\ 语句。

   .. container:: refsect1
      :name: id-1.9.3.108.9

      .. rubric:: 另见
         :name: 另见

      `CREATE DATABASE <sql-createdatabase.html>`__