tencent cloud

文档反馈

类型转换函数

最后更新时间:2024-01-22 10:52:48
    本文介绍类型转换函数的基本语法及示例。
    如果您在查询与分析数据时,需要区分更细维度的数据类型,您可以在查询与分析语句中使用类型转换函数转换数据的数据类型。
    函数名称
    语法
    说明
    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
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持