DIV

Syntaxe

Paramètres

Description

Cette fonction permet de diviser une valeur par une autre valeur.

Remarques

• Effectue une division entière (sans décimales) : La fonction DIV(X, Y) effectue une division entière, ce qui signifie qu'elle retourne uniquement la partie entière du quotient. Par exemple, DIV(7, 2) retourne 3 et non 3.5, ce qui la distingue de l'opérateur de division / qui produit un résultat décimal.
• Le diviseur ne peut jamais être zéro : Comme dans toute opération de division, le paramètre Y (le diviseur) ne peut pas être égal à zéro, sinon une erreur d'exécution est levée. Il est donc judicieux de valider les données ou d'utiliser une condition de contrôle pour éviter les divisions invalides.
• Pratique pour des calculs par tranches ou regroupements : DIV() est utile dans les cas où l'on souhaite regrouper ou répartir des valeurs en blocs fixes. Par exemple, pour attribuer une rangée à chaque tranche de 10 articles vendus, on peut utiliser DIV(nombre_articles, 10).
• Résultat toujours de type entier (INT64) : Le résultat retourné par la fonction est toujours un entier, même si les paramètres sont de types mixtes (comme FLOAT64). Cela garantit une cohérence de type mais peut conduire à des pertes de précision si l'utilisateur s'attend à un résultat flottant.
• Différent de / ou SAFE_DIVIDE() dans son comportement : Contrairement à l'opérateur / retournant un résultat décimal, DIV() supprime toute partie fractionnaire. Il se distingue également de SAFE_DIVIDE() qui, lui, retourne NULL en cas de division par zéro au lieu d'une erreur.
• Peut être combinée avec MOD() pour des calculs précis : Lorsque combinée avec la fonction MOD(X, Y), DIV() permet de retrouver à la fois le quotient entier et le reste d'une division. Cette combinaison est souvent utilisée pour des algorithmes d'arrondi ou de transformation de données en base.
• Compatible avec les types numériques standards : Les paramètres X et Y doivent généralement être de type numérique (INT64 ou FLOAT64), mais si des types non compatibles sont fournis, BigQuery tentera de les convertir automatiquement. Toutefois, il est préférable de s'assurer que les données sont déjà bien typées.
• Très utile pour le partitionnement logique de données : Dans des requêtes analytiques, DIV() peut être utilisé pour répartir les données en groupes d'index égaux, par exemple pour diviser un ensemble de lignes en pages ou segments, ce qui est très utile en pagination ou en échantillonnage.