Postgresql 中文操作指南

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' [, ... ] ) ]

Description

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

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

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

创建服务器需要使用中的外部数据包装器上的 USAGE 权限。

Parameters

  • IF NOT EXISTS

    • 如果同名服务器已存在,则不抛出错误。此时会发出通知。请注意,无法保证现有服务器与将要创建的服务器有何相似之处。

  • server_name

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

  • server_type

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

  • server_version

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

  • fdw_name

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

  • OPTIONS ( _option ' value ' [, …… ] )_

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

Notes

使用 dblink 模块时,外部服务器的名称可以用作 dblink_connect 函数的参数,以指示连接参数。必须在外部服务器上具有 USAGE 权限,才能以这种方式使用它。

如果外部服务器支持排序下推,则它必须与本地服务器具有相同的排序顺序。

Examples

创建使用外部数据包装器 postgres_fdwmyserver 服务器:

CREATE SERVER myserver FOREIGN DATA WRAPPER postgres_fdw OPTIONS (host 'foo', dbname 'foodb', port '5432');

有关更多详细信息,请参见 postgres_fdw

Compatibility

CREATE SERVER 符合 ISO/IEC 9075-9 (SQL/MED)。