CREATE USER MAPPING

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

语法

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

描述

CREATE USER MAPPING定义用户到外部服务器的映射。用户映射通常封装连接信息，外部数据包装器会将该信息与外部服务器封装的信息结合使用，以访问外部数据资源。

外部服务器的所有者可以为该服务器创建任何用户的用户映射。此外，如果用户已获得服务器上的USAGE权限，则该用户可以为自己创建用户映射。

参数

如果不存在

如果给定用户到给定外部服务器的映射已存在，则不要引发错误。在这种情况下会发出通知。请注意，无法保证现有的用户映射与将要创建的映射类似。

user_name

映射到外部服务器的现有用户的名称。CURRENT_ROLE、CURRENT_USER 和 USER 匹配当前用户的名称。当指定 PUBLIC 时，将创建所谓的公共映射，当没有适用的特定于用户的映射时使用该映射。

server_name

要为其创建用户映射的现有服务器的名称。

OPTIONS ( option 'value' [, ... ] )

此子句指定用户映射的选项。这些选项通常定义映射的实际用户名和密码。选项名称必须唯一。允许的选项名称和值特定于服务器的外来数据包装器。

示例

为用户bob、服务器foo创建用户映射

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

兼容性

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

另请参见

ALTER USER MAPPING、DROP USER MAPPING、CREATE FOREIGN DATA WRAPPER、CREATE SERVER