> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8a08bda2.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>
  limit を指定せずに delimiter を指定する場合、delimiter は最初のパラメータでなければなりません。delimiter と limit の両方を指定する場合、delimiter は limit より前に指定する必要があります。

  また、パラメータと引数で異なる区切り文字を指定した場合は、引数で指定した区切り文字のみが使用されます。
</Note>

**構文**

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

**別名**: `group_concat`

**Parameters**

* `delimiter` — 連結した値の区切りに使用する文字列です。このパラメータは省略可能で、指定しない場合は空文字列がデフォルトで使用されます。[`String`](/ja/reference/data-types/string)
* `limit` — 連結する要素の最大数を指定する正の整数です。要素数がこれを超える場合、超過分の要素は無視されます。このパラメータは省略可能です。[`UInt*`](/ja/reference/data-types/int-uint)

**Arguments**

* `expression` — 連結する文字列を出力する式またはカラム名です。[`String`](/ja/reference/data-types/string)
* `delimiter` — 連結した値の区切りに使用する文字列です。このパラメータは省略可能で、指定しない場合は空文字列、または Parameters で指定した区切り文字がデフォルトで使用されます。[`String`](/ja/reference/data-types/string)

**戻り値**

カラムまたは式の値を連結した文字列を返します。グループに要素がない場合、または NULL 要素しかない場合で、関数側で NULL のみの値に対する処理が指定されていなければ、結果は NULL 値を持つ Nullable な文字列になります。[`String`](/ja/reference/data-types/string)

**Examples**

**区切り文字を使わない基本的な使い方**

```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
```