複数の配列内のすべての要素を連結して新しい配列を返すか、複数の文字列を連結して新しい文字列を返します。
構文
array<T> concat(array<T> <a>, array<T> <b>[,...])
string concat(string <str1>, string <str2>[,...])パラメーター
aおよびb: 必須。 これらのパラメータは配列を指定します。
array<T>のTは、配列内の要素のデータ型を指定します。 要素は任意のデータ型にすることができます。 配列aの要素と配列bの要素は同じデータ型である必要があります。 null要素も操作に含まれます。str1およびstr2: 必須です。 値はSTRING型です。 入力値がBIGINT、DOUBLE、DECIMAL、またはDATETIME型の場合、計算前に暗黙的にSTRING型の値に変換されます。 入力値が他のデータ型の場合、エラーが返されます。
戻り値
ARRAY型の値が返されます。 入力配列の1つがnullの場合、nullが返されます。
STRING型の値が返されます。 入力パラメーターが設定されていない場合、または入力パラメーターがnullに設定されている場合は、nullが返されます。
例
例1:
配列 (10、20)と配列 (20、-20)のすべての要素を連結します。 例：-- The return value is [10, 20, 20, -20]. select concat(array(10, 20), array(20, -20));例2: 入力配列の1つにnull要素が含まれています。 例：
-- The return value is [10, null, 20, -20]. select concat(array(10, null), array(20, -20));例3: 入力配列の1つがnullです。 例：
-- The return value is null. select concat(array(10, 20), null);例4: 文字列
aabcとabcdeを連結します。 例：-- The return value is aabcabcde. select concat('aabc','abcde');例5: 入力が空です。 例：
-- The return value is null. select concat();例6: 入力文字列の1つがnullです。 例：
-- The return value is null. select concat('aabc', 'abcde', null);
関連関数
CONCATは、複合型関数または文字列関数です。