文本函数

文本函数是数据分析中用于处理文本字符串的一类函数。它们可以帮助您提取子串、拼接字符串、转换大小写等。本文为您介绍系统内置函数中文本函数的使用方法。

BI_CONCAT

BI_CONCAT用于将多个字符串合并成一个字符串。

语法

BI_CONCAT(string1, string2, …)

参数说明

string1, string2, ...:需要合并成一个字符串的多个字符串。

定义

将多个字符串合并成一个字符串。

输出

字符串

示例

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

BI_CONTAINS

BI_CONTAINS用于判断给定字符串是否包含指定子字符串。

语法

BI_CONTAINS(string, substring)

参数说明

  • string:给定字符串。

  • substring:指定子字符串。

定义

如果给定字符串包含指定子字符串,则返回 true。

输出

布尔值

示例

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

BI_ENDWITH

BI_ENDWITH用于判断给定字符串是否以指定子字符串结尾。

语法

BI_ENDWITH(string, substring)

参数说明

  • string:给定字符串。

  • substring:指定子字符串。

定义

如果<string>以<substring>结尾,则返回 true。会忽略尾随空格。

输出

布尔值

示例

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

BI_FIND

BI_FIND用于返回字符所在位置。

语法

BI_FIND(substring, string, [start])

参数说明

  • substring:需要查找的字符串。

  • string:被查找的字符串。

  • [start]:指定进行查找字符的索引位置。

定义

返回子字符串在字符串中的索引位置,从指定的索引<start>开始查找(<start>可不填)。如果未找到子字符串,则返回 0。字符串中第一个字符的位置为 1。

输出

数值

示例

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

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

BI_LEFT

BI_LEFT用于根据指定的字符数返回字符串中的前几个字符。

语法

BI_LEFT(string, number)

参数说明

  • string:待选取字符的字符串。

  • number:指定返回的字符串长度。

定义

返回字符串最左侧一定 <number> 的字符。

输出

字符串

示例

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

BI_LEN

BI_LEN用于返回字符串长度。

语法

BI_LEN(string)

参数说明

string:待返回字符串长度的字符串。

定义

返回字符串长度。

输出

数值

示例

BI_LEN('Hello World') = 11

BI_LOWER

BI_LOWER用于将字符串中所有的字符转化为小写。

语法

BI_LOWER(string)

参数说明

string:需要全部转化为小写的字符串。

定义

以全小写字符返回 <string>。

输出

字符串

示例

BI_UPPER('Hello World') =  'hello world'

BI_LTRIM

BI_LTRIM用于移除字符串的前置空格。

语法

BI_LTRIM(string)

参数说明

string:待移除前置空格的字符串。

定义

移除 <string> 的所有前置空格。

输出

字符串

示例

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

BI_MID

BI_MID用于返回指定位置字符串。

语法

BI_MID(string, start, [length])

参数说明

  • string:待选取字符的字符串。

  • start:文本中需要提取字符的起始位置。字符串中第一个字符的位置为 1。

  • [length]:指定返回的字符串长度。

定义

返回<string>从指定<start>位置处开始的字符串。字符串中第一个字符的位置为 1。

如果添加了可选数字参数<length>,则返回的字符串仅包含该数量的字符。

输出

字符串

示例

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

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

BI_REPLACE

BI_REPLACE用于替换指定位置字符。

语法

BI_REPLACE(string, substring, replacement)

参数说明

  • string:需要被替换部分字符的字符串。

  • substring:指定的字符串。

  • replacement:用来替换部分字符的新字符。

定义

在 <string> 中搜索 <substring> 并将其替换为 <replacement>。如果未找到 <substring>,则字符串保持不变。

输出

字符串

示例

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

BI_RIGHT

BI_RIGHT用于根据指定的字符数返回字符串中的最后几个字符。

语法

BI_RIGHT(string, number)

参数说明

  • string:待选取字符的字符串。

  • number:指定返回的字符串长度。

定义

返回字符串最右侧一定 <number> 的字符。

输出

字符串

示例

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

BI_RTRIM

BI_RTRIM用于移除字符串的尾随空格。

语法

BI_RTRIM(string)

参数说明

string:待移除尾随空格的字符串。

定义

移除 <string> 的所有尾随空格。

输出

字符串

示例

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

BI_SPLIT

BI_SPLIT用于分隔字段。

语法

BI_SPLIT(string, delimiter, token number)

参数说明

  • string:待分隔的字符串。

  • delimiter:分隔符。

  • token number:返回第N个字符,正数为从左往右数(例如1为左边第1个),负数从右往左数(例如-1为右边第1个)。

定义

使用分隔符将<string>分为多个子字符串,并返回其中一个。

输出

字符串

示例

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

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

使用限制

SQL Server数据源不支持。

BI_STARTWITH

BI_STARTWITH用于判断给定字符串是否以指定子字符串开头。

语法

BI_STARTWITH(string, substring)

参数说明

  • string:给定字符串。

  • substring:指定子字符串。

定义

如果<string>以<substring>开头,则返回 true。会忽略前置空格。

输出

布尔值

示例

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

BI_TRIM

BI_TRIM用于移除字符串的首尾空格。

语法

BI_TRIM(string)

参数说明

string:待移除首尾空格的字符串。

定义

移除 <string> 的所有前置空格和尾随空格。

输出

字符串

示例

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

BI_UPPER

BI_UPPER用于将字符串中所有的字符转化为大写。

语法

BI_UPPER(string)

参数说明

string:需要全部转化为大写的字符串。

定义

以全大写字符返回 <string>。

输出

字符串

示例

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