5.0 KiB
| toc_priority | toc_title |
|---|---|
| 53 | Функции для работы с UUID |
Функции для работы с UUID
generateUUIDv4
Генерирует идентификатор UUID версии 4.
generateUUIDv4()
Возвращаемое значение
Значение типа UUID.
Пример использования
Этот пример демонстрирует, как создать таблицу с UUID-колонкой и добавить в нее сгенерированный UUID.
CREATE TABLE t_uuid (x UUID) ENGINE=TinyLog
INSERT INTO t_uuid SELECT generateUUIDv4()
SELECT * FROM t_uuid
┌────────────────────────────────────x─┐
│ f4bf890f-f9dc-4332-ad5c-0c18e73f28e9 │
└──────────────────────────────────────┘
toUUID (x)
Преобразует значение типа String в тип UUID.
toUUID(String)
Возвращаемое значение
Значение типа UUID.
Пример использования
SELECT toUUID('61f0c404-5cb3-11e7-907b-a6006ad3dba0') AS uuid
┌─────────────────────────────────uuid─┐
│ 61f0c404-5cb3-11e7-907b-a6006ad3dba0 │
└──────────────────────────────────────┘
toUUIDOrNull (x)
Принимает строку, и пытается преобразовать в тип UUID. При неудаче возвращает NULL.
toUUIDOrNull(String)
Возвращаемое значение
Значение типа Nullable(UUID).
Пример использования
SELECT toUUIDOrNull('61f0c404-5cb3-11e7-907b-a6006ad3dba0T') AS uuid
┌─uuid─┐
│ ᴺᵁᴸᴸ │
└──────┘
toUUIDOrZero (x)
Принимает строку, и пытается преобразовать в тип UUID. При неудаче возвращает нулевой UUID.
toUUIDOrZero(String)
Возвращаемое значение
Значение типа UUID.
Пример использования
SELECT toUUIDOrZero('61f0c404-5cb3-11e7-907b-a6006ad3dba0T') AS uuid
┌─────────────────────────────────uuid─┐
│ 00000000-0000-0000-0000-000000000000 │
└──────────────────────────────────────┘
UUIDStringToNum
Принимает строку, содержащую 36 символов в формате xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx, и возвращает в виде набора байт в FixedString(16).
UUIDStringToNum(String)
Возвращаемое значение
FixedString(16)
Пример использования
SELECT
'612f3c40-5d3b-217e-707b-6a546a3d7b29' AS uuid,
UUIDStringToNum(uuid) AS bytes
┌─uuid─────────────────────────────────┬─bytes────────────┐
│ 612f3c40-5d3b-217e-707b-6a546a3d7b29 │ a/<@];!~p{jTj={) │
└──────────────────────────────────────┴──────────────────┘
UUIDNumToString
Принимает значение типа FixedString(16). Возвращает строку из 36 символов в текстовом виде.
UUIDNumToString(FixedString(16))
Возвращаемое значение
Значение типа String.
Пример использования
SELECT
'a/<@];!~p{jTj={)' AS bytes,
UUIDNumToString(toFixedString(bytes, 16)) AS uuid
┌─bytes────────────┬─uuid─────────────────────────────────┐
│ a/<@];!~p{jTj={) │ 612f3c40-5d3b-217e-707b-6a546a3d7b29 │
└──────────────────┴──────────────────────────────────────┘