groupArrayInsertAt

在指定位置插入一个值到数组中。

语法

groupArrayInsertAt(default_x, size)(x, pos)

如果在一个查询中有多个值被插入到同一个位置，该函数的行为如下：

• 如果在单线程中执行查询，则使用第一个插入的值。
• 如果在多线程中执行查询，则结果值是插入值中的一个未确定的值。

参数

• x — 要插入的值。 表达式，结果为支持的数据类型之一 supported data types。
• pos — 要插入指定元素 x 的位置。数组中的索引编号从零开始。 UInt32。
• default_x — 用于替换空位置的默认值。可选参数。 表达式，结果为为 x 参数配置的数据类型。如果未定义 default_x，则使用 默认值。
• size — 结果数组的长度。可选参数。在使用此参数时，必须指定默认值 default_x。 UInt32。

返回值

• 包含插入值的数组。

类型：数组。

示例

查询：

SELECT groupArrayInsertAt(toString(number), number * 2) FROM numbers(5);

结果：

┌─groupArrayInsertAt(toString(number), multiply(number, 2))─┐
│ ['0','','1','','2','','3','','4']                         │
└───────────────────────────────────────────────────────────┘

查询：

SELECT groupArrayInsertAt('-')(toString(number), number * 2) FROM numbers(5);

结果：

┌─groupArrayInsertAt('-')(toString(number), multiply(number, 2))─┐
│ ['0','-','1','-','2','-','3','-','4']                          │
└────────────────────────────────────────────────────────────────┘

查询：

SELECT groupArrayInsertAt('-', 5)(toString(number), number * 2) FROM numbers(5);

结果：

┌─groupArrayInsertAt('-', 5)(toString(number), multiply(number, 2))─┐
│ ['0','-','1','-','2']                                             │
└───────────────────────────────────────────────────────────────────┘

多线程将元素插入到一个位置。

查询：

SELECT groupArrayInsertAt(number, 0) FROM numbers_mt(10) SETTINGS max_block_size = 1;

作为该查询的结果，你将获得一个范围在 [0,9] 内的随机整数。例如：

┌─groupArrayInsertAt(number, 0)─┐
│ [7]                           │
└───────────────────────────────┘