F.60. uuid-ossp
Модуль uuid-ossp предоÑтавлÑет функции Ð´Ð»Ñ Ð³ÐµÐ½ÐµÑ€Ð¸Ñ€Ð¾Ð²Ð°Ð½Ð¸Ñ ÑƒÐ½Ð¸Ð²ÐµÑ€Ñальных уникальных идентификаторов (UUID) по одному из неÑкольких Ñтандартных алгоритмов. Ð’ нём также еÑÑ‚ÑŒ функции, выдающие Ñпециальные UUID-конÑтанты.
F.60.1. Функции uuid-ossp
Ð’ Таблице F.35 показаны функции, предназначенные Ð´Ð»Ñ Ð³ÐµÐ½ÐµÑ€Ð°Ñ†Ð¸Ð¸ UUID. Четыре алгоритма Ð´Ð»Ñ Ð³ÐµÐ½ÐµÑ€Ð°Ñ†Ð¸Ð¸ UUID, обозначаемые номерами верÑий 1, 3, 4 и 5, опиÑаны в Ñтандартах ITU-T Rec. X.667, ISO/IEC 9834-8:2005 и RFC 4122. (Ðлгоритма верÑии 2 нет.) Каждый из Ñтих алгоритмов предназначен Ð´Ð»Ñ Ñ€Ð°Ð·Ð»Ð¸Ñ‡Ð½Ñ‹Ñ… Ñфер применениÑ.
Таблица F.35. Функции Ð´Ð»Ñ Ð³ÐµÐ½ÐµÑ€Ð¸Ñ€Ð¾Ð²Ð°Ð½Ð¸Ñ UUID
| Ð¤ÑƒÐ½ÐºÑ†Ð¸Ñ | ОпиÑание |
|---|---|
uuid_generate_v1() | Ðта Ñ„ÑƒÐ½ÐºÑ†Ð¸Ñ Ð³ÐµÐ½ÐµÑ€Ð¸Ñ€ÑƒÐµÑ‚ UUID верÑии 1. Такой UUID включает в ÑÐµÐ±Ñ MAC-Ð°Ð´Ñ€ÐµÑ ÐºÐ¾Ð¼Ð¿ÑŒÑŽÑ‚ÐµÑ€Ð° и текущее времÑ. Заметьте, что UUID такого типа раÑкрывают «личноÑть» компьютера, Ñоздавшего идентификатор, и Ð²Ñ€ÐµÐ¼Ñ Ñтой операции, что может быть неприемлемым Ð´Ð»Ñ Ð¾Ð¿Ñ€ÐµÐ´ÐµÐ»Ñ‘Ð½Ð½Ñ‹Ñ… приложений, где важна конфиденциальноÑÑ‚ÑŒ. |
uuid_generate_v1mc() | Ðта Ñ„ÑƒÐ½ÐºÑ†Ð¸Ñ Ð³ÐµÐ½ÐµÑ€Ð¸Ñ€ÑƒÐµÑ‚ UUID верÑии 1, но вмеÑто реального MAC-адреÑа компьютера иÑпользуетÑÑ Ñлучайный групповой MAC-адреÑ. |
uuid_generate_v3(namespace uuid, name text) | Ðта Ñ„ÑƒÐ½ÐºÑ†Ð¸Ñ Ð³ÐµÐ½ÐµÑ€Ð¸Ñ€ÑƒÐµÑ‚ UUID верÑии 3 Ð´Ð»Ñ Ð·Ð°Ð´Ð°Ð½Ð½Ð¾Ð³Ð¾ проÑтранÑтва имён UUID и указанного имени. ПроÑтранÑтво имён должно задаватьÑÑ Ð¾Ð´Ð½Ð¾Ð¹ из Ñпециальных конÑтант, которые выдаютÑÑ Ñ„ÑƒÐ½ÐºÑ†Ð¸Ñми Ðапример: SELECT uuid_generate_v3(uuid_ns_url(), 'http://www.postgresql.org'); Из параметра name будет получен MD5-хеш, так что из Ñгенерированного UUID Ð½ÐµÐ»ÑŒÐ·Ñ Ð±ÑƒÐ´ÐµÑ‚ воÑÑтановить имÑ. Ð’ генерируемых таким алгоритмом UUID нет Ñлемента ÑлучайноÑти или завиÑимоÑти от окружениÑ, так что они могут быть воÑпроизведены. |
uuid_generate_v4() | Ðта Ñ„ÑƒÐ½ÐºÑ†Ð¸Ñ Ð³ÐµÐ½ÐµÑ€Ð¸Ñ€ÑƒÐµÑ‚ UUID верÑии 4, который вÑецело определÑетÑÑ Ñлучайными чиÑлами. |
uuid_generate_v5(namespace uuid, name text) | Ðта Ñ„ÑƒÐ½ÐºÑ†Ð¸Ñ Ð³ÐµÐ½ÐµÑ€Ð¸Ñ€ÑƒÐµÑ‚ UUID верÑии 5, который похож на верÑию 3, но хеш раÑÑчитываетÑÑ Ð¿Ð¾ алгоритму SHA-1. ВерÑÐ¸Ñ 5 предпочтительнее верÑии 3, так как SHA-1 ÑчитаетÑÑ Ð±Ð¾Ð»ÐµÐµ безопаÑным, чем MD5. |
Таблица F.36. Функции, возвращающие UUID-конÑтанты
uuid_nil() | «Ðулевой» UUID, который не ÑчитаетÑÑ Ð´ÐµÐ¹Ñтвительным UUID. |
uuid_ns_dns() | КонÑтанта, Ð¾Ð±Ð¾Ð·Ð½Ð°Ñ‡Ð°ÑŽÑ‰Ð°Ñ Ð¿Ñ€Ð¾ÑтранÑтво имён DNS Ð´Ð»Ñ UUID. |
uuid_ns_url() | КонÑтанта, Ð¾Ð±Ð¾Ð·Ð½Ð°Ñ‡Ð°ÑŽÑ‰Ð°Ñ Ð¿Ñ€Ð¾ÑтранÑтво имён URL Ð´Ð»Ñ UUID. |
uuid_ns_oid() | КонÑтанта, Ð¾Ð±Ð¾Ð·Ð½Ð°Ñ‡Ð°ÑŽÑ‰Ð°Ñ Ð¿Ñ€Ð¾ÑтранÑтво имён идентификаторов объектов ISO (OID, ISO Object Identifier) Ð´Ð»Ñ UUID. (ЗдеÑÑŒ имеютÑÑ Ð² виду идентификаторы объектов ASN.1, которые никак не ÑвÑзаны Ñ OID, применÑемыми в Postgres Pro.) |
uuid_ns_x500() | КонÑтанта, Ð¾Ð±Ð¾Ð·Ð½Ð°Ñ‡Ð°ÑŽÑ‰Ð°Ñ Ð¿Ñ€Ð¾ÑтранÑтво имён Ñ ÑƒÐ½Ð¸ÐºÐ°Ð»ÑŒÐ½Ñ‹Ð¼Ð¸ именами X.500 Ð´Ð»Ñ UUID. |
F.60.2. Сборка uuid-ossp
Ð’ прошлом Ñтот модуль завиÑел от библиотеки OSSP UUID, что отразилоÑÑŒ в его имени. Ð¥Ð¾Ñ‚Ñ Ð±Ð¸Ð±Ð»Ð¸Ð¾Ñ‚ÐµÐºÑƒ OSSP UUID вÑÑ‘ ещё можно найти по адреÑу http://www.ossp.org/pkg/lib/uuid/, она плохо поддерживаетÑÑ Ð¸ её ÑтановитÑÑ Ð²ÑÑ‘ Ñложнее портировать на новые платформы. ПоÑтому модуль uuid-ossp теперь на некоторых платформах можно Ñобирать без библиотеки OSSP. Во FreeBSD, NetBSD и некоторых других ОС на базе BSD подходÑщие функции Ñ„Ð¾Ñ€Ð¼Ð¸Ñ€Ð¾Ð²Ð°Ð½Ð¸Ñ UUID включены в ÑиÑтемную библиотеку libc. Ð’ Linux, OS X и некоторых других платформах подходÑщие функции предоÑтавлÑÑŽÑ‚ÑÑ Ð±Ð¸Ð±Ð»Ð¸Ð¾Ñ‚ÐµÐºÐ¾Ð¹ libuuid, ÐºÐ¾Ñ‚Ð¾Ñ€Ð°Ñ Ð¸Ð·Ð½Ð°Ñ‡Ð°Ð»ÑŒÐ½Ð¾ пришла из проекта e2fsprogs (Ñ…Ð¾Ñ‚Ñ Ð² Ñовременных диÑтрибутивах Linux она ÑвлÑетÑÑ Ñ‡Ð°Ñтью пакета util-linux-ng). Ð’Ñ‹Ð·Ñ‹Ð²Ð°Ñ configure, передайте ключ --with-uuid=bsd, чтобы иÑпользовать функции BSD, либо --with-uuid=e2fs, чтобы иÑпользовать libuuid из e2fsprogs, либо ключ --with-uuid=ossp, чтобы иÑпользовать библиотеку OSSP UUID. Ð’ конкретной ÑиÑтеме может быть уÑтановлено Ñразу неÑколько библиотек, поÑтому configure не выбирает библиотеку автоматичеÑки.
Примечание
ЕÑли вам нужны только Ñлучайные UUID (верÑии 4), в качеÑтве альтернативы вы можете иÑпользовать функцию gen_random_uuid() из Ð¼Ð¾Ð´ÑƒÐ»Ñ pgcrypto.
F.60.3. Ðвтор
Питер Ðйзентраут <[email protected]>