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

ALTER SERVER

ALTER SERVER — 更改外部伺服器的定義

概要

ALTER SERVER name [ VERSION 'new_version' ]
    [ OPTIONS ( [ ADD | SET | DROP ] option ['value'] [, ... ] ) ]
ALTER SERVER name OWNER TO { new_owner | CURRENT_ROLE | CURRENT_USER | SESSION_USER }
ALTER SERVER name RENAME TO new_name

描述

ALTER SERVER 更改外部伺服器的定義。第一種形式更改伺服器版本字串或伺服器的一般選項 (至少需要一個子句)。第二種形式更改伺服器的擁有者。

要更改伺服器,您必須是伺服器的擁有者。此外,要更改擁有者,您必須能夠 SET ROLE 為新的擁有角色,並且您必須對伺服器的外部資料包裝器具有 USAGE 權限。(請注意,超級使用者會自動滿足所有這些條件。)

參數

name

現有伺服器的名稱。

new_version

新的伺服器版本。

OPTIONS ( [ ADD | SET | DROP ] option ['value'] [, ... ] )

更改伺服器的選項。ADDSETDROP 指定要執行的動作。如果未明確指定任何操作,則假定為 ADD。選項名稱必須是唯一的;名稱和值也會使用伺服器的外部資料包裝器函式庫進行驗證。

new_owner

外部伺服器新擁有者的使用者名稱。

new_name

外部伺服器的新名稱。

範例

變更伺服器 foo,新增連線選項

ALTER SERVER foo OPTIONS (host 'foo', dbname 'foodb');

變更伺服器 foo,變更版本,變更 host 選項

ALTER SERVER foo VERSION '8.4' OPTIONS (SET host 'baz');

相容性

ALTER SERVER 符合 ISO/IEC 9075-9 (SQL/MED)。OWNER TORENAME 形式是 PostgreSQL 擴充功能。

提交更正

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