tencent cloud

Cloud Log Service

ドキュメントCloud Log Service操作ガイドログトピックの検索分析統計分析（SQL）SQL関数関数概要

関数概要

ダウンロード
フォーカスモード
フォントサイズ
最終更新日: 2026-10-12 14:32:15
AI翻訳
本ドキュメントでは、CLSがサポートする各種SQL関数、演算子および式を列挙します。

汎用集計関数

関数名
説明
目标列から非NULLの値をランダムに返します。
KEYの算術平均を計算します。
目标列のすべての値のビット単位AND演算の結果を返します。
目标列のすべての値のビット単位OR演算の結果を返します。
すべてのログが指定された条件を満たすかどうかを判定し、満たす場合は TRUE を返し、それ以外の場合は FALSE を返します。
任意のログが指定された条件を満たすかどうかを判定し、満たす場合は TRUE を返し、それ以外の場合は FALSE を返します。
目标列のチェックサム値を計算し、結果としてバイナリ文字列を返します。
すべての行数をカウントします。
COUNT(1)はCOUNT(*)と同等であり、すべての行数を表します。
KEY列が非NULLの行数をカウントします。
指定された条件を満たす行数をカウントします。
すべてのログが指定された条件を満たすかどうかを判定し、満たす場合は TRUE を返し、それ以外の場合は FALSE を返します。
KEYの幾何平均を計算します。KEYに負数が含まれる場合は結果がNaNになります。
KEY内の最大値をクエリします。
yが最大値の場合に対応するx値を返します。
最大の n 個の y 値に対応する x 値を返し、戻り値は JSON 配列です。
KEY内の最小値をクエリします。
yが最小値の場合に対応するx値を返します。
最小の n 個の y 値に対応する x 値を返します。戻り値は JSON 配列です。
KEYの合計を計算します。
各入力値の出現回数をカウントしたマップを返します。
入力された key / value ペアから作成されたマップを返します。
すべての入力マップの和集合を返します。あるキーが複数の入力マップに出現する場合、結果マップにおけるそのキーの値は任意の1つの入力マップから取得されます。
入力された key / value ペアから作成された多重マップを返します。各キーは複数の値に関連付けることができます。

論理演算子

関数名
説明
左右のオペランドが両方とも TRUE の場合のみ、結果は TRUE になります。
左右のオペランドのいずれかが TRUE の場合、結果は TRUE になります。
右側のオペランドが FALSE の場合のみ、結果は TRUE になります。

算術演算子および比較演算子

関数名
説明
加算：演算子の両側の値を加算します。
減算：演算子の左側から演算子の右側を引きます。
乗算：演算子の両側の値を掛け合わせます。
除算：演算子の左側を演算子の右側で割ります。
取模：演算子の左側を演算子の右側で割った後に得られる余りです。
演算子の両側の値が等しいかどうかを判断し、等しい場合は条件が真になります。
演算子の両側の値が等しいかどうかを判断し、等しくない場合は条件が真になります。
演算子の両側の値が等しいかどうかを判断し、等しくない場合は条件が真になります。
演算子の左側の値が演算子の右側の値より大きいかどうかを判断し、大きい場合は条件が真になります。
演算子の左側の値が演算子の右側の値より小さいかどうかを判断し、小さい場合は条件が真になります。
演算子の左側の値が演算子の右側の値以上かどうかを判断し、そうである場合は条件が真になります。
演算子の左側の値が演算子の右側の値以下かどうかを判断し、そうである場合は条件が真になります。
IN 演算子は、ある値を一連の指定リストの値と比較するために使用されます。
IN 演算子の反対で、ある値を一連の指定リストに含まれない値と比較するために使用されます。
BETWEEN 演算子は、指定された最小値と最大値の範囲内にある一連の値から値を検索するために使用されます。
LIKE 演算子は、ある値をワイルドカード演算子を使用した類似値と比較するために使用されます。% はゼロ個、1 個、または複数の文字を表します。_ は 1 つの数字または文字を表します。
NULL 演算子は、ある値を NULL 値と比較するために使用されます。NULL の場合は真になります。
NULL 演算子は、ある値を NULL 値と比較するために使用されます。NULL でない場合は真になります。
x と y が等しいかどうかを比較します。
x、y...の中の最小値を返します。
x、y...の中の最大値を返します。
x がすべての条件を満たす場合、true を返します。
x がいずれかの条件を満たす場合、true を返します。

推定関数

関数名
説明
KEY列の一意な値の個数を推定し、推定結果の標準誤差は2.3%です。
KEY列を昇順にソートし、percentageの位置にほぼ該当する値を返します。KEYは数値型フィールドである必要があり、percentageの値の範囲は[0,1]です。

前年比・前期比関数

関数名
説明
現在の時間周期内におけるxの値と、n秒前の時間周期内の値とを比較します。
現在の時間周期内におけるxの値と、n1秒、n2秒、n3秒前の時間周期内の値とを比較します。
現在の時間周期内におけるxの時間経過に伴う変化傾向と、n秒前の時間周期内の変化傾向とを比較します。timeはxの変化傾向に対応する時間列です。
現在の時間周期内におけるxの時間経過に伴う変化傾向と、n1秒、n2秒、n3秒前の時間周期内の変化傾向とを比較します。timeはxの変化傾向に対応する時間列です。

文字列関数

関数名
説明
入力パラメータで指定されたASCIIコード位置に対応する文字を返します。
ASCIIコード形式のフィールド値をBigInt型に変換します。
複数の文字列KEY1、KEY2、KEY3、...、KEYNを1つの文字列に連結します。これは||連結子と同じ効果です。
注意：任意の文字列が null の場合、返却結果は null です。null をスキップする必要がある場合は、concat_ws を使用できます。
split_stringを区切り文字として文字列KEY1、KEY2、KEY3、...、KEYNを連結し、KEY1、...、KEYN内のnull値をスキップします。
split_stringを区切り文字として、配列内の要素を1つの文字列に連結します。split_stringがnullの場合、結果はnullとなり、配列内のnull値はスキップされます。戻り値はvarchar型です。
注意：この関数では、array(varchar)パラメータは配列であり、文字列ではありません。
フォーマットformatを使用してパラメータargsをフォーマット出力します。
バイナリ文字列をUTF-8形式の文字列に変換します。不正なUTF-8文字はU+FFFDに置き換えられます。
バイナリ文字列をUTF-8形式の文字列に変換します。不正なUTF-8文字はreplaceに置き換えられます。
KEY1文字列とKEY2文字列のハミング距離を返します。注意：2つの文字列の長さは一致している必要があります。
文字列KEYの長さを計算します。
KEY1文字列とKEY2文字列の編集距離を返します。
文字列KEYを小文字に変換します。
padstringを使用して文字列KEYを左側にsizeの長さまで埋めます。sizeがKEYの長さより小さい場合、文字列をsizeの長さに切り詰めます。sizeは非負である必要があり、padstringは空であってはなりません。
文字列KEYの左側にある空白文字を削除します。
stringをNFC標準形式に変換します。
stringをform形式に変換します。この関数のformパラメータには、文字列ではなくキーワード（NFD、NFC、NFKD、NFKC）を使用する必要があります。
substringが文字列KEY内で最初に出現する位置を返します。位置は1から始まります。見つからない場合は0を返します。
文字列KEYからすべてのsubstring文字列を削除します。
文字列KEY内のすべてのsubstringをreplaceに置き換えます。
文字列KEYを反転します。
padstringを使用して文字列KEYを右側にsizeの長さまで埋めます。sizeがKEYの長さより小さい場合、文字列をsizeの長さに切り詰めます。sizeは非負である必要があり、padstringは空であってはなりません。
文字列KEYの右側にある空白文字を削除します。
指定された区切り文字delimiterを使用して文字列KEYを分割し、配列を返します。
指定された区切り文字delimiterを使用して文字列KEYを分割し、配列を返します。配列の長さは最大でlimitです。配列の最後の要素は常にkey内の残りすべての部分です。limitは正の数である必要があります。
指定された区切り文字delimiterを使用して文字列KEYを分割し、配列内のindex番目の文字列を返します。indexは1から始まります。indexが配列の長さより大きい場合はnullを返します。
substringが文字列KEY内で最初に出現する位置を返します。位置は1から始まります。見つからない場合は0を返します。
substringで分割された文字列KEY内のinstance番目のインスタンスのstring内での位置を返します。instanceが負の数の場合、末尾から数えます。位置は1から始まり、見つからない場合は0を返します。
文字列内のstart位置から始まる残りすべての文字を返します。位置は1から数えます。startが負の数の場合、末尾から数えます。
文字列内のstart位置から始まる最大length文字数の部分文字列を返します。位置は1から数えます。startが負の数の場合、末尾から数えます。
stringをUTF-8形式のバイナリ文字列varbinaryに変換します。
KEY内でfromに含まれる文字をすべて、to内の対応する位置の文字に置き換えます。fromに重複する文字が含まれる場合、最初の文字のみが有効です。KEYにfromの文字が含まれない場合、KEYはそのままコピーされます。fromの長さがtoの長さを超える場合、対応する文字は削除されます。
文字列の前後にある空白文字を削除します。
文字列KEYを大文字に変換します。
wordの英語の語根を返します。
wordのlang言語における語根を返します。

日付と時間関数

関数名
説明
現在の日付を返します。例えば、2022-12-28です。
現在の時刻を返します。例えば、17:08:18です。
現在の時刻のタイムスタンプ（Unix形式以外）を返します。例えば、2022-12-28T17:09:05.655+08:00[Asia/Shanghai]です。
現在のタイムゾーンを返します。例えば、Asia/Shanghaiです。
timestampにvalue個の時間単位（unit）を加算します。valueが負の場合は減算となります。unitはmillisecond、second、minute、hour、day、week、month、quarter、yearをサポートします。
2つのtimestamp間の時間差を返します。unitはmillisecond、second、minute、hour、day、week、month、quarter、yearをサポートします。
TIMESTAMP型の日時をformat形式の文字列に変換します。formatの説明は関数の詳細説明を参照してください。
format形式の日時文字列stringをTIMESTAMP型に変換します。formatの説明は関数の詳細説明を参照してください。
timestampをunit単位で切り捨てます。この関数は時間に基づく統計分析が必要な場面でよく使用されます。unitはunit、second、minute、hour、day、week、month、quarter、yearをサポートします。
timestampから指定された時間部分（field）を抽出します。fieldは以下の値をサポートします：year、quarter、month、week、day、day_of_month、day_of_week、dow、day_of_year、doy、year_of_week、yow、hour、minute、second。
ISO8601形式の日付文字列をDATE型の日付式に変換します。
ISO8601形式の日時文字列をタイムゾーン付きTIMESTAMP型の日時式に変換します。
UnixタイムスタンプをTIMESTAMP型の日時式に変換します。
Unixタイムスタンプをタイムゾーン付きTIMESTAMP型の日時式に変換します。
時間列time_columnを時間間隔intervalで複数のグループに分割し、そのグループに基づいてログを集計します。time_columnはミリ秒のLONG型UNIXタイムスタンプまたはTIMESTAMP型の日時式である必要があります。intervalは単位としてSECOND（秒）、MINUTE（分）、HOUR（時間）、DAY（日）をサポートします。
秒を読みやすい時間間隔の文字列に変換します。例：1 minute、36 seconds。
timestampが属する月の最終日を返します。
ローカル時間を返します。
ローカルの日付と時刻を返します。
現在の時刻のタイムスタンプ（Unix形式以外）を返します。current_timestamp関数と同じ用法です。例えば、2022-12-28T17:09:05.655+08:00[Asia/Shanghai]です。
文字列stringを時間間隔式に変換します。
時間列time_columnを時間間隔intervalで複数のグループに分割し、そのグループに基づいてログを集計します。クエリ時間枠内の欠落データの補完をサポートします。time_columnはミリ秒のLONG型UNIXタイムスタンプまたはTIMESTAMP型の日時式である必要があります。intervalは単位としてs（秒）、m（分）、h（時間）、d（日）をサポートします。formatは時間形式で、'%Y-%m-%dT%H:%i:%s+08:00'の使用を推奨します。paddingはデータ補完方式です。詳細は関数の詳細説明を参照してください。
TIMESTAMPが属するタイムゾーンの時間オフセットを返します。
TIMESTAMPが属するタイムゾーンの分オフセットを返します。
DATE型またはTIMESTAMP型の日時式をISO8601形式の日時文字列に変換します。
ミリ秒単位で間隔の時間値を返します。
TIMESTAMP型の日時式をUnixタイムスタンプに変換します。

IP関数

関数名
説明
IPアドレスのバージョンを取得します。戻り値はIPv4またはIPv6です。
対象IPアドレスのプレフィックスを取得します。戻り値はサブネットマスク形式のIPアドレスです。
IP網セグメント内の最大IPアドレスを取得します。戻り値はIPアドレスです。
IP網セグメント内の最小IPアドレスを取得します。戻り値はIPアドレスです。
IP網セグメントの範囲を取得します。戻り値はArray型のIPアドレスです。
対象IPアドレスが属する都市を分析します。
対象IPアドレスが属する都市のコードを分析します。戻り値は都市の行政区画コードです。中国台湾および海外の都市は現在サポートされていません。
対象IPアドレスが属する都市の経緯度を分析します。戻り値は都市の経緯度です。中国台湾および海外の都市は現在サポートされていません。
対象IPアドレスが属する国または地域を分析します。
対象IPアドレスが属する国または地域のコードを分析します。
対象IPアドレスが属する国または地域の経緯度を分析します。
対象IPアドレスがイントラネットアドレスかインターネットアドレスかを判断します。イントラネットの場合はintranet、インターネットの場合はinternet、不正なIPアドレスの場合はinvalidを返します。
対象IPアドレスに対応するネットワーク事業者を分析します。
対象IPアドレスが属する省を分析します。
対象IPアドレスが属する省のコードを分析します。
対象IPアドレスが属する省の経緯度を分析します。
対象ネットワークセグメントが特定のネットワークセグメントのサブネットかどうかを判断します。
対象IPアドレスが特定のネットワークセグメント内にあるかどうかを判断します。
Tencentセキュリティ脅威インテリジェンスセンターのセキュリティ脅威情報に基づき、指定されたIPが悪意のあるIPかどうかを判断します。
不審なIPおよび悪意のあるIPの脅威Tagは、そのIPに存在する具体的な悪意のある行為を示し、返される結果は配列です。
IP脅威検出の詳細です。返される結果はJSON形式です。

URL関数

関数名
説明
URL をデコードします。
KEY に対して URL エスケープエンコードを行います。
URL から fragment を抽出します。
URL から host を抽出します。
URL から query に対応するパラメータ値を抽出します。
URL から path を抽出します。
URL からポートを抽出します。
URL からプロトコルを抽出します。
URL から query を抽出します。

JSON関数

関数名
説明
JSON 配列に特定の値が含まれているかどうかを判断します。
JSON 配列内の特定のインデックスに対応する要素を取得します。
JSON 配列内の要素数を計算します。x が JSON 配列ではない場合、null を返します。
json_path を使用して、JSON オブジェクトまたは JSON 配列から JSON 値のセット（配列またはオブジェクト）を抽出します。配列要素を走査する必要がある json_path 構文（例：$.store.book[*].author）はサポートされていません。
json_path を使用して、JSON オブジェクトまたは JSON 配列からスカラー値のセット（文字列、整数、またはブール値）を抽出します。配列要素を走査する必要がある json_path 構文（例：$.store.book[*].author）はサポートされていません。
JSON 型を文字列型に変換します。
文字列型を JSON 型に変換し、JSON 形式に準拠しているかどうかを判断します。
JSON オブジェクトまたは JSON 配列内の要素数を計算します。

MAP関数

関数名
説明
map から指定されたキーに対応する値を取得します。
map の基数（サイズ）を返します。
指定されたキーに対応する値を返します。キーが存在しない場合は NULL を返します。
空のマップを返すか、指定されたキー/値の配列を使用してマップを作成します。
指定されたエントリの配列からマップを作成します。
指定されたエントリの配列から multimap を作成します。各キーには複数の値を関連付けることができます。
指定されたすべての map の和集合を返します。
map から関数が true を返すエントリを抽出して新しい map を構築します。
map 内のすべてのキーを返します。
map 内のすべての値を返します。
2 つの map を 1 つに結合し、同じキーに対応する値のペアに関数を適用します。
map の各エントリに関数を適用し、キーを変換します。
map の各エントリに関数を適用し、値を変換します。

正規表現関数

関数名
説明
対象文字列KEYから正規表現に一致する最初の部分文字列を抽出して返します。
対象文字列KEYから正規表現に一致する部分文字列を抽出し、ターゲットキャプチャグループに一致する最初の部分文字列を返します。nはn番目のキャプチャグループを表し、nは1から始まる整数です。
対象文字列KEYから正規表現に一致する部分文字列を抽出し、すべての部分文字列の集合を返します。
対象文字列KEYから正規表現に一致する部分文字列を抽出し、ターゲットキャプチャグループに一致する部分文字列の集合を返します。nはn番目のキャプチャグループを表し、nは1から始まる整数です。
対象文字列KEYが正規表現に一致するかどうかを判断します。
対象文字列KEY内の正規表現に一致する部分文字列を置換し、置換後の文字列を返します。
対象文字列KEY内の正規表現に一致する部分文字列を削除します。
正規表現を使用して対象文字列を分割し、分割後の部分文字列の集合を返します。

配列関数

関数名
説明
KEY内のすべての値を配列形式で返します。
配列内の重複要素を削除し、一意な値のみを保持します。
2つの配列の差集合を計算します。
2つの配列の交差集合を計算します。
指定された区切り文字delimiterを使用して、配列内の要素を1つの文字列に連結します。配列にnull要素が含まれている場合、null要素は無視されます。
指定された区切り文字を使用して、配列内の要素を1つの文字列に連結します。配列にnull要素が含まれている場合、null要素はnull_replacementに置き換えられます。
配列内の最大値を取得します。
配列内の最小値を取得します。
指定された要素のインデックスを取得します。インデックスは1から始まります。指定された要素が存在しない場合は、0を返します。
配列内の指定された要素を削除します。
配列の要素を昇順に並べ替えます。
2つの配列の和集合を計算します。
配列内の要素数を計算します。
配列に指定された要素が含まれているかどうかを判断します。含まれている場合は、trueを返します。
配列内のy番目の要素を返します。yは1から始まります。
Lambda式と組み合わせて、配列内の要素をフィルタリングします。Lambda式の条件を満たす要素のみを返します。
2次元配列を1次元配列に変換します。
Lambda式の定義に従って、配列内の各要素に対して加算計算を行い、計算結果を返します。
指定された開始値xから配列を返します。その要素はx～y内の連続的かつ増加する値のセットです。
指定された開始値xから配列を返します。その要素はx～y内の連続的かつ増加する値のセットです（間隔はstep）。
配列要素をランダムに並べ替えます。
配列xのサブセットを返します。startはインデックスの開始位置を指定し、lengthはサブセット内の要素数を指定します。
Lambda式を配列の各要素に適用します。
複数の配列を1つの2次元配列に結合し、各配列内の同じインデックスを持つ要素が新しい配列を構成します。
Lambda式の定義に従って、2つの配列を1つの配列に結合します。

型変換関数

関数名
説明
フィールドKEYのデータ型を変換する際、値の変換に失敗した場合、クエリ全体が終了します。失敗をスキップするには、try_castを使用してください。typeに指定できる値は、bigint、varchar、double、boolean、timestamp、decimal、array、mapです。
フィールドKEYのデータ型を変換します。値の変換に失敗した場合、その値はnullを返し、その値をスキップして処理を続行します。typeに指定できる値は、bigint、varchar、double、boolean、timestamp、decimal、array、mapです。
xのデータ型を返します。

条件式

関数名
説明
条件判断によってデータを分類します。
複数の式から最初の非 NULL 値を取得します。
condition が true の場合、result1 を返します。それ以外の場合は null を返します。
condition が true の場合、result1 を返します。それ以外の場合は result2 を返します。
2つの式の値が等しいかどうかを比較します。等しい場合は null を返し、それ以外の場合は最初の式の値を返します。
例外情報をキャプチャし、システムがクエリと分析操作を継続して実行できるようにします。

数学計算関数

関数名
説明
数値の絶対値を計算します。
数値の逆余弦を計算します。
数値の逆正弦を計算します。
数値の逆正接を計算します。
2つの数値の除算結果の逆正接を計算します。
数値の立方根を計算します。
数値を切り上げて整数にします。
数値の余弦を計算します。
数値の双曲余弦を計算します。
ベクトルxとyの間のコサイン類似度を計算します。
ラジアンを度に変換します。
数値の自然対数を計算します。
自然対数の指数を返します。
数値を切り捨てて整数にします。
BASEエンコードに基づいて文字列stringをradix進数の数値に変換します。
正の無限大の数値を返します。
対象値KEYがNaN（Not a Number）であるかどうかを判断します。
数値の自然対数を計算します。
bを底とする対数を計算します。
10を底とする対数を計算します。
2を底とする対数を計算します。
xとyの除算の余りを計算するために使用します。
NaN値（Not a Number）を返します。
小数点以下14桁のπ値を返します。
数値のb乗を計算します。
度をラジアンに変換します。
乱数を返します。
[0,n)の範囲の乱数を返します。
doubleを四捨五入した整数を返します。
doubleの小数点以下n桁を保持します。
numberの符号を返します。1、0、-1で表します。
数値の正弦を計算します。
数値の平方根を計算します。
数値の正接を計算します。
数値の双曲正接を計算します。
BASEエンコードに基づいてxをradix進数の文字列に変換します。
数値の小数部分を切り捨てます。
配列（bins）を使用してBucketの範囲を指定し、numberが属するBucketを返します。
ある範囲の数値（bound1 - bound2）を同じサイズのn個のBucketに分割し、numberが属するBucketを返します。

数学統計関数

関数名
説明
2つの列の相関度を計算します。計算結果の範囲は[0,1]です。
2つの列の母共分散を計算します。
2つの列の標本共分散を計算します。
入力値の線形回帰の切片を返します。key1は従属変数、key2は独立変数です。
入力値の線形回帰の傾きを返します。key1は従属値、key2は独立値です。
key列の標本標準偏差を計算します。stddev_samp関数と同義です。
key列の母標準偏差を返します。
key列の標本標準偏差を計算します。
key列の母分散を計算します。
key列の標本分散を計算します。
key列の標本分散を計算します。var_samp関数と同義です。

バイナリ文字列関数

関数名
説明
base64をバイナリ文字列に変換します。
URL セーフな base64 をバイナリ文字列に変換します。
ビッグエンディアン形式のバイナリ文字列を数値に変換します。
16進数からバイナリに変換します。
バイナリ文字列の md5 を計算します。
バイナリ文字列の sha1 を計算します。
バイナリ文字列の sha256 ハッシュを計算します。
バイナリ文字列の sha512 ハッシュを計算します。
バイナリ文字列をbase64に変換します。
バイナリ文字列をURLセーフなbase64に変換します。
数値をビッグエンディアン形式のバイナリに変換します。
バイナリ文字列を16進数表現に変換します。
バイナリ文字列の xxhash64 を計算します。

ビット演算関数

関数名
説明
xのバイナリ表現における1の個数をカウントします。
x、yに対してバイナリ形式でAND演算を行います。
xのすべてのビットに対してバイナリ形式でNOT演算を行います。
x、yに対してバイナリ形式でOR演算を行います。
x、yに対してバイナリ形式でXOR演算を行います。

Lambda関数

Lambda式は関数と一緒に使用する必要があります。例えば、filter関数、reduce関数、transform関数、zip_with関数です。詳細についてはLambda関数をご覧ください。

ウィンドウ関数

ウィンドウ関数は、指定された複数行のデータに対して計算を実行し、計算結果を返すために使用されます。GROUP BY との違いは、計算結果を各行に付加するだけで、行自体を結合しない点にあります。関数の説明については、ウィンドウ関数をご覧ください。

空間幾何関数

空間幾何関数は、幾何空間内で空間エンティティを構築し、空間関係の判定、操作および計算を行うために使用されます。関数の説明については、空間幾何関数をご覧ください。
前の記事へ: UNNEST構文次の記事へ: 文字列関数

ヘルプとサポート

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

フィードバック

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