> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> 计算由一组字符串拼接而成的字符串，可选用分隔符分隔，并可选择限制最大元素数量。

# groupConcat

<div id="groupConcat">
  ## groupConcat
</div>

首次引入于：v24.8.0

从一组字符串中计算得到一个拼接字符串，可选地使用分隔符分隔，也可选地限制最大元素数量。

<Note>
  如果只指定 delimiter 而未指定 limit，则 delimiter 必须作为第一个参数。如果同时指定了 delimiter 和 limit，则 delimiter 必须位于 limit 之前。

  此外，如果在参数和实参中指定了不同的分隔符，则只会使用实参中的分隔符。
</Note>

**语法**

```sql theme={null}
groupConcat[(delimiter [, limit])](expression)
```

**别名**: `group_concat`

**参数**

* `delimiter` — 用于分隔拼接值的字符串。此参数为可选；如果未指定，默认为空字符串。[`String`](/zh/reference/data-types/string)
* `limit` — 指定要拼接的最大元素数量的正整数。如果元素数量超过该值，则会忽略多余元素。此参数为可选。[`UInt*`](/zh/reference/data-types/int-uint)

**参数列表**

* `expression` — 输出待拼接字符串的表达式或列名。[`String`](/zh/reference/data-types/string)
* `delimiter` — 用于分隔拼接值的字符串。此参数为可选；如果未指定，则默认为空字符串，或使用参数中指定的 delimiter。[`String`](/zh/reference/data-types/string)

**返回值**

返回一个由列或表达式的值拼接而成的字符串。如果组中没有元素，或仅包含 NULL 元素，且函数未指定仅包含 NULL 值时的处理方式，则结果为值为 NULL 的可空字符串。[`String`](/zh/reference/data-types/string)

**示例**

**不使用分隔符的基本用法**

```sql title=Query theme={null}
SELECT groupConcat(Name) FROM Employees;
```

```response title=Response theme={null}
JohnJaneBob
```

**以逗号作为分隔符 (参数语法) **

```sql title=Query theme={null}
SELECT groupConcat(', ')(Name) FROM Employees;
```

```response title=Response theme={null}
John, Jane, Bob
```

**以逗号作为分隔符 (参数语法) **

```sql title=Query theme={null}
SELECT groupConcat(Name, ', ') FROM Employees;
```

```response title=Response theme={null}
John, Jane, Bob
```

**限制拼接元素的数量**

```sql title=Query theme={null}
SELECT groupConcat(', ', 2)(Name) FROM Employees;
```

```response title=Response theme={null}
John, Jane
```