Перейти к основному содержимому
Перейти к основному содержимому

UUID

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

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

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

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

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

Пример:

Результат:

В качестве обходного решения UUID можно преобразовать в тип с интуитивно понятным порядком сортировки.

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

Результат:

Генерация UUID

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

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

Пример 1

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

Результат:

Пример 2

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

Ограничения

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

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