TO_JSON_STRING |
A chaîne de caractères JSON |
| BigQuery |
Syntaxe
|
TO_JSON_STRING(value[, pretty_print])
|
Paramètres
| Nom |
Description |
| value |
Ce paramètre permet de spécifier la valeur de tout type de données BigQuery que vous souhaitez convertir en une chaîne de caractères JSON. Cela peut être une structure (STRUCT), un tableau (ARRAY), ou un type de données simple. La fonction tentera de sérialiser cette valeur en une chaîne JSON valide. |
| pretty_print |
Ce paramètre facultatif de type BOOL permet de contrôler le formatage de la chaîne JSON de sortie. Si TRUE, ce paramètre permet d'inclure des retours à la ligne et des indentations dans la chaîne JSON résultante, la rendant plus lisible pour les humains. Si FALSE ou omis, la fonction renvoie une chaîne JSON compacte, sans formatage supplémentaire, ce qui est souvent préférable pour l'entreposage ou la transmission de données. |
Description
Cette fonction permet de demander une chaîne de caractères de format JSON correspondant à la valeur spécifié.
Remarques
- Conversion universelle de types en format JSON : La fonction TO_JSON_STRING est très pratique car elle permet de convertir n'importe quelle valeur
BigQuery - que ce soit un simple entier, une chaîne, un tableau ou une structure complexe - en une chaîne de caractères au format
JSON. Cela facilite l'exportation, la journalisation ou la transmission des données dans un format largement utilisé.
- Très utile pour la sérialisation de STRUCT et ARRAY : Lorsque vous travaillez avec des champs STRUCT ou ARRAY dans BigQuery, TO_JSON_STRING permet
d'obtenir une représentation textuelle fidèle de ces structures imbriquées. Cela est essentiel dans les cas où ces valeurs doivent être stockées dans des systèmes tiers
ou visualisées dans des outils compatibles JSON.
- Support du format "pretty print" pour la lisibilité : Grâce au paramètre pretty_print, on peut choisir un affichage JSON lisible par un humain, avec des
sauts de ligne et des indentations. Cela est particulièrement utile pour le débogage ou l'inspection visuelle des résultats directement depuis l'interface BigQuery.
- Production d'un JSON conforme aux standards : Le JSON généré par TO_JSON_STRING respecte les normes JSON, ce qui le rend immédiatement réutilisable dans
des appels d'API REST, des fichiers de configuration, ou des exports vers d'autres systèmes. Cela garantit une interopérabilité optimale.
- Représente fidèlement les types NULL : Lorsqu'une valeur NULL est convertie, la fonction produit un null JSON valide. Cela permet de gérer proprement
les données manquantes ou absentes dans les traitements en aval, sans introduire d'ambiguïté dans la représentation.
- Particulièrement utile en combinaison avec ARRAY_AGG ou STRUCT : Dans les requêtes complexes, on peut agréger ou structurer des données puis les convertir
facilement en JSON pour une sortie unifiée. Cela permet de produire des rapports, des blocs de données hiérarchiques ou des documents JSON sans passer par des scripts
externes.
- Peut simplifier l'intégration avec des services externes : Lorsqu'on souhaite transférer des données depuis BigQuery vers un service acceptant uniquement
du JSON (par exemple, une fonction infonuagique ou une API), cette fonction permet de formater les données directement
à la source, réduisant ainsi le besoin de transformations intermédiaires.
- Compacte ou lisible selon l'objectif : L'option pretty_print permet d'adapter la sortie au besoin : une version compacte pour un transfert réseau
plus efficace, ou une version bien formatée pour l'affichage ou le développement. Cette flexibilité renforce son utilité dans divers contextes d'usage.
Dernière mise à jour : Jeudi, le 18 Juin 2020
