jsonb_plpython3u. Трансформация для типа jsonb в структуру PL/Python3u#

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

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

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

Модуль реализует трансформации (преобразование) для типа jsonb в структуру недоверенного (untrusted) PL/Python3.

Модуль jsonb_plpython3u является одним из дополнительных расширений для различных процедурных языков.

Расширение для недоверенных (untrusted) PL/Python: jsonb_plpython3u – PL/Python 3.

При использовании расширений значения jsonb отображаются в соответствующие структуры Python:

• массивы;

• хеши;

• скаляры.

Сравнение типов с точки зрения эффективности:

Доработка#

Доработка не проводилась.

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

Ограничения отсутствуют.

Установка#

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

Модуль считается «доверенным», поэтому его могут устанавливать пользователи, имеющие право CREATE в текущей базе данных.

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

   SberLinux, РЕД ОС, CentOS Astra Linux Альт СП

   sudo dnf install pangolin-dbms-{base_version}-jsonb-plpython3-{product_version}-{OS}.x86_64.rpm
   

   sudo apt install pangolin-dbms-{base_version}-jsonb-plpython3-{product_version}_amd64.deb
   

   sudo apt-get install pangolin-dbms-{base_version}-jsonb-plpython3-{product_version}-{OS}.x86_64.rpm
   

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

   cd distributive
   tar -xzf untrusted/untrusted.tar.gz -C untrusted/
   sudo dnf -y install untrusted/pangolin-dbms-7-jsonb-plpython3-7.1.1-sberlinux8.x86_64.rpm
   

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

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

   CREATE EXTENSION jsonb_plpython3u CASCADE SCHEMA ext;
   

Отключение#

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

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

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

   DROP EXTENSION jsonb_plpython3u CASCADE;
   

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

Настройка#

Настройка не требуется.

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

Подробное описание типов json/jsonb/jsonpath (синтаксис, проверки, вхождения, трансформации) представлено в официальной документации: https://www.postgresql.org/docs/15/datatype-json.html#id-1.5.7.22.20

Ниже приведены несколько примеров для понимания различий в работе типов:

• значение JSON вводится и затем выводится без дополнительной обработки, выводит тот же текст, что поступил на вход:

  SELECT '{"bar": "baz", "balance": 7.77, "active":false}'::json;
  

  Пример вывода результата:

                        json
  -------------------------------------------------
   {"bar": "baz", "balance": 7.77, "active":false}
  (1 row)
  

• jsonb не сохраняет семантически незначащие детали, например, пробелы:

  SELECT '{"bar": "baz", "balance": 7.77, "active":false}'::jsonb;
  

  Пример вывода результата:

                        jsonb
  --------------------------------------------------
   {"bar": "baz", "active": false, "balance": 7.77}
  (1 row)
  

• с jsonb числа выводятся по правилам нижележащего типа numeric

  SELECT '{"reading": 4.230e-6}'::json, '{"reading": 4.230e-6}'::jsonb;
  

  Пример вывода результата:

           json          |          jsonb
  -----------------------+--------------------------
   {"reading": 4.230e-6} | {"reading": 0.000004230}
  (1 row)
  

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

Дополнительно поставляемый модуль jsonb_plpython3u: https://www.postgresql.org/docs/15/datatype-json.html#id-1.5.7.22.20;

Описание специальных функций и операторов для работы с типами JSON/JSONB: https://www.postgresql.org/docs/15/functions-json.html.