Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

groupConcat

View as MarkdownEdit this pageReport an issueSet up docs MCP

groupConcat

導入バージョン: v24.8.0

文字列のグループから連結文字列を返します。必要に応じて区切り文字を指定でき、要素数の上限を設定することもできます。

構文

groupConcat[(delimiter [, limit])](expression)

別名: group_concat, string_agg

Parameters

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

Arguments

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

戻り値

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

Examples

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

CREATE TABLE Employees (Name String) ENGINE = Memory;
INSERT INTO Employees VALUES ('John'), ('Jane'), ('Bob');

SELECT groupConcat(Name) FROM Employees;
JohnJaneBob

区切り文字にカンマを使用する (パラメータ構文) 

SELECT groupConcat(', ')(Name) FROM Employees;
John, Jane, Bob

区切り文字にカンマを使用する (引数の構文) 

SELECT groupConcat(Name, ', ') FROM Employees;
John, Jane, Bob

連結する要素数を制限する

SELECT groupConcat(', ', 2)(Name) FROM Employees;
John, Jane
Navigation