受支持版本: 当前版本 (18) / 17 / 16 / 15 / 14
开发版本: devel

CREATE SERVER

CREATE SERVER — 定义一个新的外部服务器

Synopsis

CREATE SERVER [ IF NOT EXISTS ] server_name [ TYPE 'server_type' ] [ VERSION 'server_version' ]
    FOREIGN DATA WRAPPER fdw_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)。

提交更正

如果您发现文档中有不正确的内容、与您使用特定功能的经验不符或需要进一步说明,请使用此表单来报告文档问题。