SELECT name, setting FROM pg_settings WHERE name LIKE 'enable%'; name | setting ----------------------+--------- enable_bitmapscan | on enable_hashagg | on enable_hashjoin | on enable_indexonlyscan | on enable_indexscan | on enable_material | on enable_mergejoin | on enable_nestloop | on enable_seqscan | on enable_sort | on enable_tidscan | on (11 rows) CREATE TABLE foo2(fooid int, f2 int); INSERT INTO foo2 VALUES(1, 11); INSERT INTO foo2 VALUES(2, 22); INSERT INTO foo2 VALUES(1, 111); CREATE FUNCTION foot(int) returns setof foo2 as 'SELECT * FROM foo2 WHERE fooid = $1 ORDER BY f2;' LANGUAGE SQL; -- function with ORDINALITY select * from foot(1) with ordinality as z(a,b,ord); a | b | ord ---+-----+----- 1 | 11 | 1 1 | 111 | 2 (2 rows) select * from foot(1) with ordinality as z(a,b,ord) where b > 100; -- ordinal 2, not 1 a | b | ord ---+-----+----- 1 | 111 | 2 (1 row) -- ordinality vs. column names and types select a,b,ord from foot(1) with ordinality as z(a,b,ord); a | b | ord ---+-----+----- 1 | 11 | 1 1 | 111 | 2 (2 rows) select a,ord from unnest(array['a','b']) with ordinality as z(a,ord); a | ord ---+----- a | 1 b | 2 (2 rows) select * from unnest(array['a','b']) with ordinality as z(a,ord); a | ord ---+----- a | 1 b | 2 (2 rows) select a,ord from unnest(array[1.0::float8]) with ordinality as z(a,ord); a | ord ---+----- 1 | 1 (1 row) select * from unnest(array[1.0::float8]) with ordinality as z(a,ord); a | ord ---+----- 1 | 1 (1 row) -- ordinality vs. views create temporary view vw_ord as select * from (values (1)) v(n) join foot(1) with ordinality as z(a,b,ord) on (n=ord); select * from vw_ord; n | a | b | ord ---+---+----+----- 1 | 1 | 11 | 1 (1 row) select definition from pg_views where viewname='vw_ord'; definition ------------------------------------------------------------------- SELECT v.n, + z.a, + z.b, + z.ord + FROM (( VALUES (1)) v(n) + JOIN foot(1) WITH ORDINALITY z(a, b, ord) ON ((v.n = z.ord))); (1 row) drop view vw_ord; -- ordinality vs. rewind and reverse scan begin; declare foo scroll cursor for select * from generate_series(1,5) with ordinality as g(i,o); fetch all from foo; i | o ---+--- 1 | 1 2 | 2 3 | 3 4 | 4 5 | 5 (5 rows) fetch backward all from foo; i | o ---+--- 5 | 5 4 | 4 3 | 3 2 | 2 1 | 1 (5 rows) fetch all from foo; i | o ---+--- 1 | 1 2 | 2 3 | 3 4 | 4 5 | 5 (5 rows) fetch next from foo; i | o ---+--- (0 rows) fetch next from foo; i | o ---+--- (0 rows) fetch prior from foo; i | o ---+--- 5 | 5 (1 row) fetch absolute 1 from foo; i | o ---+--- 1 | 1 (1 row) commit; -- function with implicit LATERAL select * from foo2, foot(foo2.fooid) z where foo2.f2 = z.f2; fooid | f2 | fooid | f2 -------+-----+-------+----- 1 | 11 | 1 | 11 2 | 22 | 2 | 22 1 | 111 | 1 | 111 (3 rows) -- function with implicit LATERAL and explicit ORDINALITY select * from foo2, foot(foo2.fooid) with ordinality as z(fooid,f2,ord) where foo2.f2 = z.f2; fooid | f2 | fooid | f2 | ord -------+-----+-------+-----+----- 1 | 11 | 1 | 11 | 1 2 | 22 | 2 | 22 | 1 1 | 111 | 1 | 111 | 2 (3 rows) -- function in subselect select * from foo2 where f2 in (select f2 from foot(foo2.fooid) z where z.fooid = foo2.fooid) ORDER BY 1,2; fooid | f2 -------+----- 1 | 11 1 | 111 2 | 22 (3 rows) -- function in subselect select * from foo2 where f2 in (select f2 from foot(1) z where z.fooid = foo2.fooid) ORDER BY 1,2; fooid | f2 -------+----- 1 | 11 1 | 111 (2 rows) -- function in subselect select * from foo2 where f2 in (select f2 from foot(foo2.fooid) z where z.fooid = 1) ORDER BY 1,2; fooid | f2 -------+----- 1 | 11 1 | 111 (2 rows) -- nested functions select foot.fooid, foot.f2 from foot(sin(pi()/2)::int) ORDER BY 1,2; fooid | f2 -------+----- 1 | 11 1 | 111 (2 rows) CREATE TABLE foo (fooid int, foosubid int, fooname text, primary key(fooid,foosubid)); INSERT INTO foo VALUES(1,1,'Joe'); INSERT INTO foo VALUES(1,2,'Ed'); INSERT INTO foo VALUES(2,1,'Mary'); -- sql, proretset = f, prorettype = b CREATE FUNCTION getfoo(int) RETURNS int AS 'SELECT $1;' LANGUAGE SQL; SELECT * FROM getfoo(1) AS t1; t1 ---- 1 (1 row) SELECT * FROM getfoo(1) WITH ORDINALITY AS t1(v,o); v | o ---+--- 1 | 1 (1 row) CREATE VIEW vw_getfoo AS SELECT * FROM getfoo(1); SELECT * FROM vw_getfoo; getfoo -------- 1 (1 row) DROP VIEW vw_getfoo; CREATE VIEW vw_getfoo AS SELECT * FROM getfoo(1) WITH ORDINALITY as t1(v,o); SELECT * FROM vw_getfoo; v | o ---+--- 1 | 1 (1 row) -- sql, proretset = t, prorettype = b DROP VIEW vw_getfoo; DROP FUNCTION getfoo(int); CREATE FUNCTION getfoo(int) RETURNS setof int AS 'SELECT fooid FROM foo WHERE fooid = $1;' LANGUAGE SQL; SELECT * FROM getfoo(1) AS t1; t1 ---- 1 1 (2 rows) SELECT * FROM getfoo(1) WITH ORDINALITY AS t1(v,o); v | o ---+--- 1 | 1 1 | 2 (2 rows) CREATE VIEW vw_getfoo AS SELECT * FROM getfoo(1); SELECT * FROM vw_getfoo; getfoo -------- 1 1 (2 rows) DROP VIEW vw_getfoo; CREATE VIEW vw_getfoo AS SELECT * FROM getfoo(1) WITH ORDINALITY AS t1(v,o); SELECT * FROM vw_getfoo; v | o ---+--- 1 | 1 1 | 2 (2 rows) -- sql, proretset = t, prorettype = b DROP VIEW vw_getfoo; DROP FUNCTION getfoo(int); CREATE FUNCTION getfoo(int) RETURNS setof text AS 'SELECT fooname FROM foo WHERE fooid = $1;' LANGUAGE SQL; SELECT * FROM getfoo(1) AS t1; t1 ----- Joe Ed (2 rows) SELECT * FROM getfoo(1) WITH ORDINALITY AS t1(v,o); v | o -----+--- Joe | 1 Ed | 2 (2 rows) CREATE VIEW vw_getfoo AS SELECT * FROM getfoo(1); SELECT * FROM vw_getfoo; getfoo -------- Joe Ed (2 rows) DROP VIEW vw_getfoo; CREATE VIEW vw_getfoo AS SELECT * FROM getfoo(1) WITH ORDINALITY AS t1(v,o); SELECT * FROM vw_getfoo; v | o -----+--- Joe | 1 Ed | 2 (2 rows) -- sql, proretset = f, prorettype = c DROP VIEW vw_getfoo; DROP FUNCTION getfoo(int); CREATE FUNCTION getfoo(int) RETURNS foo AS 'SELECT * FROM foo WHERE fooid = $1;' LANGUAGE SQL; SELECT * FROM getfoo(1) AS t1; fooid | foosubid | fooname -------+----------+--------- 1 | 1 | Joe (1 row) SELECT * FROM getfoo(1) WITH ORDINALITY AS t1(a,b,c,o); a | b | c | o ---+---+-----+--- 1 | 1 | Joe | 1 (1 row) CREATE VIEW vw_getfoo AS SELECT * FROM getfoo(1); SELECT * FROM vw_getfoo; fooid | foosubid | fooname -------+----------+--------- 1 | 1 | Joe (1 row) DROP VIEW vw_getfoo; CREATE VIEW vw_getfoo AS SELECT * FROM getfoo(1) WITH ORDINALITY AS t1(a,b,c,o); SELECT * FROM vw_getfoo; a | b | c | o ---+---+-----+--- 1 | 1 | Joe | 1 (1 row) -- sql, proretset = t, prorettype = c DROP VIEW vw_getfoo; DROP FUNCTION getfoo(int); CREATE FUNCTION getfoo(int) RETURNS setof foo AS 'SELECT * FROM foo WHERE fooid = $1;' LANGUAGE SQL; SELECT * FROM getfoo(1) AS t1; fooid | foosubid | fooname -------+----------+--------- 1 | 1 | Joe 1 | 2 | Ed (2 rows) SELECT * FROM getfoo(1) WITH ORDINALITY AS t1(a,b,c,o); a | b | c | o ---+---+-----+--- 1 | 1 | Joe | 1 1 | 2 | Ed | 2 (2 rows) CREATE VIEW vw_getfoo AS SELECT * FROM getfoo(1); SELECT * FROM vw_getfoo; fooid | foosubid | fooname -------+----------+--------- 1 | 1 | Joe 1 | 2 | Ed (2 rows) DROP VIEW vw_getfoo; CREATE VIEW vw_getfoo AS SELECT * FROM getfoo(1) WITH ORDINALITY AS t1(a,b,c,o); SELECT * FROM vw_getfoo; a | b | c | o ---+---+-----+--- 1 | 1 | Joe | 1 1 | 2 | Ed | 2 (2 rows) -- ordinality not supported for returns record yet -- sql, proretset = f, prorettype = record DROP VIEW vw_getfoo; DROP FUNCTION getfoo(int); CREATE FUNCTION getfoo(int) RETURNS RECORD AS 'SELECT * FROM foo WHERE fooid = $1;' LANGUAGE SQL; SELECT * FROM getfoo(1) AS t1(fooid int, foosubid int, fooname text); fooid | foosubid | fooname -------+----------+--------- 1 | 1 | Joe (1 row) CREATE VIEW vw_getfoo AS SELECT * FROM getfoo(1) AS (fooid int, foosubid int, fooname text); SELECT * FROM vw_getfoo; fooid | foosubid | fooname -------+----------+--------- 1 | 1 | Joe (1 row) -- sql, proretset = t, prorettype = record DROP VIEW vw_getfoo; DROP FUNCTION getfoo(int); CREATE FUNCTION getfoo(int) RETURNS setof record AS 'SELECT * FROM foo WHERE fooid = $1;' LANGUAGE SQL; SELECT * FROM getfoo(1) AS t1(fooid int, foosubid int, fooname text); fooid | foosubid | fooname -------+----------+--------- 1 | 1 | Joe 1 | 2 | Ed (2 rows) CREATE VIEW vw_getfoo AS SELECT * FROM getfoo(1) AS (fooid int, foosubid int, fooname text); SELECT * FROM vw_getfoo; fooid | foosubid | fooname -------+----------+--------- 1 | 1 | Joe 1 | 2 | Ed (2 rows) -- plpgsql, proretset = f, prorettype = b DROP VIEW vw_getfoo; DROP FUNCTION getfoo(int); CREATE FUNCTION getfoo(int) RETURNS int AS 'DECLARE fooint int; BEGIN SELECT fooid into fooint FROM foo WHERE fooid = $1; RETURN fooint; END;' LANGUAGE plpgsql; SELECT * FROM getfoo(1) AS t1; t1 ---- 1 (1 row) SELECT * FROM getfoo(1) WITH ORDINALITY AS t1(v,o); v | o ---+--- 1 | 1 (1 row) CREATE VIEW vw_getfoo AS SELECT * FROM getfoo(1); SELECT * FROM vw_getfoo; getfoo -------- 1 (1 row) DROP VIEW vw_getfoo; CREATE VIEW vw_getfoo AS SELECT * FROM getfoo(1) WITH ORDINALITY AS t1(v,o); SELECT * FROM vw_getfoo; v | o ---+--- 1 | 1 (1 row) -- plpgsql, proretset = f, prorettype = c DROP VIEW vw_getfoo; DROP FUNCTION getfoo(int); CREATE FUNCTION getfoo(int) RETURNS foo AS 'DECLARE footup foo%ROWTYPE; BEGIN SELECT * into footup FROM foo WHERE fooid = $1; RETURN footup; END;' LANGUAGE plpgsql; SELECT * FROM getfoo(1) AS t1; fooid | foosubid | fooname -------+----------+--------- 1 | 1 | Joe (1 row) SELECT * FROM getfoo(1) WITH ORDINALITY AS t1(a,b,c,o); a | b | c | o ---+---+-----+--- 1 | 1 | Joe | 1 (1 row) CREATE VIEW vw_getfoo AS SELECT * FROM getfoo(1); SELECT * FROM vw_getfoo; fooid | foosubid | fooname -------+----------+--------- 1 | 1 | Joe (1 row) DROP VIEW vw_getfoo; CREATE VIEW vw_getfoo AS SELECT * FROM getfoo(1) WITH ORDINALITY AS t1(a,b,c,o); SELECT * FROM vw_getfoo; a | b | c | o ---+---+-----+--- 1 | 1 | Joe | 1 (1 row) DROP VIEW vw_getfoo; DROP FUNCTION getfoo(int); DROP FUNCTION foot(int); DROP TABLE foo2; DROP TABLE foo; -- Rescan tests -- CREATE TEMPORARY SEQUENCE foo_rescan_seq; CREATE TYPE foo_rescan_t AS (i integer, s bigint); CREATE FUNCTION foo_sql(int,int) RETURNS setof foo_rescan_t AS 'SELECT i, nextval(''foo_rescan_seq'') FROM generate_series($1,$2) i;' LANGUAGE SQL; -- plpgsql functions use materialize mode CREATE FUNCTION foo_mat(int,int) RETURNS setof foo_rescan_t AS 'begin for i in $1..$2 loop return next (i, nextval(''foo_rescan_seq'')); end loop; end;' LANGUAGE plpgsql; --invokes ExecReScanFunctionScan - all these cases should materialize the function only once -- LEFT JOIN on a condition that the planner can't prove to be true is used to ensure the function -- is on the inner path of a nestloop join SELECT setval('foo_rescan_seq',1,false); setval -------- 1 (1 row) SELECT * FROM (VALUES (1),(2),(3)) v(r) LEFT JOIN foo_sql(11,13) ON (r+i)<100; r | i | s ---+----+--- 1 | 11 | 1 1 | 12 | 2 1 | 13 | 3 2 | 11 | 1 2 | 12 | 2 2 | 13 | 3 3 | 11 | 1 3 | 12 | 2 3 | 13 | 3 (9 rows) SELECT setval('foo_rescan_seq',1,false); setval -------- 1 (1 row) SELECT * FROM (VALUES (1),(2),(3)) v(r) LEFT JOIN foo_sql(11,13) WITH ORDINALITY AS f(i,s,o) ON (r+i)<100; r | i | s | o ---+----+---+--- 1 | 11 | 1 | 1 1 | 12 | 2 | 2 1 | 13 | 3 | 3 2 | 11 | 1 | 1 2 | 12 | 2 | 2 2 | 13 | 3 | 3 3 | 11 | 1 | 1 3 | 12 | 2 | 2 3 | 13 | 3 | 3 (9 rows) SELECT setval('foo_rescan_seq',1,false); setval -------- 1 (1 row) SELECT * FROM (VALUES (1),(2),(3)) v(r) LEFT JOIN foo_mat(11,13) ON (r+i)<100; r | i | s ---+----+--- 1 | 11 | 1 1 | 12 | 2 1 | 13 | 3 2 | 11 | 1 2 | 12 | 2 2 | 13 | 3 3 | 11 | 1 3 | 12 | 2 3 | 13 | 3 (9 rows) SELECT setval('foo_rescan_seq',1,false); setval -------- 1 (1 row) SELECT * FROM (VALUES (1),(2),(3)) v(r) LEFT JOIN foo_mat(11,13) WITH ORDINALITY AS f(i,s,o) ON (r+i)<100; r | i | s | o ---+----+---+--- 1 | 11 | 1 | 1 1 | 12 | 2 | 2 1 | 13 | 3 | 3 2 | 11 | 1 | 1 2 | 12 | 2 | 2 2 | 13 | 3 | 3 3 | 11 | 1 | 1 3 | 12 | 2 | 2 3 | 13 | 3 | 3 (9 rows) SELECT * FROM (VALUES (1),(2),(3)) v(r) LEFT JOIN generate_series(11,13) f(i) ON (r+i)<100; r | i ---+---- 1 | 11 1 | 12 1 | 13 2 | 11 2 | 12 2 | 13 3 | 11 3 | 12 3 | 13 (9 rows) SELECT * FROM (VALUES (1),(2),(3)) v(r) LEFT JOIN generate_series(11,13) WITH ORDINALITY AS f(i,o) ON (r+i)<100; r | i | o ---+----+--- 1 | 11 | 1 1 | 12 | 2 1 | 13 | 3 2 | 11 | 1 2 | 12 | 2 2 | 13 | 3 3 | 11 | 1 3 | 12 | 2 3 | 13 | 3 (9 rows) SELECT * FROM (VALUES (1),(2),(3)) v(r) LEFT JOIN unnest(array[10,20,30]) f(i) ON (r+i)<100; r | i ---+---- 1 | 10 1 | 20 1 | 30 2 | 10 2 | 20 2 | 30 3 | 10 3 | 20 3 | 30 (9 rows) SELECT * FROM (VALUES (1),(2),(3)) v(r) LEFT JOIN unnest(array[10,20,30]) WITH ORDINALITY AS f(i,o) ON (r+i)<100; r | i | o ---+----+--- 1 | 10 | 1 1 | 20 | 2 1 | 30 | 3 2 | 10 | 1 2 | 20 | 2 2 | 30 | 3 3 | 10 | 1 3 | 20 | 2 3 | 30 | 3 (9 rows) --invokes ExecReScanFunctionScan with chgParam != NULL (using implied LATERAL) SELECT setval('foo_rescan_seq',1,false); setval -------- 1 (1 row) SELECT * FROM (VALUES (1),(2),(3)) v(r), foo_sql(10+r,13); r | i | s ---+----+--- 1 | 11 | 1 1 | 12 | 2 1 | 13 | 3 2 | 12 | 4 2 | 13 | 5 3 | 13 | 6 (6 rows) SELECT setval('foo_rescan_seq',1,false); setval -------- 1 (1 row) SELECT * FROM (VALUES (1),(2),(3)) v(r), foo_sql(10+r,13) WITH ORDINALITY AS f(i,s,o); r | i | s | o ---+----+---+--- 1 | 11 | 1 | 1 1 | 12 | 2 | 2 1 | 13 | 3 | 3 2 | 12 | 4 | 1 2 | 13 | 5 | 2 3 | 13 | 6 | 1 (6 rows) SELECT setval('foo_rescan_seq',1,false); setval -------- 1 (1 row) SELECT * FROM (VALUES (1),(2),(3)) v(r), foo_sql(11,10+r); r | i | s ---+----+--- 1 | 11 | 1 2 | 11 | 2 2 | 12 | 3 3 | 11 | 4 3 | 12 | 5 3 | 13 | 6 (6 rows) SELECT setval('foo_rescan_seq',1,false); setval -------- 1 (1 row) SELECT * FROM (VALUES (1),(2),(3)) v(r), foo_sql(11,10+r) WITH ORDINALITY AS f(i,s,o); r | i | s | o ---+----+---+--- 1 | 11 | 1 | 1 2 | 11 | 2 | 1 2 | 12 | 3 | 2 3 | 11 | 4 | 1 3 | 12 | 5 | 2 3 | 13 | 6 | 3 (6 rows) SELECT setval('foo_rescan_seq',1,false); setval -------- 1 (1 row) SELECT * FROM (VALUES (11,12),(13,15),(16,20)) v(r1,r2), foo_sql(r1,r2); r1 | r2 | i | s ----+----+----+---- 11 | 12 | 11 | 1 11 | 12 | 12 | 2 13 | 15 | 13 | 3 13 | 15 | 14 | 4 13 | 15 | 15 | 5 16 | 20 | 16 | 6 16 | 20 | 17 | 7 16 | 20 | 18 | 8 16 | 20 | 19 | 9 16 | 20 | 20 | 10 (10 rows) SELECT setval('foo_rescan_seq',1,false); setval -------- 1 (1 row) SELECT * FROM (VALUES (11,12),(13,15),(16,20)) v(r1,r2), foo_sql(r1,r2) WITH ORDINALITY AS f(i,s,o); r1 | r2 | i | s | o ----+----+----+----+--- 11 | 12 | 11 | 1 | 1 11 | 12 | 12 | 2 | 2 13 | 15 | 13 | 3 | 1 13 | 15 | 14 | 4 | 2 13 | 15 | 15 | 5 | 3 16 | 20 | 16 | 6 | 1 16 | 20 | 17 | 7 | 2 16 | 20 | 18 | 8 | 3 16 | 20 | 19 | 9 | 4 16 | 20 | 20 | 10 | 5 (10 rows) SELECT setval('foo_rescan_seq',1,false); setval -------- 1 (1 row) SELECT * FROM (VALUES (1),(2),(3)) v(r), foo_mat(10+r,13); r | i | s ---+----+--- 1 | 11 | 1 1 | 12 | 2 1 | 13 | 3 2 | 12 | 4 2 | 13 | 5 3 | 13 | 6 (6 rows) SELECT setval('foo_rescan_seq',1,false); setval -------- 1 (1 row) SELECT * FROM (VALUES (1),(2),(3)) v(r), foo_mat(10+r,13) WITH ORDINALITY AS f(i,s,o); r | i | s | o ---+----+---+--- 1 | 11 | 1 | 1 1 | 12 | 2 | 2 1 | 13 | 3 | 3 2 | 12 | 4 | 1 2 | 13 | 5 | 2 3 | 13 | 6 | 1 (6 rows) SELECT setval('foo_rescan_seq',1,false); setval -------- 1 (1 row) SELECT * FROM (VALUES (1),(2),(3)) v(r), foo_mat(11,10+r); r | i | s ---+----+--- 1 | 11 | 1 2 | 11 | 2 2 | 12 | 3 3 | 11 | 4 3 | 12 | 5 3 | 13 | 6 (6 rows) SELECT setval('foo_rescan_seq',1,false); setval -------- 1 (1 row) SELECT * FROM (VALUES (1),(2),(3)) v(r), foo_mat(11,10+r) WITH ORDINALITY AS f(i,s,o); r | i | s | o ---+----+---+--- 1 | 11 | 1 | 1 2 | 11 | 2 | 1 2 | 12 | 3 | 2 3 | 11 | 4 | 1 3 | 12 | 5 | 2 3 | 13 | 6 | 3 (6 rows) SELECT setval('foo_rescan_seq',1,false); setval -------- 1 (1 row) SELECT * FROM (VALUES (11,12),(13,15),(16,20)) v(r1,r2), foo_mat(r1,r2); r1 | r2 | i | s ----+----+----+---- 11 | 12 | 11 | 1 11 | 12 | 12 | 2 13 | 15 | 13 | 3 13 | 15 | 14 | 4 13 | 15 | 15 | 5 16 | 20 | 16 | 6 16 | 20 | 17 | 7 16 | 20 | 18 | 8 16 | 20 | 19 | 9 16 | 20 | 20 | 10 (10 rows) SELECT setval('foo_rescan_seq',1,false); setval -------- 1 (1 row) SELECT * FROM (VALUES (11,12),(13,15),(16,20)) v(r1,r2), foo_mat(r1,r2) WITH ORDINALITY AS f(i,s,o); r1 | r2 | i | s | o ----+----+----+----+--- 11 | 12 | 11 | 1 | 1 11 | 12 | 12 | 2 | 2 13 | 15 | 13 | 3 | 1 13 | 15 | 14 | 4 | 2 13 | 15 | 15 | 5 | 3 16 | 20 | 16 | 6 | 1 16 | 20 | 17 | 7 | 2 16 | 20 | 18 | 8 | 3 16 | 20 | 19 | 9 | 4 16 | 20 | 20 | 10 | 5 (10 rows) SELECT * FROM (VALUES (1),(2),(3)) v(r), generate_series(10+r,20-r) f(i); r | i ---+---- 1 | 11 1 | 12 1 | 13 1 | 14 1 | 15 1 | 16 1 | 17 1 | 18 1 | 19 2 | 12 2 | 13 2 | 14 2 | 15 2 | 16 2 | 17 2 | 18 3 | 13 3 | 14 3 | 15 3 | 16 3 | 17 (21 rows) SELECT * FROM (VALUES (1),(2),(3)) v(r), generate_series(10+r,20-r) WITH ORDINALITY AS f(i,o); r | i | o ---+----+--- 1 | 11 | 1 1 | 12 | 2 1 | 13 | 3 1 | 14 | 4 1 | 15 | 5 1 | 16 | 6 1 | 17 | 7 1 | 18 | 8 1 | 19 | 9 2 | 12 | 1 2 | 13 | 2 2 | 14 | 3 2 | 15 | 4 2 | 16 | 5 2 | 17 | 6 2 | 18 | 7 3 | 13 | 1 3 | 14 | 2 3 | 15 | 3 3 | 16 | 4 3 | 17 | 5 (21 rows) SELECT * FROM (VALUES (1),(2),(3)) v(r), unnest(array[r*10,r*20,r*30]) f(i); r | i ---+---- 1 | 10 1 | 20 1 | 30 2 | 20 2 | 40 2 | 60 3 | 30 3 | 60 3 | 90 (9 rows) SELECT * FROM (VALUES (1),(2),(3)) v(r), unnest(array[r*10,r*20,r*30]) WITH ORDINALITY AS f(i,o); r | i | o ---+----+--- 1 | 10 | 1 1 | 20 | 2 1 | 30 | 3 2 | 20 | 1 2 | 40 | 2 2 | 60 | 3 3 | 30 | 1 3 | 60 | 2 3 | 90 | 3 (9 rows) -- deep nesting SELECT * FROM (VALUES (1),(2),(3)) v1(r1), LATERAL (SELECT r1, * FROM (VALUES (10),(20),(30)) v2(r2) LEFT JOIN generate_series(21,23) f(i) ON ((r2+i)<100) OFFSET 0) s1; r1 | r1 | r2 | i ----+----+----+---- 1 | 1 | 10 | 21 1 | 1 | 10 | 22 1 | 1 | 10 | 23 1 | 1 | 20 | 21 1 | 1 | 20 | 22 1 | 1 | 20 | 23 1 | 1 | 30 | 21 1 | 1 | 30 | 22 1 | 1 | 30 | 23 2 | 2 | 10 | 21 2 | 2 | 10 | 22 2 | 2 | 10 | 23 2 | 2 | 20 | 21 2 | 2 | 20 | 22 2 | 2 | 20 | 23 2 | 2 | 30 | 21 2 | 2 | 30 | 22 2 | 2 | 30 | 23 3 | 3 | 10 | 21 3 | 3 | 10 | 22 3 | 3 | 10 | 23 3 | 3 | 20 | 21 3 | 3 | 20 | 22 3 | 3 | 20 | 23 3 | 3 | 30 | 21 3 | 3 | 30 | 22 3 | 3 | 30 | 23 (27 rows) SELECT * FROM (VALUES (1),(2),(3)) v1(r1), LATERAL (SELECT r1, * FROM (VALUES (10),(20),(30)) v2(r2) LEFT JOIN generate_series(20+r1,23) f(i) ON ((r2+i)<100) OFFSET 0) s1; r1 | r1 | r2 | i ----+----+----+---- 1 | 1 | 10 | 21 1 | 1 | 10 | 22 1 | 1 | 10 | 23 1 | 1 | 20 | 21 1 | 1 | 20 | 22 1 | 1 | 20 | 23 1 | 1 | 30 | 21 1 | 1 | 30 | 22 1 | 1 | 30 | 23 2 | 2 | 10 | 22 2 | 2 | 10 | 23 2 | 2 | 20 | 22 2 | 2 | 20 | 23 2 | 2 | 30 | 22 2 | 2 | 30 | 23 3 | 3 | 10 | 23 3 | 3 | 20 | 23 3 | 3 | 30 | 23 (18 rows) SELECT * FROM (VALUES (1),(2),(3)) v1(r1), LATERAL (SELECT r1, * FROM (VALUES (10),(20),(30)) v2(r2) LEFT JOIN generate_series(r2,r2+3) f(i) ON ((r2+i)<100) OFFSET 0) s1; r1 | r1 | r2 | i ----+----+----+---- 1 | 1 | 10 | 10 1 | 1 | 10 | 11 1 | 1 | 10 | 12 1 | 1 | 10 | 13 1 | 1 | 20 | 20 1 | 1 | 20 | 21 1 | 1 | 20 | 22 1 | 1 | 20 | 23 1 | 1 | 30 | 30 1 | 1 | 30 | 31 1 | 1 | 30 | 32 1 | 1 | 30 | 33 2 | 2 | 10 | 10 2 | 2 | 10 | 11 2 | 2 | 10 | 12 2 | 2 | 10 | 13 2 | 2 | 20 | 20 2 | 2 | 20 | 21 2 | 2 | 20 | 22 2 | 2 | 20 | 23 2 | 2 | 30 | 30 2 | 2 | 30 | 31 2 | 2 | 30 | 32 2 | 2 | 30 | 33 3 | 3 | 10 | 10 3 | 3 | 10 | 11 3 | 3 | 10 | 12 3 | 3 | 10 | 13 3 | 3 | 20 | 20 3 | 3 | 20 | 21 3 | 3 | 20 | 22 3 | 3 | 20 | 23 3 | 3 | 30 | 30 3 | 3 | 30 | 31 3 | 3 | 30 | 32 3 | 3 | 30 | 33 (36 rows) SELECT * FROM (VALUES (1),(2),(3)) v1(r1), LATERAL (SELECT r1, * FROM (VALUES (10),(20),(30)) v2(r2) LEFT JOIN generate_series(r1,2+r2/5) f(i) ON ((r2+i)<100) OFFSET 0) s1; r1 | r1 | r2 | i ----+----+----+--- 1 | 1 | 10 | 1 1 | 1 | 10 | 2 1 | 1 | 10 | 3 1 | 1 | 10 | 4 1 | 1 | 20 | 1 1 | 1 | 20 | 2 1 | 1 | 20 | 3 1 | 1 | 20 | 4 1 | 1 | 20 | 5 1 | 1 | 20 | 6 1 | 1 | 30 | 1 1 | 1 | 30 | 2 1 | 1 | 30 | 3 1 | 1 | 30 | 4 1 | 1 | 30 | 5 1 | 1 | 30 | 6 1 | 1 | 30 | 7 1 | 1 | 30 | 8 2 | 2 | 10 | 2 2 | 2 | 10 | 3 2 | 2 | 10 | 4 2 | 2 | 20 | 2 2 | 2 | 20 | 3 2 | 2 | 20 | 4 2 | 2 | 20 | 5 2 | 2 | 20 | 6 2 | 2 | 30 | 2 2 | 2 | 30 | 3 2 | 2 | 30 | 4 2 | 2 | 30 | 5 2 | 2 | 30 | 6 2 | 2 | 30 | 7 2 | 2 | 30 | 8 3 | 3 | 10 | 3 3 | 3 | 10 | 4 3 | 3 | 20 | 3 3 | 3 | 20 | 4 3 | 3 | 20 | 5 3 | 3 | 20 | 6 3 | 3 | 30 | 3 3 | 3 | 30 | 4 3 | 3 | 30 | 5 3 | 3 | 30 | 6 3 | 3 | 30 | 7 3 | 3 | 30 | 8 (45 rows) DROP FUNCTION foo_sql(int,int); DROP FUNCTION foo_mat(int,int); DROP SEQUENCE foo_rescan_seq; -- -- Test cases involving OUT parameters -- CREATE FUNCTION foo(in f1 int, out f2 int) AS 'select $1+1' LANGUAGE sql; SELECT foo(42); foo ----- 43 (1 row) SELECT * FROM foo(42); f2 ---- 43 (1 row) SELECT * FROM foo(42) AS p(x); x ---- 43 (1 row) -- explicit spec of return type is OK CREATE OR REPLACE FUNCTION foo(in f1 int, out f2 int) RETURNS int AS 'select $1+1' LANGUAGE sql; -- error, wrong result type CREATE OR REPLACE FUNCTION foo(in f1 int, out f2 int) RETURNS float AS 'select $1+1' LANGUAGE sql; ERROR: function result type must be integer because of OUT parameters -- with multiple OUT params you must get a RECORD result CREATE OR REPLACE FUNCTION foo(in f1 int, out f2 int, out f3 text) RETURNS int AS 'select $1+1' LANGUAGE sql; ERROR: function result type must be record because of OUT parameters CREATE OR REPLACE FUNCTION foo(in f1 int, out f2 int, out f3 text) RETURNS record AS 'select $1+1' LANGUAGE sql; ERROR: cannot change return type of existing function HINT: Use DROP FUNCTION foo(integer) first. CREATE OR REPLACE FUNCTION foor(in f1 int, out f2 int, out text) AS $$select $1-1, $1::text || 'z'$$ LANGUAGE sql; SELECT f1, foor(f1) FROM int4_tbl; f1 | foor -------------+---------------------------- 0 | (-1,0z) 123456 | (123455,123456z) -123456 | (-123457,-123456z) 2147483647 | (2147483646,2147483647z) -2147483647 | (-2147483648,-2147483647z) (5 rows) SELECT * FROM foor(42); f2 | column2 ----+--------- 41 | 42z (1 row) SELECT * FROM foor(42) AS p(a,b); a | b ----+----- 41 | 42z (1 row) CREATE OR REPLACE FUNCTION foob(in f1 int, inout f2 int, out text) AS $$select $2-1, $1::text || 'z'$$ LANGUAGE sql; SELECT f1, foob(f1, f1/2) FROM int4_tbl; f1 | foob -------------+---------------------------- 0 | (-1,0z) 123456 | (61727,123456z) -123456 | (-61729,-123456z) 2147483647 | (1073741822,2147483647z) -2147483647 | (-1073741824,-2147483647z) (5 rows) SELECT * FROM foob(42, 99); f2 | column2 ----+--------- 98 | 42z (1 row) SELECT * FROM foob(42, 99) AS p(a,b); a | b ----+----- 98 | 42z (1 row) -- Can reference function with or without OUT params for DROP, etc DROP FUNCTION foo(int); DROP FUNCTION foor(in f2 int, out f1 int, out text); DROP FUNCTION foob(in f1 int, inout f2 int); -- -- For my next trick, polymorphic OUT parameters -- CREATE FUNCTION dup (f1 anyelement, f2 out anyelement, f3 out anyarray) AS 'select $1, array[$1,$1]' LANGUAGE sql; SELECT dup(22); dup ---------------- (22,"{22,22}") (1 row) SELECT dup('xyz'); -- fails ERROR: could not determine polymorphic type because input has type "unknown" SELECT dup('xyz'::text); dup ------------------- (xyz,"{xyz,xyz}") (1 row) SELECT * FROM dup('xyz'::text); f2 | f3 -----+----------- xyz | {xyz,xyz} (1 row) -- fails, as we are attempting to rename first argument CREATE OR REPLACE FUNCTION dup (inout f2 anyelement, out f3 anyarray) AS 'select $1, array[$1,$1]' LANGUAGE sql; ERROR: cannot change name of input parameter "f1" HINT: Use DROP FUNCTION dup(anyelement) first. DROP FUNCTION dup(anyelement); -- equivalent behavior, though different name exposed for input arg CREATE OR REPLACE FUNCTION dup (inout f2 anyelement, out f3 anyarray) AS 'select $1, array[$1,$1]' LANGUAGE sql; SELECT dup(22); dup ---------------- (22,"{22,22}") (1 row) DROP FUNCTION dup(anyelement); -- fails, no way to deduce outputs CREATE FUNCTION bad (f1 int, out f2 anyelement, out f3 anyarray) AS 'select $1, array[$1,$1]' LANGUAGE sql; ERROR: cannot determine result data type DETAIL: A function returning a polymorphic type must have at least one polymorphic argument. -- -- table functions -- CREATE OR REPLACE FUNCTION foo() RETURNS TABLE(a int) AS $$ SELECT a FROM generate_series(1,5) a(a) $$ LANGUAGE sql; SELECT * FROM foo(); a --- 1 2 3 4 5 (5 rows) DROP FUNCTION foo(); CREATE OR REPLACE FUNCTION foo(int) RETURNS TABLE(a int, b int) AS $$ SELECT a, b FROM generate_series(1,$1) a(a), generate_series(1,$1) b(b) $$ LANGUAGE sql; SELECT * FROM foo(3); a | b ---+--- 1 | 1 1 | 2 1 | 3 2 | 1 2 | 2 2 | 3 3 | 1 3 | 2 3 | 3 (9 rows) DROP FUNCTION foo(int); -- -- some tests on SQL functions with RETURNING -- create temp table tt(f1 serial, data text); create function insert_tt(text) returns int as $$ insert into tt(data) values($1) returning f1 $$ language sql; select insert_tt('foo'); insert_tt ----------- 1 (1 row) select insert_tt('bar'); insert_tt ----------- 2 (1 row) select * from tt; f1 | data ----+------ 1 | foo 2 | bar (2 rows) -- insert will execute to completion even if function needs just 1 row create or replace function insert_tt(text) returns int as $$ insert into tt(data) values($1),($1||$1) returning f1 $$ language sql; select insert_tt('fool'); insert_tt ----------- 3 (1 row) select * from tt; f1 | data ----+---------- 1 | foo 2 | bar 3 | fool 4 | foolfool (4 rows) -- setof does what's expected create or replace function insert_tt2(text,text) returns setof int as $$ insert into tt(data) values($1),($2) returning f1 $$ language sql; select insert_tt2('foolish','barrish'); insert_tt2 ------------ 5 6 (2 rows) select * from insert_tt2('baz','quux'); insert_tt2 ------------ 7 8 (2 rows) select * from tt; f1 | data ----+---------- 1 | foo 2 | bar 3 | fool 4 | foolfool 5 | foolish 6 | barrish 7 | baz 8 | quux (8 rows) -- limit doesn't prevent execution to completion select insert_tt2('foolish','barrish') limit 1; insert_tt2 ------------ 9 (1 row) select * from tt; f1 | data ----+---------- 1 | foo 2 | bar 3 | fool 4 | foolfool 5 | foolish 6 | barrish 7 | baz 8 | quux 9 | foolish 10 | barrish (10 rows) -- triggers will fire, too create function noticetrigger() returns trigger as $$ begin raise notice 'noticetrigger % %', new.f1, new.data; return null; end $$ language plpgsql; create trigger tnoticetrigger after insert on tt for each row execute procedure noticetrigger(); select insert_tt2('foolme','barme') limit 1; NOTICE: noticetrigger 11 foolme CONTEXT: SQL function "insert_tt2" statement 1 NOTICE: noticetrigger 12 barme CONTEXT: SQL function "insert_tt2" statement 1 insert_tt2 ------------ 11 (1 row) select * from tt; f1 | data ----+---------- 1 | foo 2 | bar 3 | fool 4 | foolfool 5 | foolish 6 | barrish 7 | baz 8 | quux 9 | foolish 10 | barrish 11 | foolme 12 | barme (12 rows) -- and rules work create temp table tt_log(f1 int, data text); create rule insert_tt_rule as on insert to tt do also insert into tt_log values(new.*); select insert_tt2('foollog','barlog') limit 1; NOTICE: noticetrigger 13 foollog CONTEXT: SQL function "insert_tt2" statement 1 NOTICE: noticetrigger 14 barlog CONTEXT: SQL function "insert_tt2" statement 1 insert_tt2 ------------ 13 (1 row) select * from tt; f1 | data ----+---------- 1 | foo 2 | bar 3 | fool 4 | foolfool 5 | foolish 6 | barrish 7 | baz 8 | quux 9 | foolish 10 | barrish 11 | foolme 12 | barme 13 | foollog 14 | barlog (14 rows) -- note that nextval() gets executed a second time in the rule expansion, -- which is expected. select * from tt_log; f1 | data ----+--------- 15 | foollog 16 | barlog (2 rows) -- test case for a whole-row-variable bug create function foo1(n integer, out a text, out b text) returns setof record language sql as $$ select 'foo ' || i, 'bar ' || i from generate_series(1,$1) i $$; set work_mem='64kB'; select t.a, t, t.a from foo1(10000) t limit 1; a | t | a -------+-------------------+------- foo 1 | ("foo 1","bar 1") | foo 1 (1 row) reset work_mem; select t.a, t, t.a from foo1(10000) t limit 1; a | t | a -------+-------------------+------- foo 1 | ("foo 1","bar 1") | foo 1 (1 row) drop function foo1(n integer); -- test use of SQL functions returning record -- this is supported in some cases where the query doesn't specify -- the actual record type ... create function array_to_set(anyarray) returns setof record as $$ select i AS "index", $1[i] AS "value" from generate_subscripts($1, 1) i $$ language sql strict immutable; select array_to_set(array['one', 'two']); array_to_set -------------- (1,one) (2,two) (2 rows) select * from array_to_set(array['one', 'two']) as t(f1 int,f2 text); f1 | f2 ----+----- 1 | one 2 | two (2 rows) select * from array_to_set(array['one', 'two']); -- fail ERROR: a column definition list is required for functions returning "record" LINE 1: select * from array_to_set(array['one', 'two']); ^ create temp table foo(f1 int8, f2 int8); create function testfoo() returns record as $$ insert into foo values (1,2) returning *; $$ language sql; select testfoo(); testfoo --------- (1,2) (1 row) select * from testfoo() as t(f1 int8,f2 int8); f1 | f2 ----+---- 1 | 2 (1 row) select * from testfoo(); -- fail ERROR: a column definition list is required for functions returning "record" LINE 1: select * from testfoo(); ^ drop function testfoo(); create function testfoo() returns setof record as $$ insert into foo values (1,2), (3,4) returning *; $$ language sql; select testfoo(); testfoo --------- (1,2) (3,4) (2 rows) select * from testfoo() as t(f1 int8,f2 int8); f1 | f2 ----+---- 1 | 2 3 | 4 (2 rows) select * from testfoo(); -- fail ERROR: a column definition list is required for functions returning "record" LINE 1: select * from testfoo(); ^ drop function testfoo(); -- -- Check some cases involving dropped columns in a rowtype result -- create temp table users (userid text, email text, todrop bool, enabled bool); insert into users values ('id','email',true,true); insert into users values ('id2','email2',true,true); alter table users drop column todrop; create or replace function get_first_user() returns users as $$ SELECT * FROM users ORDER BY userid LIMIT 1; $$ language sql stable; SELECT get_first_user(); get_first_user ---------------- (id,email,t) (1 row) SELECT * FROM get_first_user(); userid | email | enabled --------+-------+--------- id | email | t (1 row) create or replace function get_users() returns setof users as $$ SELECT * FROM users ORDER BY userid; $$ language sql stable; SELECT get_users(); get_users ---------------- (id,email,t) (id2,email2,t) (2 rows) SELECT * FROM get_users(); userid | email | enabled --------+--------+--------- id | email | t id2 | email2 | t (2 rows) SELECT * FROM get_users() WITH ORDINALITY; -- make sure ordinality copes userid | email | enabled | ordinality --------+--------+---------+------------ id | email | t | 1 id2 | email2 | t | 2 (2 rows) drop function get_first_user(); drop function get_users(); drop table users; -- this won't get inlined because of type coercion, but it shouldn't fail create or replace function foobar() returns setof text as $$ select 'foo'::varchar union all select 'bar'::varchar ; $$ language sql stable; select foobar(); foobar -------- foo bar (2 rows) select * from foobar(); foobar -------- foo bar (2 rows) drop function foobar(); -- check handling of a SQL function with multiple OUT params (bug #5777) create or replace function foobar(out integer, out numeric) as $$ select (1, 2.1) $$ language sql; select * from foobar(); column1 | column2 ---------+--------- 1 | 2.1 (1 row) create or replace function foobar(out integer, out numeric) as $$ select (1, 2) $$ language sql; select * from foobar(); -- fail ERROR: function return row and query-specified return row do not match DETAIL: Returned type integer at ordinal position 2, but query expects numeric. create or replace function foobar(out integer, out numeric) as $$ select (1, 2.1, 3) $$ language sql; select * from foobar(); -- fail ERROR: function return row and query-specified return row do not match DETAIL: Returned row contains 3 attributes, but query expects 2. drop function foobar();