PostgreSQL PL/pgSQL開(kāi)發(fā)提示

一個(gè)PL/pgSQL函數(shù)的代碼在一個(gè)CREATE FUNCTION中被指定為一個(gè)字符串。如果你用通常的方式把該字符串寫(xiě)在單引號(hào)中間，那么該函數(shù)體中的任何單引號(hào)都必須被雙寫(xiě)；同樣任何反斜線也必須被雙寫(xiě)（假定使用了轉(zhuǎn)義字符串語(yǔ)法）。雙寫(xiě)引號(hào)最多有點(diǎn)冗長(zhǎng)，并且在更復(fù)雜的情況中代碼會(huì)變得完全無(wú)法理解，因?yàn)槟愫苋菀装l(fā)現(xiàn)你需要半打或者更多相鄰的引號(hào)。我們推薦你轉(zhuǎn)而把函數(shù)體寫(xiě)成一個(gè) “美元引用”的字符串（見(jiàn)第 4.1.2.4 節(jié)）。在美元引用方法中，你從不需要雙寫(xiě)任何引號(hào)。但是要注意為你需要的每一層嵌套選擇一個(gè)不同的美元引用定界符。例如，你可能把CREATE FUNCTION命令寫(xiě)成：

CREATE OR REPLACE FUNCTION testfunc(integer) RETURNS integer AS $PROC$ .... $PROC$ LANGUAGE plpgsql;

在這里面，你可以在 SQL 命令中為簡(jiǎn)單字符串使用引號(hào)并且用$$來(lái)界定被你組裝成字符串的 SQL 命令片段。如果你需要引用包括$$的文本，你可以使用$Q$等等。

下列圖表展示了在寫(xiě)沒(méi)有美元引用的引號(hào)時(shí)需要做什么。在將之前用美元引用的代碼翻譯成更容易理解的代碼時(shí)，它們會(huì)有所幫助。

為了輔助用戶在一些簡(jiǎn)單但常見(jiàn)的問(wèn)題產(chǎn)生危害之前找到它們， PL/pgSQL提供了額外的檢查。當(dāng)被啟用時(shí)， 根據(jù)配置，它們可以在一個(gè)函數(shù)的編譯期間被用來(lái)發(fā)出 WARNING或者ERROR。一個(gè)已經(jīng)收到了 WARNING的函數(shù)可以被繼續(xù)執(zhí)行而不會(huì)產(chǎn)生進(jìn)一步的消息， 因此建議你在一個(gè)單獨(dú)的開(kāi)發(fā)環(huán)境中進(jìn)行測(cè)試。

根據(jù)需要設(shè)置 plpgsql.extra_warnings 或 plpgsql.extra_errors，適當(dāng)情況下，在開(kāi)發(fā)和/或測(cè)試環(huán)境中可以設(shè)置為 "all"。

這些附加檢查通過(guò)配置變量啟用， plpgsql.extra_warnings用于警告，plpgsql.extra_errors 用于錯(cuò)誤。 兩者都可以設(shè)置為逗號(hào)分隔的檢查列表，"none" 或 "all"。 默認(rèn)值為"none"。當(dāng)前可用的檢查列表包括：

下面的示例顯示了plpgsql.extra_warnings 設(shè)置為shadowed_variables的效果：

SET plpgsql.extra_warnings TO 'shadowed_variables';

CREATE FUNCTION foo(f1 int) RETURNS int AS $$
DECLARE
f1 int;
BEGIN
RETURN f1;
END;
$$ LANGUAGE plpgsql;
WARNING:  variable "f1" shadows a previously defined variable
LINE 3: f1 int;
        ^
CREATE FUNCTION

下面的示例顯示了將plpgsql.extra_warnings 設(shè)置為strict_multi_assignment：

SET plpgsql.extra_warnings TO 'strict_multi_assignment';

CREATE OR REPLACE FUNCTION public.foo()
 RETURNS void
 LANGUAGE plpgsql
AS $$
DECLARE
  x int;
  y int;
BEGIN
  SELECT 1 INTO x, y;
  SELECT 1, 2 INTO x, y;
  SELECT 1, 2, 3 INTO x, y;
END;
$$;

SELECT foo();
WARNING:  number of source and target fields in assignment does not match
DETAIL:  strict_multi_assignment check of extra_warnings is active.
HINT:  Make sure the query returns the exact list of columns.
WARNING:  number of source and target fields in assignment does not match
DETAIL:  strict_multi_assignment check of extra_warnings is active.
HINT:  Make sure the query returns the exact list of columns.

 foo 
-----
 
(1 row)