메인 콘텐츠로 건너뛰기

bech32Decode

도입 버전: v25.6.0 bech32 또는 bech32m 알고리즘으로 생성된 Bech32 주소 문자열을 디코딩합니다.
인코딩 함수와 달리 bech32Decode는 패딩된 FixedStrings도 자동으로 처리합니다.
구문
인수
  • address — 디코딩할 Bech32 문자열입니다. String 또는 FixedString
  • mode — 선택 사항입니다. 첫 번째 바이트를 witness version으로 제거하지 않고 디코딩하려면 'raw'를 지정합니다. SegWit이 아닌 주소(예: Cosmos SDK)에 사용하십시오. String
반환 값 문자열을 인코딩하는 데 사용된 (hrp, data)로 이루어진 튜플을 반환합니다. 데이터는 바이너리 형식입니다. Tuple(String, String) 예시 주소 디코딩
Query
Response
테스트넷 주소
Query
Response

bech32Encode

도입 버전: v25.6.0 Bech32 or Bech32m 알고리즘을 사용하여 사람이 읽을 수 있는 부분(HRP)과 함께 바이너리 데이터 문자열을 인코딩합니다.
FixedString 데이터 타입을 사용할 때 값이 행을 완전히 채우지 않으면 null 문자로 패딩됩니다. bech32Encode 함수는 hrp 인수에 대해서는 이를 자동으로 처리하지만, data 인수는 값이 패딩되지 않아야 합니다. 따라서 모든 값의 길이가 같고 FixedString 컬럼도 해당 길이로 설정되어 있다고 확신할 수 있는 경우가 아니라면, 데이터 값에 FixedString 데이터 타입을 사용하지 않는 것이 좋습니다.
구문
인수
  • hrp — 코드의 “human-readable part”를 지정하는 1 - 83자의 소문자 String입니다. 일반적으로 ‘bc’ 또는 ‘tb’입니다. String 또는 FixedString
  • data — 인코딩할 바이너리 데이터 String입니다. String 또는 FixedString
  • witver_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
Query
Response
Bech32 알고리즘
Query
Response
사용자 지정 HRP
Query
Response
Cosmos SDK 주소 (BIP173, witness version 없음)
Query
Response

bin

도입 버전: v21.8.0 서로 다른 타입에 대해 다음 로직에 따라 인수의 이진 표현을 포함하는 문자열을 반환합니다: 구문
인수 반환 값 인수의 이진 표현을 담은 문자열을 반환합니다. String 예시 간단한 정수
Query
Response
Float32 값
Query
Response
Float64 수
Query
Response
UUID 변환
Query
Response

bitPositionsToArray

도입 버전: v21.7.0 이 함수는 부호 없는 정수의 이진 표현에서 값이 1인 비트의 위치를 오름차순으로 반환합니다. 부호 있는 입력 정수는 먼저 부호 없는 정수로 변환됩니다. 구문
인수
  • arg — 정수 값입니다. (U)Int*
반환 값 입력값의 이진 표현에서 1인 비트의 위치를 오름차순으로 정렬한 배열을 반환합니다. Array(UInt64) 예시 단일 비트만 설정된 경우
Query
Response
모든 비트가 설정된 상태
Query
Response

bitmaskToArray

도입 버전: v1.1.0 이 함수는 정수를 2의 거듭제곱의 합으로 분해합니다. 각 2의 거듭제곱은 오름차순으로 정렬된 배열로 반환됩니다. 구문
인수
  • num — 정수 값입니다. (U)Int*
반환 값 입력된 숫자를 합으로 하는 2의 거듭제곱들을 오름차순으로 정렬한 배열을 반환합니다. Array(UInt64) 예시 기본 예시
Query
Response
단일 2의 거듭제곱
Query
Response

bitmaskToList

v1.1.0에서 도입됨 bitmaskToArray와 비슷하지만, 2의 거듭제곱을 쉼표로 구분한 문자열로 반환합니다. 구문
인수
  • num — 정수 값입니다. (U)Int*
반환 값 쉼표로 구분된 2의 거듭제곱 값이 포함된 문자열을 반환합니다. String 예시 기본 예시
Query
Response

char

도입 버전: v20.1.0 전달된 인수의 개수와 길이가 같고, 각 바이트가 해당 인수의 값을 갖는 문자열을 반환합니다. 숫자 타입의 여러 인수를 받을 수 있습니다. 인수 값이 UInt8 데이터 타입의 범위를 벗어나면, 반올림 및 오버플로우가 발생할 수 있는 방식으로 UInt8로 변환됩니다. 구문
인수 반환 값 주어진 바이트로 이루어진 문자열을 반환합니다. String 예시 기본 예시
Query
Response
임의의 인코딩 생성
Query
Response

hex

도입 버전: v1.1.0 서로 다른 타입에 대해 아래 로직에 따라 인수의 16진수 표현을 포함한 문자열을 반환합니다: 이 함수는 대문자 A-F를 사용하며, 접두사(0x 등)나 접미사(h 등)는 사용하지 않습니다. 구문
인수 반환 값 인수의 16진수 표현을 담은 문자열을 반환합니다. String 예시 간단한 정수
Query
Response
Float32 숫자
Query
Response
Float64 형 숫자
Query
Response
UUID 변환
Query
Response

hilbertDecode

도입 버전: v24.6.0 Hilbert 곡선 인덱스를 다시 부호 없는 정수의 튜플로 디코딩하며, 이는 다차원 공간의 좌표를 나타냅니다. hilbertEncode 함수와 마찬가지로, 이 함수는 두 가지 모드로 동작합니다:
  • 간단
  • 확장
간단 모드 최대 2개의 부호 없는 정수를 인수로 받아 UInt64 코드를 생성합니다. 확장 모드 첫 번째 인수로 범위 마스크(튜플)를 받고, 나머지 인수로 최대 2개의 부호 없는 정수를 받습니다. 마스크의 각 숫자는 해당 인수를 왼쪽으로 시프트할 비트 수를 설정하며, 그 결과 해당 범위 내에서 인수가 효과적으로 스케일링됩니다. 범위 확장은 범위(또는 카디널리티)가 크게 다른 인수들에 대해 비슷한 분포가 필요할 때 유용할 수 있습니다. 예를 들어 ‘IP Address’ (0...FFFFFFFF) 및 ‘Country code’ (0...FF)가 있습니다. 인코드 함수와 마찬가지로, 이는 최대 8개의 숫자로 제한됩니다. 구문
인수 반환 값 지정된 크기의 Tuple을 반환합니다. Tuple(UInt64) 예시 단순 모드
Query
Response
단일 인수
Query
Response
확장 모드
Query
Response
컬럼 사용법
Query
Response

hilbertEncode

지원 시작 버전: v24.6.0 부호 없는 정수 목록에 대한 힐버트 곡선 코드를 계산합니다. 이 함수는 두 가지 모드로 동작합니다.
  • 단순
  • 확장
단순 모드 최대 2개의 부호 없는 정수를 인수로 받아 UInt64 코드를 생성합니다. 확장 모드 첫 번째 인수로 범위 마스크(Tuple)를 받고, 다른 인수로는 최대 2개의 부호 없는 정수를 받습니다. 마스크의 각 숫자는 해당 인수를 왼쪽으로 시프트할 비트 수를 지정하며, 결과적으로 해당 범위 내에서 인수를 스케일링합니다. 구문
인수
  • args — 최대 2개의 UInt 값 또는 UInt 타입 컬럼. UInt8/16/32/64
  • range_mask — 확장 모드에서는 최대 2개의 UInt 값 또는 UInt 타입 컬럼. UInt8/16/32/64
반환 값 UInt64 코드를 반환합니다. UInt64 예시 기본 모드
Query
Response
확장 모드
Query
Response
단일 인수
Query
Response
확장 모드의 단일 인수
Query
Response
컬럼 사용법
Query
Response

mortonDecode

도입 버전: v24.6.0 Morton 인코딩(ZCurve)을 해당하는 부호 없는 정수 튜플로 디코딩합니다. mortonEncode 함수와 마찬가지로, 이 함수는 두 가지 모드로 동작합니다:
  • Simple
  • Expanded
단순 모드 첫 번째 인수로 결과 튜플의 크기를 받고, 두 번째 인수로 코드를 받습니다. 확장 모드 첫 번째 인수로 범위 마스크(튜플)를 받고, 두 번째 인수로 코드를 받습니다. 마스크의 각 숫자는 범위 축소 정도를 설정합니다:
  • 1 - 축소 없음
  • 2 - 2배 축소
  • 3 - 3배 축소 ⋮
  • 최대 8배 축소
범위 확장은 범위(또는 카디널리티)가 크게 다른 인수들에 대해 비슷한 분포가 필요할 때 유용할 수 있습니다. 예: ‘IP Address’ (0...FFFFFFFF) 및 ‘Country code’ (0...FF). 인코딩 함수와 마찬가지로, 이는 최대 8개의 숫자로 제한됩니다. 구문
인수
  • tuple_size — 8 이하의 정수 값입니다. UInt8/16/32/64
  • range_mask — 확장 모드에서 각 인수에 적용되는 마스크입니다. 마스크는 부호 없는 정수로 이루어진 튜플입니다. 마스크의 각 숫자는 범위 축소량을 설정합니다. Tuple(UInt8/16/32/64)
  • code — UInt64 코드입니다. UInt64
반환 값 지정된 크기의 튜플을 반환합니다. Tuple(UInt64) 예시 단순 모드
Query
Response
단일 인수
Query
Response
확장 모드, 하나의 인수를 축소
Query
Response
컬럼 사용법
Query
Response

mortonEncode

도입 버전: v24.6.0 부호 없는 정수 목록에 대한 Morton 인코딩(ZCurve)을 계산합니다. 이 함수는 두 가지 모드로 동작합니다.
  • Simple
  • Expanded*
Simple mode 최대 8개의 부호 없는 정수를 인수로 받아 UInt64 코드를 생성합니다. Expanded mode 첫 번째 인수로 범위 마스크(Tuple)를 받고, 나머지 인수로 최대 8개의 부호 없는 정수를 받습니다. 마스크의 각 숫자는 범위 확장 정도를 설정합니다.
  • 1 - 확장 없음
  • 2 - 2배 확장
  • 3 - 3배 확장 ⋮
  • 최대 8배 확장
구문
인수
  • args — 앞서 언급한 타입의 부호 없는 정수 또는 해당 타입의 컬럼을 최대 8개까지 지정할 수 있습니다. UInt8/16/32/64
  • range_mask — 확장 모드에서는 각 인수에 적용되는 마스크입니다. 마스크는 1 - 8 범위의 부호 없는 정수로 이루어진 튜플입니다. 마스크의 각 숫자는 범위 축소량을 설정합니다. Tuple(UInt8/16/32/64)
반환 값 UInt64 코드를 반환합니다. UInt64 예시 단순 모드
Query
Response
확장 모드
Query
Response
단일 인수
Query
Response
확장 단일 인수
Query
Response
컬럼 사용법
Query
Response

sqidDecode

도입 버전: v24.1.0 sqid를 숫자 배열로 다시 변환합니다. 구문
인수
  • sqid — 디코딩할 sqid 값입니다. String
반환 값 sqid를 디코딩한 숫자 배열을 반환합니다. Array(UInt64) 예시 사용 예시
Query
Response

sqidEncode

도입 버전: v24.1.0 숫자를 YouTube와 유사한 ID 문자열인 sqid로 변환합니다. 구문
별칭: sqid 인수
  • n1[, n2, ...] — 개수에 제한이 없는 숫자입니다. UInt8/16/32/64
반환 값 해시 ID String를 반환합니다. 예시 사용 예시
Query
Response

unbin

도입 버전: v21.8.0 인수에 있는 각 이진 숫자 쌍을 숫자로 해석한 뒤, 그 숫자가 나타내는 바이트로 변환합니다. 이 함수는 bin과 반대되는 연산을 수행합니다. 숫자형 인수에 대해 unbin()bin()의 역연산 결과를 반환하지 않습니다. 결과를 숫자로 변환하려면 reversereinterpretAs<Type> 함수를 사용할 수 있습니다.
clickhouse-client에서 unbin을 호출하면 바이너리 문자열이 UTF-8로 표시됩니다.
이진 숫자 01을 지원합니다. 이진 숫자의 개수는 8의 배수일 필요가 없습니다. 인수 문자열에 이진 숫자 이외의 문자가 포함되어 있으면 결과는 정의되지 않습니다(예외가 발생하지 않습니다). 구문
인수
  • arg — 이진 숫자를 임의 개수만큼 포함하는 문자열입니다. String
반환 값 바이너리 문자열(BLOB)을 반환합니다. String 예시 기본 사용법
Query
Response
Number로 변환
Query
Response

unhex

도입 버전: v1.1.0 hex의 반대 연산을 수행합니다. (인수의) 각 16진수 숫자 쌍을 숫자로 해석한 다음, 해당 숫자가 나타내는 바이트로 변환합니다. 반환 값은 바이너리 문자열(BLOB)입니다. 결과를 숫자로 변환하려면 reversereinterpretAs<Type> 함수를 사용할 수 있습니다.
clickhouse-client는 문자열을 UTF-8로 해석합니다. 이로 인해 hex가 반환한 값이 예상과 다르게 표시될 수 있습니다.
대문자와 소문자 A-F를 모두 지원합니다. 16진수 숫자의 개수는 짝수일 필요가 없습니다. 홀수인 경우 마지막 숫자는 00-0F 바이트의 하위 4비트로 해석됩니다. 인수 문자열에 16진수 숫자가 아닌 문자가 포함되어 있으면 구현에 따라 정의된 결과가 반환됩니다(예외는 발생하지 않습니다). 숫자 인수에는 unhex()가 hex(N)의 역연산을 수행하지 않습니다. 구문
인수
  • arg — 임의 개수의 16진수 숫자를 포함하는 문자열입니다. String 또는 FixedString
반환 값 바이너리 문자열(BLOB)을 반환합니다. String 예시 기본 사용법
Query
Response
숫자로 변환
Query
Response
마지막 수정일 2026년 6월 10일