SAFE_MULTIPLY

Syntaxe

Paramètres

Description

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

Remarques

• Sécurité contre les dépassements de capacité : La fonction SAFE_MULTIPLY est conçue pour éviter les erreurs pouvant survenir lorsqu'un produit dépasse la capacité maximale du type de données numérique (comme un dépassement de type INT64). Plutôt que de générer une erreur, elle retourne NULL, ce qui évite les interruptions inattendues de requête.
• Fonction utile dans les calculs avec grands nombres : Lorsque vous travaillez avec de grandes valeurs ou des agrégats (par exemple, des revenus multipliés par des quantités élevées), il est possible de provoquer un débordement. SAFE_MULTIPLY agit comme un garde-fou pour maintenir la stabilité des calculs.
• Maintient la compatibilité entre types numériques : Cette fonction accepte divers types numériques (comme INT64, FLOAT64, NUMERIC) et respecte les règles de compatibilité de BigQuery. Elle facilite les opérations entre types compatibles tout en gérant les risques d'erreur.
• Utile dans les transformations de données automatisées : Dans des scripts SQL automatisés où l'origine des données est variable, SAFE_MULTIPLY protège le processus d'intégration contre des anomalies inattendues, comme des valeurs extrêmes issues d'un import mal formaté.
• Retourne NULL en cas d'erreur plutôt qu'un plantage : Le comportement par défaut des fonctions arithmétiques en SQL est de lever une erreur en cas de dépassement. Avec SAFE_MULTIPLY, le calcul reste silencieux et continue, ce qui permet d'obtenir un résultat partiel au lieu d'un échec global.
• Peut être combinée avec COALESCE pour des valeurs par défaut : Pour éviter que des NULL ne se propagent dans les résultats finaux, il est courant d'associer SAFE_MULTIPLY à COALESCE, comme dans COALESCE(SAFE_MULTIPLY(X, Y), 0), ce qui garantit une valeur numérique de secours.
• Favorise la robustesse dans les rapports analytiques : Dans des tableaux de bord ou rapports, un seul échec de multiplication pourrait compromettre l'affichage de toute une ligne ou cellule. SAFE_MULTIPLY sécurise les calculs en empêchant les erreurs de propagation.
• Simplifie la gestion des erreurs dans les requêtes complexes : Sans cette fonction, il faudrait écrire des vérifications manuelles pour éviter les débordements (CASE WHEN ...). Grâce à SAFE_MULTIPLY, cette logique est internalisée, rendant les requêtes SQL plus simples, lisibles et maintenables.