Syntaxe
Paramètres
| Nom |
Description |
| X |
Ce paramètre permet de spécifier la base, c'est-à-dire le nombre qui sera élevé à une puissance. Il doit s'agir d'une expression numérique. |
| Y |
Ce paramètre permet de spécifier l'exposant (la puissance), c'est-à-dire le nombre de fois que la base X sera multipliée par elle-même. Il doit également s'agir d'une expression numérique. |
Description
Cette fonction permet de demander la valeur du nombre élevé à la puissance spécifié.
Remarques
- Fonction mathématique de base : La fonction POW fait partie des fonctions mathématiques fondamentales. Elle permet de calculer une puissance, en élevant
un nombre (X) à un exposant (Y). Cela revient à effectuer la multiplication répétée de la base.
- Équivalent de POWER() : Dans BigQuery, POW(X, Y) est équivalente à POWER(X, Y). Les deux fonctions effectuent exactement la même opération. Le choix
entre les deux dépend uniquement d'une préférence de nommage.
- Types de données pris en charge : Les deux paramètres X et Y doivent être de type numérique (INTEGER, FLOAT ou NUMERIC). Si l'un des deux est NULL, le
résultat sera aussi NULL.
- Prise en charge des exposants négatifs et fractionnaires : La fonction accepte des puissances négatives (exemple : POW(2, -2) retourne 0.25) ainsi
que des exposants fractionnaires (ex. : POW(9, 0.5) retourne 3.0), ce qui permet de calculer des racines carrées ou des inverses.
- Peut produire des erreurs en cas de valeurs non valides : Certaines combinaisons de valeurs (comme POW(-2, 0.5)) peuvent provoquer des résultats
indéfinis (NaN) ou des erreurs, car les puissances de nombres négatifs avec exposants fractionnaires ne sont pas définies en mathématique réelle.
- Comportement avec zéro : Si X = 0 et Y > 0, le résultat est 0. Si X = 0 et Y = 0, le résultat est 1, conformément à la convention mathématique. Cependant,
si X = 0 et Y < 0, cela peut provoquer une erreur car on divise par zéro.
- Utilisation dans des expressions complexes : POW est très souvent utilisée dans des formules statistiques, calculs financiers, ou modélisations physiques,
où les puissances sont omniprésentes (ex. : calcul de croissance exponentielle, loi de puissance,...).
- Résultat renvoyé en type FLOAT64 : La valeur retournée par POW est généralement de type FLOAT64, même si les entrées sont des entiers. Il est donc conseillé
de tenir compte des décimales et de l'imprécision éventuelle liée à ce type lors de comparaisons.
Dernière mise à jour : Jeudi, le 18 Juin 2020
