=================
DROP USER MAPPING
=================


.. container:: refentry
   :name: SQL-DROPUSERMAPPING

   .. container:: titlepage

   .. container:: refnamediv

      .. rubric:: DROP USER MAPPING
         :name: drop-user-mapping

      DROP USER MAPPING — 移除一个用于外部服务器的用户映射

   .. container:: refsynopsisdiv

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

      .. code:: synopsis

         DROP USER MAPPING [ IF EXISTS ] FOR { user_name | USER | CURRENT_USER | PUBLIC } SERVER server_name

   .. container:: refsect1
      :name: id-1.9.3.144.5

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

      ``DROP USER MAPPING``\ 从外部服务器移除 一个已有的用户映射。

      一个外部服务器的拥有者可以为该服务器的任何用户删除用户映射。如果
      该服务器上的\ ``USAGE``\ 特权被授予了一个用户，它也能删除
      用于它们自己的用户名的用户映射。

   .. container:: refsect1
      :name: id-1.9.3.144.6

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

      .. container:: variablelist

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

         *``user_name``*
            该映射的用户名。\ ``CURRENT_USER``
            和\ ``USER``\ 匹配当前用户的名称。\ ``PUBLIC``
            被用来匹配系统中所有现存和未来的用户名。

         *``server_name``*
            用户映射的服务器名。

   .. container:: refsect1
      :name: id-1.9.3.144.7

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

      删除一个用户映射\ ``bob``\ （服务器\ ``foo``\ ），如果它存在：

      .. code:: programlisting

         DROP USER MAPPING IF EXISTS FOR bob SERVER foo;

   .. container:: refsect1
      :name: id-1.9.3.144.8

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

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

   .. container:: refsect1
      :name: id-1.9.3.144.9

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

      `CREATE USER MAPPING <sql-createusermapping.html>`__, `ALTER USER
      MAPPING <sql-alterusermapping.html>`__