すべてのプロダクト
Search

このプロダクト

    Quick BI:テキスト関数

    ドキュメントセンター

    Quick BI:テキスト関数

    最終更新日:Feb 10, 2026

    テキスト関数は、データ分析で文字列を処理するために使用される関数クラスです。部分文字列の抽出、文字列の連結、文字の大文字/小文字の変更が可能です。この Topic では、組み込みテキスト関数の使用方法について説明します。

    BI_CONCAT

    BI_CONCAT は、複数の文字列を 1 つの文字列にマージします。

    構文

    BI_CONCAT(string1, string2, …)

    パラメーターの説明

    string1, string2, ...：マージする文字列。

    定義

    複数の文字列を 1 つの文字列にマージします。

    出力

    文字列

    例

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

    BI_CONTAINS

    BI_CONTAINS は、文字列に指定された部分文字列が含まれているかどうかをチェックします。

    構文

    BI_CONTAINS(string, substring)

    パラメーターの説明

    • string：指定された文字列。

    • substring：検索する部分文字列。

    定義

    文字列に部分文字列が含まれている場合は "true" を返し、含まれていない場合は "false" を返します。

    出力

    文字列

    例

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

    BI_ENDWITH

    BI_ENDWITH は、文字列が指定された部分文字列で終わるかどうかをチェックします。

    構文

    BI_ENDWITH(string, substring)

    パラメーターの説明

    • string：チェックする文字列。

    • substring：検索する部分文字列。

    定義

    <string> が <substring> で終わる場合は "true" を返します。それ以外の場合は "false" を返します。末尾のスペースは無視されます。

    出力

    文字列

    例

    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 '

    制限事項

    Lindorm (LindormTSDB) データソースではサポートされていません。

    BI_MID

    BI_MID は、指定された位置から始まる、文字列からの特定の数の文字を返します。

    構文

    BI_MID(string, start, [length])

    パラメーターの説明

    • string：文字を抽出する文字列。

    • start：文字抽出の開始位置。文字列の最初の文字の位置は 1 です。

    • [length]：返す文字数。

    定義

    指定された <start> 位置から始まる <string> から部分文字列を返します。文字列の最初の文字の位置は 1 です。

    オプションの <length> パラメーターが含まれている場合、返される文字列にはその文字数のみが含まれます。

    出力

    文字列

    例

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

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

    制限事項

    TiDB データソースではサポートされていません。

    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'

    制限事項

    Lindorm (LindormTSDB) データソースではサポートされていません。

    BI_SPLIT

    BI_SPLIT はフィールドを分割します。

    構文

    BI_SPLIT(string, delimiter, token number)

    パラメーターの説明

    • string：分割する文字列。

    • delimiter：区切り文字。

    • token number：返す N 番目のトークン。正の数は左から数えます (例：1 は左から最初のトークンです)。負の数は右から数えます (例：-1 は右から最初のトークンです)。

    定義

    デリミタを使用して <string> を複数の部分文字列に分割し、そのうちの 1 つを返します。

    出力

    文字列

    例

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

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

    制限事項

    • SQL Server、Lindorm、Elasticsearch、IBM DB2 LUW、または SAP IQ (Sybase IQ) データソースではサポートされていません。

    • HANA データソースでは負の数はサポートされていません。

    BI_STARTWITH

    BI_STARTWITH は、文字列が指定された部分文字列で始まるかどうかをチェックします。

    構文

    BI_STARTWITH(string, substring)

    パラメーターの説明

    • string：ユーザーが指定した文字列。

    • substring：検索する部分文字列。

    定義

    <string> が <substring> で始まる場合は "true" を返します。それ以外の場合は "false" を返します。先頭のスペースは無視されます。

    出力

    文字列

    例

    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'