メインコンテンツまでスキップ
バージョン: 26.x

CONCAT_WS

説明​

CONCAT_WS関数（Concatenate With Separator）は、指定された区切り文字を使用して複数の文字列や配列を連結します。CONCAT関数とは異なり、CONCAT_WSは自動的にNULL値をスキップし（ただし空文字列はスキップしません）、NULL以外の値の間に区切り文字を挿入します。この関数は文字列引数と配列引数の両方のモードをサポートしており、CSVフォーマットの生成、パスの結合、タグリストなどのシナリオで非常に有用です。

構文​

-- String mode
CONCAT_WS(<sep>, <str> [, <str> ...])

-- Array mode  
CONCAT_WS(<sep>, <array> [, <array> ...])

パラメータ​

Parameterデスクリプション
<sep>部分を結合するために使用される区切り文字列。タイプ: VARCHAR
<str>連結される文字列引数。タイプ: VARCHAR
<array>連結される配列引数、配列要素は文字列タイプである必要があります。タイプ: ARRAY<VARCHAR>

戻り値​

VARCHAR タイプを返し、区切り文字で連結された文字列を表します。

連結ルール:

  • 最初の引数を区切り文字として使用し、後続の引数を結合します
  • NULL 値は自動的にスキップしますが、空文字列は保持します
  • 文字列引数または配列引数をサポートしますが、混在はできません
  • 区切り文字とコンテンツとして UTF-8 マルチバイト文字をサポートします

特殊なケース:

  • 区切り文字が NULL の場合、NULL を返します
  • 連結される引数がすべて NULL の場合、空文字列を返します
  • 配列モードでは、配列内の NULL 要素をスキップしますが、空文字列要素は保持します
  • 複数の配列引数に NULL 配列が含まれている場合、空文字列を返します
  • 文字列引数と配列引数の混在は許可されません

例​

  1. 基本的な文字列連結
SELECT CONCAT_WS(',', 'apple', 'banana', 'orange'), CONCAT_WS('-', 'hello', 'world');
+-------------------------------------------+----------------------------------+
| CONCAT_WS(',', 'apple', 'banana', 'orange') | CONCAT_WS('-', 'hello', 'world') |
+-------------------------------------------+----------------------------------+
| apple,banana,orange                       | hello-world                      |
+-------------------------------------------+----------------------------------+
  1. NULL区切り文字の処理
SELECT CONCAT_WS(NULL, 'd', 'is'), CONCAT_WS('or', 'd', NULL, 'is');
+----------------------------+----------------------------------+
| CONCAT_WS(NULL, 'd', 'is') | CONCAT_WS('or', 'd', NULL, 'is') |
+----------------------------+----------------------------------+
| NULL                       | doris                            |
+----------------------------+----------------------------------+
  1. 空文字列の処理（空文字列を保持）
SELECT CONCAT_WS('|', 'hello', '', 'world', NULL), CONCAT_WS(',', '', 'test', '');
+--------------------------------------------+-------------------------------+
| CONCAT_WS('|', 'hello', '', 'world', NULL) | CONCAT_WS(',', '', 'test', '') |
+--------------------------------------------+-------------------------------+
| hello||world                               | ,test,                        |
+--------------------------------------------+-------------------------------+
  1. すべてのNULL値
SELECT CONCAT_WS('x', NULL, NULL), CONCAT_WS('-', NULL, NULL, NULL);
+----------------------------+---------------------------------+
| CONCAT_WS('x', NULL, NULL) | CONCAT_WS('-', NULL, NULL, NULL) |
+----------------------------+---------------------------------+
|                            |                                 |
+----------------------------+---------------------------------+
  1. Array モード基本的な使用方法
SELECT CONCAT_WS('or', ['d', 'is']), CONCAT_WS('-', ['apple', 'banana', 'cherry']);
+------------------------------+--------------------------------------------+
| CONCAT_WS('or', ['d', 'is']) | CONCAT_WS('-', ['apple', 'banana', 'cherry']) |
+------------------------------+--------------------------------------------+
| doris                        | apple-banana-cherry                        |
+------------------------------+--------------------------------------------+
  1. 配列内のNULL値
SELECT CONCAT_WS('or', ['d', NULL, 'is']), CONCAT_WS(',', [NULL, 'a', 'b', NULL, 'c']);
+------------------------------------+------------------------------------------+
| CONCAT_WS('or', ['d', NULL, 'is']) | CONCAT_WS(',', [NULL, 'a', 'b', NULL, 'c']) |
+------------------------------------+------------------------------------------+
| doris                              | a,b,c                                    |
+------------------------------------+------------------------------------------+
  1. 複数配列の連結
SELECT CONCAT_WS('-', ['a', 'b'], ['c', NULL], ['d']), CONCAT_WS('|', ['x'], ['y', 'z']);
+------------------------------------------------+----------------------------------+
| CONCAT_WS('-', ['a', 'b'], ['c', NULL], ['d']) | CONCAT_WS('|', ['x'], ['y', 'z']) |
+------------------------------------------------+----------------------------------+
| a-b-c-d                                        | x|y|z                            |
+------------------------------------------------+----------------------------------+
  1. 複数配列内のNULL配列
SELECT CONCAT_WS('-', ['a', 'b'], NULL, ['c', NULL], ['d']);
+-----------------------------------------------------+
| CONCAT_WS('-', ['a', 'b'], NULL, ['c', NULL], ['d']) |
+-----------------------------------------------------+
|                                                     |
+-----------------------------------------------------+
  1. UTF-8マルチバイト文字の処理
SELECT CONCAT_WS('x', 'ṭṛì', 'ḍḍumai'), CONCAT_WS('→', ['ṭṛì', 'ḍḍumai', 'hello']);
+-------------------------------+----------------------------------------------+
| CONCAT_WS('x', 'ṭṛì', 'ḍḍumai') | CONCAT_WS('→', ['ṭṛì', 'ḍḍumai', 'hello']) |
+-------------------------------+----------------------------------------------+
| ṭṛìxḍḍumai                    | ṭṛì→ḍḍumai→hello                          |
+-------------------------------+----------------------------------------------+
  1. CSV形式の生成とパス結合
SELECT CONCAT_WS(',', 'Name', 'Age', 'City'), CONCAT_WS('/', 'home', 'user', 'documents', 'file.txt');
+------------------------------------+--------------------------------------------------------+
| CONCAT_WS(',', 'Name', 'Age', 'City') | CONCAT_WS('/', 'home', 'user', 'documents', 'file.txt') |
+------------------------------------+--------------------------------------------------------+
| Name,Age,City                      | home/user/documents/file.txt                          |
+------------------------------------+--------------------------------------------------------+