SAFE_ADD

Syntaxe

Paramètres

Description

Cette fonction permet d'effectuer une addition et de retourner la valeur NULL si une exception se produit.

Remarques

• Addition sécurisée avec gestion des erreurs : La fonction SAFE_ADD réalise l'addition de deux nombres tout en gérant de manière sécurisée les erreurs potentielles. En cas de dépassement de capacité ou d'erreur arithmétique, elle ne génère pas d'exception mais retourne plutôt la valeur NULL, ce qui permet d'éviter des interruptions brutales dans les requêtes.
• Compatibilité avec différents types numériques : Les paramètres X et Y peuvent être de tout type numérique compatible (INT, FLOAT, NUMERIC,...). Cette flexibilité permet d'utiliser la fonction dans de nombreux contextes où les types de données peuvent varier tout en garantissant la sécurité de l'opération.
• Prévention des erreurs liées au dépassement de capacité : Lorsqu'une addition dépasse la limite maximale supportée par le type de données, SAFE_ADD empêche l'erreur classique de débordement en renvoyant NULL, ce qui aide à maintenir la robustesse des traitements sans planter la requête.
• Utilisation courante en traitement de données sensibles : Cette fonction est particulièrement utile dans des pipelines où les valeurs peuvent être imprévues ou extrêmes. Elle évite que des données erronées fassent échouer des analyses ou des calculs par une gestion propre des erreurs.
• Retourne NULL en cas d'entrée NULL : Si l'un des paramètres est NULL, ou si une erreur survient, la fonction retourne NULL. Cela permet de repérer facilement les cas problématiques dans les résultats sans perturber les autres calculs.
• Alternative sécurisée à l'opérateur + classique : Contrairement à l'opérateur d'addition standard, qui peut générer une erreur en cas de débordement de valeur, SAFE_ADD offre une version plus tolérante privilégiant la continuité des traitements au détriment d'une valeur numérique incorrecte.
• Simplicité d'utilisation dans les requêtes SQL : La syntaxe est simple et intuitive, ce qui facilite son adoption rapide dans les requêtes SQL BigQuery sans besoin de gestion d'erreurs complexe supplémentaire.
• Permet un contrôle fin dans les transformations de données : En intégrant SAFE_ADD, il devient possible d'identifier et d'isoler les calculs posant problème, en testant la présence de NULL et en prenant des décisions spécifiques lors du traitement des résultats.