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

Apache Doris 中文参考:ELEMENT_AT

· 52CE 我爱测

1. **ARRAY 数组以及 Doris 5.0.0 及后续版本中的 VARIANT 数组,索引都从 1 开始**,不是从 0 开始; 2. ARRAY 和 VARIANT 数组都支持负数索引, 表示最后一个元素, 表示倒数第二个,以此类推; 3. 函数的功能与 作用一致(详细见示例);

功能

ELEMENT_AT 函数用于从数组、map、struct 或 variant 中按指定的索引或键提取对应的元素值。

  • 当作用于 数组(ARRAY) 时,返回指定位置的元素;
  • 当作用于 MAP 时,返回指定键对应的值。
  • 当作用于 STRUCT 时,返回指定位置(从 1 开始)或指定字段名对应的子列,等价于 STRUCT_ELEMENT。
  • 当作用于 VARIANT 时,返回指定子列对应的值。

语法

ELEMENT_AT(container, key_or_index)

参数

  • container:可以是ARRAY, MAP, STRUCT, VARIANT。
  • key_or_index:
    • 对于 ARRAY:为整数类型,索引从 1 开始;
    • 对于 MAP:为 MAP 中的键类型(K),可为任意支持的基础类型。
    • 对于 STRUCT:为常量整数(字段位置,从 1 开始)或常量字符串(字段名,按大小写不敏感匹配)。
    • 对于 VARIANT 对象访问:为字符串类型的 key;
    • 对于 Doris 5.0.0 及后续版本中的 VARIANT 数组:为整数索引,正数索引从 1 开始,负数索引从数组末尾倒数。

返回值

  • 若为 ARRAY,返回数组中对应索引的元素(T 类型);
  • 若为 MAP,返回对应键的值(V 类型);
  • 若为 STRUCT,返回指定的子列值;
  • 若为 VARIANT,返回 VARIANT 类型。key 不存在、下标为 0 或越界、对数组使用字符串 key、对对象使用整数下标、对标量值使用 key,都返回 NULL;
  • 如果索引或键不存在,返回 NULL(对于 STRUCT,位置越界或字段名不存在会报错);
  • 如果参数为 NULL,返回 NULL。

使用说明

  1. ARRAY 数组以及 Doris 5.0.0 及后续版本中的 VARIANT 数组,索引都从 1 开始,不是从 0 开始;
  2. ARRAY 和 VARIANT 数组都支持负数索引,-1 表示最后一个元素,-2 表示倒数第二个,以此类推;
  3. ELEMENT_AT(container, key_or_index) 函数的功能与 container[key_or_index] 作用一致(详细见示例);
SELECT ELEMENT_AT(parse_to_variant('[10, 20, 30]'), 1);  -- 10
SELECT ELEMENT_AT(parse_to_variant('[10, 20, 30]'), 2);  -- 20
SELECT ELEMENT_AT(parse_to_variant('[10, 20, 30]'), -1); -- 30
  1. 对于 VARIANT,在查询中计算出的值里,值为 JSON null 的成员会返回 VARIANT null,它不是 SQL NULL;表中不会存储数组之外、值为 null 的对象成员,因此对从表中读取的数据做同样的访问会返回 SQL NULL。参见 NULL 语义。

示例

  1. ELEMENT_AT 函数的功能与 [] 作用一致。

    SELECT ELEMENT_AT([1, 2, 3], 2);
    +--------------------------+
    | ELEMENT_AT([1, 2, 3], 2) |
    +--------------------------+
    |                        2 |
    +--------------------------+
    
    SELECT [1, 2, 3][2];
    +--------------+
    | [1, 2, 3][2] |
    +--------------+
    |            2 |
    +--------------+
    
  2. 数组下标从 1 开始,越界会返回 NULL。

    SELECT ELEMENT_AT([1, 2, 3], 0);
    +--------------------------+
    | ELEMENT_AT([1, 2, 3], 0) |
    +--------------------------+
    |                     NULL |
    +--------------------------+
    
    SELECT ELEMENT_AT([1, 2, 3], 4);
    +--------------------------+
    | ELEMENT_AT([1, 2, 3], 4) |
    +--------------------------+
    |                     NULL |
    +--------------------------+
    
  3. 访问 MAP 中不存在的 KEY,会返回 NULL。

     SELECT ELEMENT_AT({"a": 1, "b": 2}, "c");
    +-----------------------------------+
    | ELEMENT_AT({"a": 1, "b": 2}, "c") |
    +-----------------------------------+
    |                              NULL |
    +-----------------------------------+
    
  4. 按位置或字段名访问 STRUCT 的子列(等价于 STRUCT_ELEMENT)。

    SELECT ELEMENT_AT(NAMED_STRUCT('name', 'Jack', 'id', 1728923), 1);
    +------------------------------------------------------------+
    | ELEMENT_AT(NAMED_STRUCT('name', 'Jack', 'id', 1728923), 1) |
    +------------------------------------------------------------+
    | Jack                                                       |
    +------------------------------------------------------------+
    
    SELECT NAMED_STRUCT('name', 'Jack', 'id', 1728923)['id'];
    +--------------------------------------------------+
    | NAMED_STRUCT('name', 'Jack', 'id', 1728923)['id'] |
    +--------------------------------------------------+
    |                                          1728923 |
    +--------------------------------------------------+
    
  5. 访问 VARIANT 的某个子列,如果 VARIANT 的值不是 OBJECT,返回 NULL

     SELECT ELEMENT_AT(PARSE_TO_VARIANT('{"a": 1, "b": 2}'), "a");
    +-------------------------------------------------------+
    | ELEMENT_AT(PARSE_TO_VARIANT('{"a": 1, "b": 2}'), "a") |
    +-------------------------------------------------------+
    | 1                                                     |
    +-------------------------------------------------------+
    
    SELECT ELEMENT_AT(PARSE_TO_VARIANT('123'), "");
    +-------------------------------------------+
    | ELEMENT_AT(PARSE_TO_VARIANT('123'), "")   |
    +-------------------------------------------+
    | NULL                                      |
    +-------------------------------------------+
    

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

资料来源与适用范围

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

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

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