==============
DROP EXTENSION
==============


.. container:: refentry
   :name: SQL-DROPEXTENSION

   .. container:: titlepage

   .. container:: refnamediv

      .. rubric:: DROP EXTENSION
         :name: drop-extension

      DROP EXTENSION — 移除一个扩展

   .. container:: refsynopsisdiv

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

      .. code:: synopsis

         DROP EXTENSION [ IF EXISTS ] name [, ...] [ CASCADE | RESTRICT ]

   .. container:: refsect1
      :name: id-1.9.3.111.5

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

      ``DROP EXTENSION``\ 从数据库移除扩展。
      删除一个扩展会导致其组成对象也被删除。

      你必须拥有该扩展才能使用\ ``DROP EXTENSION``\ 。

   .. container:: refsect1
      :name: id-1.9.3.111.6

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

      .. container:: variablelist

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

         ``name``
            一个已安装扩展的名称。

         ``CASCADE``
            自动删除依赖于该扩展的对象，然后删除所有
            依赖于那些对象的对象（见\ `第 5.14 节 <ddl-depend.html>`__\ ）。

         ``RESTRICT``
            如果有任何对象依赖于该扩展（而不是它自己拥有的成员
            对象和其他被列在同一个\ ``DROP``\ 命令中
            的扩展），则拒绝删除它。这是默认值。

   .. container:: refsect1
      :name: id-1.9.3.111.7

      .. rubric:: 示例
         :name: 示例

      要从当前数据库移除扩展\ ``hstore``\ ：

      .. code:: programlisting

         DROP EXTENSION hstore;

      如果\ ``hstore``\ 的任何对象在该数据库库中
      正在使用，例如有一个表的列是\ ``hstore``\ 类型，这个
      命令都将会失败。加上\ ``CASCADE``\ 选项可以强制
      把这些依赖对象也移除。

   .. container:: refsect1
      :name: id-1.9.3.111.8

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

      ``DROP EXTENSION``\ 是一个 OushuDB 扩展。

   .. container:: refsect1
      :name: id-1.9.3.111.9

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

      `CREATE EXTENSION <sql-createextension.html>`__, `ALTER
      EXTENSION <sql-alterextension.html>`__