Как может `RETURN TABLE (столбцы)` быть эквивалентным использованию одного или нескольких параметров `OUT` и пометить функцию как возвращающую запись` SETOF`?

Question

В документе PostgreSQL написано

Существует еще один способ объявить функцию SQL возвращающей набор, который заключается в использовании синтаксиса RETURNS TABLE(columns). Это эквивалентно использованию одного или нескольких OUT параметров плюс маркировка функции как возвращение SETOF записи (или SETOF тип одного выходного параметра, в зависимости от ситуации).

Не могли бы вы объяснить, как RETURN TABLE(columns) может быть эквивалентно:

• с использованием одного или нескольких OUT параметров и

• маркировка функции как возвращающая SETOF запись (или SETOF тип одного выходного параметра, в зависимости от ситуации)

Спасибо.

Answer 1

Эти функции эквивалентны:

create type my_type as (id int, str text);

create or replace function function_returning_setof(n int)
returns setof my_type language sql as $$
    select i, i::text
    from generate_series(1, n) i;
$$;

create or replace function function_returning_table(n int)
returns table(id int, str text) language sql as $$
    select i, i::text
    from generate_series(1, n) i;
$$;

create or replace function function_with_out_params(in n int, out id int, out str text)
returns setof record language sql as $$
    select i, i::text
    from generate_series(1, n) i;
$$;

DbFiddle.