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

Apache Doris 中文参考:VARIANT_TYPE

· 52CE 我爱测

函数用于返回 值的类型名称。 该函数通常用于调试或分析 数据的结构,辅助进行类型判断和数据处理。本页描述的是 Doris 5.0.0 及之后版本中的行为。

功能

VARIANT_TYPE 函数用于返回 VARIANT 值的类型名称。 该函数通常用于调试或分析 VARIANT 数据的结构,辅助进行类型判断和数据处理。本页描述的是 Doris 5.0.0 及之后版本中的行为。

语法

VARIANT_TYPE(variant_value)

参数

  • variant_value:一个 VARIANT 类型的值。要查看嵌套值的类型,请传入路径,例如 VARIANT_TYPE(v['a'])。

返回值

返回一个 STRING,表示该值本身的类型名称。对于对象或数组,返回 object 或 array,不会列出其成员的类型。

结果 对应的值
object、array JSON 对象或数组
string 字符串
bool true 或 false
tinyint、smallint、int、bigint 整数,按能容纳该值的最小类型报告
decimal 定点数,包括超出 BIGINT 范围的整数,以及不超过 38 位的 LARGEINT 值
float、double 浮点数
date 日期
timestamp 带时区的时间戳
timestamp_ntz 不带时区的时间戳,如 DATETIME、TIMESTAMP_NS 值
null VARIANT null(JSON null)
binary、time、uuid Doris 的 JSON 解析和 CAST 都不会产生这些类型的值,它们可能来自其他系统写入的 VARIANT 数据,例如 Parquet 文件

输入为 SQL NULL 时返回 SQL NULL。

使用说明

  1. 用于查看 VARIANT 列中值的实际类型。对于从表中读取的值,结果反映的是存储后的值,例如根值中的 DATE 会以字符串存储。参见写入后值的规范化。
  2. 结果是值的类型,而不是路径的存储类型:从 BIGINT 路径读出的整数可能是 tinyint。如需查看表中每个子列的存储类型,请使用 SET describe_extend_variant_column = true; 后执行 DESC。
  3. 函数会读取每一行,实际使用中请用 LIMIT 限制行数。

示例

CREATE TABLE variant_table(
    k INT,
    v VARIANT NULL
)
DUPLICATE KEY(`k`)
DISTRIBUTED BY HASH(`k`) BUCKETS 1
PROPERTIES (
    "replication_num" = "1"
);

INSERT INTO variant_table VALUES
    (1, PARSE_TO_VARIANT('{"a": 10, "b": 1.2, "c": "ddddd"}')),
    (2, PARSE_TO_VARIANT('[1, 2]')),
    (3, NULL);

SELECT k,
       VARIANT_TYPE(v)      AS root_type,
       VARIANT_TYPE(v['a']) AS a_type,
       VARIANT_TYPE(v['b']) AS b_type,
       VARIANT_TYPE(v['c']) AS c_type
FROM variant_table
ORDER BY k;
+------+-----------+---------+--------+--------+
| k    | root_type | a_type  | b_type | c_type |
+------+-----------+---------+--------+--------+
|    1 | object    | tinyint | double | string |
|    2 | array     | NULL    | NULL   | NULL   |
|    3 | NULL      | NULL    | NULL   | NULL   |
+------+-----------+---------+--------+--------+

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

资料来源与适用范围

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

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

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