Catégories :

Fonctions de données semi-structurées et structurées (tableau/objet)

ARRAY_TO_STRING

Renvoie un tableau d’entrée converti en chaîne en convertissant toutes les valeurs en chaînes (en utilisant TO_VARCHAR) et en les concaténant (en utilisant la chaîne du second argument pour séparer les éléments).

Syntaxe

ARRAY_TO_STRING( <array> , <separator_string> )
Copy

Arguments

array

Le tableau d’éléments à convertir en chaîne.

separator_string

La chaîne à insérer entre chaque élément, généralement un espace, une virgule ou un autre séparateur lisible par l’homme.

Renvoie

La fonction renvoie une valeur de type VARCHAR.

Notes sur l’utilisation

  • Un argument NULL renvoie NULL en conséquence.

  • Une valeur NULL dans un tableau est convertie en chaîne vide dans le résultat.

  • Pour inclure un espace vide entre les valeurs, vous devez faire précéder l’espace du caractère séparateur (par exemple ', '). Voir les exemples ci-dessous.

Exemples

Renvoyez divers tableaux sous forme de chaînes concaténées :

SELECT column1,
       ARRAY_TO_STRING(PARSE_JSON(column1), '') AS no_separation,
       ARRAY_TO_STRING(PARSE_JSON(column1), ', ') AS comma_separated
  FROM VALUES
    (NULL),
    ('[]'),
    ('[1]'),
    ('[1, 2]'),
    ('[true, 1, -1.2e-3, "Abc", ["x","y"], {"a":1}]'),
    ('[, 1]'),
    ('[1, ]'),
    ('[1, , ,2]');
Copy
+-----------------------------------------------+---------------------------------+-------------------------------------------+
| COLUMN1                                       | NO_SEPARATION                   | COMMA_SEPARATED                           |
|-----------------------------------------------+---------------------------------+-------------------------------------------|
| NULL                                          | NULL                            | NULL                                      |
| []                                            |                                 |                                           |
| [1]                                           | 1                               | 1                                         |
| [1, 2]                                        | 12                              | 1, 2                                      |
| [true, 1, -1.2e-3, "Abc", ["x","y"], {"a":1}] | true1-0.0012Abc["x","y"]{"a":1} | true, 1, -0.0012, Abc, ["x","y"], {"a":1} |
| [, 1]                                         | 1                               | , 1                                       |
| [1, ]                                         | 1                               | 1,                                        |
| [1, , ,2]                                     | 12                              | 1, , , 2                                  |
+-----------------------------------------------+---------------------------------+-------------------------------------------+

Cet exemple renvoie un tableau contenant une valeur NULL sous forme de chaîne concaténée. Commencez par créer une table et insérer un tableau :

CREATE TABLE test_array_to_string_with_null(a ARRAY);

INSERT INTO test_array_to_string_with_null
  SELECT (['A', NULL, 'B']);
Copy

Renvoyez le tableau sous forme de chaîne concaténée :

SELECT a,
       ARRAY_TO_STRING(a, ''),
       ARRAY_TO_STRING(a, ', ')
  FROM test_array_to_string_with_null;
Copy
+--------------+------------------------+--------------------------+
| A            | ARRAY_TO_STRING(A, '') | ARRAY_TO_STRING(A, ', ') |
|--------------+------------------------+--------------------------|
| [            | AB                     | A, , B                   |
|   "A",       |                        |                          |
|   undefined, |                        |                          |
|   "B"        |                        |                          |
| ]            |                        |                          |
+--------------+------------------------+--------------------------+
Langage: Français