# CREATE EXTENSION ## Name CREATE EXTENSION?--?安裝一個擴展 ## Synopsis ``` CREATE EXTENSION [ IF NOT EXISTS ] _extension_name_ [ WITH ] [ SCHEMA _schema_name_ ] [ VERSION _version_ ] [ FROM _old_version_ ] ``` ## 描述 create extension 命令安裝一個新的擴展到一個數據庫中.必須保證沒有同名的擴展已經被安裝. 安裝一個擴展意味著執行一個擴展的腳本文件.這個腳本會創建一個新的SQL實體,例如函數, 數據類型,操作符,和索引支持的方法. 安裝擴展需要有和創建他的組件對象相同的權限.對于大多數擴展這意味著需要超戶或者數據庫所有者的權限. 對于后續的權限檢查和該擴展腳本所創建的實體，運行CREARE EXTENSION命令的角色將變為擴展的所有者． ## 參數 `IF NOT EXISTS` 如果系統已經存在一個同名的擴展，不會報錯．這種情況下會給出一個提示．請注意該參數不保證系統存在的擴展和現在腳本創建的擴展相同． `_extension_name_` 　　 將被安裝擴展的名字．PostgresQL從`SHAREDIR/extension/``_extension_name_``.control`這個文件安裝擴展. `_schema_name_` 擴展的實例被安裝在該模式下,擴展的內容可以被重新安裝.指定的模式必須已經存在.如果沒有指定,擴展的控制文件也不指定一個模式,這樣將使用默認模式. 注意擴展不認為它在任何模式里面:擴展在一個數據庫范圍內的名字是不受限制的,但是一個擴展的實例是屬于一個模式的. `_version_` 安裝擴展的版本.這個可以寫為一個標識符或者字符串.默認的版本在擴展的控制文件中指定. `_old_version_` 當你想升級安裝"old style" 模塊中沒有的內容時,你必須指定`FROM` `_old_version_`. 這個選項使`CREATE EXTENSION` 運行一個安裝腳本將新的內容安裝到擴展中,而不是創建一個新的實體.注意`SCHEMA`指定了包括這些已存在實體的模式. `_old_version_`的值由擴展的作者決定,如果有多個舊的版本升級到一個擴展這個值可能會改變.對于pre-9.1PostgreSQL 提供的標準擴展,當升級擴展時使用`unpackaged` 代替`_old_version_` ## 注意 在你使用 `CREATE EXTENSION`去安裝一個擴展到數據庫之前,擴展所需的文件必須被安裝.安裝擴展所需的信息在[Additional Supplied Modules](#calibre_link-367). 現在可以安裝的擴展可以在[`pg_available_extensions`](#calibre_link-953) 或者[`pg_available_extension_versions`](#calibre_link-952)找到. 關于寫一個擴展信息,可以查看[Section 35.15](#calibre_link-840). ## 例子 在當前數據庫安裝[hstore](#calibre_link-382)擴展: ``` CREATE EXTENSION hstore; ``` 升級一個9.1安裝的`hstore` : ``` CREATE EXTENSION hstore SCHEMA public FROM unpackaged; ``` 注意指定你在哪個模式安裝過 `hstore` . ## 兼容性 `CREATE EXTENSION`是PostgreSQL的一個擴展. ## 相關內容 [ALTER EXTENSION](#calibre_link-573), [DROP EXTENSION](#calibre_link-46)