ARRAY_TO_STRING |
Tableau de chaîne de caractères |
| BigQuery |
Syntaxe
|
ARRAY_TO_STRING(array_expression, delimiter[, null_text])
|
Paramètres
| Nom |
Description |
| array_expression |
Ce paramètre permet de spécifier le tableau dont les éléments doivent être concaténés en une chaîne de caractères. Les éléments du tableau doivent être des types de données convertibles en STRING. |
| delimiter |
Ce paramètre permet de spécifier la chaîne de caractères étant insérée entre chaque élément du tableau lors de la concaténation. |
| null_text |
Ce paramètre facultatif permet de spécifier la chaîne de caractères qui sera utilisée pour remplacer les valeurs NULL dans array_expression. Si ce paramètre n'est pas fourni, les valeurs NULL sont ignorées (ne sont pas incluses dans la chaîne résultante) et le délimiteur n'est pas inséré pour elles. |
Description
Cette fonction permet de demander une concaténation des éléments d'un tableau spécifiés et retourne une chaîne de caractères.
Remarques
- La fonction ARRAY_TO_STRING est utile pour transformer un tableau en une seule chaîne lisible : Elle est souvent utilisée pour afficher ou exporter les
éléments d'un tableau sous forme textuelle, par exemple dans des rapports, des journaux ou des champs concaténés.
- Le paramètre delimiter permet de définir un séparateur entre chaque élément du tableau : Ce séparateur peut être une virgule, un espace, un
point-virgule, ou tout autre caractère, ce qui rend la sortie flexible pour différents formats (CSV, texte brut,...).
- Le troisième paramètre null_text est optionnel mais très pratique : Il permet d'insérer une chaîne spécifique à la place des valeurs NULL, évitant ainsi
des trous invisibles dans la chaîne finale et améliorant la lisibilité ou la cohérence du résultat.
- Si null_text n'est pas spécifié, les NULL sont simplement ignorés : Cela signifie qu'ils ne sont pas remplacés par quoi que ce soit, et qu'aucun délimiteur
n'est inséré à leur place, ce qui peut rendre le résultat plus compact mais moins explicite.
- Tous les éléments du tableau doivent être convertibles en texte (STRING) : Cela inclut des types simples comme INT64 ou FLOAT64, mais aussi des types plus
complexes à condition qu'ils puissent être représentés sous forme de texte (ex : CAST implicite ou explicite).
- Cette fonction est fréquemment utilisée pour formater des résultats d'agrégation en liste unique : Par exemple, après un ARRAY_AGG(name), on peut utiliser
ARRAY_TO_STRING(..., ", ") pour obtenir une liste de noms séparés par des virgules.
- Elle est souvent combinée avec des clauses conditionnelles pour filtrer ou nettoyer les données du tableau : Par exemple, avant de convertir, on peut
filtrer les éléments indésirables avec un ARRAY filtré via une SELECT imbriquée ou une fonction ARRAY_FILTER.
- Dans des contextes multilingues ou de formatage personnalisé, le délimiteur peut contenir plusieurs caractères ou des expressions dynamiques : Cela rend
la fonction puissante pour générer du texte structuré, comme des listes avec "et" ou "ou" entre les derniers éléments (avec une logique supplémentaire bien sûr).
Dernière mise à jour : Jeudi, le 18 Juin 2020
