Перейти к основному содержанию

bech32Decode

Добавленный в: v25.6.0 Декодирует строку адреса Bech32, сгенерированную алгоритмами bech32 или bech32m.
В отличие от функции кодирования, bech32Decode автоматически обрабатывает FixedString с заполнением.
Синтаксис
Аргументы
  • address — Строка Bech32 для декодирования. String или FixedString
  • mode — Необязательно. Передайте 'raw', чтобы декодировать без удаления первого байта, используемого как witness version. Используйте это для адресов, не относящихся к SegWit (например, Cosmos SDK). String
Возвращаемое значение Возвращает кортеж (hrp, data), использованный для кодирования строки. Данные представлены в бинарном формате. Tuple(String, String) Примеры Декодирование адреса
Query
Response
Адрес тестнета
Query
Response

bech32Encode

Добавленный в: v25.6.0 Кодирует строку двоичных данных вместе с человекочитаемой частью (HRP) с использованием алгоритмов Bech32 или Bech32m.
При использовании типа данных FixedString, если значение не заполняет строку полностью, оно дополняется нулевыми символами. Хотя функция bech32Encode автоматически обрабатывает это для аргумента hrp, для аргумента data значения не должны содержать такого дополнения. По этой причине не рекомендуется использовать тип данных FixedString для значений данных, если только вы не уверены, что все они имеют одинаковую длину, и не задали для столбца FixedString ту же длину.
Синтаксис
Аргументы
  • hrp — Строка из 1 - 83 строчных символов, задающая “человекочитаемую часть” кода. Обычно это ‘bc’ или ‘tb’. String или FixedString
  • data — Строка двоичных данных для кодирования. String или FixedString
  • witver_or_variant — Необязательно. Либо witness version типа UInt* (по умолчанию = 1, 0 для Bech32, 1+ для Bech32m), либо строковый вариант кодирования: 'bech32' (BIP173) или 'bech32m' (BIP350). При использовании строкового варианта байт witness version не добавляется в начало — это требуется для адресов, не относящихся к SegWit, например Cosmos SDK. UInt* или String
Возвращаемое значение Возвращает строку адреса Bech32, состоящую из человекочитаемой части, символа-разделителя, которым всегда является ‘1’, и части данных. Длина строки никогда не превышает 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 Эта функция раскладывает целое число на сумму степеней двойки. Степени двойки возвращаются в виде массива, упорядоченного по возрастанию. Синтаксис
Аргументы
  • num — Целое число. (U)Int*
Возвращаемое значение Возвращает массив степеней двойки, упорядоченных по возрастанию, сумма которых равна входному числу. Array(UInt64) Примеры Базовый пример
Query
Response
Одна степень двойки
Query
Response

bitmaskToList

Добавленный в: v1.1.0 Как и bitmaskToArray, но возвращает степени двойки в виде строки, где значения разделены запятыми. Синтаксис
Аргументы
  • num — Целое число. (U)Int*
Возвращаемое значение Возвращает строку со степенями двойки, разделёнными запятыми. String Примеры Базовый пример
Query
Response

char

Добавленный в: v20.1.0 Возвращает строку, длина которой равна числу переданных аргументов, при этом каждый байт имеет значение соответствующего аргумента. Принимает несколько аргументов числовых типов. Если значение аргумента выходит за пределы диапазона типа данных UInt8, оно преобразуется в UInt8 с возможным округлением и переполнением. Синтаксис
Аргументы
  • num1[, num2[, num3 ...]] — Числовые аргументы, интерпретируемые как целые числа. (U)Int8/16/32/64 или Float*
Возвращаемое значение Возвращает строку из заданных байтов. String Примеры Базовый пример
Query
Response
Создание произвольных кодировок
Query
Response

hex

Добавленный в: v1.1.0 Возвращает строку, содержащую шестнадцатеричное представление аргумента в соответствии со следующей логикой для разных типов: Функция использует заглавные буквы A-F и не использует никаких префиксов (например, 0x) или суффиксов (например, h). Синтаксис
Аргументы
  • arg — значение для преобразования в шестнадцатеричное представление. String или (U)Int* или Float* или Decimal или Date или DateTime
Возвращаемое значение Строка с шестнадцатеричным представлением аргумента. String Примеры Простое целое число
Query
Response
Числа типа Float32
Query
Response
Числа типа Float64
Query
Response
Преобразование UUID
Query
Response

hilbertDecode

Добавленный в: v24.6.0 Декодирует индекс кривой Гильберта обратно в кортеж беззнаковых целых чисел, представляющий координаты в многомерном пространстве. Как и функция hilbertEncode, эта функция поддерживает два режима работы:
  • Простой
  • Расширенный
Простой режим Принимает до 2 беззнаковых целых чисел в качестве аргументов и возвращает код UInt64. Расширенный режим Принимает маску диапазона (кортеж) в качестве первого аргумента и до 2 беззнаковых целых чисел в качестве остальных аргументов. Каждое число в маске задает количество битов, на которое соответствующий аргумент будет сдвинут влево, фактически масштабируя аргумент в пределах его диапазона. Расширение диапазона может быть полезно, когда нужно получить схожее распределение для аргументов с сильно различающимися диапазонами (или мощностью). Например: ‘IP-адрес’ (0...FFFFFFFF) и ‘код страны’ (0...FF). Как и в случае с функцией кодирования, здесь можно указать не более 8 чисел. Синтаксис
Аргументы Возвращаемое значение Возвращает кортеж указанного размера. Tuple(UInt64) Примеры Простой режим
Query
Response
Один аргумент
Query
Response
Расширенный режим
Query
Response
Работа со столбцами
Query
Response

hilbertEncode

Добавленный в: v24.6.0 Вычисляет код кривой Гильберта для списка беззнаковых целых чисел. У функции есть два режима работы:
  • Простой
  • Расширенный
Простой режим Принимает до 2 беззнаковых целых чисел в качестве аргументов и возвращает код UInt64. Расширенный режим Принимает маску диапазона (Tuple) в качестве первого аргумента и до 2 беззнаковых целых чисел в качестве остальных аргументов. Каждое число в маске задает количество битов, на которое соответствующий аргумент будет сдвинут влево, тем самым масштабируя аргумент в пределах его диапазона. Синтаксис
Аргументы
  • args — До двух значений UInt или столбцов типа UInt. UInt8/16/32/64
  • range_mask — В расширенном режиме: до двух значений 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, эта функция имеет два режима работы:
  • Простой
  • Расширенный
Простой режим Принимает размер результирующего кортежа в качестве первого аргумента, а код — в качестве второго. Расширенный режим Принимает маску диапазона (кортеж) в качестве первого аргумента, а код — в качестве второго. Каждое число в маске задаёт степень сужения диапазона:
  • 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) для списка беззнаковых целых чисел. У функции есть два режима работы:
  • Простой
  • Расширенный*
Простой режим Принимает до 8 беззнаковых целых чисел в качестве аргументов и возвращает код UInt64. Расширенный режим Принимает маску диапазона (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 обратно в массив чисел. Синтаксис
Аргументы
  • sqidsqid, который нужно декодировать. String
Возвращаемое значение Возвращает массив чисел, полученных из sqid. Array(UInt64) Примеры Пример использования
Query
Response

sqidEncode

Добавленный в: v24.1.0 Преобразует числа в sqid — строковый идентификатор в стиле YouTube. Синтаксис
Псевдонимы: sqid Аргументы
  • n1[, n2, ...] — Произвольное количество чисел. UInt8/16/32/64
Возвращаемое значение Возвращает хеш-идентификатор в виде String Примеры Пример использования
Query
Response

unbin

Добавленный в: v21.8.0 Интерпретирует каждую пару двоичных цифр (в аргументе) как число и преобразует её в байт, представленный этим числом. Функция выполняет операцию, обратную bin. Для числового аргумента unbin() не возвращает результат, обратный bin(). Если вы хотите преобразовать результат в число, можно использовать функции reverse и reinterpretAs<Type>.
Если unbin вызывается из clickhouse-client, двоичные строки отображаются в UTF-8.
Поддерживаются двоичные цифры 0 и 1. Количество двоичных цифр не обязательно должно быть кратно восьми. Если строковый аргумент содержит что-либо, кроме двоичных цифр, результат не определён (исключение не генерируется). Синтаксис
Аргументы
  • arg — Строка, содержащая произвольное количество двоичных цифр. String
Возвращаемое значение Возвращает двоичную строку (BLOB). String Примеры Базовое использование
Query
Response
Преобразовать в число
Query
Response

unhex

Добавленный в: v1.1.0 Выполняет операцию, обратную hex. Интерпретирует каждую пару шестнадцатеричных цифр (в аргументе) как число и преобразует её в байт, соответствующий этому числу. Возвращаемое значение — двоичная строка (BLOB). Если вы хотите преобразовать результат в число, можно использовать функции reverse и reinterpretAs<Type>.
clickhouse-client интерпретирует строки как UTF-8. Из-за этого значения, возвращаемые hex, могут отображаться неожиданно.
Поддерживаются как прописные, так и строчные буквы A-F. Количество шестнадцатеричных цифр не обязательно должно быть чётным. Если оно нечётное, последняя цифра интерпретируется как младшая половина байта 00-0F. Если строка аргумента содержит символы, отличные от шестнадцатеричных цифр, возвращается некоторый зависящий от реализации результат (исключение не генерируется). Для числового аргумента обратное преобразование hex(N) с помощью unhex() не выполняется. Синтаксис
Аргументы
  • arg — Строка, содержащая произвольное количество шестнадцатеричных цифр. String или FixedString
Возвращаемое значение Возвращает двоичную строку (BLOB). String Примеры Базовое использование
Query
Response
Преобразовать в число
Query
Response
Последнее изменение 10 июня 2026 г.