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 FOREIGN DATA WRAPPER

ALTER FOREIGN DATA WRAPPER — 更改外部資料包裝器的定義

概要

ALTER FOREIGN DATA WRAPPER name
    [ HANDLER handler_function | NO HANDLER ]
    [ VALIDATOR validator_function | NO VALIDATOR ]
    [ OPTIONS ( [ ADD | SET | DROP ] option ['value'] [, ... ]) ]
ALTER FOREIGN DATA WRAPPER name OWNER TO { new_owner | CURRENT_ROLE | CURRENT_USER | SESSION_USER }
ALTER FOREIGN DATA WRAPPER name RENAME TO new_name

描述

ALTER FOREIGN DATA WRAPPER 更改外部資料包裝器的定義。命令的第一種形式更改外部資料包裝器的支援函式或通用選項(至少需要一個子句)。第二種形式更改外部資料包裝器的所有者。

只有超級使用者才能更改外部資料包裝器。此外,只有超級使用者才能擁有外部資料包裝器。

引數

name

現有的外部資料包裝器的名稱。

HANDLER handler_function

指定新的外部資料包裝器處理函式。

NO HANDLER

用於指定外部資料包裝器不再具有處理函式。

請注意,使用沒有處理函式的外部資料包裝器的外部表無法訪問。

VALIDATOR validator_function

指定新的外部資料包裝器驗證函式。

請注意,外部資料包裝器、或相關的伺服器、使用者對映或外部表的現有選項可能根據新的驗證函式無效。PostgreSQL 不會對此進行檢查。使用者在使用修改後的外部資料包裝器之前,需要確保這些選項是正確的。但是,此 ALTER FOREIGN DATA WRAPPER 命令中指定的任何選項都將使用新的驗證函式進行檢查。

NO VALIDATOR

用於指定外部資料包裝器不再具有驗證函式。

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

更改外部資料包裝器的選項。ADDSETDROP 指定要執行的操作。如果未明確指定操作,則假定為 ADD。選項名稱必須唯一;名稱和值也將使用外部資料包裝器的驗證函式(如果存在)進行驗證。

new_owner

外部資料包裝器的新所有者的使用者名稱。

new_name

外部資料包裝器的新名稱。

示例

更改外部資料包裝器 dbi,新增選項 foo,刪除 bar

ALTER FOREIGN DATA WRAPPER dbi OPTIONS (ADD foo '1', DROP bar);

將外部資料包裝器 dbi 的驗證函式更改為 bob.myvalidator

ALTER FOREIGN DATA WRAPPER dbi VALIDATOR bob.myvalidator;

相容性

ALTER FOREIGN DATA WRAPPER 符合 ISO/IEC 9075-9 (SQL/MED) 標準,但 HANDLERVALIDATOROWNER TORENAME 子句是擴充套件。

提交更正

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