tencent cloud

Cloud Log Service

ドキュメントCloud Log Service操作ガイドデータ処理データ加工データ加工関数文字列処理関数

文字列処理関数

ダウンロード
フォーカスモード
フォントサイズ
最終更新日: 2026-10-12 15:02:21
AI翻訳

概要

文字列処理関数は、文字列の長さ計算、大文字小文字の変換、文字列の連結、置換、削除、文字位置の検索、プレフィックスとサフィックスのマッチングなどをサポートします。

str_exist関数

関数定義

値内の指定された範囲で部分文字列を検索し、TrueまたはFalseを返します。

構文記述

str_exist(文字列値, 部分文字列値, ignore_upper=False)

パラメータ説明

パラメータ名
パラメータ説明
パラメータタイプ
必須かどうか
パラメータのデフォルト値
パラメータの値の範囲
文字列の値
文字列の値
String
はい
-
-
部分文字列の値
部分文字列の値
String
はい
-
-
ignore_upper
大文字と小文字を区別するかどうか
Bool
いいえ
False
-

例

元のログ：
{"data": "cls nihao"}
加工ルール：
fields_set("result", str_exist(v(data), "nihao"))
加工結果：
{"result":"true","data":"cls nihao"}

str_existV2関数

関数定義

複数の部分文字列が存在するかどうかを判断し、1つでも存在する場合はTrueを返し、いずれも存在しない場合はFalseを返します。

構文記述

str_existV2(文字列値, 部分文字列値1,部分文字列値2,... ,ignore_upper=False)

パラメータ説明

パラメータ名
パラメータ説明
パラメータタイプ
必須かどうか
パラメータのデフォルト値
パラメータの値の範囲
文字列の値
文字列の値
String
はい
-
-
部分文字列の値1
部分文字列の値
String
はい
-
-
部分文字列の値2
部分文字列の値
String
はい
-
-
ignore_upper
大文字と小文字を区別するかどうか
Bool
いいえ
False
-

例

元のログ：
{"data": "cls nihao"}
加工ルール：
fields_set("result", str_existV2(v(data), "nihao","hello"))
加工結果：
{"result":"true","data":"cls nihao"}

str_count関数

関数定義

値内の指定された範囲で部分文字列を検索し、部分文字列が出現した回数を返します。

構文記述

str_count(値, sub="", start=0, end=-1)

パラメータ説明

パラメータ名
パラメータ説明
パラメータタイプ
必須かどうか
パラメータのデフォルト値
パラメータの値の範囲
data
文字列型の値
string
はい
-
-
sub
検索対象の部分文字列
string
はい
-
-
start
検索の開始位置
number
いいえ
デフォルトは0です。
-
end
検索の終了位置
number
いいえ
デフォルトは-1です。
-

例

元のログ：
{"data": "warn,error,error"}
加工ルール：
fields_set("result", str_count(v("data"), sub="err"))
加工結果：
{"result":"2","data":"warn,error,error"}

str_len関数

関数定義

文字列の長さを返します。

構文記述

str_len(値)

パラメータ説明

パラメータ名
パラメータ説明
パラメータタイプ
必須かどうか
パラメータのデフォルト値
パラメータの値の範囲
data
文字列型の値
string
はい
-
-

例

元のログ：
{"data": "warn,error,error"}
加工ルール：
fields_set("result", str_len(v("data")))
加工結果：
{"result":"16","data":"warn,error,error"}

str_uppercase関数

関数定義

大文字の文字列を返します。

構文記述

str_uppercase(値)

パラメータ説明

パラメータ名
パラメータ説明
パラメータタイプ
必須かどうか
パラメータのデフォルト値
パラメータの値の範囲
data
文字列型の値
string
はい
-
-

例

元のログ：
{"data": "warn,error,error"}
加工ルール：
fields_set("result", str_uppercase(v("data")))
加工結果：
{"result":"WARN,ERROR,ERROR","data":"warn,error,error"}

str_lowercase関数

関数定義

小文字の文字列を返します。

構文記述

str_lowercase(値)

パラメータ説明

パラメータ名
パラメータ説明
パラメータタイプ
必須かどうか
パラメータのデフォルト値
パラメータの値の範囲
data
文字列型の値
string
はい
-
-

例

元のログ：
{"data": "WARN,ERROR,ERROR"}
加工ルール：
fields_set("result", str_lowercase(v("data")))
加工結果：
{"result":"warn,error,error","data":"WARN,ERROR,ERROR"}

str_join関数

関数定義

連結文字列を使用して、複数の値を連結します。

構文記述

str_join(連結文字列1, 値1, 値2, ...)

パラメータ説明

パラメータ名
パラメータ説明
パラメータタイプ
必須かどうか
パラメータのデフォルト値
パラメータの値の範囲
join
文字列型の値
string
はい
-
-
値パラメータ、可変引数リスト
文字列型の値
string
はい
-
-

例

元のログ：
{"data": "WARN,ERROR,ERROR"}
加工ルール：
fields_set("result", str_join(",", v("data"), "INFO"))
加工結果：
{"result":"WARN,ERROR,ERROR,INFO","data":"WARN,ERROR,ERROR"}

str_replace関数

関数定義

文字列を置換し、置換結果の文字列を返します。

構文記述

str_replace(値, old="", new="", count=0)

パラメータ説明

パラメータ名
パラメータ説明
パラメータタイプ
必須かどうか
パラメータのデフォルト値
パラメータの値の範囲
data
文字列型の値
string
はい
-
-
old
置換対象の文字列
string
はい
-
-
new
置換対象の文字列
string
はい
-
-
count
最大置換回数。デフォルトではすべて置換します。
number
いいえ
デフォルトは0です。
-

例

フィールドdataの値の中の「WARN」を「ERROR」に置換してください。
元のログ：
{"data": "WARN,ERROR,ERROR"}
加工ルール：置換結果を新しいフィールド「result」に保存します。
fields_set("result", str_replace( v("data"), old="WARN", new="ERROR"))
加工結果：
{"result":"ERROR,ERROR,ERROR","data":"WARN,ERROR,ERROR"}

str_format関数

関数定義

文字列をフォーマットし、フォーマット結果を返します。

構文記述

str_format(フォーマット文字列, 値1, 値2, ...)

パラメータ説明

パラメータ名
パラメータ説明
パラメータタイプ
必須かどうか
パラメータのデフォルト値
パラメータの値の範囲
format
目標形式です。プレースホルダーには{}を使用します。例えば「The disk contains {0} files.」です。プレースホルダー{}内の数字は、後続のパラメータ値のインデックスに対応し、0から始まります。具体的な使用方法については、MessageFormat.format関数の使用を参照してください。
string
はい
-
-
値パラメータ、可変引数リスト
文字列型の値
string
はい
-
-

例

元のログ：
{"status": 200, "message":"OK"}
加工ルール：
fields_set("result", str_format("status:{0}, message:{1}", v("status"), v("message")))
加工結果：
{"result":"status:200, message:OK","message":"OK","status":"200"}

str_strip関数

関数定義

文字列の先頭と末尾にある指定文字を削除します。

構文記述

str_strip(値, chars="\\t\\r\\n")

パラメータ説明

パラメータ名
パラメータ説明
パラメータタイプ
必須かどうか
パラメータのデフォルト値
パラメータの値の範囲
data
文字列型の値
string
はい
-
-
chars
削除される文字列
string
いいえ
\\t\\r\\n
-

例

例1
元のログ：
{"data": " abc  "}
加工ルール：
fields_set("result", str_strip(v("data"), chars=" "))
加工結果：
{"result":"abc","data":" abc  "}
例2
元のログ：
{"data": " **abc**  "}
加工ルール：
fields_set("result", str_strip(v("data"), chars=" *"))
加工結果：
{"result":"abc","data":" **abc**  "}

str_lstrip関数

関数定義

文字列の先頭にある指定文字を削除します。

構文記述

str_strip(値, chars="\\t\\r\\n")

パラメータ説明

パラメータ名
パラメータ説明
パラメータタイプ
必須かどうか
パラメータのデフォルト値
パラメータの値の範囲
data
文字列型の値
string
はい
-
-
chars
削除される文字列
string
いいえ
\\t\\r\\n
-

例

元のログ：
{"data": " abc  "}
加工ルール：
fields_set("result", str_lstrip(v("data"), chars=" "))
加工結果：
{"result":"abc  ","data":" abc  "}

str_rstrip関数

関数定義

文字列の末尾にある指定文字を削除します。

構文記述

str_strip(値, chars="\\t\\r\\n")

パラメータ説明

パラメータ名
パラメータ説明
パラメータタイプ
必須かどうか
パラメータのデフォルト値
パラメータの値の範囲
data
文字列型の値
string
はい
-
-
chars
削除される文字列
string
いいえ
\\t\\r\\n
-

例

元のログ：
{"data": " abc  "}
加工ルール：
fields_set("result", str_rstrip(v("data"), chars=" "))
加工結果：
{"result":" abc","data":" abc  "}

str_find関数

関数定義

値内で部分文字列を検索し、部分文字列が出現した位置を返します。

構文記述

str_find(値, sub="", start=0, end=-1)

パラメータ説明

パラメータ名
パラメータ説明
パラメータタイプ
必須かどうか
パラメータのデフォルト値
パラメータの値の範囲
data
文字列型の値
string
はい
-
-
sub
検索する部分文字列
string
はい
-
-
start
検索の開始位置
number
いいえ
デフォルトは0です。
-
end
検索の終了位置
number
いいえ
デフォルトは-1です。
-

例

元のログ：
{"data": "warn,error,error"}
加工ルール：
fields_set("result", str_find(v("data"), sub="err"))
加工結果：
{"result":"5","data":"warn,error,error"}

str_start_with関数

関数定義

文字列が指定されたプレフィックスで始まるかどうかを判断します。

構文記述

str_start_with(値, sub="", start=0, end=-1)

パラメータ説明

パラメータ名
パラメータ説明
パラメータタイプ
必須かどうか
パラメータのデフォルト値
パラメータの値の範囲
data
文字列型の値
string
はい
-
-
sub
プレフィックス文字列
string
はい
-
-
start
検索の開始位置
number
いいえ
デフォルトは0です。
-
end
検索の終了位置
number
いいえ
デフォルトは-1です。
-

例

例1
元のログ：
{"data": "something"}
加工ルール：
fields_set("result", str_start_with(v("data"), sub="some"))
加工結果：
{"result":"true","data":"something"}
例2
元のログ：
{"data": "something"}
加工ルール：
fields_set("result", str_start_with(v("data"), sub="*"))
加工結果：
{"result":"false","data":"something"}

str_end_with関数

関数定義

文字列が指定されたサフィックスで終わるかどうかを判断します。

構文記述

str_end_with(値, sub="", start=0, end=-1)

パラメータ説明

パラメータ名
パラメータ説明
パラメータタイプ
必須かどうか
パラメータのデフォルト値
パラメータの値の範囲
data
文字列型の値
string
はい
-
-
sub
サフィックス文字列
string
はい
-
-
start
検索の開始位置
number
いいえ
デフォルトは0です。
-
end
検索の終了位置
number
いいえ
デフォルトは-1です。
-

例

元のログ：
{"data": "endwith something"}
加工ルール：
fields_set("result", str_end_with(v("data"), sub="ing"))
加工結果：
{"result":"true","data":"endwith something"}

前の記事へ: 時間値処理関数次の記事へ: 型変換関数

ヘルプとサポート

この記事はお役に立ちましたか？

フィードバック

キーワードで検索
    Enter keywords to search documentation