PostgreSQL創(chuàng)建函數(shù)中的選項(xiàng)是什么

這篇文章主要介紹“PostgreSQL創(chuàng)建函數(shù)中的選項(xiàng)是什么”，在日常操作中，相信很多人在PostgreSQL創(chuàng)建函數(shù)中的選項(xiàng)是什么問(wèn)題上存在疑惑，小編查閱了各式資料，整理出簡(jiǎn)單好用的操作方法，希望對(duì)大家解答”PostgreSQL創(chuàng)建函數(shù)中的選項(xiàng)是什么”的疑惑有所幫助！接下來(lái)，請(qǐng)跟著小編一起來(lái)學(xué)習(xí)吧！

Create Function的語(yǔ)法如下:

[pg12@localhost ~]$ psql
Expanded display is used automatically.
psql (12.2)
Type "help" for help.
[local:/data/run/pg12]:5120 pg12@testdb=# \help create function
Command:     CREATE FUNCTION
Description: define a new function
Syntax:
CREATE [ OR REPLACE ] FUNCTION
    name ( [ [ argmode ] [ argname ] argtype [ { DEFAULT | = } default_expr ] [, ...] ] )
    [ RETURNS rettype
      | RETURNS TABLE ( column_name column_type [, ...] ) ]
  { LANGUAGE lang_name
    | TRANSFORM { FOR TYPE type_name } [, ... ]
    | WINDOW
    | IMMUTABLE | STABLE | VOLATILE | [ NOT ] LEAKPROOF
    | CALLED ON NULL INPUT | RETURNS NULL ON NULL INPUT | STRICT
    | [ EXTERNAL ] SECURITY INVOKER | [ EXTERNAL ] SECURITY DEFINER
    | PARALLEL { UNSAFE | RESTRICTED | SAFE }
    | COST execution_cost
    | ROWS result_rows
    | SUPPORT support_function
    | SET configuration_parameter { TO value | = value | FROM CURRENT }
    | AS 'definition'
    | AS 'obj_file', 'link_symbol'
  } ...
URL: https://www.postgresql.org/docs/12/sql-createfunction.html
[local:/data/run/pg12]:5120 pg12@testdb=#

LANGUAGE
包括sql,c,internal,plpgsql等等

TRANSFORM
該選項(xiàng)列出調(diào)用函數(shù)時(shí)應(yīng)使用的transform.
transform說(shuō)明了如何轉(zhuǎn)換數(shù)據(jù)類型到一種編程語(yǔ)言.比如使用hstore類型通過(guò)PL/Python語(yǔ)言來(lái)編寫函數(shù),
PL/Python無(wú)法在Python語(yǔ)言環(huán)境中標(biāo)識(shí)hstore類型的數(shù)據(jù).語(yǔ)言默認(rèn)使用文本,但如果出現(xiàn)數(shù)組或者鏈表,
這種默認(rèn)處理就不合適了.
transform指定了兩種函數(shù):
“from SQL”:從SQL環(huán)境到編程語(yǔ)言.該函數(shù)在使用該語(yǔ)言編寫的函數(shù)時(shí)對(duì)參數(shù)進(jìn)行處理.
“to SQL”:從編程語(yǔ)言到SQL環(huán)境.處理返回值時(shí)調(diào)用.
該選項(xiàng)用于PL/Java等編程語(yǔ)言中.

WINDOW
使用該選項(xiàng),標(biāo)明該函數(shù)是窗口函數(shù)(window function)而不是普通函數(shù).

IMMUTABLE | STABLE | VOLATILE
這三個(gè)會(huì)影響查詢優(yōu)化器.默認(rèn)選項(xiàng)是VOLATILE.
IMMUTABLE:表示函數(shù)不能更改數(shù)據(jù)庫(kù)并且給定什么參數(shù)就返回什么值,100%的確定性.
STABLE:表示函數(shù)不能更改數(shù)據(jù)庫(kù),在一次表掃描過(guò)程中,對(duì)于同樣的參數(shù)會(huì)返回相同的結(jié)果,但結(jié)果可以在SQL語(yǔ)句之間改變.
結(jié)果如果依賴于數(shù)據(jù)庫(kù)查找,參數(shù)變量可變時(shí)可使用該選項(xiàng).
VOLATILE:在一次表掃描時(shí),結(jié)果也可以改變.如random(),currval()函數(shù)等.

LEAKPROOF
該選項(xiàng)表示函數(shù)不存在副作用.除了返回值,不會(huì)reveals參數(shù)的相關(guān)信息,比如如果因?yàn)槟承﹨?shù)值拋出錯(cuò)誤信息,
或者在錯(cuò)誤信息中包含參數(shù)值,那么該函數(shù)被不是leafproof.
該選項(xiàng)會(huì)影響以security_barrier選項(xiàng)創(chuàng)建的view或者啟用row level security的數(shù)據(jù)表.
系統(tǒng)將在用戶提供的包含non-leakproof函數(shù)的條件之前執(zhí)行來(lái)自安全策略的條件和來(lái)自查詢本身的安全屏障視圖，以防止數(shù)據(jù)的意外泄漏.
標(biāo)記為leakproof的函數(shù)和操作符被認(rèn)為是可信的，可以在安全策略和安全屏障視圖的條件之前執(zhí)行。

CALLED ON NULL INPUT | RETURNS NULL ON NULL INPUT | STRICT
默認(rèn)選項(xiàng)為CALLED ON NULL INPUT,表示如某些參數(shù)為null函數(shù)可以正常調(diào)用.函數(shù)的編寫者有責(zé)任檢查null值.
RETURNS NULL ON NULL INPUT | STRICT表示如果出現(xiàn)參數(shù)為null,則返回null.

SECURITY INVOKER | SECURITY DEFINER
SECURITY INVOKER表示以調(diào)用者的權(quán)限執(zhí)行函數(shù),這是默認(rèn)選項(xiàng).SECURITY DEFINER則表示以owner的權(quán)限執(zhí)行函數(shù).

PARALLEL UNSAFE | RESTRICTED | SAFE
PARALLEL UNSAFE表示不能以并行模式執(zhí)行函數(shù),如在SQL中出現(xiàn)該函數(shù)則需串行執(zhí)行,這是默認(rèn)選項(xiàng).
PARALLEL RESTRICTED表示函數(shù)可以并行模式執(zhí)行,但執(zhí)行者限制為并行組的leader.
PARALLEL SAFE表示無(wú)約束的并行執(zhí)行.
如函數(shù)修改了數(shù)據(jù)庫(kù)狀態(tài)或者使用子事務(wù)修改了事務(wù)狀態(tài)或者嘗試訪問(wèn)序列或者改變?cè)O(shè)置(如setval),那么函數(shù)應(yīng)標(biāo)記為unsafe.
如函數(shù)訪問(wèn)臨時(shí)表,客戶端連接狀態(tài),游標(biāo),預(yù)準(zhǔn)備語(yǔ)句或者系統(tǒng)無(wú)法以并行模式同步的后端本地狀態(tài),那么應(yīng)標(biāo)記為restricted.
如函數(shù)實(shí)際上unsafe但標(biāo)記為safe,那么會(huì)產(chǎn)生不可預(yù)知的錯(cuò)位.

COST
函數(shù)執(zhí)行的估算成本,單位為cpu_operator_cost.

ROWS
函數(shù)返回的估算行數(shù).

SUPPORT
該函數(shù)使用的planner support function.

SET
進(jìn)入該函數(shù)時(shí),設(shè)置配置參數(shù)為指定的值,執(zhí)行完畢則恢復(fù)為原來(lái)的參數(shù)值.

AS
函數(shù)定義.

到此，關(guān)于“PostgreSQL創(chuàng)建函數(shù)中的選項(xiàng)是什么”的學(xué)習(xí)就結(jié)束了，希望能夠解決大家的疑惑。理論與實(shí)踐的搭配能更好的幫助大家學(xué)習(xí)，快去試試吧！若想繼續(xù)學(xué)習(xí)更多相關(guān)知識(shí)，請(qǐng)繼續(xù)關(guān)注億速云網(wǎng)站，小編會(huì)繼續(xù)努力為大家?guī)?lái)更多實(shí)用的文章！