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

提交更正

如果您在文件中發現任何不正確、與您實際使用該功能時的體驗不符或需要進一步澄清的內容,請使用 此表單 報告文件問題。