F.44. pg_variables

F.44. pg_variables
Пред.	Наверх	Приложение F. Дополнительно поставляемые модули	Начало	След.

F.44.1. Введение
F.44.2. Установка
F.44.3. Функции
F.44.4. Примеры
F.44.5. Авторы

F.44.1. Введение

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

Примечание

Модуль pg_variables не поддерживает транзакции и точки сохранения. Например:

postgres=# SELECT pgv_set('vars', 'int1', 101);
BEGIN;
postgres=# SELECT pgv_set('vars', 'int2', 102);
ROLLBACK;

postgres=# SELECT * FROM pgv_list() ORDER BY package, name;
 package | name
---------+------
 vars    | int1
 vars    | int2
(2 rows)

F.44.2. Установка

Расширение pg_variables включено в состав Postgres Pro. Установив Postgres Pro, вы должны выполнить команду CREATE EXTENSION, чтобы подготовить pg_variables к работе, следующим образом:

CREATE EXTENSION pg_variables;

F.44.3. Функции

Этот модуль поддерживает скалярные типы и записи. Функции, реализованные в модуле pg_variables для поддерживаемых типов, представлены в следующих таблицах.

F.44.3.1. Скалярные переменные

Следующие функции поддерживают скалярные переменные:

Функция	Возвращает
`pgv_set(package text, name text, value anynonarray)`	`void`
`pgv_get(package text, name text, var_type anynonarray, strict bool default true)`	`anynonarray`

Для функции pgv_get() вы должны сначала создать пакет и переменную, воспользовавшись функцией pgv_set(). Если указанный пакет или переменная не существуют, происходит ошибка:

postgres=# SELECT pgv_get('vars', 'int1');
ERROR:  unrecognized package "vars"

postgres=# SELECT pgv_get('vars', 'int1');
ERROR:  unrecognized variable "int1"

Функция pgv_get() проверяет тип переменной. Если заданный тип не соответствует типу переменной, выдаётся ошибка:

SELECT pgv_get('vars', 'int1', NULL::text);
ERROR:  variable "int1" requires "integer" value

F.44.3.2. Записи

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

Функция	Возвращает	Описание
`pgv_insert(package text, name text, r record)`	`void`	Вставляет запись в набор переменных для заданного пакета. Если пакет или переменная не существуют, они создаются автоматически. Первый столбец записи `r` — первичный ключ. Если запись с таким же первичным ключом уже существует или этот набор переменных имеет другую структуру, выдаётся ошибка.
`pgv_update(package text, name text, r record)`	`boolean`	Изменяет запись с соответствующим первичным ключом (он задаётся в первом столбце `r`). Возвращает `true`, если запись была найдена. Если этот набор переменных имеет другую структуру, выдаётся ошибка.
`pgv_delete(package text, name text, value anynonarray)`	`boolean`	Удаляет запись с соответствующим первичным ключом (он задаётся в первом столбце `r`). Возвращает `true`, если запись была найдена.
`pgv_select(package text, name text)`	`set of records`	Возвращает записи из набора переменных.
`pgv_select(package text, name text, value anynonarray)`	`record`	Возвращает записи из набора переменных с соответствующими первичными ключами (первичный ключ задаётся в первом столбце `r`).
`pgv_select(package text, name text, value anyarray)`	`set of records`	Возвращает записи из набора переменных с соответствующими первичными ключами (первичный ключ задаётся в первом столбце `r`).

Для использования функций pgv_update(), pgv_delete() and pgv_select() вы должны сначала создать пакет и переменную, воспользовавшись функцией pgv_insert(). Тип переменной и тип записи должны быть одинаковыми, иначе выдаётся ошибка.

F.44.3.3. Функции разного назначения

Функция	Возвращает	Описание
`pgv_exists(package text, name text)`	`bool`	Возвращает `true`, если существует пакет и переменная.
`pgv_exists(package text)`	`bool`	Возвращает `true`, если существует указанный пакет.
`pgv_remove(package text, name text)`	`void`	Удаляет переменную с соответствующим именем. Указанный пакет и переменная должны существовать, иначе выдаётся ошибка.
`pgv_remove(package text)`	`void`	Удаляет пакет и все переменные пакета с заданным именем. Указанный пакет должен существовать, иначе выдаётся ошибка.
`pgv_free()`	`void`	Удаляет все пакеты и переменные.
`pgv_list()`	`table(package text, name text)`	Возвращает список пакетов и связанных с ними переменных.
`pgv_stats()`	`table(package text, used_memory bigint)`	Возвращает список созданных пакетов и объём памяти, используемый переменными, в байтах. Эта функция поддерживает только Postgres Pro 9.6 и выше.

F.44.3.4. Целочисленные переменные (устаревшее)

Следующие функции считаются устаревшими. Используйте вместо них универсальные функции для скалярных переменных.

Функция	Возвращает
`pgv_set_int(package text, name text, value int)`	`void`
`pgv_get_int(package text, name text, strict bool default true)`	`int`

F.44.3.5. Текстовые переменные (устаревшее)

Функция	Возвращает
`pgv_set_text(package text, name text, value text)`	`void`
`pgv_get_text(package text, name text, strict bool default true)`	`text`

F.44.3.6. Числовые переменные (устаревшее)

Функция	Возвращает
`pgv_set_numeric(package text, name text, value numeric)`	`void`
`pgv_get_numeric(package text, name text, strict bool default true)`	`numeric`

F.44.3.7. Переменные даты/времени (устаревшее)

Функция	Возвращает
`pgv_set_timestamp(package text, name text, value timestamp)`	`void`
`pgv_get_timestamp(package text, name text, strict bool default true)`	`timestamp`

F.44.3.8. Переменные даты/времени с часовым поясом (устаревшее)

Функция	Возвращает
`pgv_set_timestamptz(package text, name text, value timestamptz)`	`void`
`pgv_get_timestamptz(package text, name text, strict bool default true)`	`timestamptz`

F.44.3.9. Переменные даты (устаревшее)

Функция	Возвращает
`pgv_set_date(package text, name text, value date)`	`void`
`pgv_get_date(package text, name text, strict bool default true)`	`date`

F.44.3.10. Переменные Jsonb (устаревшее)

Функция	Возвращает
`pgv_set_jsonb(package text, name text, value jsonb)`	`void`
`pgv_get_jsonb(package text, name text, strict bool default true)`	`jsonb`

F.44.4. Примеры

Определение значений int1 и int2 с помощью функции pgv_set() и получение их значений с использованием функции pgv_get():

postgres=# SELECT pgv_set('vars', 'int1', 101);
postgres=# SELECT pgv_set('vars', 'int2', 102);

postgres=# SELECT pgv_get('vars', 'int1', NULL::int);
 pgv_get
-------------
         101
(1 row)

postgres=# SELECT pgv_get('vars', 'int2', NULL::int);
 pgv_get
-------------
         102
(1 row)

Допустим, у нас есть таблица tab:

CREATE TABLE tab (id int, t varchar);
INSERT INTO tab VALUES (0, 'str00'), (1, 'str11');

Вы можете использовать следующие функции, работающие с переменными-записями:

postgres=# SELECT pgv_insert('vars', 'r1', tab) FROM tab;

postgres=# SELECT pgv_select('vars', 'r1');
 pgv_select
------------
 (1,str11)
 (0,str00)
(2 rows)

postgres=# pgv_select('vars', 'r1', 1);
 pgv_select
------------
 (1,str11)
(1 row)

postgres=# SELECT pgv_select('vars', 'r1', 0);
 pgv_select
------------
 (0,str00)
(1 row)

postgres=# SELECT pgv_select('vars', 'r1', ARRAY[1, 0]);
 pgv_select
------------
 (1,str11)
 (0,str00)
(2 rows)

postgres=# SELECT pgv_delete('vars', 'r1', 1);

postgres=# SELECT pgv_select('vars', 'r1');
 pgv_select
------------
 (0,str00)
(1 row)

Просмотреть имеющиеся пакеты и переменные:

postgres=# SELECT * FROM pgv_list() ORDER BY package, name;
 package | name 
---------+------
 vars    | int1
 vars    | int2
 vars    | r1
(3 rows)

Получение объёма памяти, занятой переменными, в байтах:

postgres=# SELECT * FROM pgv_stats() ORDER BY package;
 package | used_memory
---------+-------------
 vars    |       16736
(1 row)

Удаление избранных переменных или пакетов:

postgres=# SELECT pgv_remove('vars', 'int1');
postgres=# SELECT pgv_remove('vars');

Удаление всех пакетов и переменных:

postgres=# SELECT pgv_free();

F.44.5. Авторы

Postgres Professional, Москва, Россия

Пред.	Наверх	След.
F.43. pg_tsparser	Начало	F.45. pg_visibility