도입 버전: v25.6.0
bech32 또는 bech32m 알고리즘으로 생성된 Bech32 주소 문자열을 디코딩합니다.
인코딩 함수와 달리 bech32Decode는 패딩된 FixedStrings도 자동으로 처리합니다.
bech32Decode(address[, 'raw'])
address — 디코딩할 Bech32 문자열입니다. String 또는 FixedStringmode — 선택 사항입니다. 첫 번째 바이트를 witness version으로 제거하지 않고 디코딩하려면 'raw'를 지정합니다. SegWit이 아닌 주소(예: Cosmos SDK)에 사용하십시오. String
반환 값
문자열을 인코딩하는 데 사용된 (hrp, data)로 이루어진 튜플을 반환합니다. 데이터는 바이너리 형식입니다. Tuple(String, String)
예시
주소 디코딩
SELECT tup.1 AS hrp, hex(tup.2) AS data FROM (SELECT bech32Decode('bc1w508d6qejxtdg4y5r3zarvary0c5xw7kj7gz7z') AS tup)
bc 751E76E8199196D454941C45D1B3A323F1433BD6
SELECT tup.1 AS hrp, hex(tup.2) AS data FROM (SELECT bech32Decode('tb1w508d6qejxtdg4y5r3zarvary0c5xw7kzp034v') AS tup)
tb 751E76E8199196D454941C45D1B3A323F1433BD6
FixedString 데이터 타입을 사용할 때 값이 행을 완전히 채우지 않으면 null 문자로 패딩됩니다.
bech32Encode 함수는 hrp 인수에 대해서는 이를 자동으로 처리하지만, data 인수는 값이 패딩되지 않아야 합니다.
따라서 모든 값의 길이가 같고 FixedString 컬럼도 해당 길이로 설정되어 있다고 확신할 수 있는 경우가 아니라면, 데이터 값에 FixedString 데이터 타입을 사용하지 않는 것이 좋습니다.bech32Encode(hrp, data[, witver | 'bech32' | 'bech32m'])
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
반환 값
human-readable part, 항상 ‘1’인 구분 문자, 그리고 data part로 구성된 Bech32 주소 문자열을 반환합니다. 문자열 길이는 90자를 초과하지 않습니다. 알고리즘이 입력으로 유효한 주소를 생성할 수 없으면 빈 문자열을 반환합니다. String
예시
기본 Bech32m
-- witness version을 지정하지 않으면 기본값은 1이며, 업데이트된 Bech32m 알고리즘이 사용됩니다.
SELECT bech32Encode('bc', unhex('751e76e8199196d454941c45d1b3a323f1433bd6'))
bc1w508d6qejxtdg4y5r3zarvary0c5xw7k8zcwmq
-- witness version이 0이면 다른 주소 문자열이 반환됩니다.
SELECT bech32Encode('bc', unhex('751e76e8199196d454941c45d1b3a323f1433bd6'), 0)
bc1w508d6qejxtdg4y5r3zarvary0c5xw7kj7gz7z
-- 'bc' (메인넷)와 'tb' (테스트넷)는 SegWit 주소 형식에서 허용되는 유일한 hrp 값이지만,
-- Bech32는 위의 요구 사항을 충족하는 모든 hrp를 허용합니다.
SELECT bech32Encode('abcdefg', unhex('751e76e8199196d454941c45d1b3a323f1433bd6'), 10)
abcdefg1w508d6qejxtdg4y5r3zarvary0c5xw7k9rp8r4
-- 'bech32' 변형을 사용하면 witness version 바이트 없이 원시 데이터를 인코딩하며,
-- Cosmos SDK, Injective, Osmosis 및 기타 non-SegWit 체인과 호환됩니다.
SELECT bech32Encode('inj', unhex('751e76e8199196d454941c45d1b3a323f1433bd6'), 'bech32')
inj1w508d6qejxtdg4y5r3zarvary0c5xw7kgj5aqs
| 유형 | 설명 |
|---|
(U)Int* | 최상위 비트부터 최하위 비트까지(빅 엔디언 또는 “사람이 읽기 쉬운” 순서) 2진수 자릿수를 출력합니다. 가장 앞의 0이 아닌 바이트부터 시작하며(선행 0 바이트는 생략), 선행 자릿수가 0이더라도 각 바이트는 항상 8자리로 출력합니다. |
Date and DateTime | 해당하는 정수 형태로 포맷됩니다(Date는 epoch 이후의 일 수, DateTime는 Unix timestamp 값). |
String and FixedString | 모든 바이트는 각각 8자리 이진수로 그대로 인코딩됩니다. 0 바이트도 생략되지 않습니다. |
Float* and Decimal | 메모리상의 표현으로 인코딩됩니다. 리틀 엔디언 아키텍처를 지원하므로 리틀 엔디언으로 인코딩됩니다. 앞뒤의 0 바이트도 생략되지 않습니다. |
UUID | 빅 엔디언 순서의 문자열로 인코딩됩니다. |
String
예시
간단한 정수
┌─bin(14)──┐
│ 00001110 │
└──────────┘
SELECT bin(toFloat32(number)) AS bin_presentation FROM numbers(15, 2)
┌─bin_presentation─────────────────┐
│ 00000000000000000111000001000001 │
│ 00000000000000001000000001000001 │
└──────────────────────────────────┘
SELECT bin(toFloat64(number)) AS bin_presentation FROM numbers(15, 2)
┌─bin_presentation─────────────────────────────────────────────────┐
│ 0000000000000000000000000000000000000000000000000010111001000000 │
│ 0000000000000000000000000000000000000000000000000011000001000000 │
└──────────────────────────────────────────────────────────────────┘
SELECT bin(toUUID('61f0c404-5cb3-11e7-907b-a6006ad3dba0')) AS bin_uuid
┌─bin_uuid─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ 01100001111100001100010000000100010111001011001100010001111001111001000001111011101001100000000001101010110100111101101110100000 │
└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
Array(UInt64)
예시
단일 비트만 설정된 경우
SELECT bitPositionsToArray(toInt8(1)) AS bit_positions
┌─bit_positions─┐
│ [0] │
└───────────────┘
SELECT bitPositionsToArray(toInt8(-1)) AS bit_positions
┌─bit_positions─────────────┐
│ [0, 1, 2, 3, 4, 5, 6, 7] │
└───────────────────────────┘
Array(UInt64)
예시
기본 예시
SELECT bitmaskToArray(50) AS powers_of_two
┌─powers_of_two───┐
│ [2, 16, 32] │
└─────────────────┘
SELECT bitmaskToArray(8) AS powers_of_two
┌─powers_of_two─┐
│ [8] │
└───────────────┘
bitmaskToArray와 비슷하지만, 2의 거듭제곱을 쉼표로 구분한 문자열로 반환합니다.
구문
인수
반환 값
쉼표로 구분된 2의 거듭제곱 값이 포함된 문자열을 반환합니다. String
예시
기본 예시
SELECT bitmaskToList(50) AS powers_list
┌─powers_list───┐
│ 2, 16, 32 │
└───────────────┘
UInt8 데이터 타입의 범위를 벗어나면, 반올림 및 오버플로우가 발생할 수 있는 방식으로 UInt8로 변환됩니다.
구문
char(num1[, num2[, ...]])
String
예시
기본 예시
SELECT char(104.1, 101, 108.9, 108.9, 111) AS hello;
┌─hello─┐
│ hello │
└───────┘
-- 해당 바이트를 전달하여 임의 인코딩의 문자열을 구성할 수 있습니다.
-- 예: UTF8
SELECT char(0xD0, 0xBF, 0xD1, 0x80, 0xD0, 0xB8, 0xD0, 0xB2, 0xD0, 0xB5, 0xD1, 0x82) AS hello;
┌─hello──┐
│ привет │
└────────┘
| 유형 | 설명 |
|---|
(U)Int* | 최상위 자릿수부터 최하위 자릿수까지 16진수 숫자(“니블”)를 출력합니다(빅 엔디안 또는 “사람이 읽기 쉬운” 순서). 가장 상위의 0이 아닌 바이트부터 시작하며(앞쪽의 0 바이트는 생략), 선행 숫자가 0이더라도 각 바이트의 두 자리는 항상 모두 출력합니다. |
Date and DateTime | 해당하는 정수 형식으로 포맷됩니다(Date는 epoch 이후 경과한 일 수, DateTime은 Unix timestamp 값). |
String and FixedString | 모든 바이트는 각각 두 자리 16진수로 그대로 인코딩됩니다. 0 바이트도 생략되지 않습니다. |
Float* and Decimal | 메모리에 표현된 형태로 인코딩됩니다. ClickHouse는 내부적으로 값을 항상 리틀 엔디안으로 표현하므로, 이에 맞춰 인코딩됩니다. 앞이나 뒤의 0 바이트도 생략되지 않습니다. |
UUID | 빅 엔디안 순서의 문자열로 인코딩됩니다. |
A-F를 사용하며, 접두사(0x 등)나 접미사(h 등)는 사용하지 않습니다.
구문
인수
반환 값
인수의 16진수 표현을 담은 문자열을 반환합니다. String
예시
간단한 정수
Float32 숫자
SELECT hex(toFloat32(number)) AS hex_presentation FROM numbers(15, 2)
┌─hex_presentation─┐
│ 00007041 │
│ 00008041 │
└──────────────────┘
SELECT hex(toFloat64(number)) AS hex_presentation FROM numbers(15, 2)
┌─hex_presentation─┐
│ 0000000000002E40 │
│ 0000000000003040 │
└──────────────────┘
SELECT lower(hex(toUUID('61f0c404-5cb3-11e7-907b-a6006ad3dba0'))) AS uuid_hex
┌─uuid_hex─────────────────────────┐
│ 61f0c4045cb311e7907ba6006ad3dba0 │
└──────────────────────────────────┘
hilbertEncode 함수와 마찬가지로, 이 함수는 두 가지 모드로 동작합니다:
간단 모드
최대 2개의 부호 없는 정수를 인수로 받아 UInt64 코드를 생성합니다.
확장 모드
첫 번째 인수로 범위 마스크(튜플)를 받고, 나머지 인수로 최대 2개의 부호 없는 정수를
받습니다. 마스크의 각 숫자는 해당 인수를 왼쪽으로 시프트할 비트 수를 설정하며,
그 결과 해당 범위 내에서 인수가 효과적으로 스케일링됩니다.
범위 확장은
범위(또는 카디널리티)가 크게 다른 인수들에 대해 비슷한 분포가 필요할 때 유용할 수 있습니다. 예를 들어 ‘IP Address’ (0...FFFFFFFF)
및 ‘Country code’ (0...FF)가 있습니다. 인코드 함수와 마찬가지로, 이는 최대 8개의
숫자로 제한됩니다.
구문
hilbertDecode(tuple_size, code)
Tuple(UInt64)
예시
단순 모드
SELECT hilbertDecode(2, 31)
-- 인수가 하나인 경우 Hilbert 코드는 항상 인수 자체입니다(튜플 형태).
SELECT hilbertDecode(1, 1)
-- 비트 시프트를 지정하는 튜플과 함께 단일 인수를 사용하면 그에 따라 오른쪽으로 시프트됩니다.
SELECT hilbertDecode(tuple(2), 32768)
-- 먼저 테이블을 생성하고 데이터를 삽입합니다
CREATE TABLE hilbert_numbers(
n1 UInt32,
n2 UInt32
)
ENGINE=MergeTree()
ORDER BY n1 SETTINGS index_granularity_bytes = '10Mi';
insert into hilbert_numbers (*) values(1,2);
-- 함수 인수로 상수 대신 컬럼 이름을 사용합니다
SELECT untuple(hilbertDecode(2, hilbertEncode(n1, n2))) FROM hilbert_numbers;
-- 단순 모드
hilbertEncode(args)
-- 확장 모드
hilbertEncode(range_mask, args)
UInt64 코드를 반환합니다. UInt64
예시
기본 모드
SELECT hilbertEncode(3, 4)
-- 범위 확장은 범위(또는 카디널리티)가 크게 다른 인수들에 대해 유사한 분포가 필요할 때 유용합니다.
-- 예: 'IP 주소' (0...FFFFFFFF)와 '국가 코드' (0...FF).
-- 참고: 튜플 크기는 나머지 인수의 개수와 같아야 합니다.
SELECT hilbertEncode((10, 6), 1024, 16)
-- 튜플 없이 단일 인수만 제공된 경우, 차원 매핑이 필요하지 않으므로
-- 함수는 인수 자체를 Hilbert 인덱스로 반환합니다.
SELECT hilbertEncode(1)
-- 비트 시프트를 지정하는 tuple과 함께 단일 인수가 제공되면, 함수는
-- 해당 인수를 지정된 비트 수만큼 왼쪽으로 시프트합니다.
SELECT hilbertEncode(tuple(2), 128)
-- 먼저 테이블을 생성하고 데이터를 삽입합니다
CREATE TABLE hilbert_numbers(
n1 UInt32,
n2 UInt32
)
ENGINE=MergeTree()
ORDER BY n1;
insert into hilbert_numbers (*) values(1, 2);
-- 함수 인수로 상수 대신 컬럼 이름을 사용합니다
SELECT hilbertEncode(n1, n2) FROM hilbert_numbers;
mortonEncode 함수와 마찬가지로, 이 함수는 두 가지 모드로 동작합니다:
단순 모드
첫 번째 인수로 결과 튜플의 크기를 받고, 두 번째 인수로 코드를 받습니다.
확장 모드
첫 번째 인수로 범위 마스크(튜플)를 받고, 두 번째 인수로 코드를 받습니다.
마스크의 각 숫자는 범위 축소 정도를 설정합니다:
1 - 축소 없음2 - 2배 축소3 - 3배 축소
⋮- 최대 8배 축소
범위 확장은 범위(또는 카디널리티)가 크게 다른
인수들에 대해 비슷한 분포가 필요할 때 유용할 수 있습니다. 예: ‘IP Address’ (0...FFFFFFFF)
및 ‘Country code’ (0...FF). 인코딩 함수와 마찬가지로, 이는
최대 8개의 숫자로 제한됩니다.
구문
-- 단순 모드
mortonDecode(tuple_size, code)
-- 확장 모드
mortonDecode(range_mask, code)
Tuple(UInt64)
예시
단순 모드
SELECT mortonDecode(3, 53)
SELECT mortonDecode(1, 1)
SELECT mortonDecode(tuple(2), 32768)
-- 먼저 테이블을 생성하고 데이터를 삽입합니다
CREATE TABLE morton_numbers(
n1 UInt32,
n2 UInt32,
n3 UInt16,
n4 UInt16,
n5 UInt8,
n6 UInt8,
n7 UInt8,
n8 UInt8
)
ENGINE=MergeTree()
ORDER BY n1;
INSERT INTO morton_numbers (*) values(1, 2, 3, 4, 5, 6, 7, 8);
-- 함수 인수로 상수 대신 컬럼 이름을 사용합니다
SELECT untuple(mortonDecode(8, mortonEncode(n1, n2, n3, n4, n5, n6, n7, n8))) FROM morton_numbers;
UInt64 코드를 생성합니다.
Expanded mode
첫 번째 인수로 범위 마스크(Tuple)를 받고,
나머지 인수로 최대 8개의 부호 없는 정수를 받습니다.
마스크의 각 숫자는 범위 확장 정도를 설정합니다.
- 1 - 확장 없음
- 2 - 2배 확장
- 3 - 3배 확장
⋮
- 최대 8배 확장
구문
-- 단순 모드
mortonEncode(args)
-- 확장 모드
mortonEncode(range_mask, args)
args — 앞서 언급한 타입의 부호 없는 정수 또는 해당 타입의 컬럼을 최대 8개까지 지정할 수 있습니다. UInt8/16/32/64range_mask — 확장 모드에서는 각 인수에 적용되는 마스크입니다. 마스크는 1 - 8 범위의 부호 없는 정수로 이루어진 튜플입니다. 마스크의 각 숫자는 범위 축소량을 설정합니다. Tuple(UInt8/16/32/64)
반환 값
UInt64 코드를 반환합니다. UInt64
예시
단순 모드
SELECT mortonEncode(1, 2, 3)
-- 범위가 크게 다른 인수(또는 카디널리티가 다른 인수)에 대해 유사한 분포가 필요할 때
-- 범위 확장이 유용할 수 있습니다.
-- 예: 'IP Address' (0...FFFFFFFF)와 'Country code' (0...FF).
-- 참고: Tuple의 크기는 나머지 인수의 수와 같아야 합니다.
SELECT mortonEncode((1,2), 1024, 16)
-- 인수가 하나인 경우 Morton 인코딩 결과는 항상 해당 인수 자체입니다
SELECT mortonEncode(1)
SELECT mortonEncode(tuple(2), 128)
-- 먼저 테이블을 생성하고 데이터를 삽입합니다
CREATE TABLE morton_numbers(
n1 UInt32,
n2 UInt32,
n3 UInt16,
n4 UInt16,
n5 UInt8,
n6 UInt8,
n7 UInt8,
n8 UInt8
)
ENGINE=MergeTree()
ORDER BY n1;
INSERT INTO morton_numbers (*) values(1, 2, 3, 4, 5, 6, 7, 8);
-- 함수 인수로 상수 대신 컬럼 이름을 사용합니다
SELECT mortonEncode(n1, n2, n3, n4, n5, n6, n7, n8) FROM morton_numbers;
sqid를 디코딩한 숫자 배열을 반환합니다. Array(UInt64)
예시
사용 예시
SELECT sqidDecode('gXHfJ1C6dN');
┌─sqidDecode('gXHfJ1C6dN')─────┐
│ [1, 2, 3, 4, 5] │
└──────────────────────────────┘
sqidEncode(n1[, n2, ...])
sqid
인수
반환 값
해시 ID String를 반환합니다.
예시
사용 예시
SELECT sqidEncode(1, 2, 3, 4, 5);
┌─sqidEncode(1, 2, 3, 4, 5)─┐
│ gXHfJ1C6dN │
└───────────────────────────┘
bin과 반대되는 연산을 수행합니다.
숫자형 인수에 대해 unbin()은 bin()의 역연산 결과를 반환하지 않습니다. 결과를 숫자로 변환하려면 reverse 및 reinterpretAs<Type> 함수를 사용할 수 있습니다.
clickhouse-client에서 unbin을 호출하면 바이너리 문자열이 UTF-8로 표시됩니다.
0과 1을 지원합니다. 이진 숫자의 개수는 8의 배수일 필요가 없습니다. 인수 문자열에 이진 숫자 이외의 문자가 포함되어 있으면
결과는 정의되지 않습니다(예외가 발생하지 않습니다).
구문
인수
arg — 이진 숫자를 임의 개수만큼 포함하는 문자열입니다. String
반환 값
바이너리 문자열(BLOB)을 반환합니다. String
예시
기본 사용법
SELECT UNBIN('001100000011000100110010'), UNBIN('0100110101111001010100110101000101001100')
┌─unbin('001100000011000100110010')─┬─unbin('0100110101111001010100110101000101001100')─┐
│ 012 │ MySQL │
└───────────────────────────────────┴───────────────────────────────────────────────────┘
SELECT reinterpretAsUInt64(reverse(unbin('1110'))) AS num
hex의 반대 연산을 수행합니다. (인수의) 각 16진수 숫자 쌍을 숫자로 해석한 다음, 해당 숫자가 나타내는 바이트로 변환합니다. 반환 값은 바이너리 문자열(BLOB)입니다.
결과를 숫자로 변환하려면 reverse 및 reinterpretAs<Type> 함수를 사용할 수 있습니다.
clickhouse-client는 문자열을 UTF-8로 해석합니다.
이로 인해 hex가 반환한 값이 예상과 다르게 표시될 수 있습니다.
A-F를 모두 지원합니다.
16진수 숫자의 개수는 짝수일 필요가 없습니다.
홀수인 경우 마지막 숫자는 00-0F 바이트의 하위 4비트로 해석됩니다.
인수 문자열에 16진수 숫자가 아닌 문자가 포함되어 있으면 구현에 따라 정의된 결과가 반환됩니다(예외는 발생하지 않습니다).
숫자 인수에는 unhex()가 hex(N)의 역연산을 수행하지 않습니다.
구문
인수
반환 값
바이너리 문자열(BLOB)을 반환합니다. String
예시
기본 사용법
SELECT unhex('303132'), UNHEX('4D7953514C')
┌─unhex('303132')─┬─unhex('4D7953514C')─┐
│ 012 │ MySQL │
└─────────────────┴─────────────────────┘
SELECT reinterpretAsUInt64(reverse(unhex('FFF'))) AS num
┌──num─┐
│ 4095 │
└──────┘
