すべてのプロダクト
Search
ドキュメントセンター

MaxCompute:WM_CONCAT

最終更新日:Jan 17, 2025

colnameの値と、separatorで指定された区切り文字を連結します。

使用上の注意

MaxCompute V2.0は追加機能を提供します。 使用する関数に新しいデータ型が含まれる場合は、MaxCompute V2.0データ型エディションを有効にする必要があります。 新しいデータ型には、TINYINT、SMALLINT、INT、FLOAT、VARCHAR、TIMESTAMP、およびBINARYが含まれます。

  • セッションレベル: MaxCompute V2.0データ型エディションを使用するには、実行するsql文の前にset odps. SQL. type.system.odps2=true; を追加し、一緒にコミットして実行する必要があります。

  • プロジェクトレベル: プロジェクトの所有者は、プロジェクトの要件に基づいて、プロジェクトのMaxCompute V2.0データ型エディションを有効にできます。 設定は10〜15分後に有効になります。 サンプルコマンド:

    setproject odps.sql.type.system.odps2=true;

    setprojectの詳細については、「プロジェクト操作」をご参照ください。 プロジェクトレベルでMaxCompute V2.0データ型エディションを有効にする際の注意事項の詳細については、「データ型エディション」をご参照ください。

複数の集計関数を含むSQL文を使用していて、プロジェクトのリソースが不足している場合、メモリオーバーフローが発生する可能性があります。 ビジネス要件に基づいて、SQLステートメントを最適化するか、コンピューティングリソースを購入することを推奨します。

構文

string wm_concat(string <separator>, string <colname>)

パラメーター

  • separator: 必須。 区切り文字。STRING型の定数です。

  • colname: 必須です。 STRING型の値。 入力値がBIGINT、DOUBLE、またはDATETIME型の場合、計算前に暗黙的にSTRING型に変換されます。

説明

WM_CONCAT関数が、within group (order by <col1>[,<col2>...]) 式およびDISTINCTキーワードとともに使用される場合は、関数構文に注意する必要があります。 集計関数の構文の詳細については、「構文」をご参照ください。

戻り値

この関数は、GROUP BY句とともに使用されます。 ORDER BY句は指定されていません。

STRING型の値が返されます。 戻り値は、次のルールによって異なります。

  • separatorの値がSTRING型の定数でない場合、エラーが返されます。

  • colnameの値がSTRING、BIGINT、DOUBLE、またはDATETIME型でない場合、エラーが返されます。

  • colnameの値がnullの場合、この値を含む行は計算に使用されません。

説明

select wm_concat(',', name) from table_name; 文のtable_nameが空のセットの場合、nullが返されます。

サンプルデータ

このセクションでは、関数の使用方法を理解するためのサンプルソースデータと例を示します。 empという名前のテーブルを作成し、サンプルデータをテーブルに挿入します。 例:

create table if not exists emp
   (empno bigint,
    ename string,
    job string,
    mgr bigint,
    hiredate datetime,
    sal bigint,
    comm bigint,
    deptno bigint);
tunnel upload emp.txt emp; -- Replace emp.txt with the actual path (path and name) to which you upload the data file.

emp.txtファイルには、次のサンプルデータが含まれています。

7369,SMITH,CLERK,7902,1980-12-17 00:00:00,800,,20
7499,ALLEN,SALESMAN,7698,1981-02-20 00:00:00,1600,300,30
7521,WARD,SALESMAN,7698,1981-02-22 00:00:00,1250,500,30
7566,JONES,MANAGER,7839,1981-04-02 00:00:00,2975,,20
7654,MARTIN,SALESMAN,7698,1981-09-28 00:00:00,1250,1400,30
7698,BLAKE,MANAGER,7839,1981-05-01 00:00:00,2850,,30
7782,CLARK,MANAGER,7839,1981-06-09 00:00:00,2450,,10
7788,SCOTT,ANALYST,7566,1987-04-19 00:00:00,3000,,20
7839,KING,PRESIDENT,,1981-11-17 00:00:00,5000,,10
7844,TURNER,SALESMAN,7698,1981-09-08 00:00:00,1500,0,30
7876,ADAMS,CLERK,7788,1987-05-23 00:00:00,1100,,20
7900,JAMES,CLERK,7698,1981-12-03 00:00:00,950,,30
7902,FORD,ANALYST,7566,1981-12-03 00:00:00,3000,,20
7934,MILLER,CLERK,7782,1982-01-23 00:00:00,1300,,10
7948,JACCKA,CLERK,7782,1981-04-12 00:00:00,5000,,10
7956,WELAN,CLERK,7649,1982-07-20 00:00:00,2450,,10
7956,TEBAGE,CLERK,7748,1982-12-30 00:00:00,1300,,10

  • 例1: すべての従業員のename列の値を連結します。 例:

    select wm_concat(',', ename) from emp;

    次の応答が返されます。

    +------------+
    | _c0        |
    +------------+
    | SMITH,ALLEN,WARD,JONES,MARTIN,BLAKE,CLARK,SCOTT,KING,TURNER,ADAMS,JAMES,FORD,MILLER,JACCKA,WELAN,TEBAGE |
    +------------+
  • 例2: GROUP BYでこの関数を使用して、すべての従業員を部署 (deptno) ごとにグループ化し、各部署の従業員の名前 (ename) を連結します。 例:

    select deptno, wm_concat(',', ename) from emp group by deptno order by deptno;

    次の応答が返されます。

    +------------+------------+
    | deptno     | _c1        |
    +------------+------------+
    | 10         | CLARK,KING,MILLER,JACCKA,WELAN,TEBAGE |
    | 20         | SMITH,JONES,SCOTT,ADAMS,FORD |
    | 30         | ALLEN,WARD,MARTIN,BLAKE,TURNER,JAMES |
    +------------+------------+
  • 例3: GROUP BYでこの関数を使用して、すべての従業員を部門 (deptno) ごとにグループ化し、重複を削除した後に各部門の従業員の給与値を連結します。 例:

    select deptno, wm_concat(distinct ',', sal) from emp group by deptno order by deptno;

    次の応答が返されます。

    +------------+------------+
    | deptno     | _c1        |
    +------------+------------+
    | 10         | 1300,2450,5000 |
    | 20         | 1100,2975,3000,800 |
    | 30         | 1250,1500,1600,2850,950 |
    +------------+------------+
  • 例4: GROUP BYおよびORDER BYでこの関数を使用して、すべての従業員を部門別にグループ化し (deptno) 、各部門のすべての従業員の給与値 (sal) を連結し、指定した順序で給与値 (sal) をソートします。 例:

    select deptno, wm_concat(',',sal) within group (order by sal) from emp group by deptno order by deptno;

    次の応答が返されます。

    +------------+------------+
    |deptno|_c1|
    +------------+------------+
    |10|1300,1300,2450,2450,5000,5000|
    |20|800,1100,2975,3000,3000|
    |30|950,1250,1250,1500,1600,2850|
    +------------+------------+
  • 例5: この関数をGROUP BYおよびORDER BYと共に使用して、指定した列を指定した順序でソートします。 例:

    SELECT
        g,
        wm_concat ('#', t) WITHIN GROUP (ORDER BY h DESC) AS t_t
    FROM
    VALUES ("24",1,10),
           ("234",2,100),
           ("555",1,20),
           ("123", 2,30),
           ("7",1,11),
           ("13",3,50) AS tmp (t,g,h)
    GROUP BY g;
    

    次の応答が返されます。

    +------+-----+
    | g    | t_t |
    +------+-----+
    | 1    | 555#7#24 |
    | 2    | 234#123 |
    | 3    | 13  |
    +------+-----+

関連関数

WM_CONCATは集計関数です。 複数の入力レコードの平均値の計算およびパラメーターの集計に使用される関数の詳細については、集計関数.