跳到主要内容
跳到主要内容

groupArrayInsertAt

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

语法

groupArrayInsertAt(default_x, size)(x, pos)

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

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

参数

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

返回值

  • 包含插入值的数组。

类型:数组

示例

查询:

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]                           │
└───────────────────────────────┘