Concatène les éléments de plusieurs tableaux ARRAY pour générer un nouveau tableau, ou assemble plusieurs chaînes pour former une nouvelle chaîne.
Syntaxe
array<T> concat(array<T> <a>, array<T> <b>[,...])
string concat(string <str1>, string <str2>[,...])
Paramètres
a, b : Obligatoire. Tableau de type ARRAY. Dans la notation
array<T>,Treprésente le type de données des éléments du tableau ; ceux-ci peuvent être de n'importe quel type. Les types de données des éléments dans a et b doivent être identiques. Les valeurs NULL présentes dans les tableaux sont prises en compte lors du calcul.str1, str2 : Obligatoire. Type STRING. Si les paramètres d'entrée sont de type BIGINT, DOUBLE, DECIMAL ou DATETIME, ils sont implicitement convertis en type STRING avant le calcul. Pour tout autre type, une erreur est renvoyée.
Valeur de retour
Renvoie une valeur de type ARRAY. Si l'un des tableaux ARRAY d'entrée est NULL, le résultat est NULL.
Renvoie une valeur de type STRING. Si aucun paramètre n'est fourni ou si l'un des paramètres est NULL, le résultat est NULL.
Exemples
-
Exemple 1 : concaténation des tableaux ARRAY
array(10, 20)etarray(20, -20).--返回[10, 20, 20, -20]。 select concat(array(10, 20), array(20, -20)); -
Exemple 2 : un tableau ARRAY contient des valeurs NULL.
--返回[10, NULL, 20, -20]。 select concat(array(10, null), array(20, -20)); -
Exemple 3 : l'un des tableaux ARRAY est NULL.
--返回NULL。 select concat(array(10, 20), null); -
Exemple 4 : concaténation des chaînes
aabcetabcde.--返回aabcabcde。 select concat('aabc','abcde'); -
Exemple 5 : absence de paramètres.
--返回NULL。 select concat(); -
Exemple 6 : l'une des chaînes d'entrée est NULL.
--返回NULL。 select concat('aabc', 'abcde', null);
Fonctions associées
La fonction CONCAT appartient aux fonctions de type complexe ou aux fonctions de manipulation de chaînes.
Pour plus d'informations sur les fonctions de traitement des données de type complexe (telles que ARRAY, MAP, STRUCT, JSON), consultez la section Complex type functions.
Pour découvrir d'autres fonctions permettant de rechercher ou de convertir des formats de chaînes, reportez-vous à la rubrique 字符串函数.