PostgreSQL學習手冊(SQL語言函數)

1、基本概念：

    SQL函數能夠包含任意數量的查詢，可是函數只返回最後一個查詢(必須是SELECT)的結果。在簡單狀況下，返回最後一條查詢結果的第一行。若是最後 一個查詢不返回任何行，那麼該函數將返回NULL值。若是須要該函數返回最後一條SELECT語句的全部行，能夠將函數的返回值定義爲集合，即SETOF sometype。
    SQL函數的函數體應該是用分號分隔的SQL語句列表，其中最後一條語句以後的分號是可選的。除非函數聲明爲返回void，不然最後一條語句必須是 SELECT。事實上，在SQL函數中，不只能夠包含SELECT查詢語句，也能夠包含INSERT、UPDATE和DELETE等其餘標準的SQL語 句，可是和事物相關的語句不能包含其中，如BEGIN、COMMIT、ROLLBACK和SAVEPOINT等。
    CREATE FUNCTION命令的語法要求函數體寫成一個字符串文本。一般來講，該文本字符串常量使用美圓符($$)圍住，如：
    CREATE FUNCTION clean_emp() RETURNS void AS $$
        DELETE FROM emp WHERE salary < 0;
    $$ LANGUAGE SQL;
    最後須要說明的是SQL函數中的參數，PostgreSQL定義$1表示第一個參數，$2爲第二個參數並以此類推。若是參數是複合類型，則可使用點表 示法，即$1.name訪問複合類型參數中的name字段。須要注意的是函數參數只能用做數據值，而不能用於標識符，如：
    INSERT INTO mytable VALUES ($1);   --合法
    INSERT INTO $1 VALUES (42);          --不合法(表名屬於標示符之一)
   
2、基本類型：
    
    最簡單的SQL函數可能就是沒有參數且返回基本類型的函數了，如：
    CREATE FUNCTION one() RETURNS integer AS $$
        SELECT 1 AS result;
    $$ LANGUAGE SQL;
    下面的例子聲明瞭基本類型做爲函數的參數。
    CREATE FUNCTION add_em(integer, integer) RETURNS integer AS $$
        SELECT $1 + $2;
    $$ LANGUAGE SQL;
     # 經過select調用函數。
     postgres=# SELECT add_em(1,2) AS answer;
     answer
    --------
          3
    (1 row)       
    在下面的例子中，函數體內包含多個SQL語句，它們之間是用分號進行分隔的。
    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;
    
3、複合類型 ：

    見以下示例：
    1). 建立數據表，這樣與之對應的複合類型也隨之生成。
    CREATE TABLE emp (
        name        text,
        salary      numeric,
        age         integer,
    );
    2). 建立函數，其參數爲複合類型。在函數體內，能夠像引用基本類型參數那樣引用複合類型，如$1。訪問複合類型的字段使用點表達式便可，如：$1.salary。
    CREATE FUNCTION double_salary(emp) RETURNS integer AS $$
        SELECT ($1.salary * 2)::integer AS salary;
    $$ LANGUAGE SQL;
    3). 在select語句中，可使用emp.*表示emp表的一整行數據。
    SELECT name, double_salary(emp.*) AS dream FROM emp WHERE age > 30;
    4). 咱們也可使用ROW表達式構造自定義的複合類型，如：
    SELECT name, double_salary(ROW(name, salary*1.1, age)) AS dream FROM emp;
    5). 建立一個函數，其返回值爲複合類型，如：
    CREATE FUNCTION new_emp() RETURNS emp AS $$
        SELECT ROW('None', 1000.0, 25)::emp;
    $$ LANGUAGE SQL;
    6). 調用返回複合類型的函數。
    SELECT new_emp();
    7). 調用返回複合類型的函數，同時訪問該返回值的某個字段。
    SELECT (new_emp()).name;

4、帶輸出參數的函數：

    還有一種方法能夠用於返回函數執行的結果，即輸出參數，如：
    CREATE FUNCTION add_em2 (IN x int, IN y int, OUT sum int) AS $$
        SELECT $1 + $2
    $$ LANGUAGE SQL;
    調用方法和返回結果與add_em(帶有返回值的函數)徹底一致，如：
     SELECT add_em(3,7);
    
    這個帶有輸出參數的函數和以前的add_em函數沒有本質的區別。事實上，輸出參數的真正價值在於它爲函數提供了返回多個字段的途徑。如，
    CREATE FUNCTION sum_n_product (x int, y int, OUT sum int, OUT product int) AS $$
        SELECT $1 + $2, $1 * $2
    $$ LANGUAGE SQL;
    調用方式沒有改變，只是返回結果多出一列。
    SELECT * FROM sum_n_product(11,42);
     sum | product
    -----+---------
      53 |     462
    (1 row)
    在上面的示例中，IN用於表示該函數參數爲輸入參數(缺省值，能夠忽略)，OUT則表示該參數爲輸出參數。

5、返回結果做爲表數據源：

    全部SQL函數均可以在查詢的FROM子句裏使用。該方法對於返回複合類型的函數而言特別有用，若是該函數定義爲返回一個基本類型，那麼該函數生成一個單字段表，若是該函數定義爲返回一個複合類型，那麼該函數生成一個複合類型裏每一個屬性組成的行。見以下示例：
    1). 建立一個數據表。
    CREATE TABLE foo (
        fooid    int,
        foosubid int,
        fooname  text
    );
    2). 建立SQL函數，其返回值爲與foo表對應的複合類型。
    CREATE FUNCTION getfoo(int) RETURNS foo AS $$
        SELECT * FROM foo WHERE fooid = $1;
    $$ LANGUAGE SQL;
    3). 在FROM子句中調用該函數。
     SELECT *, upper(fooname) FROM getfoo(1) AS t1;
    
6、返回集合的SQL函數：

    若是SQL函數的返回值爲SETOF sometype，那麼在調用該函數時，將返回最後一個SELECT查詢的所有數據。這個特性一般用於把函數放在FROM子句裏調用，見以下示例：
    CREATE FUNCTION getfoo(int) RETURNS setof foo AS $$
        SELECT * FROM foo WHERE fooid = $1;
    $$ LANGUAGE SQL;    
    在FROM子句中調用了返回複合類型集合的函數，其結果等同於： SELECT * FROM (SELECT * FROM foo WHERE fooid = 1) t1;
     SELECT * FROM getfoo(1) AS t1;    
    
7、多態的SQL函數：

    SQL函數能夠聲明爲接受多態類型( anyelement 和 anyarray)的參數或返回多態類型的返回值，見以下示例：
    1). 函數參數和返回值均爲多態類型。
    CREATE FUNCTION make_array(anyelement, anyelement) RETURNS anyarray AS $$
        SELECT ARRAY[$1, $2];
    $$ LANGUAGE SQL;
    其調用方式和調用其它類型的SQL函數徹底相同，只是在傳遞字符串類型的參數時，須要顯式轉換到目標類型，不然將會被視爲unknown類型，如：
     SELECT make_array(1, 2) AS intarray, make_array('a'::text, 'b') AS textarray;
    2). 函數的參數爲多態類型，而返回值則爲基本類型。
    CREATE FUNCTION is_greater(anyelement, anyelement) RETURNS boolean AS $$
        SELECT $1 > $2;
    $$ LANGUAGE SQL;
    3). 多態類型用於函數的輸出參數。
     CREATE FUNCTION dup (f1 anyelement, OUT f2 anyelement, OUT f3 anyarray) AS $$
        SELECT $1, ARRAY[$1,$1]
    $$ LANGUAGE sql;

8、函數重載：

    多個函數能夠定義成相同的函數名，可是它們的參數必定要有所區分。換句話說，函數名能夠重載，此規則有些相似於面嚮對象語言中的函數重載，見以下示例：
    CREATE FUNCTION test(int, real) RETURNS ...
    CREATE FUNCTION test(smallint, double) RETURNS ...

    因爲在PostgreSQL中函數支持重載，所以在刪除函數時，也必須指定參數列表，如：
    DROP FUNCTION test(int, real);
    DROP FUNCTION test(smallint,double);