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          |
+--------+---------------+