Redrock Postgres 搜索 英文
版本: 9.3 / 9.4 / 9.5 / 9.6 / 10 / 11 / 12 / 13 / 14 / 15 / 16 / 17

CREATE SERVER

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

概述

CREATE SERVER [ IF NOT EXISTS ] server_name [ TYPE 'server_type' ] [ VERSION 'server_version' ]
    FOREIGN DATA WRAPPER fdw_name
    [ OPTIONS ( option 'value' [, ... ] ) ]

描述

CREATE SERVER 定义新的外部服务器。定义服务器的用户将成为其所有者。

外部服务器通常封装外部数据封装用于访问外部数据资源的连接信息。用户映射可以指定其他用户特定的连接信息。

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

创建服务器需要对正在使用的外部数据封装具有 USAGE 权限。

参数

如果不存在

如果已存在同名的服务器,则不要抛出错误。在这种情况下会发出通知。请注意,无法保证现有服务器与将创建的服务器一模一样。

服务器名称

要创建的外围服务器名称。

服务器类型

可选的服务器类型,可能对外部数据包装器有帮助。

服务器版本

可选的服务器版本,可能对外部数据包装器有帮助。

fdw 名称

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

选项 ( 选项 '' [, ... ] )

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

注意

使用 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)。

另请参阅

ALTER SERVERDROP SERVERCREATE FOREIGN DATA WRAPPERCREATE FOREIGN TABLECREATE USER MAPPING