Функции для поиска и замены в строках описаны отдельно.
Приведённая ниже документация сгенерирована на основе системной таблицы system.functions.
0xffffffff (реализация zlib).
Синтаксис
Аргументы
s — строка String, для которой вычисляется CRC32. String
Возвращаемое значение
Возвращает контрольную сумму CRC32 для строки. UInt32
Примеры
Пример использования
SELECT CRC32('ClickHouse')
┌─CRC32('ClickHouse')─┐
│ 1538217360 │
└─────────────────────┘
s — строка, для которой вычисляется CRC32. String
Возвращаемое значение
Возвращает контрольную сумму CRC32 для строки. UInt32
Примеры
Пример использования
SELECT CRC32IEEE('ClickHouse');
┌─CRC32IEEE('ClickHouse')─┐
│ 3089448422 │
└─────────────────────────┘
s — строка, для которой вычисляется CRC64. String
Возвращаемое значение
Возвращает контрольную сумму CRC64 для строки. UInt64
Примеры
Пример использования
SELECT CRC64('ClickHouse');
┌──CRC64('ClickHouse')─┐
│ 12126588151325169346 │
└──────────────────────┘
appendTrailingCharIfAbsent
c в строку s, если s непустая и не заканчивается символом c.
Синтаксис
appendTrailingCharIfAbsent(s, c)
s — Входная строка. Stringc — Символ, который нужно добавить, если он отсутствует. String
Возвращаемое значение
Возвращает строку s с добавленным символом c, если s не заканчивается на c. String
Примеры
Пример использования
SELECT appendTrailingCharIfAbsent('https://example.com', '/');
┌─appendTraili⋯.com', '/')─┐
│ https://example.com/ │
└──────────────────────────┘
s в виде Int32.
Синтаксис
Аргументы
Возвращаемое значение
Возвращает код точки ASCII для первого символа. Если s — пустая строка, результат равен 0. Если первый символ не является символом ASCII или не входит в диапазон Latin-1 Supplement UTF-16, результат не определён. Int32
Примеры
Пример использования
┌─ascii('234')─┐
│ 50 │
└──────────────┘
encoded — столбец типа String или константа. String
Возвращаемое значение
Возвращает строку с декодированным значением аргумента. String
Примеры
Пример использования
SELECT base32Decode('IVXGG33EMVSA====');
┌─base32Decode('IVXGG33EMVSA====')─┐
│ Encoded │
└──────────────────────────────────┘
plaintext — Открытый текст, который нужно закодировать. String
Возвращаемое значение
Возвращает строку, содержащую закодированное значение аргумента. String или FixedString
Примеры
Пример использования
SELECT base32Encode('Encoded')
┌─base32Encode('Encoded')─┐
│ IVXGG33EMVSA==== │
└─────────────────────────┘
expected_size можно указать для выбора оптимизированного декодера фиксированного размера.
В настоящее время поддерживаются значения 32 и 64. Для остальных значений используется универсальный декодер.
Если выбран оптимизированный декодер, но входную строку нельзя декодировать ровно в такое количество байтов,
функция генерирует исключение (или возвращает пустую строку для tryBase58Decode).
Синтаксис
base58Decode(encoded[, expected_size])
encoded — Столбец или константа типа String для декодирования. Stringexpected_size — Необязательно. Ожидаемый размер результата декодирования в байтах. Если указано 32 или 64, используется оптимизированный декодер; для остальных значений используется универсальный декодер. UInt8, UInt16, UInt32, or UInt64
Возвращаемое значение
Возвращает строку, содержащую декодированное значение аргумента. String
Примеры
Пример использования
SELECT base58Decode('JxF12TrwUP45BMd');
┌─base58Decode⋯rwUP45BMd')─┐
│ Hello World │
└──────────────────────────┘
plaintext — Открытый текст, который нужно закодировать. String
Возвращаемое значение
Возвращает строку с закодированным значением аргумента. String
Примеры
Пример использования
SELECT base58Encode('ClickHouse');
┌─base58Encode('ClickHouse')─┐
│ 4nhk8K7GHXf6zx │
└────────────────────────────┘
FROM_BASE64
Аргументы
encoded — столбец типа String или константа для декодирования. Если строка некорректно закодирована в Base64, генерируется исключение. String
Возвращаемое значение
Возвращает декодированную строку. String
Примеры
Пример использования
SELECT base64Decode('Y2xpY2tob3VzZQ==')
┌─base64Decode('Y2xpY2tob3VzZQ==')─┐
│ clickhouse │
└──────────────────────────────────┘
TO_BASE64
Аргументы
plaintext — столбец или константа с открытым текстом для декодирования. String
Возвращаемое значение
Возвращает строку, содержащую закодированное значение аргумента. String
Примеры
Пример использования
SELECT base64Encode('clickhouse')
┌─base64Encode('clickhouse')─┐
│ Y2xpY2tob3VzZQ== │
└────────────────────────────┘
encoded — столбец типа String или константа для кодирования. Если строка закодирована в Base64 некорректно, будет сгенерировано исключение. String
Возвращаемое значение
Возвращает строку, содержащую декодированное значение аргумента. String
Примеры
Пример использования
SELECT base64URLDecode('aHR0cHM6Ly9jbGlja2hvdXNlLmNvbQ')
┌─base64URLDecode('aHR0cHM6Ly9jbGlja2hvdXNlLmNvbQ')─┐
│ https://clickhouse.com │
└───────────────────────────────────────────────────┘
base64URLEncode(plaintext)
plaintext — столбец или константа с открытым текстом для кодирования. String
Возвращаемое значение
Возвращает строку, содержащую закодированное значение аргумента. String
Примеры
Пример использования
SELECT base64URLEncode('https://clickhouse.com')
┌─base64URLEncode('https://clickhouse.com')─┐
│ aHR0cHM6Ly9jbGlja2hvdXNlLmNvbQ │
└───────────────────────────────────────────┘
expr — Строковое выражение. Обратные косые черты должны быть экранированы. String
Возвращаемое значение
Возвращает часть входной строки после последней косой или обратной косой черты. Если входная строка заканчивается косой или обратной косой чертой, функция возвращает пустую строку. Если в строке нет косых или обратных косых черт, возвращается исходная строка. String
Примеры
Извлечение имени файла из пути Unix
SELECT 'some/long/path/to/file' AS a, basename(a)
┌─a──────────────────────┬─basename('some/long/path/to/file')─┐
│ some/long/path/to/file │ file │
└────────────────────────┴────────────────────────────────────┘
SELECT 'some\\long\\path\\to\\file' AS a, basename(a)
┌─a──────────────────────┬─basename('some\\long\\path\\to\\file')─┐
│ some\long\path\to\file │ file │
└────────────────────────┴────────────────────────────────────────┘
SELECT 'some-file-name' AS a, basename(a)
┌─a──────────────┬─basename('some-file-name')─┐
│ some-file-name │ some-file-name │
└────────────────┴────────────────────────────┘
byteHammingDistance(s1, s2)
mismatches
Аргументы
Возвращаемое значение
Возвращает расстояние Хэмминга между двумя строками. UInt64
Примеры
Пример использования
SELECT byteHammingDistance('karolin', 'kathrin')
┌─byteHammingDistance('karolin', 'kathrin')─┐
│ 3 │
└───────────────────────────────────────────┘
ffi, всё равно раскладываются, поскольку свёртка регистра Unicode сама по себе их разворачивает.
Синтаксис
Аргументы
str — входная строка в кодировке UTF-8. String
Возвращаемое значение
UTF-8-строка после case folding. String
Примеры
Базовый пример case folding
SELECT caseFoldUTF8('Straße')
┌─caseFoldUTF8('Straße')─┐
│ strasse │
└─────────────────────────┘
compareSubstrings(s1, s2, s1_offset, s2_offset, num_bytes)
s1 — Первая строка для сравнения. Strings2 — Вторая строка для сравнения. Strings1_offset — Позиция в s1 (с нумерацией с нуля), с которой начинается сравнение. UInt*s2_offset — Позиция в s2 (с нумерацией с нуля), с которой начинается сравнение. UInt*num_bytes — Максимальное количество байтов для сравнения в обеих строках. Если s1_offset (или s2_offset) + num_bytes превышает длину входной строки, значение num_bytes будет соответственно уменьшено. UInt*
Возвращаемое значение
Возвращает:
-1, если s1[s1_offset : s1_offset + num_bytes] < s2[s2_offset : s2_offset + num_bytes].0, если s1[s1_offset : s1_offset + num_bytes] = s2[s2_offset : s2_offset + num_bytes].1, если s1[s1_offset : s1_offset + num_bytes] > s2[s2_offset : s2_offset + num_bytes].
Int8
Примеры
Пример использования
SELECT compareSubstrings('Saxony', 'Anglo-Saxon', 0, 6, 5) AS result
┌─result─┐
│ 0 │
└────────┘
String или FixedString, преобразуются в строки с использованием сериализации по умолчанию.
Поскольку это снижает производительность, использовать аргументы, отличные от String/FixedString, не рекомендуется.
Синтаксис
Аргументы
s1, s2, ... — Любое количество значений произвольного типа. Any
Возвращаемое значение
Возвращает строку String, полученную путём конкатенации аргументов. Если какой-либо из аргументов равен NULL, функция возвращает NULL. Если аргументы отсутствуют, возвращается пустая строка. Nullable(String)
Примеры
Конкатенация строк
SELECT concat('Hello, ', 'World!')
┌─concat('Hello, ', 'World!')─┐
│ Hello, World! │
└─────────────────────────────┘
┌─concat(42, 144)─┐
│ 42144 │
└─────────────────┘
concat, но предполагается, что concat(s1, s2, ...) → sn — инъективная функция,
то есть для разных аргументов она возвращает разные результаты.
Может использоваться для оптимизации GROUP BY.
Синтаксис
concatAssumeInjective([s1, s2, ...])
NULL, функция возвращает NULL. Если аргументы не переданы, возвращается пустая строка. String
Примеры
Оптимизация GROUP BY
SELECT concat(key1, key2), sum(value) FROM key_val GROUP BY concatAssumeInjective(key1, key2)
┌─concat(key1, key2)─┬─sum(value)─┐
│ Hello, World! │ 3 │
│ Hello, World! │ 2 │
│ Hello, World │ 3 │
└────────────────────┴────────────┘
concatWithSeparator(sep[, exp1, exp2, ...])
concat_ws
Аргументы
sep — Разделитель, который будет использоваться. const String или const FixedStringexp1, exp2, ... — Выражения для объединения. Аргументы, не имеющие тип String или FixedString, преобразуются в строки с использованием сериализации по умолчанию. Поскольку это снижает производительность, использовать аргументы не типа String/FixedString не рекомендуется. Any
Возвращаемое значение
Возвращает строку, созданную объединением аргументов. Если значение любого из аргументов равно NULL, функция возвращает NULL. String
Примеры
Пример использования
SELECT concatWithSeparator('a', '1', '2', '3', '4')
┌─concatWithSeparator('a', '1', '2', '3', '4')─┐
│ 1a2a3a4 │
└──────────────────────────────────────────────┘
concatWithSeparatorAssumeInjective
concatWithSeparator, но предполагает, что concatWithSeparator(sep[,exp1, exp2, ... ]) → result инъективна.
Функция называется инъективной, если она возвращает разные результаты для разных аргументов.
Может использоваться для оптимизации GROUP BY.
Синтаксис
concatWithSeparatorAssumeInjective(sep[, exp1, exp2, ... ])
sep — Используемый разделитель. const String or const FixedStringexp1, exp2, ... — Выражения для объединения. Аргументы типа, отличного от String или FixedString, преобразуются в строки с использованием сериализации по умолчанию. Поскольку это снижает производительность, использовать аргументы не типа String/FixedString не рекомендуется. String or FixedString
Возвращаемое значение
Возвращает строку String, полученную объединением аргументов. Если значение любого из аргументов равно NULL, функция возвращает NULL. String
Примеры
Пример использования
CREATE TABLE user_data (
user_id UInt32,
first_name String,
last_name String,
score UInt32
)
ENGINE = MergeTree
ORDER BY tuple();
INSERT INTO user_data VALUES
(1, 'John', 'Doe', 100),
(2, 'Jane', 'Smith', 150),
(3, 'John', 'Wilson', 120),
(4, 'Jane', 'Smith', 90);
SELECT
concatWithSeparatorAssumeInjective('-', first_name, last_name) as full_name,
sum(score) as total_score
FROM user_data
GROUP BY concatWithSeparatorAssumeInjective('-', first_name, last_name);
┌─full_name───┬─total_score─┐
│ Jane-Smith │ 240 │
│ John-Doe │ 100 │
│ John-Wilson │ 120 │
└─────────────┴─────────────┘
conv(number, from_base, to_base)
number — Число, которое нужно преобразовать. Может быть строкой или числовым типом. - from_base — Исходное основание системы счисления (2-36). Должно быть целым числом. - to_base — Целевое основание системы счисления (2-36). Должно быть целым числом.
Возвращаемое значение
Строковое представление числа в целевом основании системы счисления.
Примеры
Преобразование десятичного числа в двоичное
Преобразовать число из шестнадцатеричной системы в десятичную
SELECT conv('FF', 16, 10)
SELECT conv('-1', 10, 16)
SELECT conv('1010', 2, 8)
s, преобразованную из кодировки from в кодировку to.
Синтаксис
convertCharset(s, from, to)
s — Входная строка. Stringfrom — Исходная кодировка символов. Stringto — Целевая кодировка символов. String
Возвращаемое значение
Строка s, преобразованная из кодировки from в кодировку to. String
Примеры
Пример использования
SELECT convertCharset('Café', 'UTF-8', 'ISO-8859-1');
┌─convertChars⋯SO-8859-1')─┐
│ Caf� │
└──────────────────────────┘
damerauLevenshteinDistance
damerauLevenshteinDistance(s1, s2)
s1 — Первая входная строка. Strings2 — Вторая входная строка. String
Возвращаемое значение
Возвращает расстояние Дамерау — Левенштейна между двумя строками. UInt64
Примеры
Пример использования
SELECT damerauLevenshteinDistance('clickhouse', 'mouse')
┌─damerauLevenshteinDistance('clickhouse', 'mouse')─┐
│ 6 │
└───────────────────────────────────────────────────┘
s — строка, содержащая HTML-сущности для декодирования. String
Возвращаемое значение
Возвращает строку с декодированными HTML-сущностями. String
Примеры
Пример использования
SELECT decodeHTMLComponent('<div>Hello & "World"</div>')
┌─decodeHTMLComponent('<div>Hello & "World"</div>')─┐
│ <div>Hello & "World"</div> │
└─────────────────────────────────────────────────────────────────────────────┘
s — Строка, содержащая XML-сущности, которые нужно декодировать. String
Возвращаемое значение
Возвращает переданную строку с декодированными XML-сущностями. String
Примеры
Пример использования
SELECT decodeXMLComponent('<tag>Hello & World</tag>')
┌─decodeXMLCom⋯;/tag>')─┐
│ <tag>Hello & World</tag> │
└──────────────────────────┘
levenshteinDistance
Аргументы
s1 — Первая входная строка. Strings2 — Вторая входная строка. String
Возвращаемое значение
Возвращает расстояние редактирования между двумя строками. UInt64
Примеры
Пример использования
SELECT editDistance('clickhouse', 'mouse')
┌─editDistance('clickhouse', 'mouse')─┐
│ 6 │
└─────────────────────────────────────┘
levenshteinDistanceUTF8
Аргументы
s1 — Первая входная строка. Strings2 — Вторая входная строка. String
Возвращаемое значение
Возвращает расстояние редактирования между двумя строками в кодировке UTF-8. UInt64
Примеры
Пример использования
SELECT editDistanceUTF8('我是谁', '我是我')
┌─editDistanceUTF8('我是谁', '我是我')──┐
│ 1 │
└─────────────────────────────────────┘
s — строка для экранирования. String
Возвращаемое значение
Экранированная строка. String
Примеры
Пример использования
SELECT
'<tag>Hello & "World"</tag>' AS original,
encodeXMLComponent('<tag>Hello & "World"</tag>') AS xml_encoded;
┌─original───────────────────┬─xml_encoded──────────────────────────────────────────┐
│ <tag>Hello & "World"</tag> │ <tag>Hello & "World"</tag> │
└────────────────────────────┴──────────────────────────────────────────────────────┘
s — Проверяемая строка. Stringsuffix — Проверяемый суффикс. String
Возвращаемое значение
Возвращает 1, если s оканчивается на suffix, в противном случае 0. UInt8
Примеры
Пример использования
SELECT endsWith('ClickHouse', 'House');
┌─endsWith('Cl⋯', 'House')─┐
│ 1 │
└──────────────────────────┘
endsWithCaseInsensitive(s, suffix)
s — Строка для проверки. Stringsuffix — Регистронезависимый суффикс для проверки. String
Возвращаемое значение
Возвращает 1, если s заканчивается на регистронезависимый suffix, иначе 0. UInt8
Примеры
Пример использования
SELECT endsWithCaseInsensitive('ClickHouse', 'HOUSE');
┌─endsWithCaseInsensitive('Cl⋯', 'HOUSE')─┐
│ 1 │
└─────────────────────────────────────────┘
endsWithCaseInsensitiveUTF8
s на регистронезависимый суффикс suffix.
Предполагается, что строка содержит корректный текст в кодировке UTF-8.
Если это предположение нарушено, исключение не генерируется, а результат не определен.
Синтаксис
endsWithCaseInsensitiveUTF8(s, suffix)
s — проверяемая строка. Stringsuffix — регистронезависимый суффикс для проверки. String
Возвращаемое значение
Возвращает 1, если s оканчивается на регистронезависимый suffix, иначе — 0. UInt8
Примеры
Пример использования
SELECT endsWithCaseInsensitiveUTF8('данных', 'ых');
┌─endsWithCaseInsensitiveUTF8('данных', 'ых')─┐
│ 1 │
└─────────────────────────────────────────────┘
s на suffix.
Предполагается, что строка содержит корректный текст в кодировке UTF-8.
Если это предположение нарушено, исключение не генерируется, а результат не определён.
Синтаксис
Аргументы
s — Проверяемая строка. Stringsuffix — Проверяемый суффикс. String
Возвращаемое значение
Возвращает 1, если s оканчивается на suffix, иначе — 0. UInt8
Примеры
Пример использования
SELECT endsWithUTF8('данных', 'ых');
┌─endsWithUTF8('данных', 'ых')─┐
│ 1 │
└──────────────────────────────┘
- Удаление всех HTML/XML-тегов
- Удаление комментариев (
{/* */})
- Удаление элементов script и style вместе с их содержимым
- Обработку секций CDATA (копируются дословно)
- Корректную обработку и нормализацию пробельных символов
Примечание: HTML-сущности не декодируются; при необходимости их следует обрабатывать отдельной функцией.
Синтаксис
extractTextFromHTML(html)
html — String, содержащая HTML-контент, из которого нужно извлечь текст. String
Возвращаемое значение
Возвращает извлечённый текст с нормализованными пробелами. String
Примеры
Пример использования
SELECT extractTextFromHTML('
<html>
<head><title>Page Title</title></head>
<body>
<p>Hello <b>World</b>!</p>
<script>alert("test");</script>
<!-- comment -->
</body>
</html>
');
┌─extractTextFromHTML('<html><head>...')─┐
│ Page Title Hello World! │
└────────────────────────────────────────┘
String
Примеры
Пример использования
SELECT firstLine('foo\\nbar\\nbaz')
┌─firstLine('foo\nbar\nbaz')─┐
│ foo │
└────────────────────────────┘
idnaEncode() и idnaDecode() не обязательно возвращает исходную строку из-за нормализации регистра.
Синтаксис
Аргументы
Возвращаемое значение
Возвращает представление входной строки в Unicode (UTF-8) в соответствии с механизмом IDNA для входного значения. String
Примеры
Пример использования
SELECT idnaDecode('xn--strae-oqa.xn--mnchen-3ya.de')
┌─idnaDecode('xn--strae-oqa.xn--mnchen-3ya.de')─┐
│ straße.münchen.de │
└───────────────────────────────────────────────┘
Процентное декодирование, а также удаление символов табуляции, пробелов или управляющих символов не выполняются.
String
Примеры
Пример использования
SELECT idnaEncode('straße.münchen.de')
┌─idnaEncode('straße.münchen.de')─────┐
│ xn--strae-oqa.xn--mnchen-3ya.de │
└─────────────────────────────────────┘
Поскольку initcap преобразует в верхний регистр только первую букву каждого слова, для слов, содержащих апострофы или заглавные буквы, возможен неожиданный результат.
Это известная особенность, и в настоящее время исправлять её не планируется.
s, в которой первая буква каждого слова преобразуется в верхний регистр. String
Примеры
Пример использования
SELECT initcap('building for fast')
┌─initcap('building for fast')─┐
│ Building For Fast │
└──────────────────────────────┘
SELECT initcap('John''s cat won''t eat.');
┌─initcap('Joh⋯n\'t eat.')─┐
│ John'S Cat Won'T Eat. │
└──────────────────────────┘
initcap, initcapUTF8 преобразует первую букву каждого слова в верхний регистр, а остальные — в нижний.
Предполагается, что строка содержит корректный текст в кодировке UTF-8.
Если это предположение нарушено, исключение не генерируется, а результат не определён.
Эта функция не определяет язык, поэтому, например, для турецкого языка результат может быть не совсем корректным (i/İ vs. i/I).
Если длина последовательности байтов UTF-8 различается для верхнего и нижнего регистра кодовой точки, результат для этой кодовой точки может быть некорректным.
s, где первая буква каждого слова приведена к верхнему регистру. String
Примеры
Пример использования
SELECT initcapUTF8('не тормозит')
┌─initcapUTF8('не тормозит')─┐
│ Не Тормозит │
└────────────────────────────┘
isASCII
Аргументы
Возвращаемое значение
Примеры
isValidASCII
SELECT isValidASCII('hello') AS is_ascii, isValidASCII('你好') AS is_not_ascii
s — Строка, которую нужно проверить на корректность UTF-8. String
Возвращаемое значение
Возвращает 1, если набор байтов представляет собой корректный текст в кодировке UTF-8, в противном случае — 0. UInt8
Примеры
Пример использования
SELECT isValidUTF8('\\xc3\\xb1') AS valid, isValidUTF8('\\xc3\\x28') AS invalid
┌─valid─┬─invalid─┐
│ 1 │ 0 │
└───────┴─────────┘
s1 — Первая входная строка. Strings2 — Вторая входная строка. String
Возвращаемое значение
Возвращает коэффициент сходства Джаро для двух строк. Float64
Примеры
Пример использования
SELECT jaroSimilarity('clickhouse', 'click')
┌─jaroSimilarity('clickhouse', 'click')─┐
│ 0.8333333333333333 │
└───────────────────────────────────────┘
jaroWinklerSimilarity(s1, s2)
s1 — Первая входная строка. Strings2 — Вторая входная строка. String
Возвращаемое значение
Возвращает коэффициент сходства Джаро — Винклера для двух строк. Float64
Примеры
Пример использования
SELECT jaroWinklerSimilarity('clickhouse', 'click')
┌─jaroWinklerSimilarity('clickhouse', 'click')─┐
│ 0.8999999999999999 │
└──────────────────────────────────────────────┘
s с указанным смещением offset, отсчитываемым слева.
Синтаксис
Аргументы
Возвращаемое значение
Возвращает:
- Для положительного
offset — подстроку строки s длиной offset байт, начиная слева.
- Для отрицательного
offset — подстроку строки s длиной length(s) - |offset| байт, начиная слева.
- Пустую строку, если
length равно 0.
String
Примеры
Положительное смещение
SELECT left('Hello World', 5)
SELECT left('Hello World', -6)
length.
Синтаксис
leftPad(string, length[, pad_string])
lpad
Аргументы
string — Входная строка, которую нужно дополнить. Stringlength — Длина результирующей строки. Если значение меньше длины входной строки, входная строка усекается до length символов. (U)Int*pad_string — Необязательно. Строка, используемая для дополнения входной строки. Если не указана, входная строка дополняется пробелами. String
Возвращаемое значение
Возвращает строку заданной длины, дополненную слева. String
Примеры
Пример использования
SELECT leftPad('abc', 7, '*'), leftPad('def', 7)
┌─leftPad('abc', 7, '*')─┬─leftPad('def', 7)─┐
│ ****abc │ def │
└────────────────────────┴───────────────────┘
leftPad, который измеряет длину строки в байтах, здесь длина строки измеряется в кодовых точках.
Синтаксис
leftPadUTF8(string, length[, pad_string])
string — Входная строка, которую нужно дополнить. Stringlength — Длина результирующей строки. Если это значение меньше длины входной строки, она укорачивается до length символов. (U)Int*pad_string — Необязательно. Строка, которой дополняется входная строка. Если не указана, входная строка дополняется пробелами. String
Возвращаемое значение
Возвращает строку указанной длины, дополненную слева. String
Примеры
Пример использования
SELECT leftPadUTF8('абвг', 7, '*'), leftPadUTF8('дежз', 7)
┌─leftPadUTF8('абвг', 7, '*')─┬─leftPadUTF8('дежз', 7)─┐
│ ***абвг │ дежз │
└─────────────────────────────┴────────────────────────┘
s с указанным смещением offset, отсчитываемым слева.
Синтаксис
Аргументы
s — Строка в кодировке UTF-8, из которой вычисляется подстрока. String или FixedStringoffset — Количество байтов смещения. (U)Int*
Возвращаемое значение
Возвращает:
- Для положительного
offset — подстроку s длиной offset байт, начиная с левой стороны строки.\n”
- Для отрицательного
offset — подстроку s длиной length(s) - |offset| байт, начиная с левой стороны строки.\n”
- Пустую строку, если
length равен 0.
String
Примеры
Положительное смещение
SELECT leftUTF8('Привет', 4)
SELECT leftUTF8('Привет', -4)
CHARACTER_LENGTH, CHAR_LENGTH
Аргументы
s — строка, содержащая корректный текст в кодировке UTF-8. String
Возвращаемое значение
Длина строки s в кодовых точках Unicode. UInt64
Примеры
Пример использования
SELECT lengthUTF8('Здравствуй, мир!')
┌─lengthUTF8('Здравствуй, мир!')─┐
│ 16 │
└────────────────────────────────┘
lcase
Аргументы
s — Строка, которую нужно преобразовать в нижний регистр. String
Возвращаемое значение
Возвращает строку s, преобразованную в нижний регистр. String
Примеры
Пример использования
SELECT lower('CLICKHOUSE')
┌─lower('CLICKHOUSE')─┐
│ clickhouse │
└─────────────────────┘
input — Строка, которую нужно преобразовать в нижний регистр. String
Возвращаемое значение
Строка в нижнем регистре. String
Примеры
первый
SELECT lowerUTF8('München') as Lowerutf8;
NATURAL_SORT_KEY
Аргументы
s — строка, преобразуемая в ключ естественной сортировки. String
Возвращаемое значение
Возвращает строку ключа естественной сортировки, полученную из s. String
Примеры
Пример использования
SELECT s FROM t ORDER BY naturalSortKey(s)
┌─s───┐
│ a1 │
| a02 │
└─────┘
str — входная строка в кодировке UTF-8. String
Возвращаемое значение
Возвращает строку UTF-8 в нормализованной форме NFC. String
Примеры
Пример использования
SELECT
'é' AS original, -- e + комбинирующий акут (U+0065 + U+0301)
length(original),
normalizeUTF8NFC('é') AS nfc_normalized, -- é (U+00E9)
length(nfc_normalized);
┌─original─┬─length(original)─┬─nfc_normalized─┬─length(nfc_normalized)─┐
│ é │ 2 │ é │ 2 │
└──────────┴──────────────────┴────────────────┴────────────────────────┘
str — входная строка в кодировке UTF-8. String
Возвращаемое значение
Возвращает строку в нормализованной форме NFD в кодировке UTF-8. String
Примеры
Пример использования
SELECT
'é' AS original, -- é (U+00E9)
length(original),
normalizeUTF8NFD('é') AS nfd_normalized, -- e + комбинирующий акут (U+0065 + U+0301)
length(nfd_normalized);
┌─original─┬─length(original)─┬─nfd_normalized─┬─length(nfd_normalized)─┐
│ é │ 2 │ é │ 3 │
└──────────┴──────────────────┴────────────────┴────────────────────────┘
str — входная строка в кодировке UTF-8. String
Возвращаемое значение
Возвращает строку в кодировке UTF-8 в нормализованной форме NFKC. String
Примеры
Пример использования
SELECT
'① ② ③' AS original, -- Символы цифр в кружке
normalizeUTF8NFKC('① ② ③') AS nfkc_normalized; -- Преобразует в 1 2 3
┌─original─┬─nfkc_normalized─┐
│ ① ② ③ │ 1 2 3 │
└──────────┴─────────────────┘
normalizeUTF8NFKCCasefold
normalizeUTF8NFKCCasefold(str)
str — входная строка в кодировке UTF-8. String
Возвращаемое значение
Возвращает строку в нормализованной форме NFKC_Casefold. String
Примеры
Пример использования
SELECT
'Ä ① Hello' AS original,
normalizeUTF8NFKCCasefold('Ä ① Hello') AS nfkc_cf_normalized;
┌─original───┬─nfkc_cf_normalized─┐
│ Ä ① Hello │ ä 1 hello │
└────────────┴────────────────────┘
str — входная строка в кодировке UTF-8. String
Возвращаемое значение
Возвращает строку в нормализованной форме NFKD. String
Примеры
Пример использования
SELECT
'H₂O²' AS original, -- H + нижний индекс 2 + O + верхний индекс 2
normalizeUTF8NFKD('H₂O²') AS nfkd_normalized; -- Преобразует в H 2 O 2
┌─original─┬─nfkd_normalized─┐
│ H₂O² │ H2O2 │
└──────────┴─────────────────┘
s — строка, закодированная в Punycode. String
Возвращаемое значение
Возвращает открытый текст входного значения. String
Примеры
Пример использования
SELECT punycodeDecode('Mnchen-3ya')
┌─punycodeDecode('Mnchen-3ya')─┐
│ München │
└──────────────────────────────┘
String
Примеры
Пример использования
SELECT punycodeEncode('München')
┌─punycodeEncode('München')─┐
│ Mnchen-3ya │
└───────────────────────────┘
haystack первую подстроку, которая соответствует шаблону регулярного выражения и указанному индексу группы.
Синтаксис
regexpExtract(haystack, pattern[, index])
REGEXP_EXTRACT
Аргументы
haystack — String, строка, в которой ищется совпадение с шаблоном регулярного выражения. Stringpattern — String, регулярное выражение. pattern может содержать несколько групп регулярного выражения, а index указывает, какую именно группу нужно извлечь. Индекс 0 означает совпадение со всем регулярным выражением. const Stringindex — Необязательный. Целое число, большее или равное 0, со значением по умолчанию 1. Указывает, какую группу регулярного выражения нужно извлечь. (U)Int*
Возвращаемое значение
Возвращает совпадение в виде строки String
Примеры
Пример использования
SELECT
regexpExtract('100-200', '(\\d+)-(\\d+)', 1),
regexpExtract('100-200', '(\\d+)-(\\d+)', 2),
regexpExtract('100-200', '(\\d+)-(\\d+)', 0),
regexpExtract('100-200', '(\\d+)-(\\d+)');
┌─regexpExtract('100-200', '(\\d+)-(\\d+)', 1)─┬─regexpExtract('100-200', '(\\d+)-(\\d+)', 2)─┬─regexpExtract('100-200', '(\\d+)-(\\d+)', 0)─┬─regexpExtract('100-200', '(\\d+)-(\\d+)')─┐
│ 100 │ 200 │ 100-200 │ 100 │
└──────────────────────────────────────────────┴──────────────────────────────────────────────┴──────────────────────────────────────────────┴───────────────────────────────────────────┘
occurrence-го вхождения pattern в haystack, начиная поиск с байтовой позиции position.
Если return_option равен 0 (по умолчанию), возвращается позиция первого байта совпадения. Если 1 — позиция первого байта после совпадения.
Если subexpression больше 0, вместо позиции всего совпадения возвращается позиция соответствующей группы захвата.
Возвращает 0, если совпадение не найдено или если запрошенная группа захвата не участвовала в совпадении.
Функция предоставляется для совместимости с regexp_instr в PostgreSQL (и также доступна под этим псевдонимом). Обратите внимание: позиции измеряются в байтах, как и в других функциях ClickHouse для работы с регулярными выражениями; в PostgreSQL regexp_instr использует символьные позиции.
Синтаксис
regexpPosition(haystack, pattern[, position[, occurrence[, return_option[, flags[, subexpression]]]]])
regexpInstr, regexp_instr
Аргументы
haystack — Строка, в которой выполняется поиск. Stringpattern — Шаблон регулярного выражения. const Stringposition — Необязательно. Позиция в байтах, начиная с 1, с которой начинается поиск. По умолчанию: 1. (U)Int*occurrence — Необязательно. Какое по счёту совпадение вернуть. По умолчанию: 1. (U)Int*return_option — Необязательно. 0 возвращает позицию начала совпадения, 1 — позицию сразу после совпадения. По умолчанию: 0. (U)Int*flags — Необязательно. Флаги регулярного выражения. Поддерживаются: i (регистронезависимый), c (с учётом регистра), m/n (многострочные якоря), s (точка соответствует символу новой строки). По умолчанию: пустая строка. const Stringsubexpression — Необязательно. Индекс группы захвата, позицию которой нужно вернуть. 0 означает всё совпадение. По умолчанию: 0. (U)Int*
Возвращаемое значение
Возвращает позицию совпадения в байтах или 0, если совпадение не найдено. UInt64
Примеры
Базовое использование
SELECT
regexpPosition('hello world', 'world'),
regexpPosition('aXbXcXd', 'X', 1, 2),
regexpPosition('aXbXcXd', 'X', 1, 2, 1),
regexpPosition('Hello WORLD', 'world', 1, 1, 0, 'i'),
regexpPosition('foo123bar456', '([a-z]+)([0-9]+)', 1, 2, 0, '', 2);
┌─...─┬─...─┬─...─┬─...─┬─...─┐
│ 7 │ 4 │ 5 │ 7 │ 10 │
└─────┴─────┴─────┴─────┴─────┘
removeDiacriticsUTF8(str)
removeAccentsUTF8
Аргументы
str — входная строка в кодировке UTF-8. String
Возвращаемое значение
Строка в кодировке UTF-8 без диакритических знаков. String
Примеры
Базовое удаление диакритических знаков
SELECT removeDiacriticsUTF8('café résumé naïve')
┌─removeDiacriticsUTF8('café résumé naïve')─┐
│ cafe resume naive │
└────────────────────────────────────────────┘
s — строка, которую нужно повторить. Stringn — количество повторений строки. (U)Int*
Возвращаемое значение
Строка, содержащая строку s, повторённую n раз. Если n отрицательно, функция возвращает пустую строку. String
Примеры
Пример использования
┌─repeat('abc', 10)──────────────┐
│ abcabcabcabcabcabcabcabcabcabc │
└────────────────────────────────┘
s — String, содержащая корректный текст в кодировке UTF-8. String
Возвращаемое значение
Возвращает строку, в которой последовательность кодовых точек Unicode записана в обратном порядке. String
Примеры
Пример использования
SELECT reverseUTF8('ClickHouse')
s с заданным смещением offset от правого края.
Синтаксис
Аргументы
Возвращаемое значение
Возвращает:
- Для положительного
offset — подстроку s длиной offset байт, отсчитываемую от конца строки.
- Для отрицательного
offset — подстроку s длиной length(s) - |offset| байт, отсчитываемую от конца строки.
- Пустую строку, если
length равно 0.
String
Примеры
Положительное смещение
Отрицательное смещение
SELECT right('Hello', -3)
length.
Синтаксис
rightPad(string, length[, pad_string])
rpad
Аргументы
string — Исходная строка, которую нужно дополнить. Stringlength — Длина результирующей строки. Если значение меньше длины входной строки, входная строка укорачивается до length символов. (U)Int*pad_string — Необязательно. Строка, которой дополняется исходная строка. Если не указана, исходная строка дополняется пробелами. String
Возвращаемое значение
Возвращает строку заданной длины, дополненную справа. String
Примеры
Пример использования
SELECT rightPad('abc', 7, '*'), rightPad('abc', 7)
┌─rightPad('abc', 7, '*')─┬─rightPad('abc', 7)─┐
│ abc**** │ abc │
└─────────────────────────┴────────────────────┘
rightPad, который измеряет длину строки в байтах, здесь длина строки измеряется в кодовых точках.
Синтаксис
rightPadUTF8(string, length[, pad_string])
string — Входная строка, которую нужно дополнить. Stringlength — Длина результирующей строки. Если значение меньше длины входной строки, входная строка укорачивается до length символов. (U)Int*pad_string — Необязательно. Строка, которой дополняется входная строка. Если не указана, входная строка дополняется пробелами. String
Возвращаемое значение
Возвращает строку заданной длины, дополненную справа. String
Примеры
Пример использования
SELECT rightPadUTF8('абвг', 7, '*'), rightPadUTF8('абвг', 7)
┌─rightPadUTF8('абвг', 7, '*')─┬─rightPadUTF8('абвг', 7)─┐
│ абвг*** │ абвг │
└──────────────────────────────┴─────────────────────────┘
s с указанным offset, отсчитываемым справа.
Синтаксис
Аргументы
s — Строка в кодировке UTF-8, из которой извлекается подстрока. String или FixedStringoffset — Смещение в байтах. (U)Int*
Возвращаемое значение
Возвращает:
- Для положительного
offset — подстроку s длиной offset байт, отсчитываемую от конца строки.
- Для отрицательного
offset — подстроку s длиной length(s) - |offset| байт, отсчитываемую от конца строки.
- Пустую строку, если
length равно 0.
String
Примеры
Положительное смещение
SELECT rightUTF8('Привет', 4)
SELECT rightUTF8('Привет', -4)
String
Примеры
Пример использования
┌─soundex('aksel')─┐
│ A240 │
└──────────────────┘
) указанное количество раз.
Синтаксис
Аргументы
n — Количество повторений пробела. (U)Int*
Возвращаемое значение
Возвращает строку из n пробелов. Если n <= 0, функция возвращает пустую строку. String
Примеры
Пример использования
SELECT space(3) AS res, length(res);
┌─res─┬─length(res)─┐
│ │ 3 │
└─────┴─────────────┘
n,
для которых хеши (n-1)-грамм на границах подстроки
строго больше хешей любой (n-1)-граммы внутри неё.
Использует CRC32 в качестве хеш-функции.
Синтаксис
sparseGrams(s[, min_ngram_length[, max_ngram_length[, min_cutoff_length]]])
s — Входная строка. Stringmin_ngram_length — Необязательно. Минимальная длина извлекаемой n-граммы. Значение по умолчанию и минимально допустимое значение — 3. UInt*max_ngram_length — Необязательно. Максимальная длина извлекаемой n-граммы. Значение по умолчанию — 100. Должно быть не меньше min_ngram_length. UInt*min_cutoff_length — Необязательно. Если указано, возвращаются только n-граммы длиной не меньше min_cutoff_length. Значение по умолчанию совпадает с min_ngram_length. Должно быть не меньше min_ngram_length и не больше max_ngram_length. UInt*
Возвращаемое значение
Возвращает массив извлечённых подстрок. Array(String)
Примеры
Пример использования
SELECT sparseGrams('alice', 3)
┌─sparseGrams('alice', 3)────────────┐
│ ['ali','lic','lice','ice'] │
└────────────────────────────────────┘
n,
у которых хеши (n-1)-грамм на границах подстроки
строго больше хешей любой (n-1)-граммы внутри подстроки.
Использует CRC32 в качестве хеш-функции.
Синтаксис
sparseGramsHashes(s[, min_ngram_length, max_ngram_length])
s — Входная строка. Stringmin_ngram_length — Необязательно. Минимальная длина извлекаемой n-граммы. Значение по умолчанию и минимально допустимое значение — 3. UInt*max_ngram_length — Необязательно. Максимальная длина извлекаемой n-граммы. Значение по умолчанию — 100. Должно быть не меньше min_ngram_length. UInt*min_cutoff_length — Необязательно. Если указано, возвращаются только n-граммы длиной не меньше min_cutoff_length. Значение по умолчанию совпадает с min_ngram_length. Должно быть не меньше min_ngram_length и не больше max_ngram_length. UInt*
Возвращаемое значение
Возвращает массив CRC32-хешей выбранных подстрок. Array(UInt32)
Примеры
Пример использования
SELECT sparseGramsHashes('alice', 3)
┌─sparseGramsHashes('alice', 3)──────────────────────┐
│ [1481062250,2450405249,4012725991,1918774096] │
└────────────────────────────────────────────────────┘
n, для которых хеши (n-1)-грамм на границах подстроки строго больше, чем у любой (n-1)-граммы внутри подстроки.
Ожидает UTF-8 строку; в случае недопустимой последовательности UTF-8 генерирует исключение.
Использует CRC32 как хеш-функцию.
Синтаксис
sparseGramsHashesUTF8(s[, min_ngram_length, max_ngram_length])
s — Входная строка. Stringmin_ngram_length — Необязательно. Минимальная длина извлекаемой n-граммы. Значение по умолчанию и минимально допустимое значение — 3. UInt*max_ngram_length — Необязательно. Максимальная длина извлекаемой n-граммы. Значение по умолчанию — 100. Должно быть не меньше min_ngram_length. UInt*min_cutoff_length — Необязательно. Если указано, возвращаются только n-граммы длиной не меньше min_cutoff_length. Значение по умолчанию совпадает с min_ngram_length. Должно быть не меньше min_ngram_length и не больше max_ngram_length. UInt*
Возвращаемое значение
Возвращает массив CRC32-хэшей выбранных UTF-8-подстрок. Array(UInt32)
Примеры
Пример использования
SELECT sparseGramsHashesUTF8('алиса', 3)
┌─sparseGramsHashesUTF8('алиса', 3)─┐
│ [4178533925,3855635300,561830861] │
└───────────────────────────────────┘
n, у которых хеши (n-1)-грамм на границах подстроки строго больше, чем у любой (n-1)-граммы внутри неё.
Ожидает UTF-8 строку; генерирует исключение при недопустимой последовательности UTF-8.
Использует CRC32 в качестве хеш-функции.
Синтаксис
sparseGramsUTF8(s[, min_ngram_length[, max_ngram_length[, min_cutoff_length]]])
s — Входная строка. Stringmin_ngram_length — Необязательно. Минимальная длина извлекаемой n-граммы. Значение по умолчанию и минимально допустимое значение — 3. UInt*max_ngram_length — Необязательно. Максимальная длина извлекаемой n-граммы. Значение по умолчанию — 100. Должно быть не меньше min_ngram_length. UInt*min_cutoff_length — Необязательно. Если параметр указан, возвращаются только n-граммы длиной не менее min_cutoff_length. Значение по умолчанию совпадает со значением min_ngram_length. Должно быть не меньше min_ngram_length и не больше max_ngram_length. UInt*
Возвращаемое значение
Возвращает массив выбранных UTF-8-подстрок. Array(String)
Примеры
Пример использования
SELECT sparseGramsUTF8('алиса', 3)
┌─sparseGramsUTF8('алиса', 3)─┐
│ ['али','лис','иса'] │
└─────────────────────────────┘
s — Строка для проверки. Stringprefix — Префикс, наличие которого нужно проверить. String
Возвращаемое значение
Возвращает 1, если s начинается с prefix, иначе — 0. UInt8
Примеры
Пример использования
SELECT startsWith('ClickHouse', 'Click');
┌─startsWith('⋯', 'Click')─┐
│ 1 │
└──────────────────────────┘
startsWithCaseInsensitive
startsWithCaseInsensitive(s, prefix)
s — Строка, которую нужно проверить. Stringprefix — Регистронезависимый префикс, наличие которого нужно проверить. String
Возвращаемое значение
Возвращает 1, если s начинается с prefix без учёта регистра, в противном случае — 0. UInt8
Примеры
Пример использования
SELECT startsWithCaseInsensitive('ClickHouse', 'CLICK');
┌─startsWithCaseInsensitive('⋯', 'CLICK')─┐
│ 1 │
└─────────────────────────────────────────┘
startsWithCaseInsensitiveUTF8
startsWithCaseInsensitiveUTF8(s, prefix)
s — Строка, которую нужно проверить. Stringprefix — Регистронезависимый префикс, наличие которого нужно проверить. String
Возвращаемое значение
Возвращает 1, если s начинается с регистронезависимого prefix, иначе 0. UInt8
Примеры
Пример использования
SELECT startsWithCaseInsensitiveUTF8('приставка', 'при')
┌─startsWithUT⋯ка', 'при')─┐
│ 1 │
└──────────────────────────┘
startsWithUTF8(s, prefix)
s — Строка, которую нужно проверить. Stringprefix — Префикс, наличие которого нужно проверить. String
Возвращаемое значение
Возвращает 1, если s начинается с prefix, иначе — 0. UInt8
Примеры
Пример использования
SELECT startsWithUTF8('приставка', 'при')
┌─startsWithUT⋯ка', 'при')─┐
│ 1 │
└──────────────────────────┘
s — строка для анализа. String
Возвращаемое значение
Возвращает энтропию Шеннона для распределения байтов в строке. Float64
Примеры
Пример использования
SELECT stringBytesEntropy('Hello, world!')
┌─stringBytesEntropy('Hello, world!')─┐
│ 3.07049960 │
└─────────────────────────────────────┘
s — анализируемая строка. String
Возвращаемое значение
Количество различных байтов в строке. UInt16
Примеры
Пример использования
SELECT stringBytesUniq('Hello')
┌─stringBytesUniq('Hello')─┐
│ 4 │
└──────────────────────────┘
stringJaccardIndex(s1, s2)
s1 — Первая входная строка. Strings2 — Вторая входная строка. String
Возвращаемое значение
Возвращает индекс сходства по Жаккару для двух строк. Float64
Примеры
Пример использования
SELECT stringJaccardIndex('clickhouse', 'mouse')
┌─stringJaccardIndex('clickhouse', 'mouse')─┐
│ 0.4 │
└───────────────────────────────────────────┘
stringJaccardIndex, но для строк в кодировке UTF8.
Синтаксис
stringJaccardIndexUTF8(s1, s2)
s1 — Первая входная строка в кодировке UTF-8. Strings2 — Вторая входная строка в кодировке UTF-8. String
Возвращаемое значение
Возвращает индекс сходства Жаккара для двух строк в кодировке UTF-8. Float64
Примеры
Пример использования
SELECT stringJaccardIndexUTF8('我爱你', '我也爱你')
┌─stringJaccardIndexUTF8('我爱你', '我也爱你')─┐
│ 0.75 │
└─────────────────────────────────────────────┘
s, начинающуюся с указанного байтового смещения offset.
Подсчёт байтов начинается с 1 по следующей логике:
- Если
offset равен 0, возвращается пустая строка.
- Если
offset отрицательный, подстрока начинается на offset символов от конца строки, а не от её начала.
Необязательный аргумент length задаёт максимальное количество байтов в возвращаемой подстроке.
Синтаксис
substring(s, offset[, length])
byteSlice, mid, substr
Аргументы
s — Строка, из которой извлекается подстрока. String или FixedString или Enumoffset — Начальная позиция подстроки в s. (U)Int*length — Необязательный параметр. Максимальная длина подстроки. (U)Int*
Возвращаемое значение
Возвращает подстроку из s длиной length байт, начиная с индекса offset. String
Примеры
Базовое использование
SELECT 'database' AS db, substr(db, 5), substr(db, 5, 1)
┌─db───────┬─substring('database', 5)─┬─substring('database', 5, 1)─┐
│ database │ base │ b │
└──────────┴──────────────────────────┴─────────────────────────────┘
s до первых count вхождений разделителя delim, как в Spark или MySQL.
Синтаксис
substringIndex(s, delim, count)
SUBSTRING_INDEX
Аргументы
s — Строка, из которой нужно извлечь подстроку. Stringdelim — Символ-разделитель. Stringcount — Количество вхождений разделителя, которое нужно учесть перед извлечением подстроки. Если count положительный, возвращается всё слева от последнего разделителя (считая слева). Если count отрицательный, возвращается всё справа от последнего разделителя (считая справа). UInt или Int
Возвращаемое значение
Возвращает подстроку строки s до count-го вхождения delim. String
Примеры
Пример использования
SELECT substringIndex('www.clickhouse.com', '.', 2)
┌─substringIndex('www.clickhouse.com', '.', 2)─┐
│ www.clickhouse │
└──────────────────────────────────────────────┘
s до count вхождений разделителя delim; функция работает с кодовыми точками Unicode.
Предполагается, что строка содержит корректный текст в кодировке UTF-8.
Если это предположение нарушено, исключение не генерируется, а результат не определён.
Синтаксис
substringIndexUTF8(s, delim, count)
s — Строка, из которой извлекается подстрока. Stringdelim — Символ-разделитель. Stringcount — Количество вхождений разделителя, которое нужно отсчитать перед извлечением подстроки. Если count положительный, возвращается всё слева от последнего разделителя (при отсчёте слева). Если count отрицательный, возвращается всё справа от последнего разделителя (при отсчёте справа). UInt или Int
Возвращаемое значение
Возвращает подстроку s до count-го вхождения delim. String
Примеры
Пример UTF8
SELECT substringIndexUTF8('www.straßen-in-europa.de', '.', 2)
s, начинающуюся с указанной кодовой точки с индексом offset.
Отсчет кодовых точек начинается с 1 по следующей логике:
- Если
offset равен 0, возвращается пустая строка.
- Если
offset отрицательный, подстрока начинается с кодовой точки, расположенной на offset позиций от конца строки, а не от начала.
Необязательный аргумент length задает максимальное количество кодовых точек в возвращаемой подстроке.
Эта функция предполагает, что строка содержит корректный текст в кодировке UTF-8.
Если это предположение нарушено, исключение не сгенерируется, а результат будет неопределенным.
substringUTF8(s, offset[, length])
s — Строка, из которой извлекается подстрока. String или FixedString или Enumoffset — Начальная позиция подстроки в s. Int или UIntlength — Максимальная длина подстроки. Необязательный параметр. Int или UInt
Возвращаемое значение
Возвращает подстроку из s длиной length кодовых точек, начиная с кодовой точки с индексом offset. String
Примеры
Пример использования
SELECT 'Täglich grüßt das Murmeltier.' AS str, substringUTF8(str, 9), substringUTF8(str, 9, 5)
Täglich grüßt das Murmeltier. grüßt das Murmeltier. grüßt
� (U+FFFD).
Если обнаруживается несколько недопустимых символов подряд, они заменяются одним символом замены.
Синтаксис
Аргументы
s — Любая последовательность байтов, представленная объектом типа данных String. String
Возвращаемое значение
Возвращает допустимую строку UTF-8. String
Примеры
Пример использования
SELECT toValidUTF8('\\x61\\xF0\\x80\\x80\\x80b')
c
┌─toValidUTF8('a����b')─┐
│ a�b │
└───────────────────────┘
trimBoth(s[, trim_characters])
trim
Аргументы
s — Обрезаемая строка. Stringtrim_characters — Необязательно. Символы, которые нужно удалить. Если не указано, удаляются стандартные пробельные символы. String
Возвращаемое значение
Возвращает строку, у которой указанные символы удалены с обоих концов. String
Примеры
Пример использования
SELECT trimBoth('$$ClickHouse$$', '$')
┌─trimBoth('$$⋯se$$', '$')─┐
│ ClickHouse │
└──────────────────────────┘
trimLeft(input[, trim_characters])
ltrim
Аргументы
input — Строка, из которой удаляются символы. Stringtrim_characters — Необязательно. Символы, которые нужно удалить. Если не указано, удаляются распространённые пробельные символы. String
Возвращаемое значение
Возвращает строку, из которой указанные символы удалены слева. String
Примеры
Пример использования
SELECT trimLeft('ClickHouse', 'Click');
┌─trimLeft('Cl⋯', 'Click')─┐
│ House │
└──────────────────────────┘
trimRight(s[, trim_characters])
rtrim
Аргументы
s — Строка, из которой нужно удалить символы. Stringtrim_characters — Необязательные символы для удаления. Если не указаны, удаляются обычные пробельные символы. String
Возвращаемое значение
Возвращает строку, у которой указанные символы удалены справа. String
Примеры
Пример использования
SELECT trimRight('ClickHouse','House');
┌─trimRight('C⋯', 'House')─┐
│ Click │
└──────────────────────────┘
encoded — столбец String или константа, которую нужно декодировать. Если строка не является корректной строкой в кодировке Base32, то в случае ошибки возвращается пустая строка. String
Возвращаемое значение
Возвращает строку, содержащую декодированное значение аргумента. String
Примеры
Пример использования
SELECT tryBase32Decode('IVXGG33EMVSA====');
┌─tryBase32Decode('IVXGG33EMVSA====')─┐
│ Encoded │
└─────────────────────────────────────┘
base58Decode, но в случае ошибки возвращает пустую строку.
Синтаксис
tryBase58Decode(encoded[, expected_size])
encoded — Столбец типа String или константа. Если строка некорректно закодирована в Base58, в случае ошибки возвращается пустая строка. Stringexpected_size — Необязательно. Ожидаемый размер декодированного значения в байтах. Если указано 32 или 64, используется оптимизированный декодер; для других значений используется универсальный декодер. UInt8, UInt16, UInt32, or UInt64
Возвращаемое значение
Возвращает строку с декодированным значением аргумента. String
Примеры
Пример использования
SELECT tryBase58Decode('3dc8KtHrwM') AS res, tryBase58Decode('invalid') AS res_invalid;
┌─res─────┬─res_invalid─┐
│ Encoded │ │
└─────────┴─────────────┘
base64Decode, но в случае ошибки возвращает пустую строку.
Синтаксис
Аргументы
encoded — столбец String или константа для декодирования. Если строка не является корректной строкой в кодировке Base64, в случае ошибки возвращается пустая строка. String
Возвращаемое значение
Возвращает строку, содержащую декодированное значение аргумента. String
Примеры
Пример использования
SELECT tryBase64Decode('Y2xpY2tob3VzZQ==')
┌─tryBase64Decode('Y2xpY2tob3VzZQ==')─┐
│ clickhouse │
└─────────────────────────────────────┘
base64URLDecode, но в случае ошибки возвращает пустую строку.
Синтаксис
tryBase64URLDecode(encoded)
encoded — столбец типа String или константа для декодирования. Если строка не является допустимой строкой в кодировке Base64, то в случае ошибки возвращается пустая строка. String
Возвращаемое значение
Возвращает строку с декодированным значением аргумента. String
Примеры
Пример использования
SELECT tryBase64URLDecode('aHR0cHM6Ly9jbGlja2hvdXNlLmNvbQ')
┌─tryBase64URLDecode('aHR0cHM6Ly9jbGlja2hvdXNlLmNvbQ')─┐
│ https://clickhouse.com │
└──────────────────────────────────────────────────────┘
String
Примеры
Пример использования
SELECT tryIdnaEncode('straße.münchen.de')
┌─tryIdnaEncode('straße.münchen.de')──┐
│ xn--strae-oqa.xn--mnchen-3ya.de │
└─────────────────────────────────────┘
punycodeDecode, но возвращает пустую строку, если передана невалидная строка, закодированная в Punycode.
Синтаксис
Аргументы
s — строка, закодированная в Punycode. String
Возвращаемое значение
Возвращает открытый текст входного значения или пустую строку, если входное значение недопустимо. String
Примеры
Пример использования
SELECT tryPunycodeDecode('Mnchen-3ya')
┌─tryPunycodeDecode('Mnchen-3ya')─┐
│ München │
└─────────────────────────────────┘
ucase
Аргументы
s — Строка, которую нужно преобразовать в верхний регистр. String
Возвращаемое значение
Возвращает строку s в верхнем регистре. String
Примеры
Пример использования
SELECT upper('clickhouse')
┌─upper('clickhouse')─┐
│ CLICKHOUSE │
└─────────────────────┘
Эта функция не определяет язык, поэтому, например, для турецкого языка результат может быть не совсем корректным (i/İ vs. i/I).
Если длина последовательности байтов UTF-8 различается для одного и того же кодового символа в верхнем и нижнем регистре (например, ẞ и ß), результат для этого кодового символа может быть некорректным.
String. String
Примеры
Пример использования
SELECT upperUTF8('München') AS Upperutf8
┌─Upperutf8─┐
│ MÜNCHEN │
└───────────┘
Последнее изменение 10 июня 2026 г.
