Генератор GUID и UUID

UUID v4 — универсальный случайный выбор. После установки обязательных битов версии и варианта остаются 122 случайных бита. Это хороший вариант по умолчанию для независимых клиентов, тестовых данных, публичных идентификаторов ресурсов и систем, которым не нужно, чтобы сам идентификатор раскрывал время.

UUID v7 помещает миллисекундную временную метку Unix в старшие 48 бит, а затем в этой реализации использует случайные биты для оставшегося переменного пространства. Поэтому значения из разных миллисекунд примерно сортируются по времени создания, когда часы идут вперёд, что может помогать при просмотре журналов и некоторых шаблонах индексов.

Версия 7 не обещает строгий порядок создания. Этот генератор не добавляет монотонный счётчик или подпоследовательность внутри миллисекунды. Значения, созданные в одной миллисекунде, содержат случайные хвостовые биты, а часы устройства, ушедшие назад, могут нарушить видимый порядок.

Привычная форма с дефисами — это текстовое представление 16 байтов. Пять групп имеют 8, 4, 4, 4 и 12 шестнадцатеричных цифр, но группы не являются отдельными случайными строками. Полубайт версии находится в начале третьей группы, а вариант RFC — в первой шестнадцатеричной цифре четвёртой группы.

Фиксированный публичный пример v4 550e8400-e29b-41d4-a716-446655440000 имеет 4 в позиции версии и a в позиции варианта RFC. Цифра варианта может быть 8, 9, a или b для варианта RFC, потому что ведущие биты равны 10. Эти позиции объясняют, как проверка распознаёт поля; они не раскрывают, были ли остальные биты созданы случайно. Значение, написанное вручную, может имитировать тот же шаблон.

Проверка также распознаёт значения nil и max как специальные сентинелы. Nil — все нулевые биты; max — все единичные биты. Они могут быть структурно значимыми в протоколе, но не являются случайно созданными идентификаторами и не должны приниматься за обычные уникальные значения.

Для UUID v7 ClockTools берёт одну миллисекундную временную метку часов устройства для набора и записывает её в первые шесть байтов каждого значения. Каждое значение всё равно получает новые случайные байты до фиксации битов версии и варианта. Если значение часов выходит за диапазон 48-битного поля временной метки v7, оно отклоняется и создание завершается ошибкой; временная метка не обрезается до 48 бит.

Счёт уникальности локален для текущего созданного набора. Генератор использует Set и ограниченные повторные попытки, чтобы не возвращать дубликаты случайного вывода внутри запрошенного набора. Он не обращается к глобальному реестру, базе данных, другой вкладке или значениям, созданным вчера.

Вероятность всё равно не является бизнес-правилом. Если дубликаты ключей имели бы последствия, обеспечивайте уникальность там, где идентификаторы хранятся, и обрабатывайте ошибки конфликтов там же. Создание не может знать состояние вашего приложения. Неудачное новое создание очищает предыдущий набор, а не оставляет старый результат выглядеть как успешный новый запрос, поэтому копируйте нужные фикстуры до экспериментов со следующим набором.

Формат текста полезен, когда получатель ожидает печатный UUID. Строчные буквы — канонический браузерный вывод, который использует генератор, прописные буквы нужны системам с таким соглашением, фигурные скобки и кавычки являются обёртками, без дефисов — компактная 32-шестнадцатеричная форма, а URN добавляет префикс urn:uuid:.

Кодирование — другой слой. Обычный текст сохраняет выбранный формат текста. URL-кодирование процентно кодирует этот текст. Base64 и Base64 URL игнорируют обёртку формата текста и кодируют 16 исходных байтов в сетевом порядке; переключатель формата отключён для этих кодировок, потому что фигурные скобки или прописные буквы не являются частью байтового значения.

Формат вывода решает, как расположены несколько значений. По одному в строке легче всего просматривать. CSV создаёт одну строку с полями через запятую. Массив JSON полезен для фикстур и кода. Значения SQL создают строки в кавычках, разделённые запятыми; это список значений, а не полная SQL-команда.

Для фиксированного UUID 550e8400-e29b-41d4-a716-446655440000 байтовые кодировки — VQ6EAOKbQdSnFkRmVUQAAA== в Base64 и VQ6EAOKbQdSnFkRmVUQAAA в Base64 URL. Обычный текст имеет 36 символов, компактная шестнадцатеричная форма — 32, Base64 с заполнением — 24, а эта форма Base64 URL без заполнения — 22. Они представляют одни и те же 16 байтов. Кодирование 36 напечатанных ASCII-символов вместо этого кодировало бы другой ввод и не дало бы таких байтовых результатов.

RFC 4648 описывает алфавиты Base64 и URL-безопасный алфавит. URL-безопасная форма заменяет плюс и косую черту, используемые обычным Base64, и в этом инструменте убирает конечное заполнение. Регистр всё равно важен в любом алфавите Base64; не приводите значение Base64 к нижнему регистру, как если бы это был шестнадцатеричный текст UUID. URL-кодирование — третий вариант: фигурные скобки становятся %7B и %7D, а канонические буквы UUID, цифры и дефисы не требуют процентной замены.

Порядок байтов — часть контракта обмена. Эта страница кодирует байты в том же сетевом порядке, что и канонический шестнадцатеричный текст. Документация Microsoft Guid.ToByteArray показывает, что её байтовый вывод без параметров переставляет первые три группы полей относительно текста. Если получатель использует такое представление, сравнивайте задокументированный порядок байтов явно; согласие о том, что оба поля содержат GUID, не доказывает, что их строки Base64 совпадут.

Кавычки тоже накладываются слоями. Формат текста Кавычки добавляет символы кавычек к каждому значению; формат JSON затем экранирует эти символы внутри своей строки, а CSV экранирует их внутри поля. Дополнительные экранированные кавычки могут быть корректной сериализацией, но всё равно ошибкой для получателя, которому нужен UUID без обёртки. Строчные буквы плюс Обычный текст — понятная отправная точка для импорта JSON и CSV. Значения SQL используют строки в одинарных кавычках; добавляйте окружающую структуру запроса отдельно и предпочитайте параметризованные запросы приложения вместо вставки созданных строк в живой запрос.

Допустимая структура означает, что текст подходит под поддерживаемую форму UUID и его поля версии и варианта можно прочитать. Она не доказывает, что идентификатор был создан ClockTools, Web Crypto, конкретным сервисом или именно в расшифрованное время v7.

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

Проверка принимает компактную шестнадцатеричную форму или текст с дефисами и может удалить типичные обёртки вроде фигурных скобок, круглых скобок, кавычек или префикса urn:uuid: перед проверкой. Она не декодирует Base64, Base64 URL или URL-кодированный ввод для проверки; декодируйте эти представления в принимающей системе до структурного разбора.

Разбор принимает один идентификатор за раз, а не экспортированную строку CSV или массив JSON. Взять созданное значение вставляет первый исходный UUID из текущего набора, а не его закодированное отображение, поэтому набор можно проверить даже при выбранном Base64. Проверка распознаёт поддерживаемые RFC-версии с 1 по 8, но создание предлагает только v4 и v7. Предупреждение о неподдерживаемом варианте всё ещё может показать нормализованную форму; это не успешная проверка RFC и не разрешение переписывать поля протокола источника.

Ошибка количества означает, что счёт не является целым числом от 1 до 1000. Инструмент не округляет, не ограничивает и не уменьшает запрос молча. Ошибка источника случайности означает, что Web Crypto не предоставил пригодные случайные байты, поэтому идентификаторы не были созданы.

Ошибка кодирования может возникнуть, когда браузеру не хватает API, нужного для выбранного кодирования вывода. Переключитесь на Обычный текст, чтобы вернуть базовый набор, или попробуйте другой браузер. Ошибка создания отличается: она отбрасывает набор вместо сохранения частичных значений. Ошибки буфера обмена, отправки и скачивания не создают идентификаторы заново. Когда доступ к экспорту не работает, выделите видимый вывод вручную, если он доступен; проверьте загрузки, прежде чем считать начатый файл сохранённым.

Не вставляйте рабочие секреты в отчёт по UUID. UUID может быть публичным, приватным или чувствительным к безопасности в зависимости от того, как его использует ваша система, но сама форма не делает его паролем. Для bearer-токенов, сбросов пароля или учётных данных API используйте специализированный генератор секретов и управление жизненным циклом.