pl/pgsql【pl/pgsql】pl/pgsql也是一种程式语言，叫做过程化SQL语言（Procedural Language/ Postgres SQL） 。pl/pgsql是Postgresql资料库对SQL语句的扩展 。在普通SQL语句的使用上增加了程式语言的特点，所以pl/pgsql就是把数据操作和查询语句组织在pl/pgsql代码的过程性单元中，通过逻辑判断、循环等操作实现複杂的功能或者计算的程式语言 。
基本介绍中文名：过程化SQL语言
外文名：Procedural Language/PostgreSQL
简称：pl/pgsql
类别：程式语言
一、概述：PL/pgSQL函式在第一次被调用时，其函式内的原始码(文本)将被解析为二进制指令树，但是函式内的表达式和SQL命令只有在首次用到它们的时 候，PL/pgSQL解释器才会为其创建一个準备好的执行规划，随后对该表达式或SQL命令的访问都将使用该规划 。如果在一个条件语句中，有部分SQL命 令或表达式没有被用到，那幺PL/pgSQL解释器在本次调用中将不会为其準备执行规划，这样的好处是可以有效地减少为PL/pgSQL函数里的语句生成 分析和执行规划的总时间，然而缺点是某些表达式或SQL命令中的错误只有在其被执行到的时候才能发现 。由于PL/pgSQL在函数里为一个命令制定了执行计画，那幺在本次会话中该计画将会被反覆使用，这样做往往可以得到更好的性能，但是如果你动态修改了相关的资料库对象，那幺就有可能产生问题，如：CREATE FUNCTIONpopulate()RETURNS integer AS $$DECLARE-- 声明段BEGINPERFORMmy_function();END;$$ LANGUAGE plpgsql;在调用以上函式时，PERFORM语句的执行计画将引用my_function对象的OID 。在此之后，如果你重建了my_function函式，那幺 populate函式将无法再找到原有my_function函式的OID 。要解决该问题，可以选择重建populate函式，或者重新登录建立新的会 话，以使PostgreSQL重新编译该函式 。要想规避此类问题的发生，在重建my_function时可以使用CREATE OR REPLACE FUNCTION命令 。鑒于以上规则，在PL/pgSQL里直接出现的SQL命令必须在每次执行时均引用相同的表和栏位，换句话说，不能将函式的参数用作SQL命令的表名或栏位 名 。如果想绕开该限制，可以考虑使用PL/pgSQL中的EXECUTE语句动态地构造命令，由此换来的代价是每次执行时都要构造一个新的命令计画 。使用PL/pgSQL函式的一个非常重要的优势是可以提高程式的执行效率，由于原有的SQL调用不得不在客户端与伺服器之间反覆传递数据，这样不仅增加了进程间通讯所产生的开销，而且也会大大增加网路IO的开销 。二、PL/pgSQL的结构：PL/pgSQL是一种块结构语言，函式定义的所有文本都必须在一个块内，其中块中的每个声明和每条语句都是以分号结束，如果某一子块在另外一个块内，那幺该子块的END关键字后面必须以分号结束，不过对于函式体的最后一个END关键字，分号可以省略，如：[ <> ][DECLAREdeclarations ]BEGINstatementsEND[ label ];在PL/pgSQL中有两种注释类型，双破折号(--)表示单行注释 。/* */表示多行注释，该注释类型的规则等同于C语言中的多行注释 。在语句块前面的声明段中定义的变数在每次进入语句块(BEGIN)时都会将声明的变数初始化为它们的预设值，而不是每次函式调用时初始化一次 。如：CREATE FUNCTION somefunc() RETURNS integer AS $$DECLAREquantity integer := 30;BEGINRAISE NOTICE 'Quantity here is %', quantity; --在这里的数量是30quantity := 50;---- 创建一个子块--DECLAREquantity integer := 80;BEGINRAISE NOTICE 'Quantity here is %', quantity;--在这里的数量是80END;RAISE NOTICE 'Quantity here is %', quantity;--在这里的数量是50RETURN quantity;END;$$ LANGUAGE plpgsql;#执行该函式以进一步观察其执行的结果 。postgres=# select somefunc();NOTICE: Quantity here is 30NOTICE: Quantity here is 80NOTICE: Quantity here is 50somefunc----------50(1 row)最后需要说明的是，目前版本的PostgreSQL并不支持嵌套事务，函式中的事物总是由外层命令(函式的调用者)来控制的，它们本身无法开始或提交事务 。三、声明：所有在块里使用的变数都必须在块的声明段里先进行声明，唯一的例外是FOR循环里的循环计数变数，该变数被自动声明为整型 。变数声明的语法如下：variable_name [CONSTANT] variable_type [NOT NULL] [ {DEFAULT|:=} expression ];1). SQL中的数据类型均可作为PL/pgSQL变数的数据类型，如integer、varchar和char等 。2). 如果给出了DEFAULT子句，该变数在进入BEGIN块时将被初始化为该预设值，否则被初始化为SQL空值 。预设值是在每次进入该块时进行计算的 。因 此，如果把now()赋予一个类型为timestamp的变数，那幺该变数的预设值将为函式实际调用时的时间，而不是函式预编译时的时间 。3). CONSTANT选项是为了避免该变数在进入BEGIN块后被重新赋值，以保证该变数为常量 。4). 如果声明了NOT NULL，那幺赋予NULL数值给该变数将导致一个运行时错误 。因此所有声明为NOT NULL的变数也必须在声明时定义一个非空的预设值 。1. 函式参数的别名：传递给函式的参数都是用$1、$2这样的标识符来表示的 。为了增加可读性，我们可以为其声明别名 。之后别名和数字标识符均可指向该参数值，见如下示例：1). 在函式声明的同时给出参数变数名 。CREATE FUNCTION sales_tax(subtotalreal) RETURNS real AS $$BEGINRETURN subtotal * 0.06;END;$$ LANGUAGE plpgsql;2). 在声明段中为参数变数定义别名 。CREATE FUNCTION sales_tax(REAL) RETURNS real AS $$DECLAREsubtotalALIAS FOR$1;BEGINRETURN subtotal * 0.06;END;$$ LANGUAGE plpgsql;3). 对于输出参数而言，我们仍然可以遵守1)和2)中的规则 。CREATE FUNCTION sales_tax(subtotal real,OUTtax real) AS $$BEGINtax := subtotal * 0.06;END;$$ LANGUAGE plpgsql; 4). 如果PL/pgSQL函式的返回类型为多态类型(anyelement或anyarray)，那幺函式就会创建一个特殊的参数：$0 。我们仍然可以为该变数设定别名 。CREATE FUNCTION add_three_values(v1 anyelement, v2 anyelement, v3 anyelement)RETURNSanyelementAS $$DECLAREresultALIAS FOR $0;BEGINresult := v1 + v2 + v3;RETURN result;END;$$ LANGUAGE plpgsql;2. 拷贝类型：见如下形式的变数声明：variable%TYPE%TYPE表示一个变数或表栏位的数据类型，PL/pgSQL允许通过该方式声明一个变数，其类型等同于variable或表栏位的数据类型，见如下示例：user_id users.user_id%TYPE;在上面的例子中，变数user_id的数据类型等同于users表中user_id栏位的类型 。通过使用%TYPE，一旦引用的变数类型今后发生改变，我们也无需修改该变数的类型声明 。最后需要说明的是，我们可以在函式的参数和返回值中使用该方式的类型声明 。3. 行类型：见如下形式的变数声明：name table_name%ROWTYPE;name composite_type_name;table_name%ROWTYPE表示指定表的行类型，我们在创建一个表的时候，PostgreSQL也会随之创建出一个与之相应的複合类型，该类 型名等同于表名，因此，我们可以通过以上两种方式来声明行类型的变数 。由此方式声明的变数，可以保存SELECT返回结果中的一行 。如果要访问变数中的某 个域栏位，可以使用点表示法，如rowvar.field，但是行类型的变数只能访问自定义栏位，无法访问系统提供的隐含栏位，如OID等 。对于函式的参 数，我们只能使用複合类型标识变数的数据类型 。最后需要说明的是，推荐使用%ROWTYPE的声明方式，这样可以具有更好的可移植性，因为在Oracle 的PL/SQL中也存在相同的概念，其声明方式也为%ROWTYPE 。见如下示例：CREATE FUNCTION merge_fields(t_row table1) RETURNS text AS $$DECLAREt2_row table2%ROWTYPE;BEGINSELECT * INTO t2_row FROM table2 WHERE id = 1 limit 1;RETURN t_row.f1 || t2_row.f3 || t_row.f5 || t2_row.f7;END;$$ LANGUAGE plpgsql;4. 记录类型：见如下形式的变数声明：nameRECORD;记录变数类似于行类型变数，但是它们没有预定义的结构，只能通过SELECT或FOR命令来获取实际的行结构，因此记录变数在被初始化之前无法访问，否则将引发运行时错误 。注：RECORD不是真正的数据类型，只是一个占位符 。四、基本语句：1. 赋值：PL/pgSQL中赋值语句的形式为：identIFier := expression，等号两端的变数和表达式的类型或者一致，或者可以通过PostgreSQL的转换规则进行转换，否则将会导致运行时错误，见如下示例：user_id := 20;tax := subtotal * 0.06;2. SELECT INTO：通过该语句可以为记录变数或行类型变数进行赋值，其表现形式为：SELECT INTO target select_expressions FROM ...，该赋值方式一次只能赋值一个变数 。表达式中的target可以表示为是一个记录变数、行变数，或者是一组用逗号分隔的简单变数和记录/行栏位的列表 。select_expressions以及剩余部分和普通SQL一样 。如果将一行或者一个变数列表用做目标，那幺选出的数值必需精确匹配目标的结构，否则就会产生运行时错误 。如果目标是一个记录变数，那幺它自动将自己构造 成命令结果列的行类型 。如果命令返回零行，目标被赋予空值 。如果命令返回多行，那幺将只有第一行被赋予目标，其它行将被忽略 。在执行SELECT INTO语句之后，可以通过检查内置变数FOUND来判断本次赋值是否成功，如：SELECT INTO myrec * FROM emp WHERE empname = myname;IF NOT FOUND THENRAISE EXCEPTION 'employee % not found', myname;END IF;要测试一个记录/行结果是否为空，可以使用IS NULL条件进行判断，但是对于返回多条记录的情况则无法判断，如：DECLAREusers_rec RECORD;BEGINSELECT INTO users_rec * FROM users WHERE user_id = 3;IF users_rec.homepage IS NULL THENRETURN 'http://';END IF;END;3. 执行一个没有结果的表达式或者命令：在调用一个表达式或执行一个命令时，如果对其返回的结果不感兴趣，可以考虑使用PERFORM语句：PERFORM. query，该语句将执行PERFORM之后的命令并忽略其返回的结果 。其中query的写法和普通的SQL SELECT命令是一样的，只是把开头的关键字SELECT替换成PERFORM，如：PERFORM. create_mv('cs_session_page_requests_mv', my_query);4. 执行动态命令：如果在PL/pgSQL函式中操作的表或数据类型在每次调用该函式时都可能会发生变化，在这样的情况下，可以考虑使用PL/pgSQL提供的EXECUTE语句：EXECUTE command-string [ INTO target ]，其中command-string是用一段文本表示的表达式，它包含要执行的命令 。而target是一个记录变数、行变数或者一组用逗号分隔的简单变数和 记录/行域的列表 。这里需要特别注意的是，该命令字元串将不会发生任何PL/pgSQL变数代换，变数的数值必需在构造命令字元串时插入到该字元串中 。和所有其它PL/pgSQL命令不同的是，一个由EXECUTE语句运行的命令在伺服器内并不会只prepare和保存一次 。相反，该语句在每次运行的 时候，命令都会prepare一次 。因此命令字元串可以在函数里动态的生成以便于对各种不同的表和栏位进行操作，从而提高函式的灵活性 。然而由此换来的却 是性能上的折损 。见如下示例：EXECUTE 'UPDATE tbl SET ' || quote_ident(columnname) || ' = ' || quote_literal(newvalue); 五、控制结构：1. 函式返回：1). RETURN expression该表达式用于终止当前的函式，然后再将expression的值返回给调用者 。如果返回简单类型，那幺可以使用任何表达式，同时表达式的类型也将被自动 转换成函式的返回类型，就像我们在赋值中描述的那样 。如果要返回一个複合类型的数值，则必须让表达式返回记录或者匹配的行变数 。2). RETURN NEXT expression如果PL/pgSQL函式声明为返回SETOF sometype，其行记录是通过RETURN NEXT命令进行填充的，直到执行到不带参数的RETURN时才表示该函式结束 。因此对于RETURN NEXT而言，它实际上并不从函式中返回，只是简单地把表达式的值保存起来，然后继续执行PL/pgSQL函数里的下一条语句 。随着RETURN NEXT命令的叠代执行，结果集最终被建立起来 。该类函式的调用方式如下：SELECT * FROM some_func();它被放在FROM子句中作为数据源使用 。最后需要指出的是，如果结果集数量很大，那幺通过该种方式来构建结果集将会导致极大的性能损失 。2. 条件：在PL/pgSQL中有以下三种形式的条件语句 。1). IF-THENIFboolean-expressionTHENstatementsEND IF;2). IF-THEN-ELSEIFboolean-expressionTHENstatementsELSEstatementsEND IF;3). IF-THEN-ELSIF-ELSEIFboolean-expressionTHENstatementsELSIFboolean-expressionTHENstatementsELSIFboolean-expressionTHENstatementsELSEstatementsEND IF; 关于条件语句，这里就不在做过多的赘述了 。3. 循环：1). LOOPLOOPstatementsEND LOOP[ label ];LOOP定义一个无条件的循环，直到由EXIT或者RETURN语句终止 。可选的label可以由EXIT和CONTINUE语句使用，用于在嵌套循环中声明应该套用于哪一层循环 。2). EXITEXIT[ label ] [WHENexpression ];如果没有给出label，就退出最内层的循环，然后执行跟在END LOOP后面的语句 。如果给出label，它必须是当前或更高层的嵌套循环块或语句块的标籤 。之后该命名块或循环就会终止，而控制则直接转到对应循环/块的END语句后面的语句上 。如果声明了WHEN，EXIT命令只有在expression为真时才被执行，否则将直接执行EXIT后面的语句 。见如下示例：LOOP-- do somethingEXIT WHEN count > 0;END LOOP;3). CONTINUECONTINUE[ label ] [WHENexpression ];如果没有给出label，CONTINUE就会跳到最内层循环的开始处，重新进行判断，以决定是否继续执行循环内的语句 。如果指定label，则跳到该 label所在的循环开始处 。如果声明了WHEN，CONTINUE命令只有在expression为真时才被执行，否则将直接执行CONTINUE后面 的语句 。见如下示例：LOOP-- do somethingEXIT WHEN count > 100;CONTINUE WHEN count < 50;END LOOP;4). WHILE[ <> ]WHILEexpressionLOOPstatementsEND LOOP[ label ];只要条件表达式为真，其块内的语句就会被循环执行 。条件是在每次进入循环体时进行判断的 。见如下示例：WHILE amount_owed > 0 AND gift_certificate_balance > 0 LOOP--do somethingEND LOOP;5). FOR[ <> ]FORnameIN[REVERSE] expression .. expressionLOOPstatementsEND LOOP[ label ];变数name自动被定义为integer类型，其作用域仅为FOR循环的块内 。表示範围上下界的两个表达式只在进入循环时计算一次 。每次叠代name值自增1，但如果声明了REVERSE，name变数在每次叠代中将自减1，见如下示例：FOR i IN 1..10 LOOP--do somethingRAISE NOTICE 'i IS %', i;END LOOP;FOR i IN REVERSE 10..1 LOOP--do somethingEND LOOP; 4. 遍曆命令结果：[ <> ]FORrecord_or_rowINqueryLOOPstatementsEND LOOP[ label ];这是另外一种形式的FOR循环，在该循环中可以遍曆命令的结果并操作相应的数据，见如下示例：FOR rec IN SELECT * FROM some_table LOOPPERFORM. some_func(rec.one_col);END LOOP;PL/pgSQL还提供了另外一种遍曆命令结果的方式，和上面的方式相比，唯一的差别是该方式将SELECT语句存于字元串文本中，然后再交由EXECUTE命令动态的执行 。和前一种方式相比，该方式的灵活性更高，但是效率较低 。[ <> ]FORrecord_or_rowIN EXECUTEtext_expression LOOPstatementsEND LOOP[ label ];5. 异常捕获：在PL/pgSQL函式中，如果没有异常捕获，函式会在发生错误时直接退出，与其相关的事物也会随之回滚 。我们可以通过使用带有EXCEPTION子句的BEGIN块来捕获异常并使其从中恢复 。见如下声明形式：[ <> ][ DECLAREdeclarations ]BEGINstatementsEXCEPTIONWHENcondition [ OR condition ... ]THENhandler_statementsWHENcondition [ OR condition ... ]THENhandler_statementsEND;如果没有错误发生，只有BEGIN块中的statements会被正常执行，然而一旦这些语句中有任意一条发生错误，其后的语句都将被跳过，直接跳转到 EXCEPTION块的开始处 。此时系统将搜寻异常条件列表，寻找匹配该异常的第一个条件，如果找到匹配，则执行相应的 handler_statements，之后再执行END的下一条语句 。如果没有找到匹配，该错误就会被继续向外抛出，其结果与没有EXCEPTION子 句完全等同 。如果此时handler_statements中的语句发生新错误，它将不能被该EXCEPTION子句捕获，而是继续向外传播，交由其外层 的EXCEPTION子句捕获并处理 。见如下示例：INSERT INTO mytab(firstname, lastname) VALUES('Tom', 'Jones');BEGINUPDATE mytab SET firstname = 'Joe' WHERE lastname = 'Jones';x := x + 1;y := x / 0;EXCEPTIONWHEN division_by_zero THENRAISE NOTICE 'caught division_by_zero';RETURN x;END;当以上函式执行到y := x / 0语句时，将会引发一个异常错误，代码将跳转到EXCEPTION块的开始处，之后系统会寻找匹配的异常捕捉条件，此时division_by_zero 完全匹配，这样该条件内的代码将会被继续执行 。需要说明的是，RETURN语句中返回的x值为x := x + 1执行后的新值，但是在除零之前的update语句将会被回滚，BEGIN之前的insert语句将仍然生效 。六、游标：1. 声明游标变数：在PL/pgSQL中对游标的访问都是通过游标变数实现的，其数据类型为refcursor 。创建游标变数的方法有以下两种：1). 和声明其他类型的变数一样，直接声明一个游标类型的变数即可 。2). 使用游标专有的声明语法，如：nameCURSOR[ ( arguments ) ]FORquery;其中arguments为一组逗号分隔的name datatype列表，见如下示例：curs1 refcursor;curs2 CURSOR FOR SELECT * FROM tenk1;curs3 CURSOR (key integer) IS SELECT * FROM tenk1 WHERE unique1 = key;在上面三个例子中，只有第一个是未绑定游标，剩下两个游标均已被绑定 。2. 打开游标：游标在使用之前必须先被打开，在PL/pgSQL中有三种形式的OPEN语句，其中两种用于未绑定的游标变数，另外一种用于绑定的游标变数 。1). OPEN FOR:其声明形式为：OPENunbound_cursorFORquery;该形式只能用于未绑定的游标变数，其查询语句必须是SELECT，或其他返回记录行的语句，如EXPLAIN 。在PostgreSQL中，该查询和普通的SQL命令平等对待，即先替换变数名，同时也将该查询的执行计画快取起来，以供后用 。见如下示例：OPEN curs1 FOR SELECT * FROM foo WHERE key = mykey;2). OPEN FOR EXECUTE其声明形式为：OPENunbound_cursorFOREXECUTEquery-string; 和上面的形式一样，该形式也仅适用于未绑定的游标变数 。EXECUTE将动态执行其后以文本形式表示的查询字元串 。OPEN curs1 FOR EXECUTE 'SELECT * FROM ' || quote_ident($1);3). 打开一个绑定的游标其声明形式为：OPENbound_cursor [ ( argument_values ) ]; 该形式仅适用于绑定的游标变数，只有当该变数在声明时包含接收参数，才能以传递参数的形式打开该游标，这些参数将被实际代入到游标声明的查询语句中，见如下示例：OPEN curs2;OPEN curs3(42);3. 使用游标：游标一旦打开，就可以按照以下方式进行读取 。然而需要说明的是，游标的打开和读取必须在同一个事物内，因为在PostgreSQL中，如果事物结束，事物内打开的游标将会被隐含的关闭 。1). FETCH其声明形式为：FETCHcursorINTOtarget;FETCH命令从游标中读取下一行记录的数据到目标中，其中目标可以是行变数、记录变数，或者是一组逗号分隔的普通变数的列表，读取成功与否，可通过PL/pgSQL内置变数FOUND来判断，其规则等同于SELECT INTO 。见如下示例：FETCH curs1 INTO rowvar;--rowvar为行变数FETCH curs2 INTO foo, bar, baz;2). CLOSE其声明形式为：CLOSEcursor;关闭当前已经打开的游标，以释放其占有的系统资源，见如下示例：CLOSE curs1; 七、错误和讯息：在PostgreSQL中可以利用RAISE语句报告信息和抛出错误，其声明形式为：RAISElevel 'format' [, expression [, ...]];这里包含的级别有DEBUG(向伺服器日誌写信息)、LOG(向伺服器日誌写信息，优先权更高)、INFO、NOTICE和WARNING(把信息写到伺服器日誌以及转发到客户端套用，优先权逐步升高)和EXCEPTION抛出一个错误(通常退出当前事务) 。某个优先权别的信息是报告给客户端还是写到伺服器日誌，还是两个均有，是由log_min_messages和client_min_messages这两个系统初始化参数控制的 。在format部分中，%表示为占位符，其实际值仅在RAISE命令执行时由后面的变数替换，如果要在format中表示%自身，可以使用%%的形式表示，见如下示例：RAISE NOTICE 'Calling cs_create_job(%)',v_job_id;--v_job_id变数的值将替换format中的% 。RAISE EXCEPTION 'Inexistent ID --> %',user_id;