===================
CREATE USER MAPPING
===================


.. container:: refentry
   :name: SQL-CREATEUSERMAPPING

   .. container:: titlepage

   .. container:: refnamediv

      .. rubric:: CREATE USER MAPPING
         :name: create-user-mapping

      CREATE USER MAPPING — 定义一个用户到一个外部服务器的新映射

   .. container:: refsynopsisdiv

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

      .. code:: synopsis

         CREATE USER MAPPING [IF NOT EXISTS] FOR { user_name | USER | CURRENT_USER | PUBLIC }
             SERVER server_name
             [ OPTIONS ( option 'value' [ , ... ] ) ]

   .. container:: refsect1
      :name: id-1.9.3.96.5

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

      ``CREATE USER MAPPING``\ 定义一个用户
      到一个外部服务器的新映射。一个用户映射通常会包含连接信息，外部数据包装器
      会使用连接信息和外部服务器中包含的信息一起来访问一个外部数据源。

      一个外部服务器的拥有者可以为任何服务器任何用户创建用户映射。还有，
      如果一个用户被授予了服务器上的\ ``USAGE``\ 特权，该用户可以
      为他们自己的用户名创建用户映射。

   .. container:: refsect1
      :name: id-1.9.3.96.6

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

      .. container:: variablelist

         ``IF NOT EXISTS``
            如果给定用户到给定外部服务器的映射已经存在，则不要抛出错误。
            在这种情况下发出通知。请注意，不能保证现有的用户映射与要创建的映射完全相同。

         *``user_name``*
            要映射到外部服务器的一个现有用户的名称。
            ``CURRENT_USER``\ 和\ ``USER``\ 匹配当前用户的名称。
            当\ ``PUBLIC``\ 被指定时，一个所谓的公共映射会被创建，当没有
            特定用户的映射可用时将会使用它。

         *``server_name``*
            将为其创建用户映射的现有服务器的名称。

         ``OPTIONS ( option`` '*``value``*' [, ... ] )
            这个子句指定用户映射的选项。这些选项通常定义该映射实际的用户名和
            口令。选项名必须唯一。允许的选项名和值与该服务器的外部数据包装器
            有关。

   .. container:: refsect1
      :name: id-1.9.3.96.7

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

      为用户\ ``bob``\ 、服务器\ ``foo``\ 创建一个用户映射：

      .. code:: programlisting

         CREATE USER MAPPING FOR bob SERVER foo OPTIONS (user 'bob', password 'secret');

   .. container:: refsect1
      :name: id-1.9.3.96.8

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

      ``CREATE USER MAPPING``\ 符合 ISO/IEC 9075-9 (SQL/MED)。

   .. container:: refsect1
      :name: id-1.9.3.96.9

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

      `ALTER USER MAPPING <sql-alterusermapping.html>`__, `DROP USER
      MAPPING <sql-dropusermapping.html>`__, `CREATE FOREIGN DATA
      WRAPPER <sql-createforeigndatawrapper.html>`__, `CREATE
      SERVER <sql-createserver.html>`__