CREATE SERVER

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

语法

CREATE SERVER server_name  FOREIGN DATA WRAPPER fdw_name
    [ OPTIONS ( option 'value' [, ... ] ) ]

注意事项

  • CREATE SERVER定义一个新的外部服务器。 定义该服务器的用户会成为拥有者。

  • 外部服务器通常包含了外部数据包装器用来访问一个外部数据源所需的连接信息。额外的用户相关的连接信息可以通过用户映射的方式来指定。

  • 服务器名称在数据库中必须唯一。

  • 创建服务器要求使用外部数据包装器上的USAGE特权。

  • 在使用DBLink模块时,一个外部服务器的名称可以被用作dblink_connect函数的一个参数来指示连接参数。以这种方式使用外部服务器,需要具有外部服务器的USAGE权限。

  • PolarDB PostgreSQL版不能在OPTIONS中指定host、port等关键字,请使用channel_name替代。每个集群默认配置一个channel为localhost,即连接本地的channel。如果需要连接其他数据库集群,请先建立channel。

参数说明

参数

说明

server_name

需要创建的外部服务器的名称。

fdw_name

管理该服务器的外部数据包装器的名称。

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

该子句为服务器指定选项。这些选项通常定义该服务器的连接细节, 但实际的名称和值取决于该服务器的外部数据包装器。

示例

创建使用外部数据包装器postgres_fdw的服务器myserver。

说明

需要先创建postgres_fdw插件。

CREATE EXTENSION  postgres_fdw;
CREATE SERVER foreign_server FOREIGN DATA WRAPPER postgres_fdw OPTIONS (channel_name 'localhost', dbname 'foodb');