UUID

Универсальный уникальный идентификатор (UUID) — это 16-байтовое значение, используемое для идентификации записей. Подробную информацию о UUID см. в статье на Википедии.

Хотя существуют разные варианты UUID, например UUIDv4 и UUIDv7 (см. здесь), ClickHouse не проверяет, соответствуют ли вставленные значения UUID какому-либо конкретному варианту. Внутри ClickHouse UUID рассматриваются как последовательность из 16 случайных байт с представлением 8-4-4-4-12 на уровне SQL.

Пример значения UUID:

61f0c404-5cb3-11e7-907b-a6006ad3dba0

UUID по умолчанию состоит из одних нулей. Он используется, например, когда вставляется новая запись, но для столбца с типом UUID не задано значение:

00000000-0000-0000-0000-000000000000

Примечание

По историческим причинам UUID сортируются по своей второй половине.

Хотя для значений UUIDv4 это приемлемо, это может ухудшать производительность при использовании столбцов UUIDv7 в определениях первичного индекса (их использование в сортировочных ключах или ключах партиционирования допустимо). Более конкретно, значения UUIDv7 состоят из временной метки в первой половине и счетчика во второй половине. Сортировка UUIDv7 в разреженных индексах первичного ключа (то есть по первым значениям каждой гранулы индекса) будет, таким образом, выполняться по полю счетчика. Если предположить, что UUID сортировались бы по первой половине (временной метке), то на этапе анализа индекса по первичному ключу в начале выполнения запросов ожидается отсечение всех меток во всех, кроме одной, частях. Однако при сортировке по второй половине (счетчику) ожидается, что как минимум одна метка будет возвращена для всех частей, что приводит к ненужным обращениям к диску.

Пример:

CREATE TABLE tab (uuid UUID) ENGINE = MergeTree PRIMARY KEY (uuid);

INSERT INTO tab SELECT generateUUIDv7() FROM numbers(50);
SELECT * FROM tab;

Результат:

┌─uuid─────────────────────────────────┐
│ 36a0b67c-b74a-4640-803b-e44bb4547e3c │
│ 3a00aeb8-2605-4eec-8215-08c0ecb51112 │
│ 3fda7c49-282e-421a-85ab-c5684ef1d350 │
│ 16ab55a7-45f6-44a8-873c-7a0b44346b3e │
│ e3776711-6359-4f22-878d-bf290d052c85 │
│                [...]                 │
│ 9eceda2f-6946-40e3-b725-16f2709ca41a │
│ 03644f74-47ba-4020-b865-be5fd4c8c7ff │
│ ce3bc93d-ab19-4c74-b8cc-737cb9212099 │
│ b7ad6c91-23d6-4b5e-b8e4-a52297490b56 │
│ 06892f64-cc2d-45f3-bf86-f5c5af5768a9 │
└──────────────────────────────────────┘

В качестве обходного решения UUID можно преобразовать в метку времени, извлечённую из второй половины:

CREATE TABLE tab (uuid UUID) ENGINE = MergeTree PRIMARY KEY (UUIDv7ToDateTime(uuid));
-- Or alternatively:                      [...] PRIMARY KEY (toStartOfHour(UUIDv7ToDateTime(uuid)));

INSERT INTO tab SELECT generateUUIDv7() FROM numbers(50);
SELECT * FROM tab;

ORDER BY (UUIDv7ToDateTime(uuid), uuid)

Генерация UUID

ClickHouse предоставляет функцию generateUUIDv4 для генерации случайных UUID версии 4.

Пример использования

Пример 1

Этот пример демонстрирует создание таблицы со столбцом UUID и вставку значения в таблицу.

CREATE TABLE t_uuid (x UUID, y String) ENGINE=TinyLog

INSERT INTO t_uuid SELECT generateUUIDv4(), 'Example 1'

SELECT * FROM t_uuid

Результат:

┌────────────────────────────────────x─┬─y─────────┐
│ 417ddc5d-e556-4d27-95dd-a34d84e46a50 │ Example 1 │
└──────────────────────────────────────┴───────────┘

Пример 2

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

INSERT INTO t_uuid (y) VALUES ('Example 2')

SELECT * FROM t_uuid

┌────────────────────────────────────x─┬─y─────────┐
│ 417ddc5d-e556-4d27-95dd-a34d84e46a50 │ Example 1 │
│ 00000000-0000-0000-0000-000000000000 │ Example 2 │
└──────────────────────────────────────┴───────────┘

Ограничения

Тип данных UUID поддерживает только те функции, которые также поддерживает тип данных String (например, min, max и count).

Тип данных UUID не поддерживает арифметические операции (например, abs) и агрегатные функции, такие как sum и avg.