PL/pgSQL学习笔记之十一

http://www.postgresql.org/docs/9.1/static/plpgsql-declarations.html

39.3.4. Row 类型

name table_name%ROWTYPE;
name composite_type_name;

一个复合类型被称为row变量(或row-类型变量)。这样的变量可以保持一整行当select或for 查询的结果，该查询的列集合正好匹配声明的变量的数据类型。此行值得单个域值可以通过通常的点引用来访问，例如：rowvar.field。

通过使用table_name%ROWTYPE 标记法，一个row变量可以被声明为与现存的表或视图的行拥有同样的类型；或通过给出一个符合结构的类型名称。(因为每个表都有一个关联的同名的复合类型，实际上是否写%ROWTYPE都没有关系，但是带有%ROWTYPE的形式更加具备可移植性。)

函数的参数可以是复合类型(完整的表行)。在此时，相应的$n就是一个row变量，而域则可以被从中进行选出，例如: $1.user_id。

Only the user-defined columns of a table row are accessible in a row-type variable, not the OID or other system columns (because the row could be from a view). The fields of the row type inherit the table's field size or precision for data types such as char(n).

在一个row变量中，只有用户定义的表的列名可以被访问，OID或者其他的系统列不可访问(因为这些可能来自视图)。这些行当域继承了表的域的数据类型的大小和精度，如char(n)。

这里有一个使用复合数据类型的例子，table1和table2是现存的表，而且至少拥有如下提及的域：

CREATE FUNCTION merge_fields(t_row table1) RETURNS text AS $$
DECLARE
    t2_row table2%ROWTYPE;
BEGIN
    SELECT * INTO t2_row FROM table2 WHERE ... ;
    RETURN t_row.f1 || t2_row.f3 || t_row.f5 || t2_row.f7;
END;
$$ LANGUAGE plpgsql;

SELECT merge_fields(t.*) FROM table1 t WHERE ... ;