При вызове функции на PL/Python её аргументы преобразуются из типа данных PostgreSQL в соответствующий тип Python:

Когда функция PL/Python завершает выполнение, возвращаемое значение преобразуется в объявленный тип данных PostgreSQL следующим образом:

Обратите внимание, что логические несоответствия между объявленным типом возвращаемого значения PostgreSQL и типом данных Python фактически возвращаемого объекта не фиксируются; значение будет преобразовано в любом случае.

Если значение NULL в SQL передается в функцию, значение аргумента будет представлено как None в Python. Например, определение функции pymax показанное в Раздел 5.9.1 вернет неверный результат для входных данных NULL. Мы могли бы добавить STRICT в определение функции, чтобы Digital Q.DataBase сделать поведение более логичным: если передано значение NULL, функция не будет вызвана вовсе, а просто автоматически вернет результат NULL. Альтернативный вариант: проверку на наличие значений NULL можно выполнить в теле функции:

CREATE FUNCTION pymax (a integer, b integer)
  RETURNS integer
AS $$
  if (a is None) or (b is None):
    return None
  if a > b:
    return a
  return b
$$ LANGUAGE plpython3u;

Как показано выше, чтобы вернуть значение NULL в SQL из функции PL/Python, следует возвращать значение None. Это можно сделать независимо от того, помечена ли функция как STRICT или нет.

Значения массивов SQL передаются в PL/Python как список Python. Чтобы вернуть значение массива SQL из функции PL/Python, необходимо вернуть список Python:

CREATE FUNCTION return_arr()
  RETURNS int[]
AS $$
return [1, 2, 3, 4, 5]
$$ LANGUAGE plpython3u;

SELECT return_arr();
 return_arr
-------------
 {1,2,3,4,5}
(1 row)

Многомерные массивы передаются в PL/Python как вложенные списки Python. Например, двумерный массив — это список списков. При возврате многомерного массива SQL из функции PL/Python внутренние списки на каждом уровне должны иметь одинаковый размер. Например:

CREATE FUNCTION test_type_conversion_array_int4(x int4[]) RETURNS int4[] AS $$
plpy.info(x, type(x))
return x
$$ LANGUAGE plpython3u;

SELECT * FROM test_type_conversion_array_int4(ARRAY[[1,2,3],[4,5,6]]);
INFO:  ([[1, 2, 3], [4, 5, 6]], <type 'list'>)
 test_type_conversion_array_int4
---------------------------------
 {{1,2,3},{4,5,6}}
(1 строка)

Другие последовательности Python, такие как кортежи, также поддерживаются для обратной совместимости с PostgreSQL версий 9.6 и ниже, в которых многомерные массивы не поддерживались. Однако они всегда обрабатываются как одномерные массивы, так как в противном случае они неотличимы от составных типов. По этой же причине, когда составной тип используется в многомерном массиве, он должен быть представлен кортежем, а не списком.

Обратите внимание, что в Python строки являются последовательностями, что может привести к нежелательным эффектам, знакомым разработчикам на Python:

CREATE FUNCTION return_str_arr()
  RETURNS varchar[]
AS $$
return "hello"
$$ LANGUAGE plpython3u;

SELECT return_str_arr();
 return_str_arr
----------------
 {h,e,l,l,o}
(1 строка)

Аргументы составных типов передаются функции в виде отображений (mappings) Python. Именами элементов в отображении являются имена атрибутов составного типа. Если атрибут в переданной строке имеет значение NULL, он принимает значение None в отображении. Вот пример:

CREATE TABLE employee (
  name text,
  salary integer,
  age integer
);

CREATE FUNCTION overpaid (e employee)
  RETURNS boolean
AS $$
  if e["salary"] > 200000:
    return True
  if (e["age"] < 30) and (e["salary"] > 100000):
    return True
  return False
$$ LANGUAGE plpython3u;

Существует несколько способов возврата строк или составных типов из функции на языке Python. В следующих примерах предполагается, что созданы следующие объекты:

CREATE TYPE named_value AS (
  name   text,
  value  integer
);

Составной результат может быть возвращен в виде:

Функции с OUT параметрами также поддерживаются. Например:

CREATE FUNCTION multiout_simple(OUT i integer, OUT j integer) AS $$
return (1, 2)
$$ LANGUAGE plpython3u;

SELECT * FROM multiout_simple();

Выходные параметры процедур передаются обратно тем же способом. Например:

CREATE PROCEDURE python_triple(INOUT a integer, INOUT b integer) AS $$
return (a * 3, b * 3)
$$ LANGUAGE plpython3u;

CALL python_triple(5, 10);

PL/Python- PL/Python функция также может возвращать наборы скалярных или составных типов. Существует несколько способов добиться этого, так как возвращаемый объект внутри преобразуется в итератор. В следующих примерах предполагается наличие составного типа:

CREATE TYPE greeting AS (
  how text,
  who text
);

Результат в виде набора может быть возвращён из:

Функции, возвращающие набор (set-returning functions), с OUT параметрами (использующие RETURNS SETOF record) также поддерживаются. Например:

CREATE FUNCTION multiout_simple_setof(n integer, OUT integer, OUT integer) RETURNS SETOF record AS $$
return [(1, 2)] * n
$$ LANGUAGE plpython3u;

SELECT * FROM multiout_simple_setof(3);