历史版本。 PostgreSQL 13 已结束支持。 2025-11-13. 请参阅 当前版本手册.
CREATE SERVER
CREATE SERVER — 定义一个新的外部服务器
大纲
CREATE SERVER [ IF NOT EXISTS ]server_name[ TYPE 'server_type' ] [ VERSION 'server_version' ] FOREIGN DATA WRAPPERfdw_name[ OPTIONS (option'value' [, ... ] ) ]
描述
CREATE SERVER 定义一个新的外部服务器。定义该服务器的用户将成为其拥有者。
外部服务器通常封装外部数据包装器用来访问外部数据资源的连接信息。还可以通过用户映射指定额外的、特定于用户的连接信息。
服务器名称在数据库内必须唯一。
要创建服务器，必须在所使用的外部数据包装器上具有 USAGE 权限。
参数
IF NOT EXISTS如果同名服务器已存在，则不要抛出错误。在这种情况下会发出一个通知。请注意，不能保证现有服务器与原本将要创建的服务器有任何相似之处。
server_name要创建的外部服务器的名称。
server_type可选的服务器类型，可能对外部数据包装器有用。
server_version可选的服务器版本，可能对外部数据包装器有用。
fdw_name管理该服务器的外部数据包装器的名称。
OPTIONS (option'value' [, ... ] )这个子句指定服务器的选项。这些选项通常定义该服务器的连接细节，但实际的名称和值取决于该服务器的外部数据包装器。
注解
在使用 dblink 模块时，可以将外部服务器的名称用作 dblink_connect 函数的一个参数，以指示连接参数。要以这种方式使用它，必须在该外部服务器上具有
USAGE 权限。
如果外部服务器支持排序下推，那么它必须与本地服务器具有相同的排序顺序。
示例
创建一个使用外部数据包装器 postgres_fdw
的服务器 myserver：
CREATE SERVER myserver FOREIGN DATA WRAPPER postgres_fdw OPTIONS (host 'foo', dbname 'foodb', port '5432');
详见 postgres_fdw。
兼容性
CREATE SERVER 符合 ISO/IEC 9075-9 (SQL/MED)。