==================
DROP FOREIGN TABLE
==================


.. container:: refentry
   :name: SQL-DROPFOREIGNTABLE

   .. container:: titlepage

   .. container:: refnamediv

      .. rubric:: DROP FOREIGN TABLE
         :name: drop-foreign-table

      DROP FOREIGN TABLE — 移除一个外部表

   .. container:: refsynopsisdiv

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

      .. code:: synopsis

         DROP FOREIGN TABLE [ IF EXISTS ] name [, ...] [ CASCADE | RESTRICT ]

   .. container:: refsect1
      :name: id-1.9.3.113.5

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

      ``DROP FOREIGN TABLE``\ 移除一个
      外部表。只有一个外部表的拥有者才能移除它。

   .. container:: refsect1
      :name: id-1.9.3.113.6

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

      .. container:: variablelist

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

         *``name``*
            要删除的外部表的名称（可以是模式限定的）。

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

         ``RESTRICT``
            如果有任何对象依赖于该外部表，则拒绝删除它。这是默认值。

   .. container:: refsect1
      :name: id-1.9.3.113.7

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

      要销毁两个外部表\ ``films`` 和\ ``distributors``\ ：

      .. code:: programlisting

         DROP FOREIGN TABLE films, distributors;

   .. container:: refsect1
      :name: id-1.9.3.113.8

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

      这个命令符合 ISO/IEC 9075-9 (SQL/MED)，不过该标准只允许每个命令
      中删除一个外部表并且没有\ ``IF EXISTS``\ 选项。该选项是一个
      PostgreSQL扩展。

   .. container:: refsect1
      :name: id-1.9.3.113.9

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

      `ALTER FOREIGN TABLE <sql-alterforeigntable.html>`__, `CREATE
      FOREIGN TABLE <sql-createforeigntable.html>`__