tencent cloud

Cloud Log Service

型変換関数

ダウンロード
フォーカスモード
フォントサイズ
最終更新日: 2026-10-12 14:32:16
AI翻訳
本文では、型変換関数の基本構文と例を紹介します。
データのクエリと分析時に、より細かい次元のデータ型を区別する必要がある場合は、クエリと分析ステートメントで型変換関数を使用してデータのデータ型を変換できます。
関数名
構文
説明
cast関数
cast(x as type)
xのデータ型を変換します。
cast関数を使用してデータ型を変換する際に、値の変換に失敗した場合、クエリと分析操作全体が終了します。
try_cast関数
try_cast(x as type)
xのデータ型を変換します。
try_cast関数を使用してデータ型を変換する際に、値の変換に失敗した場合、その値はNULLを返し、その値をスキップして処理を続行します。
typeof 関数
typeof(x)
xのデータ型を返します。
説明:
ログに不正なデータが含まれる可能性がある場合は、try_cast関数を使用して、不正なデータによるクエリと分析操作全体の失敗を回避することを推奨します。

cast関数

cast関数はxのデータ型を変換するために使用されます。cast関数を使用してデータ型を変換する際に、ある値の変換が失敗した場合、クエリと分析操作全体が終了します。

構文

cast(x as type)

パラメータ説明

パラメータ
説明
x
パラメータ値は任意の型にすることができます。
type
SQLデータ型。指定可能な値はbigint、varchar、double、boolean、timestamp、decimal、array、またはmapです。
インデックスデータ型とSQLデータ型のマッピング関係については、付録:データ型マッピング関係を参照してください。
説明:
typeがtimestampの場合、xはミリ秒単位のタイムスタンプまたはISO 8601形式の時刻文字列である必要があります。例:1597807109000または2019-12-25T16:17:01+08:00。
UNIXタイムスタンプをtimestampに変換する際は、UTC+0タイムゾーンを使用します。その他のタイムゾーンに変換する必要がある場合は、指定されたタイムゾーン機能を持つ関数(例:from_unixtime(__TIMESTAMP__/1000, 'Asia/Shanghai'))を使用するか、手動でタイムゾーンオフセットを追加します(例:cast(__TIMESTAMP__+8*60*60*1000 as timestamp)またはcast(__TIMESTAMP__ as timestamp)+ INTERVAL 8 HOUR)。

戻り値の型

これは、お客様が設定したtypeパラメータによって決まります。

例

1. 数値0.01をbigint形式に変換します。
* | select cast(0.01 as bigint)
2. CLSに付属するログ収集時刻__TIMESTAMP__をTIMESTAMP型に変換します。
* | select cast(__TIMESTAMP__ as timestamp)

try_cast関数

try_cast関数はxのデータ型を変換するために使用されます。try_cast関数を使用してデータ型を変換する際に、ある値の変換が失敗した場合、その値はNULLを返し、その値をスキップして処理を続行します。

構文

try_cast(x as type)

パラメータ説明

パラメータ
説明
x
パラメータ値は任意の型にすることができます。
type
SQLデータ型。指定可能な値はbigint、varchar、double、boolean、timestamp、decimal、array、またはmapです。
インデックスデータ型とSQLデータ型のマッピング関係については、付録:データ型マッピング関係を参照してください。

戻り値の型

これは、お客様が設定したtypeパラメータによって決まります。

例

remote_userフィールド値をvarchar形式に変換します。
* | select try_cast(remote_user as varchar)

付録:データ型マッピング関係

インデックスデータ型とSQLデータ型の対応関係は以下の表の通りです:
インデックスのデータ型
SQLのデータ型
long
bigint
text
varchar
double
double
json
varchar


ヘルプとサポート

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

フィードバック