Описание

CREATE TRANSFORM определяет новое преобразование. CREATE OR REPLACE TRANSFORM либо создаст новое преобразование, либо заменит существующее определение.

Преобразование определяет, как адаптировать тип данных для процедурного языка. Например, при написании функции на PL/Python с использованием типа hstore, PL/Python заранее не знает, как представить значения hstore в окружении Python. Реализации языков обычно по умолчанию используют текстовое представление, но это неудобно, когда, например, ассоциативный массив или список был бы более подходящим.

Преобразование задаёт две функции:

Не обязательно предоставлять обе эти функции. Если одна не указана, будет использовано поведение по умолчанию для языка, если это необходимо. (Чтобы предотвратить преобразование в определённом направлении вообще, можно также написать функцию преобразования, которая всегда выдаёт ошибку.)

Чтобы иметь возможность создать преобразование, вы должны владеть типом и иметь привилегию USAGE на него, иметь привилегию USAGE на язык, а также владеть и иметь привилегию EXECUTE на функции from-SQL и to-SQL, если они указаны.

Параметры

Примечания

Используйте DROP TRANSFORM для удаления преобразований.

Примеры

Чтобы создать преобразование для типа hstore и языка plpython3u, сначала настройте тип и язык:

CREATE TYPE hstore ...;

CREATE EXTENSION plpython3u;

Затем создайте необходимые функции:

CREATE FUNCTION hstore_to_plpython(val internal) RETURNS internal
LANGUAGE C STRICT IMMUTABLE
AS ...;

CREATE FUNCTION plpython_to_hstore(val internal) RETURNS hstore
LANGUAGE C STRICT IMMUTABLE
AS ...;

И, наконец, создайте преобразование, чтобы связать всё вместе:

CREATE TRANSFORM FOR hstore LANGUAGE plpython3u (
    FROM SQL WITH FUNCTION hstore_to_plpython(internal),
    TO SQL WITH FUNCTION plpython_to_hstore(internal)
);

На практике эти команды были бы упакованы в расширение.

Раздел contrib содержит ряд расширений, предоставляющих преобразования, которые могут служить реальными примерами.

Совместимость

Эта форма CREATE TRANSFORM является расширением Digital Q.DataBase. В стандарте SQL существует команда CREATE TRANSFORM, но она предназначена для адаптации типов данных к клиентским языкам. Такое использование не поддерживается Digital Q.DataBase.

См. также

CREATE FUNCTION, CREATE LANGUAGE, CREATE TYPE, DROP TRANSFORM