全部產品
Search
文件中心

Quick BI:文本函數

更新時間:Mar 13, 2025

文本函數是資料分析中用於處理文本字串的一類函數。它們可以協助您提取子串、拼接字串、轉換大小寫等。本文為您介紹系統內建函數中文本函數的使用方法。

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'