2025年9月25日: PostgreSQL 18 发布!
支持的版本:当前18)/ 17 / 16 / 15 / 14 / 13
开发版本:devel
不支持的版本:12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4

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 权限。

参数

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

提交更正

如果您在文档中发现任何不正确、与您实际使用该功能时的体验不符或需要进一步澄清的内容,请使用 此表单 报告文档问题。