POWER

Syntaxe

Paramètres

Description

Cette fonction permet de demander la valeur du nombre élevé à la puissance spécifié. Cette fonction est un alias de POW.

Remarques

• Fonction mathématique de base : POWER(X, Y) est utilisée pour élever un nombre (X) à une puissance (Y). Cela signifie que le nombre X sera multiplié par lui-même Y fois. C'est une opération fondamentale en mathématiques, notamment dans les domaines financiers, statistiques ou scientifiques.
• Alias parfait de POW : Dans BigQuery, POWER est strictement équivalente à la fonction POW. Il n'y a aucune différence fonctionnelle entre les deux, il s'agit uniquement d'une variation de nom pour répondre aux préférences des développeurs.
• Acceptation de types numériques : Les deux paramètres doivent être des expressions numériques. Les types INT64, FLOAT64 et NUMERIC sont acceptés. Si l'un des deux paramètres est NULL, le résultat renvoyé sera également NULL.
• Support des puissances négatives et fractionnaires : La fonction accepte aussi bien des exposants positifs que négatifs, ce qui permet de calculer des inverses. Elle accepte également les exposants fractionnaires, permettant par exemple de calculer des racines carrées ou cubiques (exemple : POWER(8, 1/3)).
• Comportement avec le zéro : Si la base X est 0 et l'exposant Y est supérieur à 0, le résultat est 0. Si les deux sont 0, le résultat retourné est 1, selon la convention mathématique. En revanche, si X = 0 et Y < 0, une erreur ou un NaN peut survenir car cela implique une division par zéro.
• Retourne un FLOAT64 : Le résultat retourné est généralement de type FLOAT64, même si les paramètres sont entiers. Il est donc important de tenir compte de l'arrondi et des limitations de précision lors de comparaisons avec d'autres nombres.
• Utilisation dans des cas complexes : POWER est particulièrement utile dans des calculs de croissance exponentielle, des modèles de prévision, ou encore des formules scientifiques. Elle est souvent utilisée avec EXP(), LOG() ou SQRT() dans des modèles statistiques.
• Importance de la validation des entrées : Il est important de valider les données en entrée pour éviter les erreurs. Par exemple, des bases négatives avec des puissances fractionnaires peuvent produire des valeurs non définies ou erreurs de calcul, car les résultats seraient complexes (nombre imaginaires).