MaxCompute:CONCAT

Syntaxe

array<T> concat(array<T> <a>, array<T> <b>[,...])
string concat(string <str1>, string <str2>[,...])

Paramètres

• a et b : obligatoires. Ces paramètres désignent des tableaux. Le paramètre T dans array<T> indique le type de données des éléments contenus dans les tableaux. Les éléments peuvent être de n’importe quel type. Les éléments du tableau a et ceux du tableau b doivent avoir le même type de données. Les éléments null participent également à l’opération.

• str1 et str2 : obligatoires. Les valeurs sont de type STRING. Si les valeurs d’entrée sont de type BIGINT, DOUBLE, DECIMAL ou DATETIME, elles sont implicitement converties en type STRING avant le calcul. Pour tout autre type de données, une erreur est renvoyée.

Valeur de retour

• Renvoie une valeur de type ARRAY. Si l’un des tableaux d’entrée est null, la fonction renvoie null.

• Renvoie une valeur de type STRING. Si aucun paramètre d’entrée n’est spécifié ou si un paramètre d’entrée est défini sur null, la fonction renvoie null.

Exemples

• Exemple 1 : concaténer tous les éléments de array(10, 20) et de array(20, -20). Exemple d’instruction :

  -- The return value is [10, 20, 20, -20]. 
  select concat(array(10, 20), array(20, -20));

• Exemple 2 : l’un des tableaux d’entrée contient un élément null. Exemple d’instruction :

  -- The return value is [10, null, 20, -20]. 
  select concat(array(10, null), array(20, -20));

• Exemple 3 : l’un des tableaux d’entrée est null. Exemple d’instruction :

  -- The return value is null. 
  select concat(array(10, 20), null);

• Exemple 4 : concaténer les chaînes aabc et abcde. Exemple d’instruction :

  -- The return value is aabcabcde. 
  select concat('aabc','abcde');

• Exemple 5 : l’entrée est vide. Exemple d’instruction :

  -- The return value is null. 
  select concat();

• Exemple 6 : l’une des chaînes d’entrée est null. Exemple d’instruction :

  -- The return value is null. 
  select concat('aabc', 'abcde', null);

Fonctions associées

CONCAT est une fonction de type complexe ou une fonction de chaîne.

• Pour plus d’informations sur les fonctions utilisées pour traiter les données de types complexes, telles que ARRAY, MAP, STRUCT et JSON, consultez Fonctions de type complexe.

• Pour plus d’informations sur les fonctions liées à la recherche et à la conversion de chaînes, consultez Présentation des fonctions de chaîne.