本文介绍日志服务支持的类型转换函数语法及常见场景的使用示例。 ## 函数列表 :::tip 在日志服务分析语句（SQL 语句）中，需要使用单引号（''）包裹代表字符串的字符，无符号包裹或被双引号（""）包裹的字符为字段名或列名。例如`'time'` 代表字符串，`time` 或 `"time"` 代表字段名或列名。 ::: |函数名称 |语法 |说明 | |---|---|---| |[CAST 函数](/docs/6470/1254755#d7e22f0d) |CAST(KEY AS type) |转换 KEY 的数据类型。 | |[TRY_CAST 函数](/docs/6470/1254755#de10d346) |TRY_CAST(KEY AS type) |转换 KEY 的数据类型。 | |[TYPEOF 函数](/docs/6470/1254755#f7cc456d) |TYPEOF(KEY) |查询 KEY 的数据类型。 | ## CAST 函数 CAST 函数用于转换 KEY 的数据类型。使用 CAST 函数转换数据类型时，如果某个值的数据类型转换失败，系统将终止整个检索分析操作。 ### 函数语法 * 语法格式 ```SQL CAST(KEY AS type) ``` * 参数说明 |参数 |说明 | |---|---| |KEY |字段、表达式，值为任意数据类型。 | |type |SQL 数据类型，可选值为 bigint、varchar、double、boolean、timestamp、decimal、array 或者 map。例如 `CAST(JSON_PARSE(KEY) AS array(varchar))`。|\ | |索引数据类型和 SQL 数据类型的映射关系，请参见[数据类型映射关系](/docs/6470/1254755#f9ba72ce)。 | * 返回值说明返回值数据类型与 `type` 参数一致。 ### 函数示例 * 场景 `child_type` 字段值为 varchar 类型，通过 CAST 函数将 `child_type` 字段值转换为 MAP(varchar, varchar) 类型。 :::tip 本示例中的 `child_type` 字段的索引数据类型为 text，如果索引数据类型为 json，执行如下语句将报错。 ::: * 日志样例 ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/080bb9310e114820931f1b13f93d0a2f~tplv-goo7wpa0wc-image.image =824x) * 检索和分析语句 ```SQL * | SELECT CAST(JSON_PARSE(child_type) AS MAP(varchar, varchar)) ``` * 检索和分析结果 ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/33ce9a100b8f4368b476c1d834b3fb3a~tplv-goo7wpa0wc-image.image =835x) ## TRY_CAST 函数 TRY_CAST 函数用于转换 KEY 的数据类型。使用 TRY_CAST 函数转换数据类型时，如果某个值的数据类型转换失败，系统将返回 NULL，并跳过该值继续处理。 ### 函数语法 * 语法格式 ```SQL TRY_CAST(KEY AS type) ``` * 参数说明 |参数 |说明 | |---|---| |KEY |字段、表达式，值为任意数据类型。 | |type |SQL 数据类型，可选值为 bigint、varchar、double、boolean、timestamp、decimal、array 或者 map。例如 `TRY_CAST(JSON_PARSE(KEY) AS array(varchar))`。|\ | |索引数据类型和 SQL 数据类型的映射关系，请参见[数据类型映射关系](/docs/6470/1254755#f9ba72ce)。 | * 返回值说明返回值数据类型与 `type` 参数一致。 ### 函数示例 * 场景将 `ReqTime` 字段值转换为 varchar 类型并返回该数据类型。 * 检索和分析语句 ```SQL * | SELECT ReqTime,TYPEOF(TRY_CAST(ReqTime AS varchar)) ``` * 检索和分析结果 ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/7a2de28bdff94a45a1741fffaf54eda5~tplv-goo7wpa0wc-image.image =1001x) ## TYPEOF 函数 TYPEOF 函数用于查询 KEY 的数据类型。 ### 函数**语法** * 语法格式 ```SQL TYPEOF(KEY) ``` * 参数说明 |参数 |说明 | |---|---| |KEY |日志字段、表达式，其值可以为任意数据类型。 | * 返回值说明返回值为 Varchar 类型。 ### 函数示例 * 场景查看 `Method` 字段值的数据类型。 * 日志样例 ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/eb3aac5eda6a4031bc0a051402a1e428~tplv-goo7wpa0wc-image.image =1329x) * 检索和分析语句 ```SQL * | SELECT TYPEOF(Method) ``` * 检索和分析结果 ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/488d691eb0d04939810513472c1dd672~tplv-goo7wpa0wc-image.image =967x) ## 数据类型映射关系索引数据类型和 SQL 数据类型的对应关系如下表所示： |索引数据类型 |SQL 数据类型 | |---|---| |long |bigint | |text |varchar | |double |double | |json |varchar |