Перейти к основному содержимому

bool_plperl. Трансформация для логических значений

В исходном дистрибутиве установлено по умолчанию: нет.

Связанные компоненты: plperl.

Схема размещения: ext.

Модуль представляет собой реализацию механизма трансформации для логических значений.

По умолчанию значения bool передаются в PL/Perl в текстовом виде — как 't' или 'f'. Perl не будет воспринимать 'f' как false. Для решения этой проблемы применяется трансформация (CREATE TRANSFORM).

В результате работы механизма трансформации Perl будет получать аргумент bool как 1 или пустое значение. Для Perl это будет выглядеть как true или false. Если функция возвращает результат типа bool, выдается значение true или false в зависимости от того, считается ли в Perl результат истинным или ложным.

примечание

Расширение вынесено в часть дистрибутива «untrusted». Подробное описание решения представлено в разделе «Информация по Untrusted-расширениям» документа «Руководство по установке».

Доработка​

Не проводилась.

Ограничения​

Ограничений нет.

Установка​

Обозначения

Далее в примерах команд будут использоваться следующие обозначения:

  • {OS} – наименование операционной системы и ее версия;
  • {product_version} – версия продукта (текущая версия: 8.2.0);
  • {base_version} – базовая версия продукта (текущая: 8).

Необходима предварительная установка связанного расширения plperl или использовать предложение CASCADE.

При наличии прав администратора СУБД установку и активацию модуля возможно выполнить вручную.

  1. Установите rpm/deb-пакет расширения, в зависимости от окружения:

    sudo dnf install pangolin-dbms-{base_version}-bool-plperl-{product_version}-{OS}.x86_64.rpm
    Подсказка

    Пример заполненной команды:

    cd distributive
    tar -xzf untrusted/untrusted.tar.gz -C untrusted/
    sudo dnf -y install untrusted/pangolin-dbms-8-bool-plperl-8.2.0-sberlinux9.x86_64.rpm

  2. Подключиться к БД, в которой необходимо зарегистрировать расширение.

  3. Выполните активацию расширения с помощью команды:

    CREATE EXTENSION bool_plperl CASCADE SCHEMA ext;

Отключение​

Для отключения расширения необходимо его удалить.

  1. Подключиться к БД, в которой зарегистрировано расширение.

  2. Выполните отключение расширения с помощью команды:

    DROP EXTENSION bool_plperl CASCADE;

  3. Удалите rpm/deb-пакет с расширением.

Настройка​

Не требуется.

Использование модуля​

После подключения расширения достаточно использовать атрибут TRANSFORM для функции на PL/Perl, которая принимает и выдает bool:

CREATE FUNCTION имя_функции (типы аргументов) RETURNS тип результата
TRANSFORM FOR TYPE bool
AS $$
  # Тело функции на PL/Perl
$$ LANGUAGE plperl;

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

Ссылки на документацию разработчика​

Дополнительно поставляемый модуль bool_plperl.