TO_UUID_OR_ZERO

설명

문자열을 UUID로 변환합니다. 유효하지 않은 텍스트에는 모든 비트가 영인 UUID를 반환하고, NULL 입력에는 NULL을 반환합니다.

별칭

toUUIDOrZero.

사용 시 참고 사항

입력 문자열의 변환 실패 처리는 enable_strict_cast 설정과 무관합니다.

구문

TO_UUID_OR_ZERO(<string>)

매개변수

매개변수	설명
<string>	CHAR, VARCHAR 또는 STRING 값입니다. 하이픈이 포함된 36자 표준 형식의 문자열 또는 32자리 십육진수를 허용하며, 대소문자를 구분하지 않습니다. 중괄호, 앞뒤 공백, 표준 형식과 다른 위치의 하이픈은 허용되지 않습니다.

반환 값

UUID 타입을 반환합니다. 입력이 NULL인 경우에만 NULL을 반환합니다. 모든 비트가 영인 UUID는 NULL과 구별되는 유효한 값입니다.

예제

SELECT TO_UUID_OR_ZERO('550E8400E29B41D4A716446655440000') AS parsed,
       TO_UUID_OR_ZERO('bad') AS invalid,
       TO_UUID_OR_ZERO(NULL) AS null_input;

+--------------------------------------+--------------------------------------+------------+
| parsed                               | invalid                              | null_input |
+--------------------------------------+--------------------------------------+------------+
| 550e8400-e29b-41d4-a716-446655440000 | 00000000-0000-0000-0000-000000000000 | NULL       |
+--------------------------------------+--------------------------------------+------------+

SELECT TO_UUID_OR_ZERO('{550e8400-e29b-41d4-a716-446655440000}') AS braces,
       TO_UUID_OR_ZERO(' 550e8400-e29b-41d4-a716-446655440000') AS leading_space;

+--------------------------------------+--------------------------------------+
| braces                               | leading_space                        |
+--------------------------------------+--------------------------------------+
| 00000000-0000-0000-0000-000000000000 | 00000000-0000-0000-0000-000000000000 |
+--------------------------------------+--------------------------------------+