uuid-ossp. Функции для генерирования UUID#

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

Связанные компоненты: отсутствуют.

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

Использование модуля позволяет генерировать универсальные уникальные идентификаторы (UUID) по одному из нескольких стандартных алгоритмов и специальные UUID-константы.

Модуль uuid-osspнеобходим только при наличии особых потребностей, для удовлетворения которых не хватает стандартного функционала в ядре PostgreSQL. Встроенные в ядро способы генерирования UUID описаны в UUID Functions.

В следующей таблице перечислены функции, предназначенные для генерации UUID. Четыре алгоритма для генерации UUID, обозначаемые номерами версий 1, 3, 4 и 5, описаны в стандартах ITU-T Rec. X.667, ISO/IEC 9834-8:2005 и RFC 4122. Алгоритма версии 2 нет. Каждый из этих алгоритмов предназначен для различных сфер применения.

Функции, возвращающие UUID-константы:

Доработка#

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

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

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

Установка#

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

CREATE EXTENSION "uuid-ossp" SCHEMA ext;

Настройка#

В прошлом этот модуль зависел от библиотеки OSSP UUID. Этот факт отразился в имени модуля. Библиотеку OSSP UUID можно найти по адресу http://www.ossp.org/pkg/lib/uuid/. Библиотека недостаточно поддерживается и ее сложно портировать на новые платформы. Поэтому модуль uuid-ossp теперь на некоторых платформах можно собирать без библиотеки OSSP.

Во FreeBSD и некоторых других ОС на базе BSD подходящие функции формирования UUID включены в системную библиотеку libc.

В Linux, macOS и некоторых других платформах подходящие функции предоставляются библиотекой libuuid, которая изначально поступила из проекта e2fsprogs. В современных дистрибутивах Linux библиотека libuuid является частью пакета util-linux-ng.

При вызове configure необходимо передать ключи:

• --with-uuid=bsd для использования функции BSD;

• --with-uuid=e2fs для использования libuuid из e2fsprogs;

• --with-uuid=ossp для использования библиотеки OSSP UUID.

В конкретной системе может быть установлено сразу несколько библиотек, поэтому configure не выбирает библиотеку автоматически.

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

SELECT uuid_generate_v1();

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

           uuid_generate_v1           
--------------------------------------
 2193434e-c7a8-11ed-b3d2-0050560a7d0b
(1 row)

Функция uuid_generate_v3:

Из параметра name будет получен MD5-хеш, так что из сгенерированного UUID нельзя будет восстановить имя. В генерируемых таким алгоритмом UUID нет элемента случайности или зависимости от окружения, так что они могут быть воспроизведены.

SELECT uuid_generate_v3(uuid_ns_url(), 'http://www.postgresql.org');

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

           uuid_generate_v3           
--------------------------------------
 cf16fe52-3365-3a1f-8572-288d8d2aaa46
(1 row)

Создание таблицы со столбцом UUID:

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

CREATE TABLE contacts (
    contact_id uuid DEFAULT uuid_generate_v4 (),
    first_name      VARCHAR NOT NULL,
    last_name       VARCHAR NOT NULL,
    email           VARCHAR NOT NULL,
    phone           VARCHAR,
    PRIMARY KEY (contact_id)
);

В этом утверждении типом данных столбца contact_id является UUID. Столбец contact_id имеет значения по умолчанию, предоставляемые функцией uuid_generate_v4(), поэтому всякий раз, когда вставлена новую строку без указания значения для contact_id, PostgreSQL вызовет функцию uuid_generate_v4() для генерации для нее значения.

Вставить некоторые данные в таблицу contacts:

INSERT INTO contacts (
    first_name,
    last_name,
    email,
    phone
)
VALUES
    (
        'John',
        'Smith',
        'john.smith@example.com',
        '408-237-2345'
    ),
    (
        'Jane',
        'Smith',
        'jane.smith@example.com',
        '408-237-2344'
    ),
    (
        'Alex',
        'Smith',
        'alex.smith@example.com',
        '408-237-2343'
    );

Выполнить запрос ко всем строкам в таблице contacts, используя инструкцию SELECT:

SELECT * FROM contacts;

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

              contact_id              | first_name | last_name |         email          |    phone     
--------------------------------------+------------+-----------+------------------------+--------------
 4b92898b-ac3e-4120-b623-6b168294e442 | John       | Smith     | john.smith@example.com | 408-237-2345
 34d4babb-e443-4bea-9005-93806e9a14d5 | Jane       | Smith     | jane.smith@example.com | 408-237-2344
 f5b1fd1f-4515-415f-a3fd-56c31d56bc37 | Alex       | Smith     | alex.smith@example.com | 408-237-2343
(3 rows)

В результате столбец contact_id заполнен значениями UUID, сгенерированными функцией uuid_generate_v4().

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

Исходная документация PosgreSQL по модулю uuid-ossp: https://www.postgresql.org/docs/15/uuid-ossp.html.