CREATE SERVER
定义一个新的外部服务器
英文手册覆盖始于 PostgreSQL 6.4. 来源历史与运行验证各自保留独立版本边界。
当前阅读 PG 18·选择有来源记录的版本
- anchor
- SQL-CREATESERVER
- file
- sql-createserver.html
- lang
- en
- name
- CREATE SERVER
- purpose
- define a new foreign server
- purpose zh
- 未知
- sections same as
- 未知
- slug
- 18
- synopsis text
- CREATE SERVER [ IF NOT EXISTS ] server_name [ TYPE 'server_type' ] [ VERSION 'server_version' ] FOREIGN DATA WRAPPER fdw_name [ OPTIONS ( option 'value' [, ... ] ) ]
语法
CREATE SERVER [ IF NOT EXISTS ] server_name [ TYPE 'server_type' ] [ VERSION 'server_version' ]
FOREIGN DATA WRAPPER fdw_name
[ OPTIONS ( option 'value' [, ... ] ) ]语法图
从左向右阅读；分支表示选择，旁路表示可选，循环表示重复。点击带下划线的参数可打开对应规则。
版本定义 PG 18
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)。
另见
ALTER SERVER, DROP SERVER, CREATE FOREIGN DATA WRAPPER, CREATE FOREIGN TABLE, CREATE USER MAPPING比较版本
完整来源事实
synopsis html
CREATE SERVER [ IF NOT EXISTS ] <em class="replaceable"><code>server_name</code></em> [ TYPE '<em class="replaceable"><code>server_type</code></em>' ] [ VERSION '<em class="replaceable"><code>server_version</code></em>' ]
FOREIGN DATA WRAPPER <em class="replaceable"><code>fdw_name</code></em>
[ OPTIONS ( <em class="replaceable"><code>option</code></em> '<em class="replaceable"><code>value</code></em>' [, ... ] ) ]来源引用
定义来源
center · PostgreSQL 18 · a709ab85
正文语言: zh-Hans · 1b5ca64c