一、基本概念:
SQL函數(shù)可以包含任意數(shù)量的查詢,但是函數(shù)只返回最后一個(gè)查詢(必須是SELECT)的結(jié)果。在簡(jiǎn)單情況下,返回最后一條查詢結(jié)果的第一行。如果最后一個(gè)查詢不返回任何行,那么該函數(shù)將返回NULL值。如果需要該函數(shù)返回最后一條SELECT語句的所有行,可以將函數(shù)的返回值定義為集合,即SETOF sometype。
SQL函數(shù)的函數(shù)體應(yīng)該是用分號(hào)分隔的SQL語句列表,其中最后一條語句之后的分號(hào)是可選的。除非函數(shù)聲明為返回void,否則最后一條語句必須是SELECT。事實(shí)上,在SQL函數(shù)中,不僅可以包含SELECT查詢語句,也可以包含INSERT、UPDATE和DELETE等其他標(biāo)準(zhǔn)的SQL語句,但是和事物相關(guān)的語句不能包含其中,如BEGIN、COMMIT、ROLLBACK和SAVEPOINT等。
CREATE FUNCTION命令的語法要求函數(shù)體寫成一個(gè)字符串文本。通常來說,該文本字符串常量使用美元符($$)圍住,如:
復(fù)制代碼 代碼如下:
CREATE FUNCTION clean_emp() RETURNS void AS $$
DELETE FROM emp WHERE salary 0;
$$ LANGUAGE SQL;
最后需要說明的是SQL函數(shù)中的參數(shù),PostgreSQL定義$1表示第一個(gè)參數(shù),$2為第二個(gè)參數(shù)并以此類推。如果參數(shù)是復(fù)合類型,則可以使用點(diǎn)表示法,即$1.name訪問復(fù)合類型參數(shù)中的name字段。需要注意的是函數(shù)參數(shù)只能用作數(shù)據(jù)值,而不能用于標(biāo)識(shí)符,如:
復(fù)制代碼 代碼如下:
INSERT INTO mytable VALUES ($1); --合法
INSERT INTO $1 VALUES (42); --不合法(表名屬于標(biāo)示符之一)
二、基本類型:
最簡(jiǎn)單的SQL函數(shù)可能就是沒有參數(shù)且返回基本類型的函數(shù)了,如:
復(fù)制代碼 代碼如下:
CREATE FUNCTION one() RETURNS integer AS $$
SELECT 1 AS result;
$$ LANGUAGE SQL;
下面的例子聲明了基本類型作為函數(shù)的參數(shù)。
復(fù)制代碼 代碼如下:
CREATE FUNCTION add_em(integer, integer) RETURNS integer AS $$
SELECT $1 + $2;
$$ LANGUAGE SQL;
# 通過select調(diào)用函數(shù)。
postgres=# SELECT add_em(1,2) AS answer;
answer
--------
3
(1 row)
在下面的例子中,函數(shù)體內(nèi)包含多個(gè)SQL語句,它們之間是用分號(hào)進(jìn)行分隔的。
復(fù)制代碼 代碼如下:
CREATE FUNCTION tf1 (integer, numeric) RETURNS numeric AS $$
UPDATE bank SET balance = balance - $2 WHERE accountno = $1;
SELECT balance FROM bank WHERE accountno = $1;
$$ LANGUAGE SQL;
三、復(fù)合類型:
見如下示例:
1). 創(chuàng)建數(shù)據(jù)表,這樣與之對(duì)應(yīng)的復(fù)合類型也隨之生成。
復(fù)制代碼 代碼如下:
CREATE TABLE emp (
name text,
salary numeric,
age integer,
);
2). 創(chuàng)建函數(shù),其參數(shù)為復(fù)合類型。在函數(shù)體內(nèi),可以像引用基本類型參數(shù)那樣引用復(fù)合類型,如$1。訪問復(fù)合類型的字段使用點(diǎn)表達(dá)式即可,如:$1.salary。
復(fù)制代碼 代碼如下:
CREATE FUNCTION double_salary(emp) RETURNS integer AS $$
SELECT ($1.salary * 2)::integer AS salary;
$$ LANGUAGE SQL;
3). 在select語句中,可以使用emp.*表示emp表的一整行數(shù)據(jù)。
復(fù)制代碼 代碼如下:
SELECT name, double_salary(emp.*) AS dream FROM emp WHERE age > 30;
4). 我們也可以使用ROW表達(dá)式構(gòu)造自定義的復(fù)合類型,如:
復(fù)制代碼 代碼如下:
SELECT name, double_salary(ROW(name, salary*1.1, age)) AS dream FROM emp;
5). 創(chuàng)建一個(gè)函數(shù),其返回值為復(fù)合類型,如:
復(fù)制代碼 代碼如下:
CREATE FUNCTION new_emp() RETURNS emp AS $$
SELECT ROW('None', 1000.0, 25)::emp;
$$ LANGUAGE SQL;
6). 調(diào)用返回復(fù)合類型的函數(shù)。
復(fù)制代碼 代碼如下:
SELECT new_emp();
7). 調(diào)用返回復(fù)合類型的函數(shù),同時(shí)訪問該返回值的某個(gè)字段。
復(fù)制代碼 代碼如下:
SELECT (new_emp()).name;
四、帶輸出參數(shù)的函數(shù):
還有一種方法可以用于返回函數(shù)執(zhí)行的結(jié)果,即輸出參數(shù),如:
復(fù)制代碼 代碼如下:
CREATE FUNCTION add_em2 (IN x int, IN y int, OUT sum int) AS $$
SELECT $1 + $2
$$ LANGUAGE SQL;
調(diào)用方法和返回結(jié)果與add_em(帶有返回值的函數(shù))完全一致,如:
復(fù)制代碼 代碼如下:
SELECT add_em(3,7);
這個(gè)帶有輸出參數(shù)的函數(shù)和之前的add_em函數(shù)沒有本質(zhì)的區(qū)別。事實(shí)上,輸出參數(shù)的真正價(jià)值在于它為函數(shù)提供了返回多個(gè)字段的途徑。如,
復(fù)制代碼 代碼如下:
CREATE FUNCTION sum_n_product (x int, y int, OUT sum int, OUT product int) AS $$
SELECT $1 + $2, $1 * $2
$$ LANGUAGE SQL;
調(diào)用方式?jīng)]有改變,只是返回結(jié)果多出一列。
復(fù)制代碼 代碼如下:
SELECT * FROM sum_n_product(11,42);
sum | product
-----+---------
53 | 462
(1 row)
在上面的示例中,IN用于表示該函數(shù)參數(shù)為輸入?yún)?shù)(缺省值,可以忽略),OUT則表示該參數(shù)為輸出參數(shù)。
五、返回結(jié)果作為表數(shù)據(jù)源:
所有SQL函數(shù)都可以在查詢的FROM子句里使用。該方法對(duì)于返回復(fù)合類型的函數(shù)而言特別有用,如果該函數(shù)定義為返回一個(gè)基本類型,那么該函數(shù)生成一個(gè)單字段表,如果該函數(shù)定義為返回一個(gè)復(fù)合類型,那么該函數(shù)生成一個(gè)復(fù)合類型里每個(gè)屬性組成的行。見如下示例:
1). 創(chuàng)建一個(gè)數(shù)據(jù)表。
復(fù)制代碼 代碼如下:
CREATE TABLE foo (
fooid int,
foosubid int,
fooname text
);
2). 創(chuàng)建SQL函數(shù),其返回值為與foo表對(duì)應(yīng)的復(fù)合類型。
復(fù)制代碼 代碼如下:
CREATE FUNCTION getfoo(int) RETURNS foo AS $$
SELECT * FROM foo WHERE fooid = $1;
$$ LANGUAGE SQL;
3). 在FROM子句中調(diào)用該函數(shù)。
復(fù)制代碼 代碼如下:
SELECT *, upper(fooname) FROM getfoo(1) AS t1;
六、返回集合的SQL函數(shù):
如果SQL函數(shù)的返回值為SETOF sometype,那么在調(diào)用該函數(shù)時(shí),將返回最后一個(gè)SELECT查詢的全部數(shù)據(jù)。這個(gè)特性通常用于把函數(shù)放在FROM子句里調(diào)用,見如下示例:
CREATE FUNCTION getfoo(int) RETURNS setof foo AS $$
SELECT * FROM foo WHERE fooid = $1;
$$ LANGUAGE SQL;
在FROM子句中調(diào)用了返回復(fù)合類型集合的函數(shù),其結(jié)果等同于:SELECT * FROM (SELECT * FROM foo WHERE fooid = 1) t1;
SELECT * FROM getfoo(1) AS t1;
七、多態(tài)的SQL函數(shù):
SQL函數(shù)可以聲明為接受多態(tài)類型(anyelement和anyarray)的參數(shù)或返回多態(tài)類型的返回值,見如下示例:
1). 函數(shù)參數(shù)和返回值均為多態(tài)類型。
復(fù)制代碼 代碼如下:
CREATE FUNCTION make_array(anyelement, anyelement) RETURNS anyarray AS $$
SELECT ARRAY[$1, $2];
$$ LANGUAGE SQL;
其調(diào)用方式和調(diào)用其它類型的SQL函數(shù)完全相同,只是在傳遞字符串類型的參數(shù)時(shí),需要顯式轉(zhuǎn)換到目標(biāo)類型,否則將會(huì)被視為unknown類型,如:
復(fù)制代碼 代碼如下:
SELECT make_array(1, 2) AS intarray, make_array('a'::text, 'b') AS textarray;
2). 函數(shù)的參數(shù)為多態(tài)類型,而返回值則為基本類型。
復(fù)制代碼 代碼如下:
CREATE FUNCTION is_greater(anyelement, anyelement) RETURNS boolean AS $$
SELECT $1 > $2;
$$ LANGUAGE SQL;
3). 多態(tài)類型用于函數(shù)的輸出參數(shù)。
復(fù)制代碼 代碼如下:
CREATE FUNCTION dup (f1 anyelement, OUT f2 anyelement, OUT f3 anyarray) AS $$
SELECT $1, ARRAY[$1,$1]
$$ LANGUAGE sql;
八、函數(shù)重載:
多個(gè)函數(shù)可以定義成相同的函數(shù)名,但是它們的參數(shù)一定要有所區(qū)分。換句話說,函數(shù)名可以重載,此規(guī)則有些類似于面向?qū)ο笳Z言中的函數(shù)重載,見如下示例:
復(fù)制代碼 代碼如下:
CREATE FUNCTION test(int, real) RETURNS ...
CREATE FUNCTION test(smallint, double) RETURNS ...
由于在PostgreSQL中函數(shù)支持重載,因此在刪除函數(shù)時(shí),也必須指定參數(shù)列表,如:
復(fù)制代碼 代碼如下:
DROP FUNCTION test(int, real);
DROP FUNCTION test(smallint,double);
您可能感興趣的文章:- PostgreSQL中的XML操作函數(shù)代碼
- PostgreSQL 正則表達(dá)式 常用函數(shù)的總結(jié)
- 深入解讀PostgreSQL中的序列及其相關(guān)函數(shù)的用法
- PostgreSQL教程(七):函數(shù)和操作符詳解(3)
- PostgreSQL教程(五):函數(shù)和操作符詳解(1)
- PostgreSQL教程(六):函數(shù)和操作符詳解(2)
- PostgreSQL Node.js實(shí)現(xiàn)函數(shù)計(jì)算方法示例
- PostgreSQL數(shù)據(jù)庫中窗口函數(shù)的語法與使用