tencent cloud

日志服务

动态与公告
产品动态
公告
新手指引
产品简介
产品概述
产品优势
地域和访问域名
规格与限制
基本概念
购买指南
计费概述
产品定价
按量计费(后付费)
欠费说明
清理日志服务资源
成本优化
常见问题
快速入门
一分钟入门指南
入门指南
使用 Demo 日志快速体验 CLS
操作指南
资源管理
权限管理
日志采集
指标采集
日志存储
指标存储
检索分析(日志主题)
检索分析(指标主题)
仪表盘
数据处理
投递与消费
监控告警
云产品中心
DataSight 独立控制台
历史文档
实践教程
日志采集
检索分析
仪表盘
监控告警
投递和消费
成本优化
开发者指南
通过 iframe 内嵌 CLS(旧方案)
通过 Grafana 使用 CLS
API 文档
History
Introduction
API Category
Making API Requests
Topic Management APIs
Log Set Management APIs
Index APIs
Topic Partition APIs
Machine Group APIs
Collection Configuration APIs
Log APIs
Metric APIs
Alarm Policy APIs
Data Processing APIs
Kafka Protocol Consumption APIs
CKafka Shipping Task APIs
Kafka Data Subscription APIs
COS Shipping Task APIs
SCF Delivery Task APIs
Scheduled SQL Analysis APIs
COS Data Import Task APIs
Data Types
Error Codes
常见问题
健康监测问题解释
采集相关
检索分析相关
其他问题
服务等级协议
CLS 政策
隐私协议
数据处理和安全协议
联系我们
词汇表

类型转换函数

PDF
聚焦模式
字号
最后更新时间: 2026-01-07 15:39:44
本文介绍类型转换函数的基本语法及示例。
如果您在查询与分析数据时,需要区分更细维度的数据类型,您可以在查询与分析语句中使用类型转换函数转换数据的数据类型。
函数名称
语法
说明
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。

返回值类型

由您配置的 type 参数决定。

示例

1. 将数值0.01转换为 bigint 格式。
* | select cast(0.01 as bigint)
2. 将日志服务附带的日志采集时间__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

帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈