# CREATE FOREIGN DATA WRAPPER ## Name CREATE FOREIGN DATA WRAPPER?--?定義一個外部數據封裝器 ## Synopsis ``` CREATE FOREIGN DATA WRAPPER _name_ [ HANDLER _handler_function_ | NO HANDLER ] [ VALIDATOR _validator_function_ | NO VALIDATOR ] [ OPTIONS ( _option_ '_value_' [, ... ] ) ] ``` ## 描述 `CREATE FOREIGN DATA WRAPPER`創建一個新的外部數據封裝器。 創建外部數據封裝器的用戶成為其所有者。 外部數據封裝器的名字必需在數據庫中唯一。 只有超級用戶可以創建外部數據封裝器。 ## 參數 `_name_` 要創建的外部數據封裝器的名字。 `HANDLER` `_handler_function_` `_handler_function_` 是先前已經注冊了的函數的名字，用來為外部表檢索執行函數。 處理器函數必須沒有參數，并且它的返回類型必須為`fdw_handler`。 不用處理器函數創建外部數據封裝器是可能的，但是使用這種封裝器的外部表只能被聲明，不能被訪問。 `VALIDATOR` `_validator_function_` `_validator_function_` 是先前已經注冊了的函數的名字，用來檢查提供給外部數據封裝器的通用選項， 還有使用該外部數據封裝器的外部服務器和用戶映射的選項。 如果沒有驗證器函數或聲明了`NO VALIDATOR`， 那么在創建時將不檢查選項。（外部數據封裝器可能在運行時忽略或拒絕無效的選項說明， 取決于實現。）驗證器函數必須接受兩個參數：一個類型為`text[]`， 將包含存儲在系統目錄中的選項的數組，一個類型為`oid`， 是包含這些選項的系統目錄的OID。忽略返回類型；該函數應該使用 `ereport(ERROR)`函數報告無效選項。 `OPTIONS (` `_option_` '`_value_`' [, ... ] ) 這個子句為新的外部數據封裝器聲明選項。允許的選項名和值是特定于每個外部數據封裝器的， 并且是經過外部數據封裝器的驗證器函數驗證了的。選項名必須是唯一的。 ## 注意 PostgreSQL的外部數據功能一直在積極開發。 查詢的優化是原始的（并且主要是封裝器）。因此，未來的性能提升有很大的空間。 ## 例子 創建一個無用的外部數據封裝器`dummy`： ``` CREATE FOREIGN DATA WRAPPER dummy; ``` 創建一個帶有處理器函數`file_fdw_handler` 的外部數據封裝器`file`： ``` CREATE FOREIGN DATA WRAPPER file HANDLER file_fdw_handler; ``` 創建一個帶有一些選項的外部數據封裝器`mywrapper`： ``` CREATE FOREIGN DATA WRAPPER mywrapper OPTIONS (debug 'true'); ``` ## 兼容性 `CREATE FOREIGN DATA WRAPPER`遵從ISO/IEC 9075-9 (SQL/MED)， 除了`HANDLER`和`VALIDATOR`子句是擴展， 并且標準的子句`LIBRARY`和`LANGUAGE` 沒有在PostgreSQL中實現。 請注意，然而，SQL/MED功能作為一個整體目前是不符合的。 ## 又見 [ALTER FOREIGN DATA WRAPPER](#calibre_link-59), [DROP FOREIGN DATA WRAPPER](#calibre_link-61), [CREATE SERVER](#calibre_link-6), [CREATE USER MAPPING](#calibre_link-68), [CREATE FOREIGN TABLE](#calibre_link-0)