IPv4CIDRToRange
도입 버전: v20.1.0 CIDR(Classless Inter-Domain Routing) prefix 길이가 지정된 IPv4 주소를 받아, 해당 서브넷의 주소 범위를 2개의 IPv4 값으로 이루어진 튜플로 반환합니다. 즉, 해당 서브넷의 첫 번째 주소와 마지막 주소입니다. IPv6 버전은IPv6CIDRToRange를 참조하십시오.
구문
Tuple(IPv4, IPv4)
예시
사용 예시
Query
Response
IPv4NumToString
도입 버전: v1.1.0 32비트 정수를 점으로 구분된 10진 표기법(A.B.C.D 포맷)의 IPv4 주소 문자열로 변환합니다. 입력값은 빅 엔디언 바이트 순서로 해석합니다. 구문INET_NTOA
인수
num— UInt32 값으로 표현된 IPv4 주소입니다.UInt32
0을 반환합니다. String
예시
사용 예시
Query
Response
IPv4NumToStringClassC
도입 버전: v1.1.0 32비트 정수를 점으로 구분된 10진 표기법(A.B.C.D 포맷)의 IPv4 주소 문자열로 변환합니다.IPv4NumToString과 비슷하지만 마지막 옥텟 대신 xxx를 사용합니다.
구문
num— UInt32 값으로 표현된 IPv4 주소입니다.UInt32
String
예시
집계를 사용한 기본 예시
Query
Response
IPv4StringToNum
도입 버전: v1.1.0 점으로 구분된 10진 표기법(A.B.C.D 포맷)의 IPv4 주소 문자열을 해당하는 32비트 정수 값으로 변환합니다. (IPv4NumToString의 반대 기능입니다.)
IPv4 주소 포맷이 올바르지 않으면 예외가 발생합니다.
구문
INET_ATON
인수
string— IPv4 주소 문자열입니다.String
UInt32
예시
사용 예시
Query
Response
IPv4StringToNumOrDefault
도입 버전: v22.3.0 점으로 구분된 10진 표기법(A.B.C.D 포맷)의 IPv4 주소 문자열을 해당하는 32비트 정수 값으로 변환합니다. 단, IPv4 주소 형식이 올바르지 않으면0을 반환합니다.
구문
string— IPv4 주소 문자열입니다.String
0을 반환합니다. UInt32
예시
유효하지 않은 주소 예시
Query
Response
IPv4StringToNumOrNull
도입 버전: v22.3.0 32비트 정수를 점으로 구분된 10진 표기법(A.B.C.D 포맷)의 IPv4 주소 문자열로 변환합니다. 단, IPv4 주소 포맷이 올바르지 않으면NULL을 반환합니다.
구문
string— IPv4 주소 문자열입니다.String
NULL을 반환합니다. Nullable(UInt32)
예시
유효하지 않은 주소 예시
Query
Response
IPv4ToIPv6
도입 버전: v1.1.0 (빅 엔디언) 32비트 숫자를 IPv4 주소로 해석한 후, 이를FixedString(16) 포맷의 해당 IPv6 주소로 해석합니다.
구문
x— IPv4 주소.UInt32
FixedString(16)
예시
사용 예시
Query
Response
IPv6CIDRToRange
도입 버전: v20.1.0 CIDR(Classless Inter-Domain Routing) prefix 길이가 지정된 IPv6 주소를 받아, 해당 서브넷의 주소 범위를 가장 낮은 주소와 가장 높은 주소로 이루어진 두 개의 IPv6 값 튜플로 반환합니다. IPv4 버전은IPv4CIDRToRange를 참조하십시오.
구문
Tuple(IPv6, IPv6)
예시
사용 예시
Query
Response
IPv6NumToString
도입 버전: v1.1.0 IPv6 주소를 바이너리 형식(FixedString(16))에서 표준 텍스트 표현으로 변환합니다. IPv4-mapped IPv6 주소는::ffff:111.222.33.44 형식으로 표시됩니다.
구문
INET6_NTOA
인수
x— 바이너리 형식의 IPv6 주소.FixedString(16)또는IPv6
String
예시
사용 예시
Query
Response
Query
Response
Query
Response
IPv6StringToNum
도입 버전: v1.1.0 IPv6 주소를 표준 텍스트 표현에서 바이너리 형식(FixedString(16))으로 변환합니다.
::ffff:111.222.33.44. 형식의 IPv4-mapped IPv6 주소도 허용합니다.
IPv6 주소 형식이 올바르지 않으면 예외가 발생합니다.
입력 문자열에 유효한 IPv4 주소가 포함되어 있으면 해당 주소에 대응하는 IPv6 표현을 반환합니다.
HEX는 대문자와 소문자를 모두 사용할 수 있습니다.
구문
INET6_ATON
인수
string— IPv6 주소 문자열.String
FixedString(16)
예시
기본 예시
Query
Response
IPv6StringToNumOrDefault
도입 버전: v22.3.0 IPv6 주소를 표준 텍스트 표현에서 바이너리 형식(FixedString(16))으로 변환합니다.
::ffff:111.222.33.44. 포맷의 IPv4-mapped IPv6 주소를 허용합니다.
IPv6 주소의 포맷이 올바르지 않으면 기본값 ::를 반환합니다.
구문
string— IPv6 주소 문자열입니다.String
FixedString(16)입니다. FixedString(16)
예시
유효하지 않은 주소에 대한 기본 예시
Query
Response
IPv6StringToNumOrNull
도입 버전: v22.3.0 IPv6 주소를 표준 텍스트 표현에서 바이너리 형식(FixedString(16))으로 변환합니다.
::ffff:111.222.33.44. 형식의 IPv4-mapped IPv6 주소를 허용합니다.
IPv6 주소 포맷이 올바르지 않으면 NULL을 반환합니다.
구문
string— IPv6 주소 문자열입니다.String
NULL을 반환합니다. Nullable(FixedString(16))
예시
유효하지 않은 주소를 사용하는 기본 예시
Query
Response
cutIPv6
도입 버전: v1.1.0 바이너리 형식의 IPv6 주소를 담은FixedString(16) 값을 받습니다.
지정된 바이트 수를 제거한 주소를 텍스트 포맷의 문자열로 반환합니다.
구문
x— 바이너리 형식의 IPv6 주소입니다.FixedString(16)또는IPv6bytesToCutForIPv6— IPv6에서 잘라낼 바이트 수입니다.UInt8bytesToCutForIPv4— IPv4에서 잘라낼 바이트 수입니다.UInt8
String
예시
사용 예시
Query
Response
ipcryptDecrypt
도입 버전: v26.10.0ipcryptEncrypt로 암호화한 IP 주소를 동일한 개인 키로 복호화합니다.
입력이 IPv4/IPv6이면 IPv6를 반환하고, String 입력이면 String을 반환합니다(참조 구현과 동일하게 IPv4 매핑 결과는 IPv4 텍스트로 기록됩니다).
구문
encrypted_ip— 복호화할 암호화된 IP 주소입니다.IPv4또는IPv6또는Stringkey— 16바이트 암호화 키입니다(원시 바이트 또는 16진수 문자 32자). 상수여야 합니다.String또는FixedString
IPv6 또는 String
예시
암호화 후 복호화하는 왕복 예시
Query
Response
ipcryptEncrypt
도입 버전: v26.10.0 16바이트 키와 결정적 형식 보존 암호화(format-preserving encryption)를 사용하여 IP 주소를 암호화합니다. IPv4/IPv6 입력에 대해서는 IPv6를 반환하고, String 입력에 대해서는 String을 반환합니다(참조 구현과 마찬가지로 IPv4 매핑 결과는 IPv4 텍스트로 기록됩니다). 구문ip— 암호화할 IP 주소입니다.IPv4또는IPv6또는Stringkey— 16바이트 암호화 키입니다(원시 바이트 또는 16진수 문자 32자). 상수여야 합니다.String또는FixedString
IPv6 또는 String
예시
IPv4 주소 암호화
Query
Response
ipcryptPrefixDecrypt
도입 버전: v26.10.0ipcryptPrefixEncrypt로 암호화한 IP 주소를 동일한 개인 키로 복호화합니다.
반환 유형은 입력과 동일한 주소 유형을 유지합니다. 즉, IPv4는 IPv4로, IPv6는 IPv6로 반환됩니다.
구문
encrypted_ip— 복호화할 암호화된 IP 주소입니다.IPv4또는IPv6또는Stringkey— 32바이트 암호화 키입니다(원시 바이트 또는 16진수 문자 64개). 상수여야 합니다.String또는FixedString
IPv4 또는 IPv6 또는 String
예시
접두사 보존 방식으로 암호화한 후 복호화하는 왕복 예시
Query
Response
ipcryptPrefixEncrypt
도입 버전: v26.10.0 32바이트 키를 사용하여 접두사 보존 암호화(prefix-preserving encryption) 방식으로 IP 주소를 암호화합니다. 네트워크 접두사가 같은 주소들은 암호화된 후에도 동일한 접두사를 공유합니다. 반환 유형은 입력 주소의 종류를 그대로 유지합니다. 즉, IPv4는 IPv4로, IPv6는 IPv6로 반환됩니다. 구문ip— 암호화할 IP 주소입니다.IPv4또는IPv6또는Stringkey— 32바이트 암호화 키(원시 바이트 또는 16진수 문자 64개)입니다. 상수여야 합니다.String또는FixedString
IPv4 또는 IPv6 또는 String
예시
IPv4 접두사 보존 암호화
Query
Response
isIPAddressInRange
도입 버전: v21.4.0 IP 주소가 Classless Inter-Domain Routing (CIDR) 표기법으로 나타낸 네트워크에 포함되는지 확인합니다. 이 함수는 문자열로 표현된 IPv4 및 IPv6 주소(및 네트워크)를 모두 허용합니다. 주소의 IP 버전과 CIDR의 IP 버전이 일치하지 않으면0을 반환합니다.
구문
1을 반환하고, 그렇지 않으면 0을 반환합니다. UInt8
예시
범위에 포함되는 IPv4 주소
Query
Response
Query
Response
Query
Response
isIPv4String
도입 버전: v21.1.0 입력 문자열이 IPv4 주소인지 판별합니다. IPv6 버전은isIPv6String을 참조하십시오.
구문
string— 확인할 IP 주소 문자열입니다.String
string이 IPv4 주소이면 1을 반환하고, 그렇지 않으면 0을 반환합니다. UInt8
예시
사용 예시
Query
Response
isIPv6String
도입 버전: v21.1.0 입력 문자열이 IPv6 주소인지 판별합니다. IPv4 버전은isIPv4String을 참조하십시오.
구문
string— 확인할 IP 주소 문자열입니다.String
string이 IPv6 주소이면 1을 반환하고, 그렇지 않으면 0을 반환합니다. UInt8
예시
사용 예시
Query
Response
toIPv4
도입 버전: v20.1.0 문자열 또는 IPv4 주소의 UInt32 형식을 IPv4 타입으로 변환합니다.IPv4StringToNum 및 IPv4NumToString 함수와 유사하지만, 입력 인수로 문자열과 부호 없는 정수 데이터 타입을 모두 지원합니다.
구문
x— IPv4 주소를 나타내는String또는UInt8/16/32
IPv4
예시
사용 예시
Query
Response
Query
Response
Query
Response
toIPv4OrDefault
도입 버전: v22.3.0 IPv4 주소를 나타내는 문자열 또는 UInt32 형식을IPv4 타입으로 변환합니다.
IPv4 주소의 포맷이 올바르지 않으면 0.0.0.0(0 IPv4) 또는 지정된 기본 IPv4 값을 반환합니다.
구문
IPv4
예시
유효한 IPv4 문자열과 올바르지 않은 IPv4 문자열
Query
Response
toIPv4OrNull
도입 버전: v22.3.0 입력 값을IPv4 유형의 값으로 변환하며, 오류가 발생한 경우 NULL을 반환합니다.
toIPv4와 비슷하지만, 변환 오류 시 예외를 발생시키는 대신 NULL을 반환합니다.
지원되는 인수:
- 점으로 구분된 10진 표기법의 IPv4 주소 문자열 표현.
- IPv4 주소의 정수 표현.
NULL 반환):
- 잘못된 IP 주소 포맷.
- IPv6 주소.
- 범위를 벗어난 값.
- 형식이 잘못된 주소.
NULL을 반환합니다. IPv4 또는 NULL
예시
사용 예시
Query
Response
toIPv4OrZero
도입 버전: v23.1.0 입력 값을 IPv4 타입의 값으로 변환하지만, 오류가 발생하면 0.0.0.0 IPv4 주소를 반환합니다.toIPv4와 비슷하지만, 변환 오류 시 예외를 발생시키는 대신 0 IPv4 주소(0.0.0.0)를 반환합니다.
지원되는 인수:
- 점으로 구분된 10진 표기법의 IPv4 주소 문자열 표현입니다.
- IPv4 주소의 정수 표현입니다.
- 잘못된 IP 주소 포맷입니다.
- IPv6 주소입니다.
- 범위를 벗어난 값입니다.
0.0.0.0)를 반환합니다. IPv4
예시
사용 예시
Query
Response
toIPv6
도입 버전: v20.1.0 문자열 또는 IPv6 주소를 나타내는UInt128 형식을 IPv6 타입으로 변환합니다.
문자열의 경우 IPv6 주소 형식이 잘못되면 빈 값을 반환합니다.
IPv6 주소를 바이너리 형식(즉, FixedString(16))으로 변환하거나, 바이너리 형식에서 IPv6 주소로 변환하는 IPv6StringToNum 및 IPv6NumToString 함수와 유사합니다.
입력 문자열에 유효한 IPv4 주소가 포함되어 있으면 해당 IPv4 주소에 해당하는 IPv6 값을 반환합니다.
구문
IPv6
예시
사용 예시
Query
Response
Query
Response
toIPv6OrDefault
도입 버전: v22.3.0 문자열 또는 UInt128 형식의 IPv6 주소를IPv6 타입으로 변환합니다.
IPv6 주소의 포맷이 올바르지 않으면 ::(0 IPv6) 또는 지정된 기본 IPv6 값을 반환합니다.
구문
string— 변환할 IP 주소 문자열입니다. -default— 선택 사항입니다. 문자열의 포맷이 올바르지 않을 때 반환할 값입니다.
string의 포맷이 올바르지 않으면 :: 또는 지정한 선택적 기본값을 반환합니다. IPv6
예시
유효한 IPv6 문자열과 잘못된 IPv6 문자열
Query
Response
toIPv6OrNull
도입 버전: v22.3.0 입력값을IPv6 유형의 값으로 변환하며, 오류가 발생하면 NULL을 반환합니다.
toIPv6와 유사하지만, 변환 오류 시 예외를 발생시키는 대신 NULL을 반환합니다.
지원되는 인수:
- 표준 표기법의 IPv6 주소 문자열 표현.
- IPv4 주소의 문자열 표현(IPv4-mapped IPv6로 변환됨).
- IPv6 주소의 이진 표현.
NULL 반환):
- 잘못된 IP 주소 포맷.
- 형식이 잘못된 IPv6 주소.
- 범위를 벗어난 값.
- 잘못된 표기법.
x— IPv6 또는 IPv4 주소를 문자열로 표현한 값입니다.String
NULL을 반환합니다. IPv6 또는 NULL
예시
사용 예시
Query
Response
toIPv6OrZero
도입 버전: v23.1.0 입력 값을 IPv6 타입의 값으로 변환하지만, 오류가 발생하면 0 IPv6 주소를 반환합니다.toIPv6와 유사하지만, 변환 오류 시 예외를 발생시키는 대신 0 IPv6 주소(::)를 반환합니다.
지원되는 인수:
- 표준 표기법의 IPv6 주소 문자열 표현.
- IPv4 주소 문자열 표현(IPv4-mapped IPv6로 변환).
- IPv6 주소의 이진 표현.
- 잘못된 IP 주소 포맷.
- 형식이 잘못된 IPv6 주소.
- 범위를 벗어난 값.
x— IPv6 또는 IPv4 주소의 문자열 표현입니다.String
::)를 반환합니다. IPv6
예시
사용 예시
Query
Response