===========
DROP SERVER
===========


.. container:: refentry
   :name: SQL-DROPSERVER

   .. container:: titlepage

   .. container:: refnamediv

      .. rubric:: DROP SERVER
         :name: drop-server

      DROP SERVER — 移除一个外部服务器描述符

   .. container:: refsynopsisdiv

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

      .. code:: synopsis

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

   .. container:: refsect1
      :name: id-1.9.3.131.5

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

      ``DROP SERVER``\ 移除一个现有的外部服务器
      描述符。要执行这个命令，当前用户必须是该服务器的拥有者。

   .. container:: refsect1
      :name: id-1.9.3.131.6

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

      .. container:: variablelist

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

         *``name``*
            一个现有服务器的名称。

         ``CASCADE``
            自动删除依赖于该服务器的对象（例如用户映射），然后删除所有
            依赖于那些对象的对象（见\ `第 5.14 节 <ddl-depend.html>`__\ ）。

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

   .. container:: refsect1
      :name: id-1.9.3.131.7

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

      如果一个服务器\ ``foo``\ 存在则删除它：

      .. code:: programlisting

         DROP SERVER IF EXISTS foo;

   .. container:: refsect1
      :name: id-1.9.3.131.8

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

      ``DROP SERVER``\ 符合 ISO/IEC 9075-9
      (SQL/MED)。\ ``IF EXISTS``\ 子句是一个 PostgreSQL扩展。

   .. container:: refsect1
      :name: id-1.9.3.131.9

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

      `CREATE SERVER <sql-createserver.html>`__, `ALTER
      SERVER <sql-alterserver.html>`__