groupConcat
文字列のグループから連結された文字列を計算し、オプションで区切り文字を使用し、オプションで最大要素数で制限します。
構文
引数
expression
— 連結する文字列を出力する式またはカラム名。delimiter
— 連結された値を区切るために使用される string。このパラメータはオプションで、指定されていない場合は空文字列またはパラメータからの区切り文字がデフォルトとなります。
パラメータ
delimiter
— 連結された値を区切るために使用される string。このパラメータはオプションで、指定されていない場合は空文字列がデフォルトとなります。limit
— 連結する要素の最大数を指定する正の integer。要素がより多く存在する場合、余分な要素は無視されます。このパラメータはオプションです。
注記
区切り文字が指定されているが制限がない場合、最初のパラメータである必要があります。区切り文字と制限の両方が指定されている場合、区切り文字は制限の前に来る必要があります。
また、異なる区切り文字がパラメータおよび引数として指定されている場合、引数からの区切り文字のみが使用されます。
返される値
- 連結されたカラムまたは表現の値から構成される string を返します。グループに要素がない場合、またはすべての要素が null の場合、関数が null 値のみの取り扱いを指定していない場合、結果は null 値を持つ Nullable な文字列になります。
例
入力テーブル:
- 区切り文字なしの基本的な使用法:
クエリ:
結果:
これは、区切りなしで全ての名前を1つの連続した文字列に連結します。
- カンマを区切り文字として使用:
クエリ:
または
結果:
この出力は、カンマとスペースで区切られた名前を表示します。
- 連結する要素数の制限
クエリ:
結果:
このクエリは、テーブルにさらに名前があるにもかかわらず、出力を最初の二つの名前に制限します。