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

TO_UUID_OR_NULL

Описание​

Преобразует строку в UUID; возвращает NULL для некорректного текста или входного значения NULL.

Псевдоним​

toUUIDOrNull.

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

Обработка ошибок преобразования входной строки не зависит от enable_strict_cast.

Синтаксис​

TO_UUID_OR_NULL(<string>)

Параметры​

ПараметрОписание
<string>Значение типа CHAR, VARCHAR или STRING. Принимает каноническую строку длиной 36 символов с дефисами или строку из 32 шестнадцатеричных цифр; допускаются буквы в любом регистре. Фигурные скобки, пробельные символы в начале или конце строки и другое расположение дефисов недопустимы.

Возвращаемое значение​

Возвращает значение типа UUID. Возвращает NULL для некорректного текста или входного значения NULL.

Пример​

SELECT TO_UUID_OR_NULL('550E8400E29B41D4A716446655440000') AS parsed,
       TO_UUID_OR_NULL('bad') AS invalid,
       TO_UUID_OR_NULL(NULL) AS null_input;
+--------------------------------------+---------+------------+
| parsed                               | invalid | null_input |
+--------------------------------------+---------+------------+
| 550e8400-e29b-41d4-a716-446655440000 | NULL    | NULL       |
+--------------------------------------+---------+------------+
SELECT TO_UUID_OR_NULL('{550e8400-e29b-41d4-a716-446655440000}') AS braces,
       TO_UUID_OR_NULL(' 550e8400-e29b-41d4-a716-446655440000') AS leading_space;
+--------+---------------+
| braces | leading_space |
+--------+---------------+
| NULL   | NULL          |
+--------+---------------+
Report issue