メインコンテンツまでスキップ

array_join

array_join

説明​

配列の要素を連結して文字列にします。

構文​

array_join(array, sep[, null_replace_str])

パラメータ​

  • array: 連結する要素を持つ配列です。ARRAYデータ型のみがサポートされています。
  • sep: 連結された配列要素を区切るデリミタです。VARCHARデータ型のみがサポートされています。
  • null_replace_str: NULL値を置き換えるために使用される文字列です。VARCHARデータ型のみがサポートされています。

戻り値​

VARCHARデータ型の値を返します。

使用上の注意​

  • arrayパラメータの値は1次元配列である必要があります。
  • arrayパラメータはDECIMAL値をサポートしていません。
  • sepパラメータをNULLに設定した場合、戻り値はNULLになります。
  • null_replace_strパラメータを指定しない場合、NULL値は破棄されます。
  • null_replace_strパラメータをNULLに設定した場合、戻り値はNULLになります。

例​

例1: 配列の要素を連結します。この例では、配列内のNULL値は破棄され、連結された配列要素はアンダースコア (_)で区切られます。

mysql> select array_join([1, 3, 5, null], '_');

+-------------------------------+
| array_join([1,3,5,NULL], '_') |
+-------------------------------+
| 1_3_5                         |
+-------------------------------+

例2: 配列の要素を連結します。この例では、配列内のNULL値はNULL文字列で置き換えられ、連結された配列要素はアンダースコア (_)で区切られます。

mysql> select array_join([1, 3, 5, null], '_', 'NULL');

+---------------------------------------+
| array_join([1,3,5,NULL], '_', 'NULL') |
+---------------------------------------+
| 1_3_5_NULL                            |
+---------------------------------------+