bech32Decode
인코딩 함수와 달리
bech32Decode는 패딩된 FixedStrings도 자동으로 처리합니다.address— 디코딩할 Bech32 문자열입니다.String또는FixedStringmode— 선택 사항입니다. 첫 번째 바이트를 witness version으로 제거하지 않고 디코딩하려면'raw'를 지정합니다. SegWit이 아닌 주소(예: Cosmos SDK)에 사용하십시오.String
(hrp, data)로 이루어진 튜플을 반환합니다. 데이터는 바이너리 형식입니다. Tuple(String, String)
예시
주소 디코딩
Query
Response
Query
Response
bech32Encode
FixedString 데이터 타입을 사용할 때 값이 행을 완전히 채우지 않으면 null 문자로 패딩됩니다.
bech32Encode 함수는 hrp 인수에 대해서는 이를 자동으로 처리하지만, data 인수는 값이 패딩되지 않아야 합니다.
따라서 모든 값의 길이가 같고 FixedString 컬럼도 해당 길이로 설정되어 있다고 확신할 수 있는 경우가 아니라면, 데이터 값에 FixedString 데이터 타입을 사용하지 않는 것이 좋습니다.hrp— 코드의 “human-readable part”를 지정하는1 - 83자의 소문자String입니다. 일반적으로 ‘bc’ 또는 ‘tb’입니다.String또는FixedStringdata— 인코딩할 바이너리 데이터String입니다.String또는FixedStringwitver_or_variant— 선택 사항입니다. UInt* witness version(기본값 = 1, Bech32는0, Bech32m은1+) 또는String인코딩 variant('bech32'(BIP173) 또는'bech32m'(BIP350)) 중 하나입니다. 문자열 variant를 사용하면 witness version 바이트를 앞에 붙이지 않습니다. 이는 Cosmos SDK와 같은 비-SegWit 주소에 필요합니다.UInt*또는String
String
예시
기본 Bech32m
Query
Response
Query
Response
Query
Response
Query
Response
bin
구문
String
예시
간단한 정수
Query
Response
Query
Response
Query
Response
Query
Response
bitPositionsToArray
arg— 정수 값입니다.(U)Int*
Array(UInt64)
예시
단일 비트만 설정된 경우
Query
Response
Query
Response
bitmaskToArray
num— 정수 값입니다.(U)Int*
Array(UInt64)
예시
기본 예시
Query
Response
Query
Response
bitmaskToList
bitmaskToArray와 비슷하지만, 2의 거듭제곱을 쉼표로 구분한 문자열로 반환합니다.
구문
num— 정수 값입니다.(U)Int*
String
예시
기본 예시
Query
Response
char
UInt8 데이터 타입의 범위를 벗어나면, 반올림 및 오버플로우가 발생할 수 있는 방식으로 UInt8로 변환됩니다.
구문
num1[, num2[, num3 ...]]— 정수로 해석되는 숫자 인수입니다.(U)Int8/16/32/64또는Float*
String
예시
기본 예시
Query
Response
Query
Response
hex
이 함수는 대문자
A-F를 사용하며, 접두사(0x 등)나 접미사(h 등)는 사용하지 않습니다.
구문
String
예시
간단한 정수
Query
Response
Query
Response
Query
Response
Query
Response
hilbertDecode
hilbertEncode 함수와 마찬가지로, 이 함수는 두 가지 모드로 동작합니다:
- 간단
- 확장
UInt64 코드를 생성합니다.
확장 모드
첫 번째 인수로 범위 마스크(튜플)를 받고, 나머지 인수로 최대 2개의 부호 없는 정수를
받습니다. 마스크의 각 숫자는 해당 인수를 왼쪽으로 시프트할 비트 수를 설정하며,
그 결과 해당 범위 내에서 인수가 효과적으로 스케일링됩니다.
범위 확장은
범위(또는 카디널리티)가 크게 다른 인수들에 대해 비슷한 분포가 필요할 때 유용할 수 있습니다. 예를 들어 ‘IP Address’ (0...FFFFFFFF)
및 ‘Country code’ (0...FF)가 있습니다. 인코드 함수와 마찬가지로, 이는 최대 8개의
숫자로 제한됩니다.
구문
tuple_size—2이하의 정수 값입니다.UInt8/16/32/64또는Tuple(UInt8/16/32/64)code—UInt64코드입니다.UInt64
Tuple(UInt64)
예시
단순 모드
Query
Response
Query
Response
Query
Response
Query
Response
hilbertEncode
- 단순
- 확장
args— 최대 2개의UInt값 또는UInt타입 컬럼.UInt8/16/32/64range_mask— 확장 모드에서는 최대 2개의UInt값 또는UInt타입 컬럼.UInt8/16/32/64
UInt64 코드를 반환합니다. UInt64
예시
기본 모드
Query
Response
Query
Response
Query
Response
Query
Response
Query
Response
mortonDecode
mortonEncode 함수와 마찬가지로, 이 함수는 두 가지 모드로 동작합니다:
- Simple
- Expanded
1- 축소 없음2- 2배 축소3- 3배 축소 ⋮- 최대 8배 축소
(0...FFFFFFFF)
및 ‘Country code’ (0...FF). 인코딩 함수와 마찬가지로, 이는
최대 8개의 숫자로 제한됩니다.
구문
tuple_size— 8 이하의 정수 값입니다.UInt8/16/32/64range_mask— 확장 모드에서 각 인수에 적용되는 마스크입니다. 마스크는 부호 없는 정수로 이루어진 튜플입니다. 마스크의 각 숫자는 범위 축소량을 설정합니다.Tuple(UInt8/16/32/64)code— UInt64 코드입니다.UInt64
Tuple(UInt64)
예시
단순 모드
Query
Response
Query
Response
Query
Response
Query
Response
mortonEncode
- Simple
- Expanded*
UInt64 코드를 생성합니다.
Expanded mode
첫 번째 인수로 범위 마스크(Tuple)를 받고,
나머지 인수로 최대 8개의 부호 없는 정수를 받습니다.
마스크의 각 숫자는 범위 확장 정도를 설정합니다.
- 1 - 확장 없음
- 2 - 2배 확장
- 3 - 3배 확장 ⋮
- 최대 8배 확장
args— 앞서 언급한 타입의 부호 없는 정수 또는 해당 타입의 컬럼을 최대 8개까지 지정할 수 있습니다.UInt8/16/32/64range_mask— 확장 모드에서는 각 인수에 적용되는 마스크입니다. 마스크는1-8범위의 부호 없는 정수로 이루어진 튜플입니다. 마스크의 각 숫자는 범위 축소량을 설정합니다.Tuple(UInt8/16/32/64)
UInt64 코드를 반환합니다. UInt64
예시
단순 모드
Query
Response
Query
Response
Query
Response
Query
Response
Query
Response
sqidDecode
sqid— 디코딩할 sqid 값입니다.String
sqid를 디코딩한 숫자 배열을 반환합니다. Array(UInt64)
예시
사용 예시
Query
Response
sqidEncode
sqid
인수
n1[, n2, ...]— 개수에 제한이 없는 숫자입니다.UInt8/16/32/64
String를 반환합니다.
예시
사용 예시
Query
Response
unbin
bin과 반대되는 연산을 수행합니다.
숫자형 인수에 대해 unbin()은 bin()의 역연산 결과를 반환하지 않습니다. 결과를 숫자로 변환하려면 reverse 및 reinterpretAs<Type> 함수를 사용할 수 있습니다.
clickhouse-client에서 unbin을 호출하면 바이너리 문자열이 UTF-8로 표시됩니다.0과 1을 지원합니다. 이진 숫자의 개수는 8의 배수일 필요가 없습니다. 인수 문자열에 이진 숫자 이외의 문자가 포함되어 있으면
결과는 정의되지 않습니다(예외가 발생하지 않습니다).
구문
arg— 이진 숫자를 임의 개수만큼 포함하는 문자열입니다.String
String
예시
기본 사용법
Query
Response
Query
Response
unhex
hex의 반대 연산을 수행합니다. (인수의) 각 16진수 숫자 쌍을 숫자로 해석한 다음, 해당 숫자가 나타내는 바이트로 변환합니다. 반환 값은 바이너리 문자열(BLOB)입니다.
결과를 숫자로 변환하려면 reverse 및 reinterpretAs<Type> 함수를 사용할 수 있습니다.
clickhouse-client는 문자열을 UTF-8로 해석합니다.
이로 인해 hex가 반환한 값이 예상과 다르게 표시될 수 있습니다.A-F를 모두 지원합니다.
16진수 숫자의 개수는 짝수일 필요가 없습니다.
홀수인 경우 마지막 숫자는 00-0F 바이트의 하위 4비트로 해석됩니다.
인수 문자열에 16진수 숫자가 아닌 문자가 포함되어 있으면 구현에 따라 정의된 결과가 반환됩니다(예외는 발생하지 않습니다).
숫자 인수에는 unhex()가 hex(N)의 역연산을 수행하지 않습니다.
구문
arg— 임의 개수의 16진수 숫자를 포함하는 문자열입니다.String또는FixedString
String
예시
기본 사용법
Query
Response
Query
Response