907
PostgreSQL SQL語法（三）：調用函數
本文檔為PostgreSQL 9.6.0文檔，本轉載已得到原譯者彭煜瑋授權。
PostgreSQL允許帶有命名參數的函數被使用位置或命名記號法調用。命名記號法對於有大量參數的函數特別有用，因為它讓參數和實際參數之間的關聯更明顯和可靠。在位置記號法中，書寫一個函數調用時，其參數值要按照它們在函數聲明中被定義的順序書寫。在命名記號法中，參數根據名稱匹配函數參數，並且可以以任何順序書寫。
在任意一種記號法中，在函數聲明中給出了默認值的參數根本不需要在調用中寫出。但是這在命名記號法中特別有用，因為任何參數的組合都可以被忽略。而在位置記號法中參數隻能從右往左忽略。
PostgreSQL也支持混合記號法，它組合了位置和命名記號法。在這種情況中，位置參數被首先寫出並且命名參數出現在其後。
下列例子將展示所有三種記號法的用法：
CREATE FUNCTION concat_lower_or_upper(a text, b text, uppercase boolean DEFAULT false)
RETURNS text
AS
$$
SELECT CASE
WHEN $3 THEN UPPER($1 || ' ' || $2)
ELSE LOWER($1 || ' ' || $2)
END;
$$
LANGUAGE SQL IMMUTABLE STRICT;
函數concat_lower_or_upper有兩個強製參數，a和b。此外，有一個可選的參數uppercase，其默認值為false。a和b輸入將被串接，並且根據uppercase參數被強製為大寫或小寫形式。這個函數的剩餘細節對這裏並不重要（詳見Chapter 36）。
在PostgreSQL中，位置記號法是給函數傳遞參數的傳統機製。一個例子：
SELECT concat_lower_or_upper('Hello', 'World', true);
concat_lower_or_upper
-----------------------
HELLO WORLD
(1 row)
所有參數被按照順序指定。結果是大寫形式，因為uppercase被指定為true。另一個例子：
SELECT concat_lower_or_upper('Hello', 'World');
concat_lower_or_upper
-----------------------
hello world
(1 row)
這裏，uppercase參數被忽略，因此它接收它的默認值false，並導致小寫形式的輸出。在位置記號法中，參數可以按照從右往左被忽略並且因此而得到默認值。
在命名記號法中，每一個參數名都用=> 指定來把它與參數表達式分隔開。例如：
SELECT concat_lower_or_upper(a => 'Hello', b => 'World');
concat_lower_or_upper
-----------------------
hello world
(1 row)
再次，參數uppercase被忽略，因此它被隱式地設置為false。使用命名記號法的一個優點是參數可以用任何順序指定，例如：
SELECT concat_lower_or_upper(a => 'Hello', b => 'World', uppercase => true);
concat_lower_or_upper
-----------------------
HELLO WORLD
(1 row)
SELECT concat_lower_or_upper(a => 'Hello', uppercase => true, b => 'World');
concat_lower_or_upper
-----------------------
HELLO WORLD
(1 row)
為了向後兼容性，基於 ":=" 的舊語法仍被支持：
SELECT concat_lower_or_upper(a := 'Hello', uppercase := true, b := 'World');
concat_lower_or_upper
-----------------------
HELLO WORLD
(1 row)
混合記號法組合了位置和命名記號法。不過，正如已經提到過的，命名參數不能超越位置參數。例如：
SELECT concat_lower_or_upper('Hello', 'World', uppercase => true);
concat_lower_or_upper
-----------------------
HELLO WORLD
(1 row)
在上述查詢中，參數a和b被以位置指定，而uppercase通過名字指定。在這個例子中，這隻增加了一點文檔。在一個具有大量帶默認值參數的複雜函數中，命名的或混合的記號法可以節省大量的書寫並且減少出錯的機會。
Note:
命名的和混合的調用記號法當前不能在調用聚集函數時使用（但是當聚集函數被用作窗口函數時它們可以被使用）。
最後更新：2017-08-16 16:32:26