大网数据广告活动
数据库部署与 SQL 参考

StarRocks 中文参考:variant_typeof

· 52CE 我爱测

此函数检查 VARIANT 值并以字符串形式返回其类型。这对于理解 VARIANT 数据的结构或基于数据类型进行条件处理非常有用。

variant_typeof

以字符串形式返回 VARIANT 值的类型名称。

此函数检查 VARIANT 值并以字符串形式返回其类型。这对于理解 VARIANT 数据的结构或基于数据类型进行条件处理非常有用。

语法

VARCHAR variant_typeof(variant_expr)

参数

  • variant_expr:表示 VARIANT 对象的表达式。通常是来自 Iceberg 表的 VARIANT 列或由 variant_query 返回的 VARIANT 值。

返回值

返回表示类型名称的 VARCHAR 值。

可能的返回值包括:

  • "Null" - 对于 VARIANT null(例如 JSON null)。对于 SQL NULL(包括路径不存在时 variant_query 的返回值),函数返回 NULL。如需判断 VARIANT null,请使用 is_variant_null。
  • "Boolean(true)" - 对于布尔值 true
  • "Boolean(false)" - 对于布尔值 false
  • "Int8", "Int16", "Int32", "Int64" - 对于整数值
  • "Float", "Double" - 对于浮点值
  • "Decimal4", "Decimal8", "Decimal16" - 对于不同精度的十进制值
  • "String" - 对于字符串值
  • "Binary" - 对于二进制数据
  • "Date" - 对于日期值
  • "TimestampTz", "TimestampNtz" - 对于带时区或不带时区的时间戳值
  • "TimestampTzNanos", "TimestampNtzNanos" - 对于纳秒精度的时间戳值
  • "TimeNtz" - 对于不带时区的时间值
  • "Uuid" - 对于 UUID 值
  • "Object" - 对于结构体或映射值
  • "Array" - 对于数组值

示例

示例 1:获取根级别 VARIANT 值的类型。

SELECT variant_typeof(data) AS type
FROM bluesky
LIMIT 1;
+--------+
| type   |
+--------+
| Object |
+--------+

示例 2:获取嵌套字段的类型。

SELECT
    variant_typeof(variant_query(data, '$.kind')) AS kind_type,
    variant_typeof(variant_query(data, '$.did')) AS did_type,
    variant_typeof(variant_query(data, '$.commit')) AS commit_type
FROM bluesky
LIMIT 1;
+-----------+----------+-------------+
| kind_type | did_type | commit_type |
+-----------+----------+-------------+
| String    | String   | Object      |
+-----------+----------+-------------+

示例 3:检查多个字段的类型。

SELECT
    variant_typeof(variant_query(data, '$.commit')) AS commit_type,
    variant_typeof(variant_query(data, '$.time_us')) AS time_type
FROM bluesky
LIMIT 1;
+-------------+-----------+
| commit_type | time_type |
+-------------+-----------+
| Object      | Int64     |
+-------------+-----------+

示例 4:在条件逻辑中使用以处理不同类型。

SELECT
    CASE variant_typeof(variant_query(data, '$.time_us'))
        WHEN 'Int64' THEN get_variant_int(data, '$.time_us')
        ELSE NULL
    END AS timestamp_value
FROM bluesky
LIMIT 3;
+------------------+
| timestamp_value  |
+------------------+
| 1733267476040329 |
| 1733267476040803 |
| 1733267476041472 |
+------------------+

示例 5:根据类型过滤行。

SELECT COUNT(*) AS object_count
FROM bluesky
WHERE variant_typeof(variant_query(data, '$.commit')) = 'Object';
+--------------+
| object_count |
+--------------+
| 9960624      |
+--------------+

keyword

VARIANT_TYPEOF,VARIANT

本文来自 StarRocks 文档贡献者,按 Apache 2.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
StarRocks 文档贡献者
适用范围
main 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
Apache 2.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。