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

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 的擴充套件。

另請參閱

CREATE SERVER, DROP SERVER

提交更正

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