Добавленный в: v25.6.0
Декодирует строку адреса Bech32, сгенерированную алгоритмами bech32 или bech32m.
В отличие от функции кодирования, bech32Decode автоматически обрабатывает FixedString с заполнением.
bech32Decode(address[, 'raw'])
address — Строка Bech32 для декодирования. String или FixedStringmode — Необязательно. Передайте 'raw', чтобы декодировать без удаления первого байта, используемого как witness version. Используйте это для адресов, не относящихся к 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, если значение не заполняет строку полностью, оно дополняется нулевыми символами.
Хотя функция bech32Encode автоматически обрабатывает это для аргумента hrp, для аргумента data значения не должны содержать такого дополнения.
По этой причине не рекомендуется использовать тип данных FixedString для значений данных, если только вы не
уверены, что все они имеют одинаковую длину, и не задали для столбца FixedString ту же длину. bech32Encode(hrp, data[, witver | 'bech32' | 'bech32m'])
hrp — Строка из 1 - 83 строчных символов, задающая “человекочитаемую часть” кода. Обычно это ‘bc’ или ‘tb’. String или FixedStringdata — Строка двоичных данных для кодирования. String или FixedStringwitver_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 по умолчанию
-- Если witness version не указана, по умолчанию используется 1 — обновлённый алгоритм Bech32m.
SELECT bech32Encode('bc', unhex('751e76e8199196d454941c45d1b3a323f1433bd6'))
bc1w508d6qejxtdg4y5r3zarvary0c5xw7k8zcwmq
-- Witness version, равный 0, приведёт к другой строке адреса.
SELECT bech32Encode('bc', unhex('751e76e8199196d454941c45d1b3a323f1433bd6'), 0)
bc1w508d6qejxtdg4y5r3zarvary0c5xw7kj7gz7z
-- Хотя 'bc' (Mainnet) и 'tb' (Testnet) — единственные допустимые значения hrp для
-- формата адресов SegWit, Bech32 допускает любой hrp, удовлетворяющий указанным требованиям.
SELECT bech32Encode('abcdefg', unhex('751e76e8199196d454941c45d1b3a323f1433bd6'), 10)
abcdefg1w508d6qejxtdg4y5r3zarvary0c5xw7k9rp8r4
-- Вариант 'bech32' кодирует необработанные данные без байта witness version,
-- совместим с Cosmos SDK, Injective, Osmosis и другими цепочками без поддержки SegWit.
SELECT bech32Encode('inj', unhex('751e76e8199196d454941c45d1b3a323f1433bd6'), 'bech32')
inj1w508d6qejxtdg4y5r3zarvary0c5xw7kgj5aqs
| Type | Description |
|---|
(U)Int* | Выводит двоичные цифры от старшего бита к младшему (в порядке big-endian, или в “человекочитаемом” порядке). Начинает со старшего ненулевого байта (начальные нулевые байты опускаются), но для каждого байта всегда выводит восемь цифр, если старшая цифра равна нулю. |
Date and DateTime | Форматируется как соответствующие целые числа (число дней с эпохи Unix для Date и значение Unix-временной метки для DateTime). |
String and FixedString | Все байты просто кодируются как восьмибитные двоичные числа. Нулевые байты не опускаются. |
Float* and Decimal | Кодируются в виде своего представления в памяти. Поскольку поддерживается архитектура little-endian, они также кодируются в little-endian. Начальные/конечные нулевые байты не опускаются. |
UUID | Кодируется как строка в порядке big-endian. |
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 │
└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
arg — Целочисленное значение. (U)Int*
Возвращаемое значение
Возвращает массив позиций битов со значением 1 в двоичном представлении входного значения, упорядоченных по возрастанию. 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] │
└───────────────┘
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* | Выводит шестнадцатеричные цифры (“полубайты”) от старшего к младшему разряду (big-endian, или в “человекочитаемом” порядке). Начинает со старшего ненулевого байта (ведущие нулевые байты опускаются), но всегда выводит обе цифры каждого байта, даже если первая цифра — ноль. |
Date and DateTime | Форматируются как соответствующие целые числа (число дней с эпохи Unix для Date и значение Unix-временной метки для DateTime). |
String and FixedString | Каждый байт просто кодируется двумя шестнадцатеричными цифрами. Нулевые байты не опускаются. |
Float* and Decimal | Кодируются в виде их представления в памяти. ClickHouse всегда хранит значения внутри в формате little-endian, поэтому они кодируются именно так. Ведущие/конечные нулевые байты не опускаются. |
UUID | Кодируется как строка в порядке байтов big-endian. |
A-F и не использует никаких префиксов (например, 0x) или суффиксов (например, h).
Синтаксис
Аргументы
Возвращаемое значение
Строка с шестнадцатеричным представлением аргумента. 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-адрес’ (0...FFFFFFFF)
и ‘код страны’ (0...FF). Как и в случае с функцией кодирования, здесь можно указать не более 8
чисел.
Синтаксис
hilbertDecode(tuple_size, code)
Tuple(UInt64)
Примеры
Простой режим
SELECT hilbertDecode(2, 31)
-- Код Гильберта для одного аргумента всегда равен самому аргументу (в виде кортежа).
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)
args — До двух значений UInt или столбцов типа UInt. UInt8/16/32/64range_mask — В расширенном режиме: до двух значений UInt или столбцов типа UInt. UInt8/16/32/64
Возвращаемое значение
Возвращает код типа UInt64. UInt64
Примеры
Простой режим
SELECT hilbertEncode(3, 4)
-- Расширение диапазона полезно, когда нужно схожее распределение для
-- аргументов с существенно различающимися диапазонами (или мощностью).
-- Например: 'IP-адрес' (0...FFFFFFFF) и 'Код страны' (0...FF).
-- Примечание: размер кортежа должен совпадать с количеством остальных аргументов.
SELECT hilbertEncode((10, 6), 1024, 16)
-- Для одного аргумента без кортежа функция возвращает сам аргумент
-- в качестве индекса Гильберта, так как размерное отображение не требуется.
SELECT hilbertEncode(1)
-- Если передан один аргумент с кортежем, задающим битовые сдвиги, функция
-- сдвигает аргумент влево на указанное количество битов.
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_size — Целочисленное значение не более 8. UInt8/16/32/64range_mask — Для расширенного режима: маска для каждого аргумента. Маска представляет собой кортеж беззнаковых целых чисел. Каждое число в маске задаёт степень сужения диапазона. Tuple(UInt8/16/32/64)code — Код типа UInt64. UInt64
Возвращаемое значение
Возвращает кортеж указанного размера. 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.
Расширенный режим
Принимает маску диапазона (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-адрес' (0...FFFFFFFF) и 'Код страны' (0...FF).
-- Примечание: размер Tuple должен быть равен количеству остальных аргументов.
SELECT mortonEncode((1,2), 1024, 16)
-- Кодирование Мортона для одного аргумента всегда равно самому аргументу
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 — sqid, который нужно декодировать. String
Возвращаемое значение
Возвращает массив чисел, полученных из sqid. Array(UInt64)
Примеры
Пример использования
SELECT sqidDecode('gXHfJ1C6dN');
┌─sqidDecode('gXHfJ1C6dN')─────┐
│ [1, 2, 3, 4, 5] │
└──────────────────────────────┘
sqidEncode(n1[, n2, ...])
sqid
Аргументы
Возвращаемое значение
Возвращает хеш-идентификатор в виде String
Примеры
Пример использования
SELECT sqidEncode(1, 2, 3, 4, 5);
┌─sqidEncode(1, 2, 3, 4, 5)─┐
│ gXHfJ1C6dN │
└───────────────────────────┘
bin.
Для числового аргумента unbin() не возвращает результат, обратный bin(). Если вы хотите преобразовать результат в число, можно использовать функции reverse и reinterpretAs<Type>.
Если unbin вызывается из clickhouse-client, двоичные строки отображаются в UTF-8.
0 и 1. Количество двоичных цифр не обязательно должно быть кратно восьми. Если строковый аргумент содержит что-либо, кроме двоичных цифр,
результат не определён (исключение не генерируется).
Синтаксис
Аргументы
arg — Строка, содержащая произвольное количество двоичных цифр. String
Возвращаемое значение
Возвращает двоичную строку (BLOB). String
Примеры
Базовое использование
SELECT UNBIN('001100000011000100110010'), UNBIN('0100110101111001010100110101000101001100')
┌─unbin('001100000011000100110010')─┬─unbin('0100110101111001010100110101000101001100')─┐
│ 012 │ MySQL │
└───────────────────────────────────┴───────────────────────────────────────────────────┘
SELECT reinterpretAsUInt64(reverse(unbin('1110'))) AS num
hex. Интерпретирует каждую пару шестнадцатеричных цифр (в аргументе) как число и преобразует
её в байт, соответствующий этому числу. Возвращаемое значение — двоичная строка (BLOB).
Если вы хотите преобразовать результат в число, можно использовать функции reverse и reinterpretAs<Type>.
clickhouse-client интерпретирует строки как UTF-8.
Из-за этого значения, возвращаемые hex, могут отображаться неожиданно.
A-F.
Количество шестнадцатеричных цифр не обязательно должно быть чётным.
Если оно нечётное, последняя цифра интерпретируется как младшая половина байта 00-0F.
Если строка аргумента содержит символы, отличные от шестнадцатеричных цифр, возвращается некоторый зависящий от реализации результат (исключение не генерируется).
Для числового аргумента обратное преобразование hex(N) с помощью unhex() не выполняется.
Синтаксис
Аргументы
arg — Строка, содержащая произвольное количество шестнадцатеричных цифр. String или FixedString
Возвращаемое значение
Возвращает двоичную строку (BLOB). String
Примеры
Базовое использование
SELECT unhex('303132'), UNHEX('4D7953514C')
┌─unhex('303132')─┬─unhex('4D7953514C')─┐
│ 012 │ MySQL │
└─────────────────┴─────────────────────┘
SELECT reinterpretAsUInt64(reverse(unhex('FFF'))) AS num
┌──num─┐
│ 4095 │
└──────┘
Последнее изменение 10 июня 2026 г.
