↑↓ 选择↵ 打开⌫ 切换范围完整搜索

PG.CENTER 连接 PostgreSQL 文档、百科与生态知识。由 Pigsty 维护。

Wiki / SQL 命令

CREATE USER MAPPING

定义用户到外部服务器的新映射

英文手册覆盖始于 PostgreSQL 6.4. 来源历史与运行验证各自保留独立版本边界。

当前阅读 PG 18·选择有来源记录的版本

8.49.09.19.29.39.49.59.61011121314151617181920
anchor
SQL-CREATEUSERMAPPING
file
sql-createusermapping.html
lang
en
name
CREATE USER MAPPING
purpose
define a new mapping of a user to a foreign server
purpose zh
未知
sections same as
未知
slug
18
synopsis text
CREATE USER MAPPING [ IF NOT EXISTS ] FOR { user_name | USER | CURRENT_ROLE | CURRENT_USER | PUBLIC } SERVER server_name [ OPTIONS ( option 'value' [ , ... ] ) ]

语法

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

从左向右阅读；分支表示选择，旁路表示可选，循环表示重复。点击带下划线的参数可打开对应规则。

CREATE USER MAPPING IF NOT EXISTS FOR user_name USER CURRENT_ROLE CURRENT_USER PUBLIC SERVER server_name OPTIONS ( option ' value ' , )

版本定义 PG 18

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权限，那么该用户也可以为自己的用户名创建用户映射。

参数

IF NOT EXISTS

如果给定用户到给定外部服务器的映射已经存在，则不要报错。这种情况下会发出一个提示。请注意，不能保证现有用户映射与本应创建的映射有任何相似之处。

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

比较版本

完整来源事实

synopsis html

CREATE USER MAPPING [ IF NOT EXISTS ] FOR { <em class="replaceable"><code>user_name</code></em> | USER | CURRENT_ROLE | CURRENT_USER | PUBLIC }
    SERVER <em class="replaceable"><code>server_name</code></em>
    [ OPTIONS ( <em class="replaceable"><code>option</code></em> '<em class="replaceable"><code>value</code></em>' [ , ... ] ) ]

来源引用

完整定义与证据 JSON

定义来源

center · PostgreSQL 18 · a709ab85

正文语言: zh-Hans · 1b5ca64c