TO_IPV6_OR_NULL

설명

문자열 형식의 IPv6 주소를 받아 IPv6 타입의 값을 반환합니다. 입력이 유효하지 않거나 NULL이면 NULL을 반환합니다.

구문

TO_IPV6_OR_NULL(<ipv6_str>)

매개변수

• <ipv6_str>: 문자열 타입의 IPv6 주소

반환 값

반환 타입: IPv6 (Nullable)

반환 값의 의미:

• IPv6 타입의 값을 반환하며, 이 값의 바이너리 표현은 ipv6_string_to_num 함수 반환 값의 바이너리 표현과 같습니다.
• 입력이 NULL이거나 유효하지 않은 IPv6 주소이면 NULL을 반환합니다.

사용 시 참고 사항

• to_ipv6_or_null → IPv6 타입 변환과 동일하며, IPv6 컬럼이 있는 테이블을 생성하는 경우에 적합합니다.
• 유효하지 않은 입력에 대해 예외를 발생시키지 않고 NULL을 반환합니다.

예제

IPv6 텍스트 2001:1b70:a1:610::b102:2를 IPv6 타입으로 변환합니다.

SELECT to_ipv6_or_null('2001:1b70:a1:610::b102:2') as v6;
+-------------------------------+
| v6                            |
+-------------------------------+
| 2001:1b70:a1:610::b102:2      |
+-------------------------------+

입력이 NULL이면 NULL을 반환합니다.

SELECT to_ipv6_or_null(NULL) as v6;
+------+
| v6   |
+------+
| NULL |
+------+

유효하지 않은 IPv6 텍스트는 NULL을 반환합니다.

SELECT to_ipv6_or_null('not-an-ip') as v6;
+------+
| v6   |
+------+
| NULL |
+------+

키워드

TO_IPV6_OR_NULL