본문으로 건너뛰기
최종 수정: 에

TO_IPV4_OR_DEFAULT

설명​

IPv4 주소의 문자열 표현을 받아 IPv4 타입의 값을 반환합니다. 입력이 잘못되었거나 NULL이면 기본값 0.0.0.0을 반환합니다.

구문​

TO_IPV4_OR_DEFAULT(<ipv4_str>)

매개변수​

  • <ipv4_str>: 문자열 타입의 IPv4 주소

반환 값​

반환 타입: IPv4

반환 값의 의미:

  • IPv4 타입의 값을 반환하며, 이 값의 바이너리 표현은 ipv4_string_to_num의 반환 값과 동일합니다.
  • 입력이 NULL이거나 유효하지 않은 IPv4 주소이면 0.0.0.0을 반환합니다.

사용 시 참고 사항​

  • to_ipv4_or_default → IPv4 타입 변환과 동일하며, IPv4 컬럼을 포함하는 테이블을 생성하는 경우에 적합합니다.
  • 잘못된 입력에 대해 예외를 발생시키지 않고 기본값 0.0.0.0을 반환합니다.

예제​

IPv4 텍스트 255.255.255.255를 IPv4 타입으로 변환합니다.

SELECT to_ipv4_or_default('255.255.255.255') as v4;
+-----------------+
| v4              |
+-----------------+
| 255.255.255.255 |
+-----------------+

입력이 NULL이면 기본값 0.0.0.0을 반환합니다.

SELECT to_ipv4_or_default(NULL) as v4;
+---------+
| v4      |
+---------+
| 0.0.0.0 |
+---------+

유효하지 않은 IPv4 텍스트를 입력하면 기본값 0.0.0.0을 반환합니다.

SELECT to_ipv4_or_default('256.1.1.1') as v4;
+---------+
| v4      |
+---------+
| 0.0.0.0 |
+---------+

키워드​

TO_IPV4_OR_DEFAULT

Report issue