Las funciones para buscar en cadenas y para reemplazar en cadenas se describen por separado.
La documentación siguiente se genera a partir de la tabla del sistema system.functions.
0xffffffff (implementación de zlib).
Sintaxis
Argumentos
s — Cadena para la que se calcula CRC32. String
Valor devuelto
Devuelve la suma de comprobación CRC32 de la cadena. UInt32
Ejemplos
Ejemplo de uso
SELECT CRC32('ClickHouse')
┌─CRC32('ClickHouse')─┐
│ 1538217360 │
└─────────────────────┘
s — Cadena para la que se calcula CRC32. String
Valor devuelto
Devuelve la suma de comprobación CRC32 de la cadena. UInt32
Ejemplos
Ejemplo de uso
SELECT CRC32IEEE('ClickHouse');
┌─CRC32IEEE('ClickHouse')─┐
│ 3089448422 │
└─────────────────────────┘
s — Cadena para la que se calcula CRC64. String
Valor devuelto
Devuelve la suma de comprobación CRC64 de la cadena. UInt64
Ejemplos
Ejemplo de uso
SELECT CRC64('ClickHouse');
┌──CRC64('ClickHouse')─┐
│ 12126588151325169346 │
└──────────────────────┘
appendTrailingCharIfAbsent
c a la cadena s si s no está vacía y no termina con el carácter c.
Sintaxis
appendTrailingCharIfAbsent(s, c)
s — Cadena de entrada. Stringc — Carácter que se añade si no está presente. String
Valor devuelto
Devuelve la cadena s con el carácter c añadido si s no termina en c. String
Ejemplos
Ejemplo de uso
SELECT appendTrailingCharIfAbsent('https://example.com', '/');
┌─appendTraili⋯.com', '/')─┐
│ https://example.com/ │
└──────────────────────────┘
s como un valor Int32.
Sintaxis
Argumentos
Valor devuelto
Devuelve el código ASCII del primer carácter. Si s está vacío, el resultado es 0. Si el primer carácter no es un carácter ASCII o no pertenece al rango de suplemento Latin-1 de UTF-16, el resultado no está definido. Int32
Ejemplos
Ejemplo de uso
┌─ascii('234')─┐
│ 50 │
└──────────────┘
encoded — columna de tipo String o constante. String
Valor devuelto
Devuelve una cadena que contiene el valor decodificado del argumento. String
Ejemplos
Ejemplo de uso
SELECT base32Decode('IVXGG33EMVSA====');
┌─base32Decode('IVXGG33EMVSA====')─┐
│ Encoded │
└──────────────────────────────────┘
plaintext — texto plano que se va a codificar. String
Valor devuelto
Devuelve una cadena que contiene el valor codificado del argumento. String o FixedString
Ejemplos
Ejemplo de uso
SELECT base32Encode('Encoded')
┌─base32Encode('Encoded')─┐
│ IVXGG33EMVSA==== │
└─────────────────────────┘
expected_size, para seleccionar un decodificador optimizado de tamaño fijo.
Actualmente, los valores admitidos son 32 y 64. Para otros valores, se utiliza el decodificador genérico.
Cuando se selecciona el decodificador optimizado pero la entrada no puede decodificarse en exactamente esa cantidad de bytes,
la función lanza una excepción (o devuelve una cadena vacía en tryBase58Decode).
Sintaxis
base58Decode(encoded[, expected_size])
encoded — Columna String o constante para decodificar. Stringexpected_size — Opcional. Tamaño esperado del valor decodificado en bytes. Cuando es 32 o 64, se usa un decodificador optimizado; para otros valores, se usa el decodificador genérico. UInt8, UInt16, UInt32, or UInt64
Valor devuelto
Devuelve una cadena con el valor decodificado del argumento. String
Ejemplos
Ejemplo de uso
SELECT base58Decode('JxF12TrwUP45BMd');
┌─base58Decode⋯rwUP45BMd')─┐
│ Hello World │
└──────────────────────────┘
plaintext — texto plano que se va a codificar. String
Valor devuelto
Devuelve una cadena que contiene el valor codificado del argumento. String
Ejemplos
Ejemplo de uso
SELECT base58Encode('ClickHouse');
┌─base58Encode('ClickHouse')─┐
│ 4nhk8K7GHXf6zx │
└────────────────────────────┘
FROM_BASE64
Argumentos
encoded — Columna String o constante que se debe decodificar. Si la cadena no está codificada en Base64 de forma válida, se genera una excepción. String
Valor devuelto
Devuelve la cadena decodificada. String
Ejemplos
Ejemplo de uso
SELECT base64Decode('Y2xpY2tob3VzZQ==')
┌─base64Decode('Y2xpY2tob3VzZQ==')─┐
│ clickhouse │
└──────────────────────────────────┘
TO_BASE64
Argumentos
plaintext — Columna o constante de texto plano que se va a decodificar. String
Valor devuelto
Devuelve una cadena que contiene el valor codificado del argumento. String
Ejemplos
Ejemplo de uso
SELECT base64Encode('clickhouse')
┌─base64Encode('clickhouse')─┐
│ Y2xpY2tob3VzZQ== │
└────────────────────────────┘
encoded — Columna String o constante para codificar. Si la cadena no está codificada en Base64 de forma válida, se lanza una excepción. String
Valor devuelto
Devuelve una cadena que contiene el valor decodificado del argumento. String
Ejemplos
Ejemplo de uso
SELECT base64URLDecode('aHR0cHM6Ly9jbGlja2hvdXNlLmNvbQ')
┌─base64URLDecode('aHR0cHM6Ly9jbGlja2hvdXNlLmNvbQ')─┐
│ https://clickhouse.com │
└───────────────────────────────────────────────────┘
base64URLEncode(plaintext)
plaintext — Columna o constante de texto plano para codificar. String
Valor devuelto
Devuelve una cadena con el valor codificado del argumento. String
Ejemplos
Ejemplo de uso
SELECT base64URLEncode('https://clickhouse.com')
┌─base64URLEncode('https://clickhouse.com')─┐
│ aHR0cHM6Ly9jbGlja2hvdXNlLmNvbQ │
└───────────────────────────────────────────┘
expr — Una expresión de tipo cadena. Las barras invertidas deben escaparse. String
Valor devuelto
Devuelve la parte final de la cadena de entrada después de la última barra o barra invertida. Si la cadena de entrada termina con una barra o una barra invertida, la función devuelve una cadena vacía. Devuelve la cadena original si no contiene barras ni barras invertidas. String
Ejemplos
Extraer el nombre de archivo de una ruta de 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
Argumentos
s1 — Primera cadena de entrada. Strings2 — Segunda cadena de entrada. String
Valor devuelto
Devuelve la distancia de Hamming entre ambas cadenas. UInt64
Ejemplos
Ejemplo de uso
SELECT byteHammingDistance('karolin', 'kathrin')
┌─byteHammingDistance('karolin', 'kathrin')─┐
│ 3 │
└───────────────────────────────────────────┘
ffi, siguen descomponiéndose porque el propio case folding de Unicode las expande.
Sintaxis
Argumentos
str — Cadena de entrada codificada en UTF-8. String
Valor devuelto
Cadena UTF-8 con normalización de mayúsculas y minúsculas. String
Ejemplos
Normalización básica de mayúsculas y minúsculas
SELECT caseFoldUTF8('Straße')
┌─caseFoldUTF8('Straße')─┐
│ strasse │
└─────────────────────────┘
compareSubstrings(s1, s2, s1_offset, s2_offset, num_bytes)
s1 — La primera cadena que se comparará. Strings2 — La segunda cadena que se comparará. Strings1_offset — La posición (indexada desde cero) en s1 a partir de la cual comienza la comparación. UInt*s2_offset — La posición (índice basado en cero) en s2 a partir de la cual comienza la comparación. UInt*num_bytes — El número máximo de bytes que se comparará en ambas cadenas. Si s1_offset (o s2_offset) + num_bytes supera el final de una cadena de entrada, num_bytes se reducirá en consecuencia. UInt*
Valor devuelto
Devuelve:
-1 si s1[s1_offset : s1_offset + num_bytes] < s2[s2_offset : s2_offset + num_bytes].0 si s1[s1_offset : s1_offset + num_bytes] = s2[s2_offset : s2_offset + num_bytes].1 si s1[s1_offset : s1_offset + num_bytes] > s2[s2_offset : s2_offset + num_bytes].
Int8
Ejemplos
Ejemplo de uso
SELECT compareSubstrings('Saxony', 'Anglo-Saxon', 0, 6, 5) AS result
┌─result─┐
│ 0 │
└────────┘
String o FixedString se convierten en cadenas mediante su serialización predeterminada.
Como esto reduce el rendimiento, no se recomienda usar argumentos distintos de String/FixedString.
Sintaxis
Argumentos
s1, s2, ... — Cualquier cantidad de valores de cualquier tipo. Any
Valor devuelto
Devuelve la cadena creada al concatenar los argumentos. Si alguno de los argumentos es NULL, la función devuelve NULL. Si no hay argumentos, devuelve una cadena vacía. Nullable(String)
Ejemplos
Concatenación de cadenas
SELECT concat('Hello, ', 'World!')
┌─concat('Hello, ', 'World!')─┐
│ Hello, World! │
└─────────────────────────────┘
┌─concat(42, 144)─┐
│ 42144 │
└─────────────────┘
concat, pero asume que concat(s1, s2, ...) → sn es inyectiva,
es decir, que devuelve resultados distintos para argumentos distintos.
Puede utilizarse para optimizar GROUP BY.
Sintaxis
concatAssumeInjective([s1, s2, ...])
NULL, la función devuelve NULL. Si no se pasa ningún argumento, devuelve una cadena vacía. String
Ejemplos
Optimización de 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
Argumentos
sep — El separador que se usará. const String o const FixedStringexp1, exp2, ... — Expresiones que se concatenarán. Los argumentos que no sean de tipo String o FixedString se convierten en cadenas mediante su serialización predeterminada. Como esto reduce el rendimiento, no se recomienda usar argumentos distintos de String/FixedString. Any
Valor devuelto
Devuelve la cadena creada al concatenar los argumentos. Si alguno de los valores de los argumentos es NULL, la función devuelve NULL. String
Ejemplos
Ejemplo de uso
SELECT concatWithSeparator('a', '1', '2', '3', '4')
┌─concatWithSeparator('a', '1', '2', '3', '4')─┐
│ 1a2a3a4 │
└──────────────────────────────────────────────┘
concatWithSeparatorAssumeInjective
concatWithSeparator, pero asume que concatWithSeparator(sep[,exp1, exp2, ... ]) → result es inyectiva.
Se considera inyectiva una función si devuelve resultados distintos para argumentos distintos.
Puede usarse para optimizar GROUP BY.
Sintaxis
concatWithSeparatorAssumeInjective(sep[, exp1, exp2, ... ])
sep — El separador que se va a utilizar. const String o const FixedStringexp1, exp2, ... — Expresión que se va a concatenar. Los argumentos que no sean de tipo String o FixedString se convierten en cadenas mediante su serialización predeterminada. Como esto reduce el rendimiento, no se recomienda usar argumentos que no sean String/FixedString. String o FixedString
Valor devuelto
Devuelve la cadena creada al concatenar los argumentos. Si alguno de los valores de los argumentos es NULL, la función devuelve NULL. String
Ejemplos
Ejemplo de uso
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 — El número que se va a convertir. Puede ser una cadena o un tipo numérico. - from_base — La base de origen (2-36). Debe ser un entero. - to_base — La base de destino (2-36). Debe ser un entero.
Valor devuelto
Representación textual del número en la base de destino.
Ejemplos
Convertir de decimal a binario
Convertir de hexadecimal a decimal
SELECT conv('FF', 16, 10)
SELECT conv('-1', 10, 16)
SELECT conv('1010', 2, 8)
s convertida desde la codificación from a la codificación to.
Sintaxis
convertCharset(s, from, to)
s — Cadena de entrada. Stringfrom — Codificación de caracteres de origen. Stringto — Codificación de caracteres de destino. String
Valor devuelto
Devuelve la cadena s convertida de la codificación from a to. String
Ejemplos
Ejemplo de uso
SELECT convertCharset('Café', 'UTF-8', 'ISO-8859-1');
┌─convertChars⋯SO-8859-1')─┐
│ Caf� │
└──────────────────────────┘
damerauLevenshteinDistance
damerauLevenshteinDistance(s1, s2)
s1 — Primera cadena de entrada. Strings2 — Segunda cadena de entrada. String
Valor devuelto
Devuelve la distancia de Damerau-Levenshtein entre las dos cadenas. UInt64
Ejemplos
Ejemplo de uso
SELECT damerauLevenshteinDistance('clickhouse', 'mouse')
┌─damerauLevenshteinDistance('clickhouse', 'mouse')─┐
│ 6 │
└───────────────────────────────────────────────────┘
s — Cadena que contiene entidades HTML que se deben decodificar. String
Valor devuelto
Devuelve la cadena con las entidades HTML decodificadas. String
Ejemplos
Ejemplo de uso
SELECT decodeHTMLComponent('<div>Hello & "World"</div>')
┌─decodeHTMLComponent('<div>Hello & "World"</div>')─┐
│ <div>Hello & "World"</div> │
└─────────────────────────────────────────────────────────────────────────────┘
s — Cadena que contiene entidades XML que se deben decodificar. String
Valor devuelto
Devuelve la cadena proporcionada con las entidades XML decodificadas. String
Ejemplos
Ejemplo de uso
SELECT decodeXMLComponent('<tag>Hello & World</tag>')
┌─decodeXMLCom⋯;/tag>')─┐
│ <tag>Hello & World</tag> │
└──────────────────────────┘
levenshteinDistance
Argumentos
s1 — Primera cadena de entrada. Strings2 — Segunda cadena de entrada. String
Valor devuelto
Devuelve la distancia de edición entre ambas cadenas. UInt64
Ejemplos
Ejemplo de uso
SELECT editDistance('clickhouse', 'mouse')
┌─editDistance('clickhouse', 'mouse')─┐
│ 6 │
└─────────────────────────────────────┘
levenshteinDistanceUTF8
Argumentos
s1 — Primera cadena de entrada. Strings2 — Segunda cadena de entrada. String
Valor devuelto
Devuelve la distancia de edición entre las dos cadenas UTF-8. UInt64
Ejemplos
Ejemplo de uso
SELECT editDistanceUTF8('我是谁', '我是我')
┌─editDistanceUTF8('我是谁', '我是我')──┐
│ 1 │
└─────────────────────────────────────┘
s — Cadena que se debe escapar. String
Valor devuelto
Devuelve la cadena escapada. String
Ejemplos
Ejemplo de uso
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 — Cadena a comprobar. Stringsuffix — Sufijo a comprobar. String
Valor devuelto
Devuelve 1 si s termina con suffix; en caso contrario, 0. UInt8
Ejemplos
Ejemplo de uso
SELECT endsWith('ClickHouse', 'House');
┌─endsWith('Cl⋯', 'House')─┐
│ 1 │
└──────────────────────────┘
endsWithCaseInsensitive(s, suffix)
s — Cadena que se va a comprobar. Stringsuffix — Sufijo sin distinguir entre mayúsculas y minúsculas que se va a comprobar. String
Valor devuelto
Devuelve 1 si s termina con el suffix sin distinguir entre mayúsculas y minúsculas; de lo contrario, 0. UInt8
Ejemplos
Ejemplo de uso
SELECT endsWithCaseInsensitive('ClickHouse', 'HOUSE');
┌─endsWithCaseInsensitive('Cl⋯', 'HOUSE')─┐
│ 1 │
└─────────────────────────────────────────┘
endsWithCaseInsensitiveUTF8
s termina con el suffix sin distinguir entre mayúsculas y minúsculas.
Asume que la cadena contiene texto válido codificado en UTF-8.
Si no se cumple esta condición, no se lanza ninguna excepción y el resultado es indefinido.
Sintaxis
endsWithCaseInsensitiveUTF8(s, suffix)
s — String que se debe comprobar. Stringsuffix — Sufijo que se debe comprobar sin distinguir entre mayúsculas y minúsculas. String
Valor devuelto
Devuelve 1 si s termina con el suffix sin distinguir entre mayúsculas y minúsculas; de lo contrario, 0. UInt8
Ejemplos
Ejemplo de uso
SELECT endsWithCaseInsensitiveUTF8('данных', 'ых');
┌─endsWithCaseInsensitiveUTF8('данных', 'ых')─┐
│ 1 │
└─────────────────────────────────────────────┘
s termina con suffix.
Asume que la cadena contiene texto válido codificado en UTF-8.
Si no se cumple esta suposición, no se lanza ninguna excepción y el resultado es indefinido.
Sintaxis
Argumentos
s — String que se va a comprobar. Stringsuffix — Sufijo que se va a comprobar. String
Valor devuelto
Devuelve 1 si s termina con suffix; de lo contrario, 0. UInt8
Ejemplos
Ejemplo de uso
SELECT endsWithUTF8('данных', 'ых');
┌─endsWithUTF8('данных', 'ых')─┐
│ 1 │
└──────────────────────────────┘
- La eliminación de todas las etiquetas HTML/XML
- La eliminación de comentarios (
{/* */})
- La eliminación de los elementos script y style junto con su contenido
- El procesamiento de secciones CDATA (copiadas literalmente)
- El tratamiento y la normalización correctos de los espacios en blanco
Nota: las entidades HTML no se decodifican y deben procesarse con una función aparte si es necesario.
Sintaxis
extractTextFromHTML(html)
html — Cadena con contenido HTML del que se extrae el texto. String
Valor devuelto
Devuelve el contenido de texto extraído con espacios en blanco normalizados. String
Ejemplos
Ejemplo de uso
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
Ejemplos
Ejemplo de uso
SELECT firstLine('foo\\nbar\\nbaz')
┌─firstLine('foo\nbar\nbaz')─┐
│ foo │
└────────────────────────────┘
idnaEncode() y idnaDecode() no devuelve necesariamente la cadena original debido a la normalización de mayúsculas y minúsculas.
Sintaxis
Argumentos
Valor devuelto
Devuelve una representación Unicode (UTF-8) de la cadena de entrada según el mecanismo IDNA correspondiente al valor de entrada. String
Ejemplos
Ejemplo de uso
SELECT idnaDecode('xn--strae-oqa.xn--mnchen-3ya.de')
┌─idnaDecode('xn--strae-oqa.xn--mnchen-3ya.de')─┐
│ straße.münchen.de │
└───────────────────────────────────────────────┘
No se realiza ninguna decodificación de porcentajes ni se eliminan tabulaciones, espacios o caracteres de control.
String
Ejemplos
Ejemplo de uso
SELECT idnaEncode('straße.münchen.de')
┌─idnaEncode('straße.münchen.de')─────┐
│ xn--strae-oqa.xn--mnchen-3ya.de │
└─────────────────────────────────────┘
Como initcap solo convierte a mayúscula la primera letra de cada palabra, es posible que observe un comportamiento inesperado en palabras que contienen apóstrofos o letras mayúsculas.
Este es un comportamiento conocido y actualmente no está previsto corregirlo.
s con la primera letra de cada palabra en mayúscula. String
Ejemplos
Ejemplo de uso
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 convierte la primera letra de cada palabra en mayúscula y el resto en minúsculas.
Se asume que la cadena contiene texto válido codificado en UTF-8.
Si no se cumple esta suposición, no se lanza ninguna excepción y el resultado no está definido.
Esta función no detecta el idioma; por ejemplo, para el turco, el resultado podría no ser exactamente correcto (i/İ vs. i/I).
Si la longitud de la secuencia de bytes UTF-8 difiere entre las formas en mayúsculas y minúsculas de un punto de código, el resultado puede ser incorrecto para ese punto de código.
s con la primera letra de cada palabra en mayúscula. String
Ejemplos
Ejemplo de uso
SELECT initcapUTF8('не тормозит')
┌─initcapUTF8('не тормозит')─┐
│ Не Тормозит │
└────────────────────────────┘
isASCII
Argumentos
Valor devuelto
Ejemplos
isValidASCII
SELECT isValidASCII('hello') AS is_ascii, isValidASCII('你好') AS is_not_ascii
s — La cadena cuya validez de codificación UTF-8 se comprobará. String
Valor devuelto
Devuelve 1 si el conjunto de bytes constituye texto válido codificado en UTF-8; de lo contrario, 0. UInt8
Ejemplos
Ejemplo de uso
SELECT isValidUTF8('\\xc3\\xb1') AS valid, isValidUTF8('\\xc3\\x28') AS invalid
┌─valid─┬─invalid─┐
│ 1 │ 0 │
└───────┴─────────┘
s1 — Primera cadena de entrada. Strings2 — Segunda cadena de entrada. String
Valor devuelto
Devuelve la similitud Jaro entre ambas cadenas. Float64
Ejemplos
Ejemplo de uso
SELECT jaroSimilarity('clickhouse', 'click')
┌─jaroSimilarity('clickhouse', 'click')─┐
│ 0.8333333333333333 │
└───────────────────────────────────────┘
jaroWinklerSimilarity(s1, s2)
s1 — Primera cadena de entrada. Strings2 — Segunda cadena de entrada. String
Valor devuelto
Devuelve la similitud de Jaro-Winkler entre ambas cadenas. Float64
Ejemplos
Ejemplo de uso
SELECT jaroWinklerSimilarity('clickhouse', 'click')
┌─jaroWinklerSimilarity('clickhouse', 'click')─┐
│ 0.8999999999999999 │
└──────────────────────────────────────────────┘
s con un offset especificado, a partir de la izquierda.
Sintaxis
Argumentos
s — La cadena a partir de la cual se calcula una subcadena. String o FixedStringoffset — La cantidad de bytes de desplazamiento. (U)Int*
Valor devuelto
Devuelve:
- Para
offset positivo, una subcadena de s de offset bytes, empezando por la izquierda de la cadena.
- Para
offset negativo, una subcadena de s de length(s) - |offset| bytes, empezando por la izquierda de la cadena.
- Una cadena vacía si
length es 0.
String
Ejemplos
Desplazamiento positivo
SELECT left('Hello World', 5)
SELECT left('Hello World', -6)
length especificada.
Sintaxis
leftPad(string, length[, pad_string])
lpad
Argumentos
string — Cadena de entrada que debe rellenarse. Stringlength — Longitud de la cadena resultante. Si el valor es menor que la longitud de la cadena de entrada, esta se acorta a length caracteres. (U)Int*pad_string — Opcional. Cadena utilizada para rellenar la cadena de entrada. Si no se especifica, la cadena de entrada se rellena con espacios. String
Valor devuelto
Devuelve una cadena rellenada por la izquierda con la longitud indicada. String
Ejemplos
Ejemplo de uso
SELECT leftPad('abc', 7, '*'), leftPad('def', 7)
┌─leftPad('abc', 7, '*')─┬─leftPad('def', 7)─┐
│ ****abc │ def │
└────────────────────────┴───────────────────┘
leftPad, que mide la longitud de la cadena en bytes, aquí la longitud de la cadena se mide en puntos de código.
Sintaxis
leftPadUTF8(string, length[, pad_string])
string — Cadena de entrada que se debe rellenar. Stringlength — La longitud de la cadena resultante. Si el valor es menor que la longitud de la cadena de entrada, esta se acorta a length caracteres. (U)Int*pad_string — Opcional. La cadena con la que se rellena la cadena de entrada. Si no se especifica, la cadena de entrada se rellena con espacios. String
Valor devuelto
Devuelve una cadena rellenada por la izquierda con la longitud indicada. String
Ejemplos
Ejemplo de uso
SELECT leftPadUTF8('абвг', 7, '*'), leftPadUTF8('дежз', 7)
┌─leftPadUTF8('абвг', 7, '*')─┬─leftPadUTF8('дежз', 7)─┐
│ ***абвг │ дежз │
└─────────────────────────────┴────────────────────────┘
s codificada en UTF-8, con un offset especificado desde la izquierda.
Sintaxis
Argumentos
s — La cadena codificada en UTF-8 a partir de la cual se calcula una subcadena. String o FixedStringoffset — El desplazamiento en bytes. (U)Int*
Valor devuelto
Devuelve:
- Para un
offset positivo, una subcadena de s de offset bytes, empezando desde la izquierda de la cadena.\n”
- Para un
offset negativo, una subcadena de s de length(s) - |offset| bytes, empezando desde la izquierda de la cadena.\n”
- Una cadena vacía si
length es 0.
String
Ejemplos
Desplazamiento positivo
SELECT leftUTF8('Привет', 4)
SELECT leftUTF8('Привет', -4)
CHARACTER_LENGTH, CHAR_LENGTH
Argumentos
s — Cadena que contiene texto codificado en UTF-8 válido. String
Valor devuelto
Longitud de la cadena s en puntos de código Unicode. UInt64
Ejemplos
Ejemplo de uso
SELECT lengthUTF8('Здравствуй, мир!')
┌─lengthUTF8('Здравствуй, мир!')─┐
│ 16 │
└────────────────────────────────┘
lcase
Argumentos
s — Una cadena para convertir a minúsculas. String
Valor devuelto
Devuelve s en minúsculas. String
Ejemplos
Ejemplo de uso
SELECT lower('CLICKHOUSE')
┌─lower('CLICKHOUSE')─┐
│ clickhouse │
└─────────────────────┘
input — Cadena de entrada que se convierte a minúsculas. String
Valor devuelto
Devuelve una cadena en minúsculas. String
Ejemplos
primero
SELECT lowerUTF8('München') as Lowerutf8;
NATURAL_SORT_KEY
Argumentos
s — Una cadena para convertirla en una clave de ordenación natural. String
Valor devuelto
Devuelve una cadena con la clave de ordenación natural de s. String
Ejemplos
Ejemplo de uso
SELECT s FROM t ORDER BY naturalSortKey(s)
┌─s───┐
│ a1 │
| a02 │
└─────┘
str — cadena de entrada codificada en UTF-8. String
Valor devuelto
Devuelve la forma normalizada NFC de la cadena UTF-8. String
Ejemplos
Ejemplo de uso
SELECT
'é' AS original, -- e + acento agudo combinado (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 — cadena de entrada codificada en UTF-8. String
Valor devuelto
Devuelve la forma normalizada NFD de la cadena en UTF-8. String
Ejemplos
Ejemplo de uso
SELECT
'é' AS original, -- é (U+00E9)
length(original),
normalizeUTF8NFD('é') AS nfd_normalized, -- e + acento combinatorio (U+0065 + U+0301)
length(nfd_normalized);
┌─original─┬─length(original)─┬─nfd_normalized─┬─length(nfd_normalized)─┐
│ é │ 2 │ é │ 3 │
└──────────┴──────────────────┴────────────────┴────────────────────────┘
str — cadena de entrada codificada en UTF-8. String
Valor devuelto
Devuelve la forma NFKC normalizada de la cadena UTF-8. String
Ejemplos
Ejemplo de uso
SELECT
'① ② ③' AS original, -- Caracteres de números en círculo
normalizeUTF8NFKC('① ② ③') AS nfkc_normalized; -- Se convierte en 1 2 3
┌─original─┬─nfkc_normalized─┐
│ ① ② ③ │ 1 2 3 │
└──────────┴─────────────────┘
normalizeUTF8NFKCCasefold
normalizeUTF8NFKCCasefold(str)
str — cadena de entrada codificada en UTF-8. String
Valor devuelto
Devuelve la forma normalizada NFKC_Casefold de la cadena codificada en UTF-8. String
Ejemplos
Ejemplo de uso
SELECT
'Ä ① Hello' AS original,
normalizeUTF8NFKCCasefold('Ä ① Hello') AS nfkc_cf_normalized;
┌─original───┬─nfkc_cf_normalized─┐
│ Ä ① Hello │ ä 1 hello │
└────────────┴────────────────────┘
str — Cadena de entrada codificada en UTF-8. String
Valor devuelto
Devuelve la forma normalizada NFKD de la cadena codificada en UTF-8. String
Ejemplos
Ejemplo de uso
SELECT
'H₂O²' AS original, -- H + subíndice 2 + O + superíndice 2
normalizeUTF8NFKD('H₂O²') AS nfkd_normalized; -- Convierte a H 2 O 2
┌─original─┬─nfkd_normalized─┐
│ H₂O² │ H2O2 │
└──────────┴─────────────────┘
s — Cadena codificada en Punycode. String
Valor devuelto
Devuelve el texto sin formato del valor de entrada. String
Ejemplos
Ejemplo de uso
SELECT punycodeDecode('Mnchen-3ya')
┌─punycodeDecode('Mnchen-3ya')─┐
│ München │
└──────────────────────────────┘
String
Ejemplos
Ejemplo de uso
SELECT punycodeEncode('München')
┌─punycodeEncode('München')─┐
│ Mnchen-3ya │
└───────────────────────────┘
haystack que coincide con el patrón de expresión regular y corresponde al índice del grupo de la expresión regular.
Sintaxis
regexpExtract(haystack, pattern[, index])
REGEXP_EXTRACT
Argumentos
haystack — String, donde se buscará la coincidencia con el patrón regexp. Stringpattern — String, expresión regular. pattern puede contener varios grupos regexp; index indica qué grupo de la expresión regular se extraerá. Un índice de 0 significa que se extrae la coincidencia de la expresión regular completa. const Stringindex — Opcional. Un número entero mayor o igual que 0, con valor predeterminado 1. Representa qué grupo de la expresión regular se extraerá. (U)Int*
Valor devuelto
Devuelve una coincidencia como cadena String
Ejemplos
Ejemplo de uso
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 de pattern en haystack, comenzando la búsqueda en la posición en bytes position.
Si return_option es 0 (valor predeterminado), devuelve la posición del primer byte de la coincidencia. Si es 1, devuelve la posición del primer byte después de la coincidencia.
Si subexpression es mayor que 0, devuelve la posición del grupo de captura correspondiente en lugar de la coincidencia completa.
Devuelve 0 si no se encuentra ninguna coincidencia o si el grupo de captura solicitado no participó en la coincidencia.
Se proporciona por compatibilidad con regexp_instr de PostgreSQL (también disponible con ese alias). Ten en cuenta que las posiciones se basan en bytes, en consonancia con otras funciones de expresiones regulares de ClickHouse; regexp_instr de PostgreSQL se basa en caracteres.
Sintaxis
regexpPosition(haystack, pattern[, position[, occurrence[, return_option[, flags[, subexpression]]]]])
regexpInstr, regexp_instr
Argumentos
haystack — Cadena en la que buscar. Stringpattern — Patrón de expresión regular. const Stringposition — Opcional. Posición en bytes, basada en 1, desde la que se inicia la búsqueda. Valor predeterminado: 1. (U)Int*occurrence — Opcional. Qué coincidencia devolver. Valor predeterminado: 1. (U)Int*return_option — Opcional. 0 devuelve la posición de inicio de la coincidencia; 1 devuelve la posición inmediatamente posterior a la coincidencia. Valor predeterminado: 0. (U)Int*flags — Opcional. Banderas de regex. Compatibles: i (sin distinción entre mayúsculas y minúsculas), c (con distinción entre mayúsculas y minúsculas), m/n (anclajes multilínea), s (el punto coincide con el salto de línea). Valor predeterminado: vacío. const Stringsubexpression — Opcional. Índice del grupo de captura cuya posición se devolverá. 0 significa la coincidencia completa. Valor predeterminado: 0. (U)Int*
Valor devuelto
Devuelve la posición en bytes de la coincidencia, o 0 si no se encuentra. UInt64
Ejemplos
Uso básico
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
Argumentos
str — cadena de entrada codificada en UTF-8. String
Valor devuelto
Cadena UTF-8 sin diacríticos. String
Ejemplos
Eliminación básica de acentos
SELECT removeDiacriticsUTF8('café résumé naïve')
┌─removeDiacriticsUTF8('café résumé naïve')─┐
│ cafe resume naive │
└────────────────────────────────────────────┘
s — La cadena que se debe repetir. Stringn — El número de veces que se debe repetir la cadena. (U)Int*
Valor devuelto
Una cadena que contiene s repetida n veces. Si n es negativo, la función devuelve una cadena vacía. String
Ejemplos
Ejemplo de uso
┌─repeat('abc', 10)──────────────┐
│ abcabcabcabcabcabcabcabcabcabc │
└────────────────────────────────┘
s — Cadena que contiene texto válido codificado en UTF-8. String
Valor devuelto
Devuelve una cadena con la secuencia de puntos de código Unicode invertida. String
Ejemplos
Ejemplo de uso
SELECT reverseUTF8('ClickHouse')
s con un offset especificado a partir de la derecha.
Sintaxis
Argumentos
s — La cadena a partir de la cual se calculará una subcadena. String o FixedStringoffset — El número de bytes de desplazamiento. (U)Int*
Valor devuelto
Devuelve:
- Para un
offset positivo, una subcadena de s de offset bytes, empezando por la derecha de la cadena.
- Para un
offset negativo, una subcadena de s de length(s) - |offset| bytes, empezando por la derecha de la cadena.
- Una cadena vacía si
length es 0.
String
Ejemplos
Desplazamiento positivo
Offset negativo
SELECT right('Hello', -3)
length especificada.
Sintaxis
rightPad(string, length[, pad_string])
rpad
Argumentos
string — Cadena de entrada que se debe rellenar. Stringlength — La longitud de la cadena resultante. Si el valor es menor que la longitud de la cadena de entrada, esta se acorta a length caracteres. (U)Int*pad_string — Opcional. La cadena con la que se rellena la cadena de entrada. Si no se especifica, la cadena de entrada se rellena con espacios. String
Valor devuelto
Devuelve una cadena rellenada por la derecha con la longitud especificada. String
Ejemplos
Ejemplo de uso
SELECT rightPad('abc', 7, '*'), rightPad('abc', 7)
┌─rightPad('abc', 7, '*')─┬─rightPad('abc', 7)─┐
│ abc**** │ abc │
└─────────────────────────┴────────────────────┘
rightPad, que mide la longitud de la cadena en bytes, aquí la longitud de la cadena se mide en puntos de código.
Sintaxis
rightPadUTF8(string, length[, pad_string])
string — Cadena de entrada que se debe rellenar. Stringlength — La longitud de la cadena resultante. Si el valor es menor que la longitud de la cadena de entrada, esta se acorta a length caracteres. (U)Int*pad_string — Opcional. La cadena con la que se rellena la cadena de entrada. Si no se especifica, la cadena de entrada se rellena con espacios. String
Valor devuelto
Devuelve una cadena de la longitud indicada, rellenada por la derecha. String
Ejemplos
Ejemplo de uso
SELECT rightPadUTF8('абвг', 7, '*'), rightPadUTF8('абвг', 7)
┌─rightPadUTF8('абвг', 7, '*')─┬─rightPadUTF8('абвг', 7)─┐
│ абвг*** │ абвг │
└──────────────────────────────┴─────────────────────────┘
s, codificada en UTF-8, con un offset especificado desde la derecha.
Sintaxis
Argumentos
s — La cadena codificada en UTF-8 de la que se calcula una subcadena. String o FixedStringoffset — El número de bytes del desplazamiento. (U)Int*
Valor devuelto
Devuelve:
- Para
offset positivo, una subcadena de s de offset bytes, empezando por la derecha de la cadena.
- Para
offset negativo, una subcadena de s de length(s) - |offset| bytes, empezando por la derecha de la cadena.
- Una cadena vacía si
length es 0.
String
Ejemplos
Desplazamiento positivo
SELECT rightUTF8('Привет', 4)
SELECT rightUTF8('Привет', -4)
String
Ejemplos
Ejemplo de uso
┌─soundex('aksel')─┐
│ A240 │
└──────────────────┘
) consigo mismo tantas veces como se indique.
Sintaxis
Argumentos
n — El número de veces que se repite el carácter de espacio. (U)Int*
Valor devuelto
Devuelve una cadena que contiene un espacio repetido n veces. Si n <= 0, la función devuelve la cadena vacía. String
Ejemplos
Ejemplo de uso
SELECT space(3) AS res, length(res);
┌─res─┬─length(res)─┐
│ │ 3 │
└─────┴─────────────┘
n,
donde los hashes de los (n-1)-gramas en los extremos de la subcadena
son estrictamente mayores que los de cualquier (n-1)-grama dentro de ella.
Usa CRC32 como función hash.
Sintaxis
sparseGrams(s[, min_ngram_length[, max_ngram_length[, min_cutoff_length]]])
s — Una cadena de entrada. Stringmin_ngram_length — Opcional. La longitud mínima del ngrama extraído. El valor predeterminado, que también es el mínimo, es 3. UInt*max_ngram_length — Opcional. La longitud máxima del ngrama extraído. El valor predeterminado es 100. No debe ser menor que min_ngram_length. UInt*min_cutoff_length — Opcional. Si se especifica, solo se devuelven n-gramas cuya longitud sea mayor o igual que min_cutoff_length. El valor predeterminado es el mismo que min_ngram_length. No debe ser menor que min_ngram_length ni mayor que max_ngram_length. UInt*
Valor devuelto
Devuelve un array de subcadenas seleccionadas. Array(String)
Ejemplos
Ejemplo de uso
SELECT sparseGrams('alice', 3)
┌─sparseGrams('alice', 3)────────────┐
│ ['ali','lic','lice','ice'] │
└────────────────────────────────────┘
n,
donde los valores hash de los ngramas de longitud n-1 en los bordes de la subcadena
sean estrictamente mayores que los de cualquier ngrama de longitud n-1 dentro de la subcadena.
Usa CRC32 como función hash.
Sintaxis
sparseGramsHashes(s[, min_ngram_length, max_ngram_length])
s — Una cadena de entrada. Stringmin_ngram_length — Opcional. La longitud mínima del ngrama extraído. El valor predeterminado y mínimo es 3. UInt*max_ngram_length — Opcional. La longitud máxima del ngrama extraído. El valor predeterminado es 100. No debe ser inferior a min_ngram_length. UInt*min_cutoff_length — Opcional. Si se especifica, solo se devuelven los ngramas con una longitud mayor o igual que min_cutoff_length. El valor predeterminado es el mismo que min_ngram_length. No debe ser inferior a min_ngram_length ni superior a max_ngram_length. UInt*
Valor devuelto
Devuelve un array de hash CRC32 de las subcadenas seleccionadas. Array(UInt32)
Ejemplos
Ejemplo de uso
SELECT sparseGramsHashes('alice', 3)
┌─sparseGramsHashes('alice', 3)──────────────────────┐
│ [1481062250,2450405249,4012725991,1918774096] │
└────────────────────────────────────────────────────┘
n, donde los hashes de los (n-1)-gramas en los bordes de la subcadena son estrictamente mayores que los de cualquier (n-1)-grama dentro de la subcadena.
Espera una cadena UTF-8 y lanza una excepción en caso de secuencia UTF-8 no válida.
Usa CRC32 como función hash.
Sintaxis
sparseGramsHashesUTF8(s[, min_ngram_length, max_ngram_length])
s — Una cadena de entrada. Stringmin_ngram_length — Opcional. La longitud mínima del ngrama extraído. El valor predeterminado y mínimo es 3. UInt*max_ngram_length — Opcional. La longitud máxima del ngrama extraído. El valor predeterminado es 100. No debe ser inferior a min_ngram_length. UInt*min_cutoff_length — Opcional. Si se especifica, solo se devuelven n-grams con una longitud igual o mayor que min_cutoff_length. El valor predeterminado es el mismo que min_ngram_length. No debe ser inferior a min_ngram_length ni superior a max_ngram_length. UInt*
Valor devuelto
Devuelve un Array de hashes CRC32 de las subcadenas UTF-8 seleccionadas. Array(UInt32)
Ejemplos
Ejemplo de uso
SELECT sparseGramsHashesUTF8('алиса', 3)
┌─sparseGramsHashesUTF8('алиса', 3)─┐
│ [4178533925,3855635300,561830861] │
└───────────────────────────────────┘
n, donde los valores hash de los (n-1)-gramas en los extremos de la subcadena son estrictamente mayores que los de cualquier (n-1)-grama dentro de la subcadena.
Espera una cadena UTF-8 y genera una excepción si la secuencia UTF-8 no es válida.
Usa CRC32 como función hash.
Sintaxis
sparseGramsUTF8(s[, min_ngram_length[, max_ngram_length[, min_cutoff_length]]])
s — Una cadena de entrada. Stringmin_ngram_length — Opcional. La longitud mínima del n-grama extraído. El valor predeterminado y mínimo es 3. UInt*max_ngram_length — Opcional. La longitud máxima del n-grama extraído. El valor predeterminado es 100. No debe ser inferior a min_ngram_length. UInt*min_cutoff_length — Opcional. Si se especifica, solo se devuelven los n-gramas con una longitud mayor o igual que min_cutoff_length. El valor predeterminado es el mismo que min_ngram_length. No debe ser inferior a min_ngram_length ni superior a max_ngram_length. UInt*
Valor devuelto
Devuelve un array de subcadenas UTF-8 seleccionadas. Array(String)
Ejemplos
Ejemplo de uso
SELECT sparseGramsUTF8('алиса', 3)
┌─sparseGramsUTF8('алиса', 3)─┐
│ ['али','лис','иса'] │
└─────────────────────────────┘
s — Cadena que se va a comprobar. Stringprefix — Prefijo que se va a comprobar. String
Valor devuelto
Devuelve 1 si s comienza con prefix; en caso contrario, 0. UInt8
Ejemplos
Ejemplo de uso
SELECT startsWith('ClickHouse', 'Click');
┌─startsWith('⋯', 'Click')─┐
│ 1 │
└──────────────────────────┘
startsWithCaseInsensitive
startsWithCaseInsensitive(s, prefix)
s — Cadena que se comprobará. Stringprefix — Prefijo sin distinción entre mayúsculas y minúsculas que se comprobará. String
Valor devuelto
Devuelve 1 si s comienza por el prefix sin distinguir entre mayúsculas y minúsculas; en caso contrario, 0. UInt8
Ejemplos
Ejemplo de uso
SELECT startsWithCaseInsensitive('ClickHouse', 'CLICK');
┌─startsWithCaseInsensitive('⋯', 'CLICK')─┐
│ 1 │
└─────────────────────────────────────────┘
startsWithCaseInsensitiveUTF8
startsWithCaseInsensitiveUTF8(s, prefix)
s — Cadena que se debe comprobar. Stringprefix — Prefijo, sin distinguir entre mayúsculas y minúsculas, cuya coincidencia se debe comprobar. String
Valor devuelto
Devuelve 1 si s empieza por prefix sin distinguir entre mayúsculas y minúsculas; en caso contrario, 0. UInt8
Ejemplos
Ejemplo de uso
SELECT startsWithCaseInsensitiveUTF8('приставка', 'при')
┌─startsWithUT⋯ка', 'при')─┐
│ 1 │
└──────────────────────────┘
startsWithUTF8(s, prefix)
s — Cadena que se va a comprobar. Stringprefix — Prefijo que se va a comprobar. String
Valor devuelto
Devuelve 1 si s empieza por prefix; de lo contrario, 0. UInt8
Ejemplos
Ejemplo de uso
SELECT startsWithUTF8('приставка', 'при')
┌─startsWithUT⋯ка', 'при')─┐
│ 1 │
└──────────────────────────┘
s — La cadena que se va a analizar. String
Valor devuelto
Devuelve la entropía de Shannon de la distribución de bytes de la cadena. Float64
Ejemplos
Ejemplo de uso
SELECT stringBytesEntropy('Hello, world!')
┌─stringBytesEntropy('Hello, world!')─┐
│ 3.07049960 │
└─────────────────────────────────────┘
s — La cadena que se analizará. String
Valor devuelto
Devuelve el número de bytes distintos de la cadena. UInt16
Ejemplos
Ejemplo de uso
SELECT stringBytesUniq('Hello')
┌─stringBytesUniq('Hello')─┐
│ 4 │
└──────────────────────────┘
stringJaccardIndex(s1, s2)
s1 — Primera cadena de entrada. Strings2 — Segunda cadena de entrada. String
Valor devuelto
Devuelve el índice de similitud de Jaccard entre ambas cadenas. Float64
Ejemplos
Ejemplo de uso
SELECT stringJaccardIndex('clickhouse', 'mouse')
┌─stringJaccardIndex('clickhouse', 'mouse')─┐
│ 0.4 │
└───────────────────────────────────────────┘
stringJaccardIndex, pero para cadenas codificadas en UTF-8.
Sintaxis
stringJaccardIndexUTF8(s1, s2)
s1 — Primera cadena UTF-8 de entrada. Strings2 — Segunda cadena UTF-8 de entrada. String
Valor devuelto
Devuelve el índice de similitud de Jaccard entre las dos cadenas UTF-8. Float64
Ejemplos
Ejemplo de uso
SELECT stringJaccardIndexUTF8('我爱你', '我也爱你')
┌─stringJaccardIndexUTF8('我爱你', '我也爱你')─┐
│ 0.75 │
└─────────────────────────────────────────────┘
s que comienza en el índice de bytes offset especificado.
El recuento de bytes comienza en 1 con la siguiente lógica:
- Si
offset es 0, se devuelve una cadena vacía.
- Si
offset es negativo, la subcadena comienza offset caracteres desde el final de la cadena, en lugar de hacerlo desde el principio.
Un argumento opcional, length, especifica el número máximo de bytes que puede tener la subcadena devuelta.
Sintaxis
substring(s, offset[, length])
byteSlice, mid, substr
Argumentos
s — La cadena de la que se extrae una subcadena. String o FixedString o Enumoffset — La posición inicial de la subcadena en s. (U)Int*length — Opcional. La longitud máxima de la subcadena. (U)Int*
Valor devuelto
Devuelve una subcadena de s de length bytes, a partir del índice offset. String
Ejemplos
Uso básico
SELECT 'database' AS db, substr(db, 5), substr(db, 5, 1)
┌─db───────┬─substring('database', 5)─┬─substring('database', 5, 1)─┐
│ database │ base │ b │
└──────────┴──────────────────────────┴─────────────────────────────┘
s situada antes de la count-ésima aparición del delimitador delim, como en Spark o MySQL.
Sintaxis
substringIndex(s, delim, count)
SUBSTRING_INDEX
Argumentos
s — La cadena de la que se extrae la subcadena. Stringdelim — El carácter delimitador. Stringcount — El número de apariciones del delimitador que se cuentan antes de extraer la subcadena. Si count es positivo, se devuelve todo lo que está a la izquierda del delimitador final (contando desde la izquierda). Si count es negativo, se devuelve todo lo que está a la derecha del delimitador final (contando desde la derecha). UInt o Int
Valor devuelto
Devuelve una subcadena de s situada antes de count apariciones de delim. String
Ejemplos
Ejemplo de uso
SELECT substringIndex('www.clickhouse.com', '.', 2)
┌─substringIndex('www.clickhouse.com', '.', 2)─┐
│ www.clickhouse │
└──────────────────────────────────────────────┘
s anterior a count apariciones del delimitador delim, específicamente para puntos de código Unicode.
Asume que la cadena contiene texto válido codificado en UTF-8.
Si no se cumple esta suposición, no se lanza ninguna excepción y el resultado es indefinido.
Sintaxis
substringIndexUTF8(s, delim, count)
s — La cadena de la que se extrae la subcadena. Stringdelim — El carácter delimitador. Stringcount — El número de apariciones del delimitador que se cuentan antes de extraer la subcadena. Si count es positivo, se devuelve todo lo que queda a la izquierda del delimitador final (contando desde la izquierda). Si count es negativo, se devuelve todo lo que queda a la derecha del delimitador final (contando desde la derecha). UInt o Int
Valor devuelto
Devuelve una subcadena de s situada antes de count apariciones de delim. String
Ejemplos
Ejemplo de UTF8
SELECT substringIndexUTF8('www.straßen-in-europa.de', '.', 2)
s que comienza en el índice de punto de código offset especificado.
El recuento de puntos de código comienza en 1 con la siguiente lógica:
- Si
offset es 0, se devuelve una cadena vacía.
- Si
offset es negativo, la subcadena comienza offset puntos de código antes del final de la cadena, en lugar de hacerlo desde el principio.
Un argumento opcional, length, especifica el número máximo de puntos de código que puede tener la subcadena devuelta.
Esta función asume que la cadena contiene texto válido codificado en UTF-8.
Si no se cumple esta suposición, no se lanza ninguna excepción y el resultado es indefinido.
substringUTF8(s, offset[, length])
s — La cadena de la que se extraerá una subcadena. String o FixedString o Enumoffset — La posición inicial de la subcadena en s. Int o UIntlength — La longitud máxima de la subcadena. Opcional. Int o UInt
Valor devuelto
Devuelve una subcadena de s de hasta length puntos de código, a partir del índice de punto de código offset. String
Ejemplos
Ejemplo de uso
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).
Cuando se encuentran varios caracteres no válidos consecutivos, se sustituyen por un único carácter de reemplazo.
Sintaxis
Argumentos
s — Cualquier conjunto de bytes representado como un objeto del tipo de dato String. String
Valor devuelto
Devuelve una cadena UTF-8 válida. String
Ejemplos
Ejemplo de uso
SELECT toValidUTF8('\\x61\\xF0\\x80\\x80\\x80b')
c
┌─toValidUTF8('a����b')─┐
│ a�b │
└───────────────────────┘
trimBoth(s[, trim_characters])
trim
Argumentos
s — Cadena que se recortará. Stringtrim_characters — Opcional. Caracteres que se recortarán. Si no se especifica, se eliminan los caracteres de espacio en blanco habituales. String
Valor devuelto
Devuelve la cadena tras recortar los caracteres especificados de ambos extremos. String
Ejemplos
Ejemplo de uso
SELECT trimBoth('$$ClickHouse$$', '$')
┌─trimBoth('$$⋯se$$', '$')─┐
│ ClickHouse │
└──────────────────────────┘
trimLeft(input[, trim_characters])
ltrim
Argumentos
input — Cadena a recortar. Stringtrim_characters — Opcional. Caracteres a recortar. Si no se especifican, se eliminan los caracteres de espacio en blanco habituales. String
Valor devuelto
Devuelve la cadena con los caracteres especificados eliminados del extremo izquierdo. String
Ejemplos
Ejemplo de uso
SELECT trimLeft('ClickHouse', 'Click');
┌─trimLeft('Cl⋯', 'Click')─┐
│ House │
└──────────────────────────┘
trimRight(s[, trim_characters])
rtrim
Argumentos
s — Cadena a recortar. Stringtrim_characters — Caracteres opcionales que se eliminarán. Si no se especifican, se eliminan los caracteres de espacio en blanco habituales. String
Valor devuelto
Devuelve la cadena con los caracteres especificados eliminados del extremo derecho. String
Ejemplos
Ejemplo de uso
SELECT trimRight('ClickHouse','House');
┌─trimRight('C⋯', 'House')─┐
│ Click │
└──────────────────────────┘
encoded — Columna de tipo String o constante que se va a decodificar. Si la cadena no es una codificación Base32 válida, devuelve una cadena vacía en caso de error. String
Valor devuelto
Devuelve una cadena que contiene el valor decodificado del argumento. String
Ejemplos
Ejemplo de uso
SELECT tryBase32Decode('IVXGG33EMVSA====');
┌─tryBase32Decode('IVXGG33EMVSA====')─┐
│ Encoded │
└─────────────────────────────────────┘
base58Decode, pero devuelve una cadena vacía en caso de error.
Sintaxis
tryBase58Decode(encoded[, expected_size])
encoded — Columna de tipo String o constante. Si la cadena no está codificada en Base58 de forma válida, devuelve una cadena vacía en caso de error. Stringexpected_size — Opcional. Tamaño esperado de la decodificación en bytes. Cuando es 32 o 64, se usa un decodificador optimizado; para otros valores, se usa el decodificador genérico. UInt8, UInt16, UInt32 o UInt64
Valor devuelto
Devuelve una cadena que contiene el valor decodificado del argumento. String
Ejemplos
Ejemplo de uso
SELECT tryBase58Decode('3dc8KtHrwM') AS res, tryBase58Decode('invalid') AS res_invalid;
┌─res─────┬─res_invalid─┐
│ Encoded │ │
└─────────┴─────────────┘
base64Decode, pero devuelve una cadena vacía en caso de error.
Sintaxis
Argumentos
encoded — Columna o constante de tipo String que se va a decodificar. Si la cadena no está codificada en Base64 de forma válida, devuelve una cadena vacía en caso de error. String
Valor devuelto
Devuelve una cadena que contiene el valor decodificado del argumento. String
Ejemplos
Ejemplo de uso
SELECT tryBase64Decode('Y2xpY2tob3VzZQ==')
┌─tryBase64Decode('Y2xpY2tob3VzZQ==')─┐
│ clickhouse │
└─────────────────────────────────────┘
base64URLDecode, pero devuelve una cadena vacía en caso de error.
Sintaxis
tryBase64URLDecode(encoded)
encoded — columna String o constante que se va a decodificar. Si la cadena no es una codificación Base64 válida, devuelve una cadena vacía en caso de error. String
Valor devuelto
Devuelve una cadena que contiene el valor decodificado del argumento. String
Ejemplos
Ejemplo de uso
SELECT tryBase64URLDecode('aHR0cHM6Ly9jbGlja2hvdXNlLmNvbQ')
┌─tryBase64URLDecode('aHR0cHM6Ly9jbGlja2hvdXNlLmNvbQ')─┐
│ https://clickhouse.com │
└──────────────────────────────────────────────────────┘
String
Ejemplos
Ejemplo de uso
SELECT tryIdnaEncode('straße.münchen.de')
┌─tryIdnaEncode('straße.münchen.de')──┐
│ xn--strae-oqa.xn--mnchen-3ya.de │
└─────────────────────────────────────┘
punycodeDecode, pero devuelve una cadena vacía si no se proporciona una cadena codificada en Punycode válida.
Sintaxis
Argumentos
s — Cadena codificada en Punycode. String
Valor devuelto
Devuelve el texto plano del valor de entrada, o una cadena vacía si la entrada no es válida. String
Ejemplos
Ejemplo de uso
SELECT tryPunycodeDecode('Mnchen-3ya')
┌─tryPunycodeDecode('Mnchen-3ya')─┐
│ München │
└─────────────────────────────────┘
ucase
Argumentos
s — La cadena que se convertirá a mayúsculas. String
Valor devuelto
Devuelve una cadena en mayúsculas a partir de s. String
Ejemplos
Ejemplo de uso
SELECT upper('clickhouse')
┌─upper('clickhouse')─┐
│ CLICKHOUSE │
└─────────────────────┘
Esta función no detecta el idioma; por ejemplo, en turco, el resultado podría no ser del todo correcto (i/İ vs. i/I).
Si la longitud de la secuencia de bytes UTF-8 difiere entre mayúsculas y minúsculas para un punto de código (como ẞ y ß), el resultado puede ser incorrecto para ese punto de código.
String
Ejemplos
Ejemplo de uso
SELECT upperUTF8('München') AS Upperutf8
┌─Upperutf8─┐
│ MÜNCHEN │
└───────────┘
