mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-12-19 21:03:51 +00:00
93 lines
3.6 KiB
Markdown
93 lines
3.6 KiB
Markdown
---
|
||
slug: /ja/sql-reference/aggregate-functions/reference/grouparrayinsertat
|
||
sidebar_position: 140
|
||
---
|
||
|
||
# groupArrayInsertAt
|
||
|
||
指定された位置に値を配列に挿入します。
|
||
|
||
**構文**
|
||
|
||
``` sql
|
||
groupArrayInsertAt(default_x, size)(x, pos)
|
||
```
|
||
|
||
1つのクエリで同じ位置に複数の値が挿入された場合、関数は次のように動作します：
|
||
|
||
- クエリが単一スレッドで実行される場合、挿入された値のうち最初のものが使用されます。
|
||
- クエリが複数スレッドで実行される場合、結果として得られる値は挿入された値の中から不確定のものです。
|
||
|
||
**引数**
|
||
|
||
- `x` — 挿入される値。[サポートされているデータ型](../../../sql-reference/data-types/index.md)の1つの[式](../../../sql-reference/syntax.md#syntax-expressions)。
|
||
- `pos` — 指定された要素 `x` を挿入する位置。配列のインデックス番号はゼロから始まります。[UInt32](../../../sql-reference/data-types/int-uint.md#uint-ranges)。
|
||
- `default_x` — 空の位置に代入するためのデフォルト値。オプションのパラメータ。[式](../../../sql-reference/syntax.md#syntax-expressions)で `x` パラメータに設定されたデータ型を結果とします。`default_x` が定義されていない場合、[デフォルト値](../../../sql-reference/statements/create/table.md#create-default-values)が使用されます。
|
||
- `size` — 結果となる配列の長さ。オプションのパラメータ。このパラメータを使用する場合、デフォルト値 `default_x` を指定する必要があります。[UInt32](../../../sql-reference/data-types/int-uint.md#uint-ranges)。
|
||
|
||
**返される値**
|
||
|
||
- 挿入された値を含む配列。
|
||
|
||
型: [Array](../../../sql-reference/data-types/array.md#data-type-array)。
|
||
|
||
**例**
|
||
|
||
クエリ:
|
||
|
||
``` sql
|
||
SELECT groupArrayInsertAt(toString(number), number * 2) FROM numbers(5);
|
||
```
|
||
|
||
結果:
|
||
|
||
``` text
|
||
┌─groupArrayInsertAt(toString(number), multiply(number, 2))─┐
|
||
│ ['0','','1','','2','','3','','4'] │
|
||
└───────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
クエリ:
|
||
|
||
``` sql
|
||
SELECT groupArrayInsertAt('-')(toString(number), number * 2) FROM numbers(5);
|
||
```
|
||
|
||
結果:
|
||
|
||
``` text
|
||
┌─groupArrayInsertAt('-')(toString(number), multiply(number, 2))─┐
|
||
│ ['0','-','1','-','2','-','3','-','4'] │
|
||
└────────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
クエリ:
|
||
|
||
``` sql
|
||
SELECT groupArrayInsertAt('-', 5)(toString(number), number * 2) FROM numbers(5);
|
||
```
|
||
|
||
結果:
|
||
|
||
``` text
|
||
┌─groupArrayInsertAt('-', 5)(toString(number), multiply(number, 2))─┐
|
||
│ ['0','-','1','-','2'] │
|
||
└───────────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
1つの位置に対するマルチスレッド挿入。
|
||
|
||
クエリ:
|
||
|
||
``` sql
|
||
SELECT groupArrayInsertAt(number, 0) FROM numbers_mt(10) SETTINGS max_block_size = 1;
|
||
```
|
||
|
||
このクエリの結果として `[0,9]` 範囲のランダムな整数が得られます。例:
|
||
|
||
``` text
|
||
┌─groupArrayInsertAt(number, 0)─┐
|
||
│ [7] │
|
||
└───────────────────────────────┘
|
||
```
|