Tous les produits
Search
Centre de documentation

Quick BI:Fonctions textuelles

Dernière mise à jour :Aug 09, 2026

Les fonctions textuelles traitent les chaînes de caractères dans l'analyse des données. Utilisez-les pour extraire des sous-chaînes, concaténer des chaînes et modifier la casse des caractères.

BI_CONCAT

BI_CONCAT fusionne plusieurs chaînes en une seule.

Syntaxe

BI_CONCAT(string1, string2, …)

Description des paramètres

string1, string2, ... : Les chaînes à fusionner.

Définition

Fusionne plusieurs chaînes en une seule.

Résultat

String

Exemple

BI_CONCAT('a', '-', 'b') = 'a-b'

BI_CONTAINS

BI_CONTAINS vérifie si une chaîne contient une sous-chaîne spécifiée.

Syntaxe

BI_CONTAINS(string, substring)

Description des paramètres

  • string : La chaîne d'entrée.

  • substring : La sous-chaîne à rechercher.

Définition

Renvoie « true » si la chaîne contient la sous-chaîne, sinon « false ».

Résultat

String

Exemple

BI_CONTAINS("Hello World", " ") = "true"

BI_ENDWITH

BI_ENDWITH vérifie si une chaîne se termine par une sous-chaîne spécifiée.

Syntaxe

BI_ENDWITH(string, substring)

Description des paramètres

  • string : La chaîne à vérifier.

  • substring : La sous-chaîne à rechercher.

Définition

Renvoie « true » si <string> se termine par <substring>, sinon « false ». Les espaces de fin sont ignorés.

Résultat

String

Exemple

BI_ENDWITH("Hello World", "World") = "true"

BI_FIND

BI_FIND renvoie la position d'une sous-chaîne.

Syntaxe

BI_FIND(substring, string, [start])

Description des paramètres

  • substring : La chaîne à rechercher.

  • string : La chaîne dans laquelle rechercher.

  • [start] : La position d'index à partir de laquelle commencer la recherche.

Définition

Renvoie la position de la sous-chaîne dans la chaîne, en commençant à partir de <start> (facultatif). Renvoie 0 si la sous-chaîne n'est pas trouvée. L'index de position commence à 1.

Résultat

Number

Exemple

BI_FIND('World', 'Hello World') =7

BI_FIND('Computer', 'Hello World') = 0

BI_LEFT

BI_LEFT renvoie un nombre spécifié de caractères depuis le début d'une chaîne.

Syntaxe

BI_LEFT(string, number)

Description des paramètres

  • string : La chaîne à partir de laquelle extraire les caractères.

  • number : Le nombre de caractères à renvoyer.

Définition

Renvoie les premiers <number> caractères de la chaîne.

Résultat

String

Exemple

BI_LEFT('Hello World', 5) = 'Hello'

BI_LEN

BI_LEN renvoie la longueur d'une chaîne.

Syntaxe

BI_LEN(string)

Description des paramètres

string : La chaîne d'entrée.

Définition

Renvoie la longueur de la chaîne.

Résultat

Number

Exemple

BI_LEN('Hello World') = 11

BI_LOWER

BI_LOWER convertit tous les caractères d'une chaîne en minuscules.

Syntaxe

BI_LOWER(string)

Description des paramètres

string : La chaîne à convertir en minuscules.

Définition

Renvoie <string> avec tous les caractères en minuscules.

Résultat

String

Exemple

BI_UPPER('Hello World') renvoie 'hello world'.

BI_LTRIM

BI_LTRIM supprime les espaces de début d'une chaîne.

Syntaxe

BI_LTRIM(string)

Description des paramètres

string : La chaîne d'entrée.

Définition

Supprime tous les espaces de début de <string>.

Résultat

String

Exemple

BI_LTRIM(' Hello World ') = 'Hello World '

Limites

Non pris en charge par les sources de données Lindorm (LindormTSDB).

BI_MID

BI_MID extrait une sous-chaîne à partir d'une position spécifiée.

Syntaxe

BI_MID(string, start, [length])

Description des paramètres

  • string : La chaîne à partir de laquelle extraire les caractères.

  • start : La position de départ (index basé sur 1).

  • [length] : Le nombre de caractères à renvoyer.

Définition

Renvoie une sous-chaîne de <string> commençant à <start> (index basé sur 1).

Si <length> est spécifié, renvoie uniquement ce nombre de caractères.

Résultat

String

Exemple

BI_MID('Hello World', 2) = 'ello World'

BI_MID('Hello World', 2, 4) ='ello'

Limites

Non pris en charge par les sources de données TiDB.

BI_REPLACE

BI_REPLACE remplace les caractères à une position spécifiée.

Syntaxe

BI_REPLACE(string, substring, replacement)

Description des paramètres

  • string : La chaîne source.

  • substring : La sous-chaîne spécifiée.

  • replacement : La chaîne de remplacement.

Définition

Remplace <substring> dans <string> par <replacement>. Renvoie la chaîne d'origine si <substring> n'est pas trouvé.

Résultat

String

Exemple

BI_REPLACE('Hello World', ' ', '-') = 'Hello-World'

BI_RIGHT

BI_RIGHT renvoie un nombre spécifié de caractères depuis la fin d'une chaîne.

Syntaxe

BI_RIGHT(string, number)

Description des paramètres

  • string : La chaîne à partir de laquelle extraire les caractères.

  • number : Le nombre de caractères à renvoyer.

Définition

Renvoie les derniers <number> caractères de la chaîne.

Résultat

String

Exemple

BI_RIGHT('Hello World', 5) = 'World'

BI_RTRIM

BI_RTRIM supprime les espaces de fin d'une chaîne.

Syntaxe

BI_RTRIM(string)

Description des paramètres

string : La chaîne d'entrée.

Définition

Supprime tous les espaces de fin de <string>.

Résultat

String

Exemple

BI_RTRIM(' Hello World ') = ' Hello World'

Limites

Non pris en charge par les sources de données Lindorm (LindormTSDB).

BI_SPLIT

BI_SPLIT divise une chaîne par un délimiteur et renvoie un jeton spécifié.

Syntaxe

BI_SPLIT(string, delimiter, token number)

Description des paramètres

  • string : La chaîne à diviser.

  • delimiter : Le séparateur.

  • token number : Le Nième jeton à renvoyer. Les nombres positifs comptent depuis la gauche (1 = premier). Les nombres négatifs comptent depuis la droite (-1 = dernier).

Définition

Divise <string> par le délimiteur et renvoie le jeton à la position spécifiée.

Résultat

String

Exemple

BI_SPLIT ('a-b-c-d', '-', 2) = 'b'

BI_SPLIT ('a|b|c|d', '|', -2) = 'c'

Limites

  • Non pris en charge par les sources de données SQL Server, Lindorm, Elasticsearch, IBM DB2 LUW ou SAP IQ (Sybase IQ).

  • Les nombres négatifs ne sont pas pris en charge pour les sources de données HANA.

BI_STARTWITH

BI_STARTWITH vérifie si une chaîne commence par une sous-chaîne spécifiée.

Syntaxe

BI_STARTWITH(string, substring)

Description des paramètres

  • string : La chaîne d'entrée.

  • substring : La sous-chaîne à rechercher.

Définition

Renvoie « true » si <string> commence par <substring>, sinon « false ». Les espaces de début sont ignorés.

Résultat

String

Exemple

BI_STARTWITH("Hello World", "Hello") = "true"

BI_TRIM

BI_TRIM supprime les espaces de début et de fin d'une chaîne.

Syntaxe

BI_TRIM(string)

Description des paramètres

string : La chaîne d'entrée.

Définition

Supprime tous les espaces de début et de fin de <string>.

Résultat

String

Exemple

BI_TRIM(' Hello World ') = 'Hello World'

BI_UPPER

BI_UPPER convertit tous les caractères d'une chaîne en majuscules.

Syntaxe

BI_UPPER(string)

Description des paramètres

string : La chaîne à convertir en majuscules.

Définition

Renvoie <string> avec tous les caractères en majuscules.

Résultat

String

Exemple

BI_UPPER('Hello World') = 'HELLO WORLD'