支援的版本:目前 (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)。

提交更正

如果您在文件中發現任何不正確的地方、與您使用特定功能的經驗不符或需要進一步澄清的地方,請使用此表單來報告文件問題。