Fonctions de manipulation de chaînes de caractères

Les fonctions de recherche dans les chaînes et de remplacement dans les chaînes sont décrites séparément.

La documentation ci-dessous est générée à partir de la table système system.functions.

CRC32

Introduit dans : v20.1.0 Calcule la somme de contrôle CRC32 d’une chaîne de caractères à l’aide du polynôme CRC-32-IEEE 802.3 et de la valeur initiale 0xffffffff (implémentation zlib). Syntaxe

CRC32(s)

Arguments

s — Chaîne String pour laquelle calculer le CRC32. String

Valeur renvoyée Renvoie la somme de contrôle CRC32 de la chaîne. UInt32 Exemples Exemple d’utilisation

Query

SELECT CRC32('ClickHouse')

Response

┌─CRC32('ClickHouse')─┐
│          1538217360 │
└─────────────────────┘

CRC32IEEE

Introduit dans : v20.1.0 Calcule la somme de contrôle CRC32 d’une chaîne de caractères à l’aide du polynôme CRC-32-IEEE 802.3. Syntaxe

CRC32IEEE(s)

Arguments

s — Chaîne dont il faut calculer le CRC32. String

Valeur renvoyée Renvoie la somme de contrôle CRC32 de la chaîne. UInt32 Exemples Exemple d’utilisation

Query

SELECT CRC32IEEE('ClickHouse');

Response

┌─CRC32IEEE('ClickHouse')─┐
│              3089448422 │
└─────────────────────────┘

CRC64

Introduit dans : v20.1.0 Calcule la somme de contrôle CRC64 d’une chaîne de caractères à l’aide du polynôme CRC-64-ECMA. Syntaxe

CRC64(s)

Arguments

s — Chaîne pour laquelle calculer la somme de contrôle CRC64. String

Valeur renvoyée Renvoie la somme de contrôle CRC64 de la chaîne. UInt64 Exemples Exemple d’utilisation

Query

SELECT CRC64('ClickHouse');

Response

┌──CRC64('ClickHouse')─┐
│ 12126588151325169346 │
└──────────────────────┘

appendTrailingCharIfAbsent

Introduit dans : v1.1.0 Ajoute le caractère c à la chaîne s si s n’est pas vide et ne se termine pas par le caractère c. Syntaxe

appendTrailingCharIfAbsent(s, c)

Arguments

s — Chaîne d’entrée. String
c — Caractère à ajouter s’il est absent. String

Valeur renvoyée Renvoie la chaîne s avec le caractère c ajouté si s ne se termine pas par c. String Exemples Exemple d’utilisation

Query

SELECT appendTrailingCharIfAbsent('https://example.com', '/');

Response

┌─appendTrailingCharIfAbsent('https://example.com', '/')─┐
│ https://example.com/                                   │
└────────────────────────────────────────────────────────┘

ascii

Introduit dans : v22.11.0 Renvoie le code ASCII du premier caractère de la chaîne s, sous la forme d’un Int32. Syntaxe

ascii(s)

Arguments

s — Entrée de type String. String

Valeur renvoyée Renvoie le code ASCII du premier caractère. Si s est vide, le résultat est 0. Si le premier caractère n’est pas un caractère ASCII ou n’appartient pas à la plage Latin-1 Supplement de l’UTF-16, le résultat n’est pas défini. Int32 Exemples Exemple d’utilisation

Query

SELECT ascii('234')

Response

┌─ascii('234')─┐
│           50 │
└──────────────┘

base32Decode

Introduit dans : v25.6.0 Décode une chaîne Base32 (RFC 4648). Si la chaîne n’est pas encodée en Base32 correctement, une exception est levée. Syntaxe

base32Decode(encoded)

Arguments

encoded — Colonne de type String ou constante. String

Valeur renvoyée Renvoie une chaîne contenant la valeur décodée de l’argument. String Exemples Exemple d’utilisation

Query

SELECT base32Decode('IVXGG33EMVSA====');

Response

┌─base32Decode('IVXGG33EMVSA====')─┐
│ Encoded                          │
└──────────────────────────────────┘

base32Encode

Introduit dans : v25.6.0 Encode une chaîne à l’aide de Base32. Syntaxe

base32Encode(plaintext)

Arguments

plaintext — Texte en clair à encoder. String

Valeur renvoyée Renvoie une chaîne contenant la valeur encodée de l’argument. String ou FixedString Exemples Exemple d’utilisation

Query

SELECT base32Encode('Encoded')

Response

┌─base32Encode('Encoded')─┐
│ IVXGG33EMVSA====        │
└─────────────────────────┘

base58Decode

Introduit dans : v22.7.0 Décode une chaîne Base58. Si la chaîne n’est pas encodée en Base58 de manière valide, une exception est levée. Un second argument facultatif, expected_size, peut être fourni pour imposer une taille décodée : une entrée qui ne se décode pas en exactement ce nombre d’octets est rejetée, et la fonction lève une exception (ou renvoie une chaîne vide pour tryBase58Decode). Cette exigence s’applique à toutes les tailles, et 0 signifie aucune exigence. Syntaxe

base58Decode(encoded[, expected_size])

Arguments

encoded — Colonne ou constante de type String à décoder. String
expected_size — Facultatif. Taille décodée requise en octets : toute entrée dont le décodage produit une autre taille est rejetée. 0 n’impose aucune exigence. UInt8, UInt16, UInt32, or UInt64

Valeur renvoyée Renvoie une chaîne contenant la valeur décodée de l’argument. String Exemples Exemple d’utilisation

Query

SELECT base58Decode('JxF12TrwUP45BMd');

Response

┌─base58Decode('JxF12TrwUP45BMd')─┐
│ Hello World                     │
└─────────────────────────────────┘

base58Encode

Introduite dans : v22.7.0 Encode une chaîne en Base58. Syntaxe

base58Encode(plaintext)

Arguments

plaintext — Texte en clair à encoder. String

Valeur renvoyée Renvoie une chaîne contenant la valeur encodée de l’argument. String Exemples Exemple d’utilisation

Query

SELECT base58Encode('ClickHouse');

Response

┌─base58Encode('ClickHouse')─┐
│ 4nhk8K7GHXf6zx             │
└────────────────────────────┘

base64Decode

Introduit dans : v18.16.0 Décode une chaîne à partir d’une représentation Base64, conformément à la RFC 4648. Depuis la version 26.7, les caractères d’espacement suivants dans l’entrée sont ignorés : espace, tabulation (\t), saut de ligne (\n), retour chariot (\r) et saut de page (\f) (les versions antérieures rejetaient les entrées qui en contenaient). La tabulation verticale (\v), ainsi que tous les autres caractères ne faisant pas partie de l’alphabet Base64, sont rejetés. Lève une exception en cas d’erreur. Syntaxe

base64Decode(encoded)

Alias : FROM_BASE64 Arguments

encoded — colonne ou constante de type String à décoder. Si la chaîne n’est pas encodée en Base64 de manière valide, une exception est levée. String

Valeur renvoyée Renvoie la chaîne décodée. String Exemples Exemple d’utilisation

Query

SELECT base64Decode('Y2xpY2tob3VzZQ==')

Response

┌─base64Decode('Y2xpY2tob3VzZQ==')─┐
│ clickhouse                       │
└──────────────────────────────────┘

base64Encode

Introduit dans : v18.16.0 Encode une chaîne à l’aide de la représentation Base64, conformément à la RFC 4648. Syntaxe

base64Encode(plaintext)

alias : TO_BASE64 Arguments

plaintext — Colonne ou constante de texte en clair à décoder. String

Valeur renvoyée Renvoie une chaîne contenant la valeur encodée de l’argument. String Exemples Exemple d’utilisation

Query

SELECT base64Encode('clickhouse')

Response

┌─base64Encode('clickhouse')─┐
│ Y2xpY2tob3VzZQ==           │
└────────────────────────────┘

base64URLDecode

Introduit dans : v24.6.0 Décode une chaîne à partir d’une représentation Base64 en utilisant un alphabet compatible avec les URL, conformément à la RFC 4648. L’alphabet standard (+ et /) est également accepté lors du décodage. Depuis la version 26.7, les caractères d’espacement espace, tabulation (\t), saut de ligne (\n), retour chariot (\r) et saut de page (\f) présents dans l’entrée sont ignorés (les versions antérieures rejetaient les entrées qui les contenaient). La tabulation verticale (\v) ainsi que tous les autres caractères ne faisant pas partie de l’alphabet Base64 sont rejetés. Lève une exception en cas d’erreur. Syntaxe

base64URLDecode(encoded)

Arguments

encoded — Colonne String ou constante à encoder. Si la chaîne n’est pas une chaîne Base64 valide, une exception est levée. String

Valeur renvoyée Renvoie une chaîne contenant la valeur décodée de l’argument. String Exemples Exemple d’utilisation

Query

SELECT base64URLDecode('aHR0cHM6Ly9jbGlja2hvdXNlLmNvbQ')

Response

┌─base64URLDecode('aHR0cHM6Ly9jbGlja2hvdXNlLmNvbQ')─┐
│ https://clickhouse.com                            │
└───────────────────────────────────────────────────┘

base64URLEncode

Introduit dans : v18.16.0 Encode une chaîne à l’aide de la représentation Base64 (RFC 4648) en utilisant un alphabet compatible avec les URL. Syntaxe

base64URLEncode(plaintext)

Arguments

plaintext — Colonne ou constante de texte en clair à encoder. String

Valeur renvoyée Renvoie une chaîne contenant la valeur encodée de l’argument. String Exemples Exemple d’utilisation

Query

SELECT base64URLEncode('https://clickhouse.com')

Response

┌─base64URLEncode('https://clickhouse.com')─┐
│ aHR0cHM6Ly9jbGlja2hvdXNlLmNvbQ            │
└───────────────────────────────────────────┘

basename

Introduit dans : v20.1.0 Extrait la partie finale d’une chaîne après sa dernière barre oblique (« / ») ou barre oblique inversée (« \ »). Cette fonction est souvent utilisée pour extraire le nom de fichier d’un chemin. Syntaxe

basename(expr)

Arguments

expr — Une expression de chaîne de caractères. Les antislashs doivent être échappés. String

Valeur renvoyée Renvoie la partie finale de la chaîne d’entrée après son dernier slash ou antislash. Si la chaîne d’entrée se termine par un slash ou un antislash, la fonction renvoie une chaîne vide. Renvoie la chaîne d’origine s’il n’y a ni slash ni antislash. String Exemples Extraire le nom du fichier à partir d’un chemin Unix

Query

SELECT 'some/long/path/to/file' AS a, basename(a)

Response

┌─a──────────────────────┬─basename(a)─┐
│ some/long/path/to/file │ file        │
└────────────────────────┴─────────────┘

Extraire le nom du fichier depuis un chemin Windows

Query

SELECT 'some\\long\\path\\to\\file' AS a, basename(a)

Response

┌─a──────────────────────┬─basename(a)─┐
│ some\long\path\to\file │ file        │
└────────────────────────┴─────────────┘

Chaîne sans séparateur de chemin

Query

SELECT 'some-file-name' AS a, basename(a)

Response

┌─a──────────────┬─basename(a)────┐
│ some-file-name │ some-file-name │
└────────────────┴────────────────┘

byteHammingDistance

Introduit dans : v23.9.0 Calcule la distance de Hamming entre deux chaînes d’octets. Syntaxe

byteHammingDistance(s1, s2)

Alias : mismatches Arguments

s1 — Première chaîne d’entrée. String
s2 — Deuxième chaîne d’entrée. String

Valeur renvoyée Renvoie la distance de Hamming entre les deux chaînes. UInt64 Exemples Exemple d’utilisation

Query

SELECT byteHammingDistance('karolin', 'kathrin')

Response

┌─byteHammingDistance('karolin', 'kathrin')─┐
│                                         3 │
└───────────────────────────────────────────┘

caseFoldUTF8

Introduit dans : v26.3.0 Applique le repliement de casse Unicode à une chaîne UTF-8, en la convertissant en une forme normalisée proche des minuscules, adaptée aux comparaisons insensibles à la casse. Applique le repliement de casse Unicode standard. Préserve les caractères de compatibilité qui ne sont pas affectés par le repliement de casse (par ex. les chiffres romains, les chiffres encerclés), mais notez que certaines ligatures comme ﬃ sont tout de même décomposées, car le repliement de casse Unicode lui-même les étend. Syntaxe

caseFoldUTF8(str)

Arguments

str — chaîne d’entrée encodée en UTF-8. String

Valeur renvoyée Chaîne UTF-8 après normalisation de la casse. String Exemples Normalisation de la casse de base

Query

SELECT caseFoldUTF8('Straße')

Response

┌─caseFoldUTF8('Straße')─┐
│ strasse                │
└────────────────────────┘

compareSubstrings

Introduit dans : v25.2.0 Compare deux chaînes de caractères dans l’ordre lexicographique. Syntaxe

compareSubstrings(s1, s2, s1_offset, s2_offset, num_bytes)

Arguments

s1 — La première chaîne à comparer. String
s2 — La deuxième chaîne à comparer. String
s1_offset — La position (à partir de zéro) dans s1 à partir de laquelle la comparaison commence. UInt*
s2_offset — La position (indice commençant à zéro) dans s2 à partir de laquelle la comparaison commence. UInt*
num_bytes — Le nombre maximal d’octets à comparer dans les deux chaînes. Si s1_offset (ou s2_offset) + num_bytes dépasse la fin d’une chaîne d’entrée, num_bytes est réduit en conséquence. UInt*

Valeur renvoyée Renvoie :

-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

Exemples Exemple d’utilisation

Query

SELECT compareSubstrings('Saxony', 'Anglo-Saxon', 0, 6, 5) AS result

Response

┌─result─┐
│      0 │
└────────┘

concat

Introduit dans : v1.1.0 Concatène les arguments fournis. Les arguments qui ne sont pas de type String ou FixedString sont convertis en chaînes de caractères à l’aide de leur sérialisation par défaut. Comme cela dégrade les performances, il n’est pas recommandé d’utiliser des arguments autres que String/FixedString. Syntaxe

concat([s1, s2, ...])

Arguments

s1, s2, ... — N’importe quel nombre de valeurs de n’importe quel type. Any

Valeur renvoyée Renvoie la String obtenue par concaténation des arguments. Si l’un des arguments est NULL, la fonction renvoie NULL. S’il n’y a aucun argument, elle renvoie une chaîne vide. Nullable(String) Exemples Concaténation de chaînes

Query

SELECT concat('Hello, ', 'World!')

Response

┌─concat('Hello, ', 'World!')─┐
│ Hello, World!               │
└─────────────────────────────┘

Concaténation de nombres

Query

SELECT concat(42, 144)

Response

┌─concat(42, 144)─┐
│ 42144           │
└─────────────────┘

concatAssumeInjective

Introduit dans : v1.1.0 Comme concat, mais en supposant que concat(s1, s2, ...) → sn est injective, c’est-à-dire qu’elle renvoie des résultats différents pour des arguments différents. Peut être utilisée pour optimiser GROUP BY. Syntaxe

concatAssumeInjective([s1, s2, ...])

Arguments

s1, s2, ... — Un nombre quelconque de valeurs de type arbitraire. String ou FixedString

Valeur renvoyée Renvoie la chaîne créée par concaténation des arguments. Si l’une des valeurs d’argument est NULL, la fonction renvoie NULL. Si aucun argument n’est transmis, elle renvoie une chaîne vide. String Exemples Optimisation du GROUP BY

Query

CREATE TABLE key_val (key1 String, key2 String, value UInt32) ENGINE = Memory;
INSERT INTO key_val VALUES ('Hello, ', 'World!', 1), ('Hello, ', 'World!', 2), ('Hello, ', 'World', 3);

SELECT concatAssumeInjective(key1, key2) AS key, sum(value) FROM key_val GROUP BY key ORDER BY key;

Response

┌─key───────────┬─sum(value)─┐
│ Hello, World  │          3 │
│ Hello, World! │          3 │
└───────────────┴────────────┘

concatWithSeparator

Introduit dans : v22.12.0 Concatène les chaînes fournies en les séparant à l’aide du séparateur spécifié. Syntaxe

concatWithSeparator(sep[, exp1, exp2, ...])

Alias : concat_ws Arguments

sep — Le séparateur à utiliser. const String ou const FixedString
exp1, exp2, ... — Expressions à concaténer. Les arguments dont le type n’est ni String ni FixedString sont convertis en chaînes à l’aide de leur sérialisation par défaut. Comme cela réduit les performances, il n’est pas recommandé d’utiliser des arguments autres que String/FixedString. Any

Valeur renvoyée Renvoie la chaîne obtenue en concaténant les arguments. Si l’une des valeurs d’argument est NULL, la fonction renvoie NULL. String Exemples Exemple d’utilisation

Query

SELECT concatWithSeparator('a', '1', '2', '3', '4')

Response

┌─concatWithSeparator('a', '1', '2', '3', '4')─┐
│ 1a2a3a4                                      │
└──────────────────────────────────────────────┘

concatWithSeparatorAssumeInjective

Introduit dans : v22.12.0 Semblable à concatWithSeparator, mais suppose que concatWithSeparator(sep[,exp1, exp2, ... ]) → result est injective. Une fonction est dite injective si elle renvoie des résultats différents pour des arguments distincts. Peut être utilisée pour optimiser GROUP BY. Syntaxe

concatWithSeparatorAssumeInjective(sep[, exp1, exp2, ... ])

Arguments

sep — Le séparateur à utiliser. const String ou const FixedString
exp1, exp2, ... — Expression à concaténer. Les arguments qui ne sont pas de type String ou FixedString sont convertis en chaînes à l’aide de leur sérialisation par défaut. Cela dégradant les performances, il est déconseillé d’utiliser des arguments autres que String/FixedString. String ou FixedString

Valeur renvoyée Renvoie la String obtenue en concaténant les arguments. Si l’une des valeurs d’argument est NULL, la fonction renvoie NULL. String Exemples Exemple d’utilisation

Query

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);

Response

┌─full_name───┬─total_score─┐
│ Jane-Smith  │         240 │
│ John-Doe    │         100 │
│ John-Wilson │         120 │
└─────────────┴─────────────┘

conv

Introduit dans : v25.10.0 Convertit des nombres d’une base à une autre. La fonction convertit un nombre d’une base à une autre. Elle prend en charge les bases de 2 à 36. Pour les bases supérieures à 10, les lettres A-Z (sans distinction de casse) sont utilisées pour représenter les chiffres de 10 à 35. Cette fonction est compatible avec la fonction CONV() de MySQL. Syntaxe

conv(number, from_base, to_base)

Arguments

number — Le nombre à convertir. Peut être une chaîne de caractères ou un type numérique. - from_base — La base d’origine (2-36). Doit être un entier. - to_base — La base cible (2-36). Doit être un entier.

Valeur renvoyée Représentation sous forme de chaîne de caractères du nombre dans la base cible. Exemples Convertir un nombre décimal en binaire

Query

SELECT conv('10', 10, 2)

Response

Convertir de l’hexadécimal en décimal

Query

SELECT conv('FF', 16, 10)

Response

Conversion avec un nombre négatif

Query

SELECT conv('-1', 10, 16)

Response

FFFFFFFFFFFFFFFF

Convertir du binaire en octal

Query

SELECT conv('1010', 2, 8)

Response

convertCharset

Introduit dans : v1.1.0 Renvoie la chaîne s convertie de l’encodage from vers l’encodage to. Syntaxe

convertCharset(s, from, to)

Arguments

s — Chaîne d’entrée. String
from — Encodage des caractères source. String
to — Encodage des caractères cible. String

Valeur renvoyée Renvoie la chaîne s convertie de l’encodage from vers l’encodage to. String Exemples Exemple d’utilisation

Query

SELECT convertCharset('Café', 'UTF-8', 'ISO-8859-1');

Response

┌─convertCharset('Café', 'UTF-8', 'ISO-8859-1')─┐
│ Caf�                                           │
└───────────────────────────────────────────────┘

damerauLevenshteinDistance

Introduit dans : v24.1.0 Calcule la distance de Damerau-Levenshtein entre deux chaînes d’octets. Syntaxe

damerauLevenshteinDistance(s1, s2)

Arguments

s1 — Première chaîne d’entrée. String
s2 — Deuxième chaîne d’entrée. String

Valeur renvoyée Renvoie la distance de Damerau-Levenshtein entre les deux chaînes. UInt64 Exemples Exemple d’utilisation

Query

SELECT damerauLevenshteinDistance('clickhouse', 'mouse')

Response

┌─damerauLevenshteinDistance('clickhouse', 'mouse')─┐
│                                                 6 │
└───────────────────────────────────────────────────┘

decodeHTMLComponent

Introduit dans : v23.9.0 Décode les entités HTML d’une chaîne en caractères correspondants. Syntaxe

decodeHTMLComponent(s)

Arguments

s — Chaîne contenant les entités HTML à décoder. String

Valeur renvoyée Renvoie la chaîne dont les entités HTML ont été décodées. String Exemples Exemple d’utilisation

Query

SELECT decodeHTMLComponent('&lt;div&gt;Hello &amp; &quot;World&quot;&lt;/div&gt;')

Response

┌─decodeHTMLComponent('&lt;div&gt;Hello &amp; &quot;World&quot;&lt;/div&gt;')─┐
│ <div>Hello & "World"</div>                                                  │
└─────────────────────────────────────────────────────────────────────────────┘

decodeXMLComponent

Introduit dans : v21.2.0 Décode les entités XML d’une chaîne en caractères correspondants. Syntaxe

decodeXMLComponent(s)

Arguments

s — Chaîne contenant les entités XML à décoder. String

Valeur renvoyée Renvoie la chaîne fournie après décodage des entités XML. String Exemples Exemple d’utilisation

Query

SELECT decodeXMLComponent('&lt;tag&gt;Hello &amp; World&lt;/tag&gt;')

Response

┌─decodeXMLComponent('&lt;tag&gt;Hello &amp; World&lt;/tag&gt;')─┐
│ <tag>Hello & World</tag>                                       │
└────────────────────────────────────────────────────────────────┘

editDistance

Introduit dans : v23.9.0 Calcule la distance d’édition entre deux chaînes d’octets. Syntaxe

editDistance(s1, s2)

Alias : levenshteinDistance Arguments

s1 — Première chaîne d’entrée. String
s2 — Deuxième chaîne d’entrée. String

Valeur renvoyée Renvoie la distance d’édition entre les deux chaînes. UInt64 Exemples Exemple d’utilisation

Query

SELECT editDistance('clickhouse', 'mouse')

Response

┌─editDistance('clickhouse', 'mouse')─┐
│                                   6 │
└─────────────────────────────────────┘

editDistanceUTF8

Disponible depuis : v24.6.0 Calcule la distance d’édition entre deux chaînes UTF8. Syntaxe

editDistanceUTF8(s1, s2)

Alias : levenshteinDistanceUTF8 Arguments

s1 — Première chaîne d’entrée. String
s2 — Deuxième chaîne d’entrée. String

Valeur renvoyée Renvoie la distance d’édition entre les deux chaînes UTF8. UInt64 Exemples Exemple d’utilisation

Query

SELECT editDistanceUTF8('我是谁', '我是我') AS distance

Response

┌─distance─┐
│        1 │
└──────────┘

encodeXMLComponent

Introduit dans : v21.1.0 Échappe les caractères afin d’insérer une chaîne dans un nœud de texte XML ou un attribut. Syntaxe

encodeXMLComponent(s)

Arguments

s — Chaîne à échapper. String

Valeur renvoyée Renvoie la chaîne échappée. String Exemples Exemple d’utilisation

Query

SELECT
    '<tag>Hello & "World"</tag>' AS original,
    encodeXMLComponent('<tag>Hello & "World"</tag>') AS xml_encoded;

Response

┌─original───────────────────┬─xml_encoded──────────────────────────────────────────┐
│ <tag>Hello & "World"</tag> │ &lt;tag&gt;Hello &amp; &quot;World&quot;&lt;/tag&gt; │
└────────────────────────────┴──────────────────────────────────────────────────────┘

endsWith

Introduit dans : v1.1.0 Indique si une chaîne se termine par le suffixe fourni. Syntaxe

endsWith(s, suffix)

Arguments

s — Chaîne à vérifier. String
suffix — Suffixe à rechercher. String

Valeur renvoyée Renvoie 1 si s se termine par suffix, sinon 0. UInt8 Exemples Exemple d’utilisation

Query

SELECT endsWith('ClickHouse', 'House');

Response

┌─endsWith('ClickHouse', 'House')─┐
│                               1 │
└─────────────────────────────────┘

endsWithCaseInsensitive

Introduit dans : v25.10.0 Vérifie si une chaîne se termine par le suffixe fourni, indépendamment de la casse. Syntaxe

endsWithCaseInsensitive(s, suffix)

Arguments

s — Chaîne à vérifier. String
suffix — Suffixe à vérifier, sans tenir compte de la casse. String

Valeur renvoyée Renvoie 1 si s se termine par le suffix sans tenir compte de la casse, sinon 0. UInt8 Exemples Exemple d’utilisation

Query

SELECT endsWithCaseInsensitive('ClickHouse', 'HOUSE');

Response

┌─endsWithCaseInsensitive('ClickHouse', 'HOUSE')─┐
│                                              1 │
└────────────────────────────────────────────────┘

endsWithCaseInsensitiveUTF8

Introduit dans : v25.10.0 Renvoie si la chaîne s se termine par le suffix sans tenir compte de la casse. Suppose que la chaîne contient du texte valide encodé en UTF-8. Si cette hypothèse n’est pas respectée, aucune exception n’est levée et le résultat est indéfini. Syntaxe

endsWithCaseInsensitiveUTF8(s, suffix)

Arguments

s — Chaîne à vérifier. String
suffix — Suffixe à vérifier, insensible à la casse. String

Valeur renvoyée Renvoie 1 si s se termine par le suffix sans tenir compte de la casse, sinon 0. UInt8 Exemples Exemple d’utilisation

Query

SELECT endsWithCaseInsensitiveUTF8('данных', 'ых');

Response

┌─endsWithCaseInsensitiveUTF8('данных', 'ых')─┐
│                                           1 │
└─────────────────────────────────────────────┘

endsWithUTF8

Introduit dans : v23.8.0 Renvoie si la chaîne s se termine par suffix. Suppose que la chaîne contient du texte valide encodé en UTF-8. Si cette hypothèse est violée, aucune exception n’est levée et le résultat est indéfini. Syntaxe

endsWithUTF8(s, suffix)

Arguments

s — Chaîne à vérifier. String
suffix — Suffixe à rechercher. String

Valeur renvoyée Renvoie 1 si s se termine par suffix, sinon 0. UInt8 Exemples Exemple d’utilisation

Query

SELECT endsWithUTF8('данных', 'ых');

Response

┌─endsWithUTF8('данных', 'ых')─┐
│                            1 │
└──────────────────────────────┘

extractTextFromHTML

Introduit dans : v21.3.0 Extrait le contenu texte de documents HTML ou XHTML. Cette fonction supprime les balises HTML, les commentaires ainsi que les éléments script/style, pour ne conserver que le contenu texte. Elle prend en charge :

La suppression de toutes les balises HTML/XML
La suppression des commentaires ({/* */})
La suppression des éléments script et style avec leur contenu
Le traitement des sections CDATA (copiées telles quelles)
La gestion correcte des espaces et leur normalisation

Remarque : les entités HTML ne sont pas décodées et doivent être traitées avec une fonction distincte si nécessaire. Syntaxe

extractTextFromHTML(html)

Arguments

html — Chaîne contenant le code HTML à partir duquel extraire le texte. String

Valeur renvoyée Renvoie le contenu textuel extrait avec des espaces blancs normalisés. String Exemples Exemple d’utilisation

Query

SELECT extractTextFromHTML('
<html>
    <head><title>Page Title</title></head>
    <body>
        <p>Hello <b>World</b>!</p>
        <script>alert("test");</script>
        <!-- comment -->
    </body>
</html>
');

Response

┌─extractTextFromHTML('\n<html>\n    <head><title>Page Title</title></head>\n    <body>\n        <p>Hello <b>World</b>!</p>\n        <script>alert("test");</script>\n        <!-- comment -->\n    </body>\n</html>\n')─┐
│ Page Title Hello World !                                                                                                                                                                                               │
└────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘

firstLine

Introduit dans : v23.7.0 Renvoie la première ligne d’une chaîne multiligne. Syntaxe

firstLine(s)

Arguments

s — Chaîne d’entrée. String

Valeur renvoyée Renvoie la première ligne de la chaîne d’entrée, ou la chaîne entière si elle ne contient aucun séparateur de ligne. String Exemples Exemple d’utilisation

Query

SELECT firstLine('foo\\nbar\\nbaz')

Response

┌─firstLine('foo\\nbar\\nbaz')─┐
│ foo\nbar\nbaz                │
└──────────────────────────────┘

idnaDecode

Introduit dans : v24.1.0 Renvoyer la représentation Unicode (UTF-8) (algorithme ToUnicode) d’un nom de domaine selon le mécanisme Internationalized Domain Names in Applications (IDNA). En cas d’erreur (par exemple si l’entrée n’est pas valide), la chaîne d’entrée est renvoyée. Notez que l’application répétée de idnaEncode() et idnaDecode() ne renvoie pas nécessairement la chaîne d’origine en raison de la normalisation de la casse. Syntaxe

idnaDecode(s)

Arguments

s — Chaîne d’entrée. String

Valeur renvoyée Renvoie une représentation Unicode (UTF-8) de la chaîne d’entrée, conformément au mécanisme IDNA appliqué à la valeur d’entrée. String Exemples Exemple d’utilisation

Query

SELECT idnaDecode('xn--strae-oqa.xn--mnchen-3ya.de')

Response

┌─idnaDecode('xn--strae-oqa.xn--mnchen-3ya.de')─┐
│ straße.münchen.de                             │
└───────────────────────────────────────────────┘

idnaEncode

Introduit dans : v24.1.0 Renvoie la représentation ASCII (algorithme ToASCII) d’un nom de domaine conformément au mécanisme Internationalized Domain Names in Applications (IDNA). La chaîne d’entrée doit être encodée en UTF et pouvoir être convertie en chaîne ASCII, sinon une exception est levée.

Aucun décodage des pourcentages ni aucune suppression des tabulations, espaces ou caractères de contrôle n’est effectué.

Syntaxe

idnaEncode(s)

Arguments

s — Chaîne d’entrée. String

Valeur renvoyée Renvoie une représentation ASCII de la chaîne d’entrée conformément au mécanisme IDNA. String Exemples Exemple d’utilisation

Query

SELECT idnaEncode('straße.münchen.de')

Response

┌─idnaEncode('straße.münchen.de')─┐
│ xn--strae-oqa.xn--mnchen-3ya.de │
└─────────────────────────────────┘

initcap

Introduit dans : v23.7.0 Convertit la première lettre de chaque mot en majuscule et les autres en minuscules. Les mots sont des séquences de caractères alphanumériques séparées par des caractères non alphanumériques.

Comme initcap convertit uniquement la première lettre de chaque mot en majuscule, vous pouvez constater un comportement inattendu avec les mots contenant des apostrophes ou des lettres majuscules. Il s’agit d’un comportement connu, et il n’est actuellement pas prévu de le corriger.

Syntaxe

initcap(s)

Arguments

s — Chaîne d’entrée. String

Valeur renvoyée Renvoie s avec la première lettre de chaque mot mise en majuscule. String Exemples Exemple d’utilisation

Query

SELECT initcap('building for fast')

Response

┌─initcap('building for fast')─┐
│ Building For Fast            │
└──────────────────────────────┘

Exemple de comportement connu pour les mots contenant des apostrophes ou des majuscules

Query

SELECT initcap('John''s cat won''t eat.');

Response

┌─initcap('John\'s cat won\'t eat.')─┐
│ John'S Cat Won'T Eat.              │
└────────────────────────────────────┘

initcapUTF8

Introduit dans : v23.7.0 Comme initcap, initcapUTF8 convertit la première lettre de chaque mot en majuscule et le reste en minuscules. Suppose que la chaîne contient un texte valide encodé en UTF-8. Si cette hypothèse n’est pas respectée, aucune exception n’est levée et le résultat est indéfini.

Cette fonction ne détecte pas la langue ; par exemple, pour le turc, le résultat peut ne pas être tout à fait correct (i/İ vs. i/I). Si la longueur de la séquence d’octets UTF-8 diffère entre les formes en majuscules et en minuscules d’un point de code, le résultat peut être incorrect pour ce point de code.

Syntaxe

initcapUTF8(s)

Arguments

s — Chaîne d’entrée. String

Valeur renvoyée Renvoie s avec la première lettre de chaque mot en majuscule. String Exemples Exemple d’utilisation

Query

SELECT initcapUTF8('не тормозит')

Response

┌─initcapUTF8('не тормозит')─┐
│ Не Тормозит                │
└────────────────────────────┘

isValidASCII

Introduit dans : v25.9.0 Renvoie 1 si la String d’entrée ou la FixedString ne contient que des octets ASCII (0x00–0x7F), sinon 0. Optimisé pour le cas positif (la valeur d’entrée est un ASCII valide). Syntaxe

isValidASCII(str)

Alias : isASCII Arguments

Aucun.

Valeur renvoyée Exemples isValidASCII

Query

SELECT isValidASCII('hello') AS is_ascii, isValidASCII('你好') AS is_not_ascii

Response

┌─is_ascii─┬─is_not_ascii─┐
│        1 │            0 │
└──────────┴──────────────┘

isValidUTF8

Introduit dans : v20.1.0 Vérifie si la séquence d’octets constitue un texte valide encodé en UTF-8. Syntaxe

isValidUTF8(s)

Arguments

s — La chaîne dont il faut vérifier la validité de l’encodage UTF-8. String

Valeur renvoyée Renvoie 1 si la suite d’octets constitue un texte valide encodé en UTF-8, sinon 0. UInt8 Exemples Exemple d’utilisation

Query

SELECT isValidUTF8('\\xc3\\xb1') AS valid, isValidUTF8('\\xc3\\x28') AS invalid

Response

┌─valid─┬─invalid─┐
│     1 │       1 │
└───────┴─────────┘

jaroSimilarity

Introduit dans : v24.1.0 Calcule la similarité de Jaro entre deux chaînes d’octets. Syntaxe

jaroSimilarity(s1, s2)

Arguments

s1 — Première chaîne d’entrée. String
s2 — Deuxième chaîne d’entrée. String

Valeur renvoyée Renvoie le score de similarité de Jaro entre les deux chaînes. Float64 Exemples Exemple d’utilisation

Query

SELECT jaroSimilarity('clickhouse', 'click')

Response

┌─jaroSimilarity('clickhouse', 'click')─┐
│                    0.8333333333333333 │
└───────────────────────────────────────┘

jaroWinklerSimilarity

Introduit dans : v24.1.0 Calcule la similarité de Jaro-Winkler entre deux chaînes d’octets. Syntaxe

jaroWinklerSimilarity(s1, s2)

Arguments

s1 — Première chaîne d’entrée. String
s2 — Deuxième chaîne d’entrée. String

Valeur renvoyée Renvoie la similarité Jaro-Winkler entre les deux chaînes. Float64 Exemples Exemple d’utilisation

Query

SELECT jaroWinklerSimilarity('clickhouse', 'click')

Response

┌─jaroWinklerSimilarity('clickhouse', 'click')─┐
│                           0.8999999999999999 │
└──────────────────────────────────────────────┘

left

Introduite dans : v22.1.0 Renvoie une sous-chaîne de la chaîne s avec un offset spécifié, à partir de la gauche. Syntaxe

left(s, offset)

Arguments

s — La chaîne dont extraire une sous-chaîne. String ou FixedString
offset — Le nombre d’octets du décalage. (U)Int*

Valeur renvoyée Renvoie :

Pour un offset positif, une sous-chaîne de s de offset octets, à partir du début de la chaîne.
Pour un offset négatif, une sous-chaîne de s de length(s) - |offset| octets, à partir du début de la chaîne.
Une chaîne vide si length vaut 0. String

Exemples Décalage positif

Query

SELECT left('Hello World', 5)

Response

Hello

Offset négatif

Query

SELECT left('Hello World', -6)

Response

Hello

leftPad

Introduit dans : v21.8.0 Complète une chaîne à gauche avec des espaces ou avec une chaîne spécifiée (répétée plusieurs fois si nécessaire) jusqu’à ce que la chaîne obtenue atteigne la length spécifiée. Syntaxe

leftPad(string, length[, pad_string])

Alias : lpad Arguments

string — Chaîne d’entrée à compléter. String
length — Longueur de la chaîne résultante. Si la valeur est inférieure à la longueur de la chaîne d’entrée, celle-ci est alors tronquée à length caractères. (U)Int*
pad_string — Facultatif. Chaîne utilisée pour compléter la chaîne d’entrée. Si elle n’est pas spécifiée, la chaîne d’entrée est complétée avec des espaces. String

Valeur renvoyée Renvoie une chaîne complétée à gauche de la longueur indiquée. String Exemples Exemple d’utilisation

Query

SELECT leftPad('abc', 7, '*'), leftPad('def', 7)

Response

┌─leftPad('abc', 7, '*')─┬─leftPad('def', 7)─┐
│ ****abc                │     def           │
└────────────────────────┴───────────────────┘

leftPadUTF8

Introduit dans : v21.8.0 Ajoute à gauche d’une chaîne UTF8 des espaces ou une chaîne spécifiée (répétée si nécessaire) jusqu’à ce que la chaîne obtenue atteigne la longueur indiquée. Contrairement à leftPad, qui mesure la longueur de la chaîne en octets, ici, la longueur de la chaîne est mesurée en points de code. Syntaxe

leftPadUTF8(string, length[, pad_string])

Arguments

string — Chaîne d’entrée à remplir. String
length — Longueur de la chaîne obtenue. Si la valeur est inférieure à la longueur de la chaîne d’entrée, celle-ci est tronquée à length caractères. (U)Int*
pad_string — Facultatif. Chaîne utilisée pour remplir la chaîne d’entrée. Si elle n’est pas spécifiée, la chaîne d’entrée est complétée avec des espaces. String

Valeur renvoyée Renvoie une chaîne complétée à gauche à la longueur indiquée. String Exemples Exemple d’utilisation

Query

SELECT leftPadUTF8('абвг', 7, '*'), leftPadUTF8('дежз', 7)

Response

┌─leftPadUTF8('абвг', 7, '*')─┬─leftPadUTF8('дежз', 7)─┐
│ ***абвг                     │    дежз                │
└─────────────────────────────┴────────────────────────┘

leftUTF8

Introduit dans : v22.1.0 Renvoie une sous-chaîne de la chaîne s, encodée en UTF-8, avec un offset spécifié à partir de la gauche. Syntaxe

leftUTF8(s, offset)

Arguments

s — La chaîne encodée en UTF-8 dont extraire une sous-chaîne. String ou FixedString
offset — Le décalage, en nombre d’octets. (U)Int*

Valeur renvoyée Renvoie :

Pour un offset positif, une sous-chaîne de s de offset octets, en partant de la gauche de la chaîne.\n”
Pour un offset négatif, une sous-chaîne de s de length(s) - |offset| octets, en partant de la gauche de la chaîne.\n”
Une chaîne vide si length vaut 0. String

Exemples Décalage positif

Query

SELECT leftUTF8('Привет', 4)

Response

Прив

Offset négatif

Query

SELECT leftUTF8('Привет', -4)

Response

Пр

lengthUTF8

Introduit dans : v1.1.0 Renvoie la longueur d’une chaîne en points de code Unicode plutôt qu’en octets ou en caractères. Pour calculer la longueur d’une chaîne en octets, utilisez la fonction length. Cette fonction suppose que la chaîne contient un texte valide encodé en UTF-8. Si cette hypothèse n’est pas respectée, aucune exception n’est levée et le résultat n’est pas indéfini. Syntaxe

lengthUTF8(s)

Alias : CHARACTER_LENGTH, CHAR_LENGTH Arguments

s — String contenant du texte valide encodé en UTF-8. String

Valeur renvoyée Longueur de la chaîne s en points de code Unicode. UInt64 Exemples Exemple d’utilisation

Query

SELECT lengthUTF8('Здравствуй, мир!')

Response

┌─lengthUTF8('Здравствуй, мир!')─┐
│                             16 │
└────────────────────────────────┘

lower

Introduit dans : v1.1.0 Convertit une chaîne ASCII en minuscules. Syntaxe

lower(s)

Alias : lcase Arguments

s — Une chaîne à convertir en minuscules. String

Valeur renvoyée Renvoie la chaîne s en minuscules. String Exemples Exemple d’utilisation

Query

SELECT lower('CLICKHOUSE')

Response

┌─lower('CLICKHOUSE')─┐
│ clickhouse          │
└─────────────────────┘

lowerUTF8

Introduit dans : v1.1.0 Convertit une chaîne en minuscules, en supposant qu’elle contient du texte valide encodé en UTF-8. Si cette hypothèse n’est pas respectée, aucune exception n’est levée et le résultat est indéfini. Syntaxe

lowerUTF8(input)

Arguments

input — Chaîne d’entrée à convertir en minuscules. String

Valeur renvoyée Renvoie une chaîne en minuscules. String Exemples premier

Query

SELECT lowerUTF8('München') as Lowerutf8;

Response

münchen

naturalSortKey

Introduit dans : v26.3.0 Cette fonction permet d’effectuer un tri naturel. Syntaxe

naturalSortKey(s)

Alias : NATURAL_SORT_KEY Arguments

s — Une chaîne à convertir en clé de tri naturel. String

Valeur renvoyée Renvoie la chaîne de clé de tri naturel obtenue à partir de s. String Exemples Exemple d’utilisation

Query

CREATE TABLE t (s String) ENGINE = Memory;
INSERT INTO t VALUES ('a1'), ('a02');

SELECT s FROM t ORDER BY naturalSortKey(s);

Response

┌─s───┐
│ a1  │
│ a02 │
└─────┘

normalizeUTF8NFC

Introduit dans : v21.11.0 Normalise une chaîne UTF-8 selon la forme de normalisation NFC. Syntaxe

normalizeUTF8NFC(str)

Arguments

str — Chaîne d’entrée encodée en UTF-8. String

Valeur renvoyée Renvoie la forme normalisée NFC de la chaîne encodée en UTF-8. String Exemples Exemple d’utilisation

Query

SELECT
'é' AS original, -- e + combining acute accent (U+0065 + U+0301)
length(original),
normalizeUTF8NFC('é') AS nfc_normalized, -- é (U+00E9)
length(nfc_normalized);

Response

┌─original─┬─length(original)─┬─nfc_normalized─┬─length(nfc_normalized)─┐
│ é        │                2 │ é              │                      2 │
└──────────┴──────────────────┴────────────────┴────────────────────────┘

normalizeUTF8NFD

Introduit dans : v21.11.0 Normalise une chaîne UTF-8 conformément à la forme de normalisation NFD. Syntaxe

normalizeUTF8NFD(str)

Arguments

str — chaîne d’entrée encodée en UTF-8. String

Valeur renvoyée Renvoie la forme normalisée NFD de la chaîne UTF-8. String Exemples Exemple d’utilisation

Query

SELECT
    'é' AS original, -- é (U+00E9)
    length(original),
    normalizeUTF8NFD('é') AS nfd_normalized, -- e + combining acute (U+0065 + U+0301)
    length(nfd_normalized);

Response

┌─original─┬─length(original)─┬─nfd_normalized─┬─length(nfd_normalized)─┐
│ é        │                2 │ é              │                      3 │
└──────────┴──────────────────┴────────────────┴────────────────────────┘

normalizeUTF8NFKC

Introduit dans : v21.11.0 Normalise une chaîne UTF-8 selon la forme de normalisation NFKC. Syntaxe

normalizeUTF8NFKC(str)

Arguments

str — Chaîne d’entrée encodée en UTF-8. String

Valeur renvoyée Renvoie la forme normalisée NFKC de la chaîne UTF-8. String Exemples Exemple d’utilisation

Query

SELECT
    '① ② ③' AS original,                           -- Circled number characters
    normalizeUTF8NFKC('① ② ③') AS nfkc_normalized  -- Converts to 1 2 3

Response

┌─original─┬─nfkc_normalized─┐
│ ① ② ③    │ 1 2 3           │
└──────────┴─────────────────┘

normalizeUTF8NFKCCasefold

Introduite dans : v26.3.0 Normalise une chaîne UTF-8 selon la forme de normalisation NFKC_Casefold, qui applique la normalisation NFKC puis le pliage de casse. Ceci est utile pour la correspondance insensible à la casse des identifiants. Syntaxe

normalizeUTF8NFKCCasefold(str)

Arguments

str — chaîne d’entrée encodée en UTF-8. String

Valeur renvoyée Renvoie la forme normalisée NFKC_Casefold de la chaîne UTF-8. String Exemples Exemple d’utilisation

Query

SELECT
    'Ä ① Hello' AS original,
    normalizeUTF8NFKCCasefold('Ä ① Hello') AS nfkc_cf_normalized;

Response

┌─original──┬─nfkc_cf_normalized─┐
│ Ä ① Hello │ ä 1 hello          │
└───────────┴────────────────────┘

normalizeUTF8NFKD

Introduit dans : v21.11.0 Normalise une chaîne UTF-8 conformément à la forme de normalisation NFKD. Syntaxe

normalizeUTF8NFKD(str)

Arguments

str — chaîne d’entrée encodée en UTF-8. String

Valeur renvoyée Renvoie la forme normalisée NFKD de la chaîne UTF-8. String Exemples Exemple d’utilisation

Query

SELECT
    'H₂O²' AS original,                           -- H + subscript 2 + O + superscript 2
    normalizeUTF8NFKD('H₂O²') AS nfkd_normalized  -- Converts to H 2 O 2

Response

┌─original─┬─nfkd_normalized─┐
│ H₂O²     │ H2O2            │
└──────────┴─────────────────┘

punycodeDecode

Introduite dans : v24.1.0 Renvoie le texte en clair encodé en UTF8 d’une chaîne encodée en Punycode. Si la chaîne fournie n’est pas une chaîne encodée en Punycode valide, une exception est levée. Syntaxe

punycodeDecode(s)

Arguments

s — Chaîne encodée en Punycode. String

Valeur renvoyée Renvoie le texte en clair de la valeur d’entrée. String Exemples Exemple d’utilisation

Query

SELECT punycodeDecode('Mnchen-3ya')

Response

┌─punycodeDecode('Mnchen-3ya')─┐
│ München                      │
└──────────────────────────────┘

punycodeEncode

Introduit dans : v24.1.0 Renvoie la représentation en Punycode d’une chaîne. La chaîne doit être encodée en UTF8, sinon le comportement est indéfini. Syntaxe

punycodeEncode(s)

Arguments

s — Valeur d’entrée. String

Valeur renvoyée Renvoie une représentation en Punycode de la valeur d’entrée. String Exemples Exemple d’utilisation

Query

SELECT punycodeEncode('München')

Response

┌─punycodeEncode('München')─┐
│ Mnchen-3ya                │
└───────────────────────────┘

regexpExtract

Introduit dans : v23.2.0 Extrait la première chaîne de haystack qui correspond au motif regexp et à l’indice du groupe regex. Syntaxe

regexpExtract(haystack, pattern[, index])

Alias : REGEXP_EXTRACT, REGEXP_SUBSTR Arguments

haystack — String dans laquelle le motif regexp sera recherché. String
pattern — String, expression régulière. pattern peut contenir plusieurs groupes regexp ; index indique quel groupe regex extraire. Un index de 0 signifie que l’expression régulière entière est extraite. const String
index — Facultatif. Un entier non négatif indiquant quel groupe regex extraire. La valeur par défaut est 1 si pattern contient au moins un groupe de capture, et 0 (la correspondance complète) si pattern ne contient aucun groupe de capture. (U)Int*

Valeur renvoyée Renvoie une chaîne correspondant au motif String Exemples Exemple d’utilisation

Query

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+');

Response

┌─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+')─┐
│ 100                                          │ 200                                          │ 100-200                                      │ 100                                       │ 100                              │
└──────────────────────────────────────────────┴──────────────────────────────────────────────┴──────────────────────────────────────────────┴───────────────────────────────────────────┴──────────────────────────────────┘

regexpPosition

Introduit dans : v26.5.0 Renvoie la position en octets (à partir de 1) de la occurrence-ième correspondance de pattern dans haystack, en commençant la recherche à la position en octets position. Si return_option vaut 0 (par défaut), la position du premier octet de la correspondance est renvoyée. Si return_option vaut 1, la position du premier octet après la correspondance est renvoyée. Si subexpression est supérieur à 0, la position du groupe de capture correspondant est renvoyée à la place de celle de la correspondance entière. Renvoie 0 si aucune correspondance n’est trouvée, ou si le groupe de capture demandé n’a pas participé à la correspondance. Cette fonction est fournie pour assurer la compatibilité avec regexp_instr de PostgreSQL (également exposé sous cet alias). Notez que les positions sont exprimées en octets, conformément aux autres fonctions Regex de ClickHouse ; regexp_instr de PostgreSQL est basé sur les caractères. Syntaxe

regexpPosition(haystack, pattern[, position[, occurrence[, return_option[, flags[, subexpression]]]]])

Aliases : regexpInstr, regexp_instr Arguments

haystack — Chaîne dans laquelle effectuer la recherche. String
pattern — Motif d’expression régulière. const String
position — Facultatif. Position en octets, indexée à partir de 1, à partir de laquelle commencer la recherche. Par défaut : 1. (U)Int*
occurrence — Facultatif. Occurrence à renvoyer. Par défaut : 1. (U)Int*
return_option — Facultatif. 0 renvoie la position du début de la correspondance, 1 renvoie la position immédiatement après la correspondance. Par défaut : 0. (U)Int*
flags — Facultatif. Indicateurs Regex. Pris en charge : i (insensible à la casse), c (sensible à la casse), m/n (ancres multiligne), s (le point correspond à un saut de ligne). Par défaut : vide. const String
subexpression — Facultatif. Indice du groupe de capture dont la position doit être renvoyée. 0 signifie la correspondance entière. Par défaut : 0. (U)Int*

Valeur renvoyée Renvoie la position en octets de la correspondance, ou 0 si aucune correspondance n’est trouvée. UInt64 Exemples Utilisation de base

Query

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);

Response

┌─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

Introduit dans : v26.3.0 Supprime les signes diacritiques (accents) d’une chaîne UTF-8 en décomposant les caractères via NFD, en supprimant les marques combinatoires (catégorie Unicode Mn), puis en les recomposant via NFC. Syntaxe

removeDiacriticsUTF8(str)

Alias: removeAccentsUTF8 Arguments

str — Chaîne d’entrée encodée en UTF-8. String

Valeur renvoyée Chaîne UTF-8 sans diacritiques. String Exemples Suppression simple des accents

Query

SELECT removeDiacriticsUTF8('café résumé naïve')

Response

┌─removeDiacriticsUTF8('café résumé naïve')─┐
│ cafe resume naive                         │
└───────────────────────────────────────────┘

repeat

Introduit dans : v20.1.0 Concatène une chaîne avec elle-même autant de fois que spécifié. Syntaxe

repeat(s, n)

Arguments

s — La chaîne à répéter. String
n — Le nombre de répétitions de la chaîne. (U)Int*

Valeur renvoyée Une chaîne contenant s répété n fois. Si n est négatif, la fonction renvoie une chaîne vide. String Exemples Exemple d’utilisation

Query

SELECT repeat('abc', 10)

Response

┌─repeat('abc', 10)──────────────┐
│ abcabcabcabcabcabcabcabcabcabc │
└────────────────────────────────┘

reverseUTF8

Introduit dans : v1.1.0 Inverse une séquence de points de code Unicode dans une chaîne. Suppose que la chaîne contient du texte encodé en UTF-8 valide. Si cette hypothèse n’est pas respectée, aucune exception n’est levée et le résultat est indéfini. Syntaxe

reverseUTF8(s)

Arguments

s — Chaîne contenant du texte valide encodé en UTF-8. String

Valeur renvoyée Renvoie une chaîne dont la séquence de points de code Unicode est inversée. String Exemples Exemple d’utilisation

Query

SELECT reverseUTF8('ClickHouse')

Response

esuoHkcilC

right

Introduit dans : v22.1.0 Renvoie une sous-chaîne de la chaîne s avec l’offset spécifié, en partant de la droite. Syntaxe

right(s, offset)

Arguments

s — La chaîne dont il faut extraire une sous-chaîne. String ou FixedString
offset — Le décalage, exprimé en nombre d’octets. (U)Int*

Valeur renvoyée Renvoie :

Pour un offset positif, une sous-chaîne de s de offset octets, en partant de la droite de la chaîne.
Pour un offset négatif, une sous-chaîne de s de length(s) - |offset| octets, en partant de la droite de la chaîne.
Une chaîne vide si length vaut 0. String

Exemples Décalage positif

Query

SELECT right('Hello', 3)

Response

llo

Décalage négatif

Query

SELECT right('Hello', -3)

Response

lo

rightPad

Introduit dans : v21.8.0 Ajoute des espaces ou une chaîne spécifiée à droite d’une chaîne (à plusieurs reprises si nécessaire) jusqu’à ce que la chaîne obtenue atteigne la length spécifiée. Syntaxe

rightPad(string, length[, pad_string])

Alias : rpad Arguments

string — Chaîne d’entrée à compléter. String
length — Longueur de la chaîne obtenue. Si la valeur est inférieure à la longueur de la chaîne d’entrée, celle-ci est tronquée à length caractères. (U)Int*
pad_string — Facultatif. Chaîne utilisée pour compléter la chaîne d’entrée. Si elle n’est pas spécifiée, la chaîne d’entrée est complétée avec des espaces. String

Valeur renvoyée Renvoie une chaîne complétée à droite de la longueur spécifiée. String Exemples Exemple d’utilisation

Query

SELECT rightPad('abc', 7, '*'), rightPad('abc', 7)

Response

┌─rightPad('abc', 7, '*')─┬─rightPad('abc', 7)─┐
│ abc****                 │ abc                │
└─────────────────────────┴────────────────────┘

rightPadUTF8

Introduit dans : v21.8.0 Ajoute à droite de la chaîne des espaces ou une chaîne spécifiée (répétée plusieurs fois si nécessaire) jusqu’à ce que la chaîne obtenue atteigne la longueur indiquée. Contrairement à rightPad, qui mesure la longueur de la chaîne en octets, ici la longueur de la chaîne est mesurée en points de code. Syntaxe

rightPadUTF8(string, length[, pad_string])

Arguments

string — Chaîne d’entrée à compléter. String
length — Longueur de la chaîne résultante. Si cette valeur est inférieure à la longueur de la chaîne d’entrée, celle-ci est tronquée à length caractères. (U)Int*
pad_string — Facultatif. Chaîne utilisée pour compléter la chaîne d’entrée. Si elle n’est pas spécifiée, la chaîne d’entrée est complétée avec des espaces. String

Valeur renvoyée Renvoie une chaîne complétée à droite jusqu’à la longueur indiquée. String Exemples Exemple d’utilisation

Query

SELECT rightPadUTF8('абвг', 7, '*'), rightPadUTF8('абвг', 7)

Response

┌─rightPadUTF8('абвг', 7, '*')─┬─rightPadUTF8('абвг', 7)─┐
│ абвг***                      │ абвг                    │
└──────────────────────────────┴─────────────────────────┘

rightUTF8

Introduit dans : v22.1.0 Renvoie une sous-chaîne de la chaîne s encodée en UTF-8 avec un offset spécifié en partant de la droite. Syntaxe

rightUTF8(s, offset)

Arguments

s — La chaîne encodée en UTF-8 dont il faut calculer une sous-chaîne. String ou FixedString
offset — Le décalage, en nombre d’octets. (U)Int*

Valeur renvoyée Renvoie :

Pour un offset positif, une sous-chaîne de s de offset octets, en partant de la droite de la chaîne.
Pour un offset négatif, une sous-chaîne de s de length(s) - |offset| octets, en partant de la droite de la chaîne.
Une chaîne vide si length vaut 0. String

Exemples Décalage positif

Query

SELECT rightUTF8('Привет', 4)

Response

ивет

OFFSET négatif

Query

SELECT rightUTF8('Привет', -4)

Response

ет

soundex

Introduit dans : v23.4.0 Renvoie le code Soundex d’une chaîne de caractères. Syntaxe

soundex(s)

Arguments

s — Chaîne d’entrée. String

Valeur renvoyée Renvoie le code Soundex de la chaîne d’entrée. String Exemples Exemple d’utilisation

Query

SELECT soundex('aksel')

Response

┌─soundex('aksel')─┐
│ A240             │
└──────────────────┘

space

Introduite dans : v23.5.0 Concatène un espace ( ) avec lui-même autant de fois que spécifié. Syntaxe

space(n)

Arguments

n — Le nombre de répétitions de l’espace. (U)Int*

Valeur renvoyée Renvoie une chaîne contenant un espace répété n fois. Si n <= 0, la fonction renvoie une chaîne vide. String Exemples Exemple d’utilisation

Query

SELECT space(3) AS res, length(res);

Response

┌─res─┬─length(res)─┐
│     │           3 │
└─────┴─────────────┘

sparseGrams

Introduit dans : v25.5.0 Trouve toutes les sous-chaînes d’une chaîne donnée dont la longueur est d’au moins n, où les hachages des (n-1)-grammes aux extrémités de la sous-chaîne sont strictement supérieurs à ceux de tout (n-1)-gramme situé à l’intérieur de la sous-chaîne. Utilise CRC32 comme fonction de hachage. Syntaxe

sparseGrams(s[, min_ngram_length[, max_ngram_length[, min_cutoff_length]]])

Arguments

s — Une chaîne d’entrée. String
min_ngram_length — Facultatif. Longueur minimale du n-gramme extrait. La valeur par défaut et la valeur minimale sont de 3. UInt*
max_ngram_length — Facultatif. Longueur maximale du n-gramme extrait. La valeur par défaut est de 100. Elle ne doit pas être inférieure à min_ngram_length. UInt*
min_cutoff_length — Facultatif. Si ce paramètre est spécifié, seuls les n-grammes d’une longueur supérieure ou égale à min_cutoff_length sont renvoyés. La valeur par défaut est la même que min_ngram_length. Elle ne doit pas être inférieure à min_ngram_length ni supérieure à max_ngram_length. UInt*

Valeur renvoyée Renvoie un tableau de sous-chaînes sélectionnées. Array(String) Exemples Exemple d’utilisation

Query

SELECT sparseGrams('alice', 3)

Response

┌─sparseGrams('alice', 3)────┐
│ ['ali','lic','ice','lice'] │
└────────────────────────────┘

sparseGramsHashes

Introduit dans : v25.5.0 Trouve les hachages de toutes les sous-chaînes d’une chaîne donnée d’une longueur d’au moins n, pour lesquelles les hachages des (n-1)-grammes situés aux extrémités de la sous-chaîne sont strictement supérieurs à ceux de tous les (n-1)-grammes qu’elle contient. Utilise CRC32 comme fonction de hachage. Syntaxe

sparseGramsHashes(s[, min_ngram_length, max_ngram_length])

Arguments

s — Une chaîne d’entrée. String
min_ngram_length — Facultatif. Longueur minimale du n-gramme extrait. La valeur par défaut, qui est aussi la valeur minimale, est 3. UInt*
max_ngram_length — Facultatif. Longueur maximale du n-gramme extrait. La valeur par défaut est 100. Doit être supérieure ou égale à min_ngram_length. UInt*
min_cutoff_length — Facultatif. Si ce paramètre est spécifié, seuls les n-grammes dont la longueur est supérieure ou égale à min_cutoff_length sont renvoyés. La valeur par défaut est la même que min_ngram_length. Doit être supérieure ou égale à min_ngram_length et inférieure ou égale à max_ngram_length. UInt*

Valeur renvoyée Renvoie un tableau de hachages CRC32 des sous-chaînes sélectionnées. Array(UInt32) Exemples Exemple d’utilisation

Query

SELECT sparseGramsHashes('alice', 3)

Response

┌─sparseGramsHashes('alice', 3)────────────────┐
│ [3851133533,3120039944,646693941,2577359366] │
└──────────────────────────────────────────────┘

sparseGramsHashesUTF8

Introduit dans : v25.5.0 Trouve les hachages de toutes les sous-chaînes d’une chaîne UTF-8 donnée dont la longueur est d’au moins n, lorsque les hachages des (n-1)-grammes situés aux extrémités de la sous-chaîne sont strictement supérieurs à ceux de tout (n-1)-gramme à l’intérieur de la sous-chaîne. Attend une chaîne UTF-8 et lève une exception en cas de séquence UTF-8 non valide. Utilise CRC32 comme fonction de hachage. Syntaxe

sparseGramsHashesUTF8(s[, min_ngram_length, max_ngram_length])

Arguments

s — Une chaîne d’entrée. String
min_ngram_length — Facultatif. Longueur minimale du n-gramme extrait. La valeur par défaut, qui est aussi la valeur minimale, est 3. UInt*
max_ngram_length — Facultatif. Longueur maximale du n-gramme extrait. La valeur par défaut est 100. Ne doit pas être inférieure à min_ngram_length. UInt*
min_cutoff_length — Facultatif. Si cette valeur est spécifiée, seuls les n-grammes dont la longueur est supérieure ou égale à min_cutoff_length sont renvoyés. La valeur par défaut est la même que min_ngram_length. Ne doit pas être inférieure à min_ngram_length ni supérieure à max_ngram_length. UInt*

Valeur renvoyée Renvoie un tableau de hachages CRC32 des sous-chaînes UTF-8 sélectionnées. Array(UInt32) Exemples Exemple d’utilisation

Query

SELECT sparseGramsHashesUTF8('алиса', 3)

Response

┌─sparseGramsHashesUTF8('алиса', 3)───────────────────────┐
│ [1328958118,547287748,4155892324,2403052185,1673399070] │
└─────────────────────────────────────────────────────────┘

sparseGramsUTF8

Introduit dans : v25.5.0 Trouve toutes les sous-chaînes d’une chaîne UTF-8 donnée dont la longueur est d’au moins n, lorsque les hachages des (n-1)-grammes aux extrémités de la sous-chaîne sont strictement supérieurs à ceux de tout (n-1)-gramme à l’intérieur de la sous-chaîne. Attend une chaîne UTF-8 et lève une exception en cas de séquence UTF-8 non valide. Utilise CRC32 comme fonction de hachage. Syntaxe

sparseGramsUTF8(s[, min_ngram_length[, max_ngram_length[, min_cutoff_length]]])

Arguments

s — Une chaîne d’entrée. String
min_ngram_length — Facultatif. Longueur minimale du n-gramme extrait. La valeur minimale et la valeur par défaut sont 3. UInt*
max_ngram_length — Facultatif. Longueur maximale du n-gramme extrait. La valeur par défaut est 100. Elle ne doit pas être inférieure à min_ngram_length. UInt*
min_cutoff_length — Facultatif. Si cette valeur est spécifiée, seuls les n-grammes dont la longueur est supérieure ou égale à min_cutoff_length sont renvoyés. La valeur par défaut est identique à min_ngram_length. Elle ne doit pas être inférieure à min_ngram_length ni supérieure à max_ngram_length. UInt*

Valeur renvoyée Renvoie un tableau des sous-chaînes UTF-8 sélectionnées. Array(String) Exemples Exemple d’utilisation

Query

SELECT sparseGramsUTF8('алиса', 3)

Response

┌─sparseGramsUTF8('алиса', 3)────────┐
│ ['али','лис','иса','лиса','алиса'] │
└────────────────────────────────────┘

startsWith

Introduit dans : v1.1.0 Vérifie si une chaîne commence par la chaîne indiquée. Syntaxe

startsWith(s, prefix)

Arguments

s — Chaîne à vérifier. String
prefix — Préfixe à rechercher. String

Valeur renvoyée Renvoie 1 si s commence par prefix, sinon 0. UInt8 Exemples Exemple d’utilisation

Query

SELECT startsWith('ClickHouse', 'Click');

Response

┌─startsWith('ClickHouse', 'Click')─┐
│                                 1 │
└───────────────────────────────────┘

startsWithCaseInsensitive

Introduit dans : v25.10.0 Vérifie si une chaîne commence par la chaîne fournie, de manière insensible à la casse. Syntaxe

startsWithCaseInsensitive(s, prefix)

Arguments

s — chaîne à vérifier. String
prefix — Préfixe insensible à la casse à rechercher. String

Valeur renvoyée Renvoie 1 si s commence par le prefix de manière insensible à la casse, sinon 0. UInt8 Exemples Exemple d’utilisation

Query

SELECT startsWithCaseInsensitive('ClickHouse', 'CLICK');

Response

┌─startsWithCaseInsensitive('ClickHouse', 'CLICK')─┐
│                                                1 │
└──────────────────────────────────────────────────┘

startsWithCaseInsensitiveUTF8

Introduit dans : v25.10.0 Vérifie si une chaîne commence par le préfixe fourni, de manière insensible à la casse. Suppose que la chaîne contient du texte valide encodé en UTF-8. Si cette hypothèse n’est pas respectée, aucune exception n’est levée et le résultat est indéfini. Syntaxe

startsWithCaseInsensitiveUTF8(s, prefix)

Arguments

s — Chaîne à vérifier. String
prefix — Préfixe à vérifier, insensible à la casse. String

Valeur renvoyée Renvoie 1 si s commence par le prefix, de manière insensible à la casse, sinon 0. UInt8 Exemples Exemple d’utilisation

Query

SELECT startsWithCaseInsensitiveUTF8('приставка', 'при')

Response

┌─startsWithCaseInsensitiveUTF8('приставка', 'при')─┐
│                                                 1 │
└───────────────────────────────────────────────────┘

startsWithUTF8

Introduit dans : v23.8.0 Vérifie si une chaîne commence par le préfixe fourni. Suppose que la chaîne contient du texte valide encodé en UTF-8. Si cette hypothèse n’est pas respectée, aucune exception n’est levée et le résultat est indéfini. Syntaxe

startsWithUTF8(s, prefix)

Arguments

s — Chaîne à vérifier. String
prefix — Préfixe à vérifier. String

Valeur renvoyée Renvoie 1 si s commence par prefix, sinon 0. UInt8 Exemples Exemple d’utilisation

Query

SELECT startsWithUTF8('приставка', 'при')

Response

┌─startsWithUTF8('приставка', 'при')─┐
│                                  1 │
└────────────────────────────────────┘

stringBytesEntropy

Introduit dans : v25.6.0 Calcule l’entropie de Shannon de la distribution des octets d’une chaîne. Syntaxe

stringBytesEntropy(s)

Arguments

s — La chaîne à analyser. String

Valeur renvoyée Renvoie l’entropie de Shannon de la distribution des octets de la chaîne. Float64 Exemples Exemple d’utilisation

Query

SELECT stringBytesEntropy('Hello, world!')

Response

┌─stringBytesEntropy('Hello, world!')─┐
│                   3.180832987205441 │
└─────────────────────────────────────┘

stringBytesUniq

Introduit dans : v25.6.0 Compte le nombre d’octets distincts dans une chaîne de caractères. Syntaxe

stringBytesUniq(s)

Arguments

s — La chaîne à analyser. String

Valeur renvoyée Renvoie le nombre d’octets distincts de la chaîne. UInt16 Exemples Exemple d’utilisation

Query

SELECT stringBytesUniq('Hello')

Response

┌─stringBytesUniq('Hello')─┐
│                        4 │
└──────────────────────────┘

stringJaccardIndex

Introduit dans : v23.11.0 Calcule l’indice de similarité de Jaccard entre deux chaînes d’octets. Syntaxe

stringJaccardIndex(s1, s2)

Arguments

s1 — Première chaîne en entrée. String
s2 — Deuxième chaîne en entrée. String

Valeur renvoyée Renvoie l’indice de similarité de Jaccard entre les deux chaînes. Float64 Exemples Exemple d’utilisation

Query

SELECT stringJaccardIndex('clickhouse', 'mouse')

Response

┌─stringJaccardIndex('clickhouse', 'mouse')─┐
│                                       0.4 │
└───────────────────────────────────────────┘

stringJaccardIndexUTF8

Introduit dans : v23.11.0 Comme stringJaccardIndex, mais pour les chaînes codées en UTF8. Syntaxe

stringJaccardIndexUTF8(s1, s2)

Arguments

s1 — Première chaîne d’entrée UTF8. String
s2 — Deuxième chaîne d’entrée UTF8. String

Valeur renvoyée Renvoie l’indice de similarité de Jaccard entre les deux chaînes UTF8. Float64 Exemples Exemple d’utilisation

Query

SELECT stringJaccardIndexUTF8('我爱你', '我也爱你') AS jaccard_index

Response

┌─jaccard_index─┐
│          0.75 │
└───────────────┘

substring

Introduit dans : v1.1.0 Renvoyer la sous-chaîne d’une chaîne s à partir de l’index d’octet offset spécifié. Le comptage des octets commence à 1, selon la logique suivante :

Si offset vaut 0, une chaîne vide est renvoyée.
Si offset est négatif, la sous-chaîne commence à offset caractères de la fin de la chaîne, et non du début.

Un argument facultatif, length, spécifie le nombre maximal d’octets que la sous-chaîne renvoyée peut contenir. Voir aussi la fonction digits, qui effectue l’opération analogue sur les chiffres d’un nombre. Syntaxe

substring(s, offset[, length])

Alias: byteSlice, mid, substr Arguments

s — La chaîne à partir de laquelle extraire une sous-chaîne. String ou FixedString ou Enum
offset — La position de début de la sous-chaîne dans s. (U)Int*
length — Facultatif. La longueur maximale de la sous-chaîne. (U)Int*

Valeur renvoyée Renvoie une sous-chaîne de s de length octets, à partir de l’indice offset. String Exemples Utilisation de base

Query

SELECT 'database' AS db, substr(db, 5), substr(db, 5, 1)

Response

┌─db───────┬─substr(db, 5)─┬─substr(db, 5, 1)─┐
│ database │ base          │ b                │
└──────────┴───────────────┴──────────────────┘

substringIndex

Introduit dans : v23.7.0 Renvoie la sous-chaîne de s située avant count occurrences du délimiteur delim, comme dans Spark ou MySQL. Syntaxe

substringIndex(s, delim, count)

Alias : SUBSTRING_INDEX Arguments

s — La chaîne à partir de laquelle extraire la sous-chaîne. String
delim — Le caractère utilisé pour le découpage. String
count — Le nombre d’occurrences du délimiteur à compter avant d’extraire la sous-chaîne. Si count est positif, tout ce qui se trouve à gauche du délimiteur final (en comptant depuis la gauche) est renvoyé. Si count est négatif, tout ce qui se trouve à droite du délimiteur final (en comptant depuis la droite) est renvoyé. UInt ou Int

Valeur renvoyée Renvoie une sous-chaîne de s avant count occurrences de delim. String Exemples Exemple d’utilisation

Query

SELECT substringIndex('www.clickhouse.com', '.', 2)

Response

┌─substringIndex('www.clickhouse.com', '.', 2)─┐
│ www.clickhouse                               │
└──────────────────────────────────────────────┘

substringIndexUTF8

Introduit dans : v23.7.0 Renvoie la sous-chaîne de s située avant count occurrences du délimiteur delim, en se basant sur les points de code Unicode. Suppose que la chaîne contient du texte valide codé en UTF-8. Si cette hypothèse n’est pas respectée, aucune exception n’est levée et le résultat est indéfini. Syntaxe

substringIndexUTF8(s, delim, count)

Arguments

s — La chaîne dont extraire la sous-chaîne. String
delim — Le caractère de séparation. String
count — Le nombre d’occurrences du délimiteur à compter avant d’extraire la sous-chaîne. Si count est positif, tout ce qui se trouve à gauche du délimiteur final (en comptant depuis la gauche) est renvoyé. Si count est négatif, tout ce qui se trouve à droite du délimiteur final (en comptant depuis la droite) est renvoyé. UInt ou Int

Valeur renvoyée Renvoie la sous-chaîne de s située avant count occurrences de delim. String Exemples Exemple UTF8

Query

SELECT substringIndexUTF8('www.straßen-in-europa.de', '.', 2)

Response

www.straßen-in-europa

substringUTF8

Introduit dans : v1.1.0 Renvoie la sous-chaîne d’une chaîne s qui commence à l’indice de point de code offset spécifié. Le comptage des points de code commence à 1, selon la logique suivante :

Si offset vaut 0, une chaîne vide est renvoyée.
Si offset est négatif, la sous-chaîne commence à offset points de code de la fin de la chaîne, plutôt que du début.

Un argument facultatif length spécifie le nombre maximal de points de code que la sous-chaîne renvoyée peut contenir.

Cette fonction suppose que la chaîne contient du texte valide encodé en UTF-8. Si cette hypothèse n’est pas respectée, aucune exception n’est levée et le résultat est indéfini.

Syntaxe

substringUTF8(s, offset[, length])

Arguments

s — La chaîne à partir de laquelle extraire une sous-chaîne. String ou FixedString ou Enum
offset — La position de début de la sous-chaîne dans s. Int ou UInt
length — La longueur maximale de la sous-chaîne. Facultatif. Int ou UInt

Valeur renvoyée Renvoie une sous-chaîne de s de length points de code, à partir de l’indice de point de code offset. String Exemples Exemple d’utilisation

Query

SELECT 'Täglich grüßt das Murmeltier.' AS str, substringUTF8(str, 9), substringUTF8(str, 9, 5)

Response

Täglich grüßt das Murmeltier.	grüßt das Murmeltier.	grüßt

toValidUTF8

Introduite dans : v20.1.0 Convertit une chaîne en UTF-8 valide en remplaçant tout caractère UTF-8 non valide par le caractère de remplacement � (U+FFFD). Lorsque plusieurs caractères non valides consécutifs sont détectés, ils sont remplacés par un seul caractère de remplacement. Syntaxe

toValidUTF8(s)

Arguments

s — Tout ensemble d’octets représenté par un objet du type de données String. String

Valeur renvoyée Renvoie une chaîne UTF-8 valide. String Exemples Exemple d’utilisation

Query

SELECT toValidUTF8('\\x61\\xF0\\x80\\x80\\x80b')

Response

\\x61\\xF0\\x80\\x80\\x80b

trimBoth

Introduit dans : v20.1.0 Supprime les caractères spécifiés au début et à la fin d’une chaîne. Par défaut, supprime les caractères d’espacement (ASCII) les plus courants. Syntaxe

trimBoth(s[, trim_characters])

Alias : trim Arguments

s — Chaîne à traiter. String
trim_characters — Facultatif. Caractères à supprimer. S’ils ne sont pas spécifiés, les caractères d’espacement courants sont supprimés. String

Valeur renvoyée Renvoie la chaîne dont les caractères spécifiés ont été supprimés aux deux extrémités. String Exemples Exemple d’utilisation

Query

SELECT trimBoth('$$ClickHouse$$', '$')

Response

┌─trimBoth('$$ClickHouse$$', '$')─┐
│ ClickHouse                      │
└─────────────────────────────────┘

trimLeft

Introduit dans : v20.1.0 Supprime les caractères spécifiés au début d’une chaîne. Par défaut, supprime les caractères d’espacement (ASCII) courants. Syntaxe

trimLeft(input[, trim_characters])

Alias : ltrim Arguments

input — Chaîne à traiter. String
trim_characters — Facultatif. Caractères à supprimer. S’ils ne sont pas spécifiés, les caractères d’espacement courants sont supprimés. String

Valeur renvoyée Renvoie la chaîne dont les caractères spécifiés ont été supprimés à gauche. String Exemples Exemple d’utilisation

Query

SELECT trimLeft('ClickHouse', 'Click');

Response

┌─trimLeft('ClickHouse', 'Click')─┐
│ House                           │
└─────────────────────────────────┘

trimRight

Introduit dans : v20.1.0 Supprime les caractères spécifiés à la fin d’une chaîne. Par défaut, supprime les caractères d’espacement (ASCII) courants. Syntaxe

trimRight(s[, trim_characters])

Alias : rtrim Arguments

s — chaîne à traiter. String
trim_characters — Caractères optionnels à rogner. S’ils ne sont pas spécifiés, les caractères d’espacement courants sont supprimés. String

Valeur renvoyée Renvoie la chaîne dont les caractères spécifiés ont été supprimés à droite. String Exemples Exemple d’utilisation

Query

SELECT trimRight('ClickHouse','House');

Response

┌─trimRight('ClickHouse', 'House')─┐
│ Click                            │
└──────────────────────────────────┘

tryBase32Decode

Introduit dans : v25.6.0 Accepte une chaîne et la décode selon le schéma d’encodage Base32. Syntaxe

tryBase32Decode(encoded)

Arguments

encoded — colonne String ou constante à décoder. Si la chaîne n’est pas encodée en Base32 de manière valide, renvoie une chaîne vide en cas d’erreur. String

Valeur renvoyée Renvoie une chaîne contenant la valeur décodée de l’argument. String Exemples Exemple d’utilisation

Query

SELECT tryBase32Decode('IVXGG33EMVSA====');

Response

┌─tryBase32Decode('IVXGG33EMVSA====')─┐
│ Encoded                             │
└─────────────────────────────────────┘

tryBase58Decode

Introduit dans : v22.10.0 Comme base58Decode, mais renvoie une chaîne vide en cas d’erreur. Syntaxe

tryBase58Decode(encoded[, expected_size])

Arguments

encoded — Colonne ou constante de type String. Si la chaîne n’est pas un encodage Base58 valide, renvoie une chaîne vide en cas d’erreur. String
expected_size — Facultatif. Taille décodée obligatoire en octets : une entrée qui se décode vers toute autre taille est rejetée. 0 n’impose aucune contrainte. UInt8, UInt16, UInt32, or UInt64

Valeur renvoyée Renvoie une chaîne contenant la valeur décodée de l’argument. String Exemples Exemple d’utilisation

Query

SELECT tryBase58Decode('3dc8KtHrwM') AS res, tryBase58Decode('invalid') AS res_invalid;

Response

┌─res─────┬─res_invalid─┐
│ Encoded │             │
└─────────┴─────────────┘

tryBase64Decode

Introduit dans : v18.16.0 Comme base64Decode, mais renvoie une chaîne vide en cas d’erreur. Syntaxe

tryBase64Decode(encoded)

Arguments

encoded — colonne String ou constante à décoder. Si la chaîne n’est pas un encodage Base64 valide, renvoie une chaîne vide en cas d’erreur. String

Valeur renvoyée Renvoie une chaîne contenant la valeur décodée de l’argument. String Exemples Exemple d’utilisation

Query

SELECT tryBase64Decode('Y2xpY2tob3VzZQ==')

Response

┌─tryBase64Decode('Y2xpY2tob3VzZQ==')─┐
│ clickhouse                          │
└─────────────────────────────────────┘

tryBase64URLDecode

Introduit dans : v18.16.0 Comme base64URLDecode, mais renvoie une chaîne vide en cas d’erreur. Syntaxe

tryBase64URLDecode(encoded)

Arguments

encoded — Colonne ou constante de type String à décoder. Si la chaîne n’est pas correctement encodée en Base64, renvoie une chaîne vide en cas d’erreur. String

Valeur renvoyée Renvoie une chaîne contenant la valeur décodée de l’argument. String Exemples Exemple d’utilisation

Query

SELECT tryBase64URLDecode('aHR0cHM6Ly9jbGlja2hvdXNlLmNvbQ')

Response

┌─tryBase64URLDecode('aHR0cHM6Ly9jbGlja2hvdXNlLmNvbQ')─┐
│ https://clickhouse.com                               │
└──────────────────────────────────────────────────────┘

tryIdnaEncode

Introduit dans : v24.1.0 Renvoie la représentation Unicode (UTF-8) (algorithme ToUnicode) d’un nom de domaine selon le mécanisme Internationalized Domain Names in Applications (IDNA). En cas d’erreur, renvoie une chaîne vide au lieu de lever une exception. Syntaxe

tryIdnaEncode(s)

Arguments

s — Chaîne d’entrée. String

Valeur renvoyée Renvoie une représentation ASCII de la chaîne d’entrée conforme au mécanisme IDNA appliqué à la valeur d’entrée, ou une chaîne vide si l’entrée n’est pas valide. String Exemples Exemple d’utilisation

Query

SELECT tryIdnaEncode('straße.münchen.de')

Response

┌─tryIdnaEncode('straße.münchen.de')─┐
│ xn--strae-oqa.xn--mnchen-3ya.de    │
└────────────────────────────────────┘

tryPunycodeDecode

Introduit dans : v24.1.0 Comme punycodeDecode, mais renvoie une chaîne vide si la chaîne fournie n’est pas une chaîne encodée en Punycode valide. Syntaxe

tryPunycodeDecode(s)

Arguments

s — Chaîne encodée en Punycode. String

Valeur renvoyée Renvoie le texte en clair de la valeur en entrée, ou une chaîne vide si l’entrée n’est pas valide. String Exemples Exemple d’utilisation

Query

SELECT tryPunycodeDecode('Mnchen-3ya')

Response

┌─tryPunycodeDecode('Mnchen-3ya')─┐
│ München                         │
└─────────────────────────────────┘

upper

Introduit dans : v1.1.0 Convertit les caractères latins ASCII d’une chaîne en majuscules. Syntaxe

upper(s)

Alias : ucase Arguments

s — La chaîne à convertir en majuscules. String

Valeur renvoyée Renvoie s convertie en majuscules. String Exemples Exemple d’utilisation

Query

SELECT upper('clickhouse')

Response

┌─upper('clickhouse')─┐
│ CLICKHOUSE          │
└─────────────────────┘

upperUTF8

Introduit dans : v1.1.0 Convertit une chaîne en majuscules, en supposant qu’elle contient du texte encodé en UTF-8 valide. Si cette hypothèse n’est pas respectée, aucune exception n’est levée et le résultat est indéfini.

Cette fonction ne détecte pas la langue ; par exemple, pour le turc, le résultat peut ne pas être parfaitement correct (i/İ vs. i/I). Si la longueur de la séquence d’octets UTF-8 diffère entre la forme majuscule et la forme minuscule d’un point de code (comme ẞ et ß), le résultat peut être incorrect pour ce point de code.

Syntaxe

upperUTF8(s)

Arguments

s — Le type String. String

Valeur renvoyée Une valeur de type String. String Exemples Exemple d’utilisation

Query

SELECT upperUTF8('München') AS Upperutf8

Response

┌─Upperutf8─┐
│ MÜNCHEN   │
└───────────┘

​CRC32

​CRC32IEEE

​CRC64

​appendTrailingCharIfAbsent

​ascii

​base32Decode

​base32Encode

​base58Decode

​base58Encode

​base64Decode

​base64Encode

​base64URLDecode

​base64URLEncode

​basename

​byteHammingDistance

​caseFoldUTF8

​compareSubstrings

​concat

​concatAssumeInjective

​concatWithSeparator

​concatWithSeparatorAssumeInjective

​conv

​convertCharset

​damerauLevenshteinDistance

​decodeHTMLComponent

​decodeXMLComponent

​editDistance

​editDistanceUTF8

​encodeXMLComponent

​endsWith

​endsWithCaseInsensitive

​endsWithCaseInsensitiveUTF8

​endsWithUTF8

​extractTextFromHTML

​firstLine

​idnaDecode

​idnaEncode

​initcap

​initcapUTF8

​isValidASCII

​isValidUTF8

​jaroSimilarity

​jaroWinklerSimilarity

​left

​leftPad

​leftPadUTF8

​leftUTF8

​lengthUTF8

​lower

​lowerUTF8

​naturalSortKey

​normalizeUTF8NFC

​normalizeUTF8NFD

​normalizeUTF8NFKC

​normalizeUTF8NFKCCasefold

​normalizeUTF8NFKD

​punycodeDecode

​punycodeEncode

​regexpExtract

​regexpPosition

​removeDiacriticsUTF8

​repeat

​reverseUTF8

​right

​rightPad

​rightPadUTF8

​rightUTF8

​soundex

​space

​sparseGrams

​sparseGramsHashes

​sparseGramsHashesUTF8

​sparseGramsUTF8

​startsWith

​startsWithCaseInsensitive

​startsWithCaseInsensitiveUTF8

​startsWithUTF8

​stringBytesEntropy

​stringBytesUniq

​stringJaccardIndex

CRC32

CRC32IEEE

CRC64

appendTrailingCharIfAbsent

ascii

base32Decode

base32Encode

base58Decode

base58Encode

base64Decode

base64Encode

base64URLDecode

base64URLEncode

basename

byteHammingDistance

caseFoldUTF8

compareSubstrings

concat

concatAssumeInjective

concatWithSeparator

concatWithSeparatorAssumeInjective

conv

convertCharset

damerauLevenshteinDistance

decodeHTMLComponent

decodeXMLComponent

editDistance

editDistanceUTF8

encodeXMLComponent

endsWith

endsWithCaseInsensitive

endsWithCaseInsensitiveUTF8

endsWithUTF8

extractTextFromHTML

firstLine

idnaDecode

idnaEncode

initcap

initcapUTF8

isValidASCII

isValidUTF8

jaroSimilarity

jaroWinklerSimilarity

left

leftPad

leftPadUTF8

leftUTF8

lengthUTF8

lower

lowerUTF8

naturalSortKey

normalizeUTF8NFC

normalizeUTF8NFD

normalizeUTF8NFKC

normalizeUTF8NFKCCasefold

normalizeUTF8NFKD

punycodeDecode

punycodeEncode

regexpExtract

regexpPosition

removeDiacriticsUTF8

repeat

reverseUTF8

right

rightPad

rightPadUTF8

rightUTF8

soundex

space

sparseGrams

sparseGramsHashes

sparseGramsHashesUTF8

sparseGramsUTF8

startsWith

startsWithCaseInsensitive

startsWithCaseInsensitiveUTF8

startsWithUTF8

stringBytesEntropy

stringBytesUniq

stringJaccardIndex