LOG10

Syntaxe

Paramètres

Description

Cette fonction permet de demander le logarithme en base 10 de la valeur spécifié.

Remarques

• Calcul du logarithme en base 10 : La fonction LOG10 permet de calculer le logarithme décimal d'un nombre, c'est-à-dire en base 10. C'est une fonction mathématique classique, utilisée pour analyser des données à échelle exponentielle ou pour représenter des grandeurs en notation logarithmique.
• La valeur d'entrée doit être strictement positive : Le paramètre X doit obligatoirement être supérieur à zéro. Si la valeur fournie est nulle, négative ou NULL, la fonction retournera NULL ou provoquera une erreur, selon le contexte d'exécution. Il est conseillé de filtrer ou valider les entrées en amont.
• Très utile pour transformer des échelles numériques : LOG10 permet de réduire l'amplitude des valeurs lorsqu'on travaille avec des données variant sur plusieurs ordres de grandeur (exemple : revenus, volumes, populations). Cela permet d'aplanir les distributions, facilitant les analyses statistiques et les représentations graphiques.
• Particulièrement utilisée en science et en finance : Le logarithme base 10 est courant dans de nombreux domaines comme l'acoustique (décibels), la chimie (pH), la finance (rendements logarithmiques), ou encore en géologie (échelle de Richter). C'est une transformation indispensable pour rendre certaines données comparables.
• Résultat retourné au format FLOAT64 : Comme la plupart des fonctions mathématiques dans BigQuery, LOG10 retourne un résultat au format nombre flottant double précision (FLOAT64). Il est donc possible d'enchaîner ce résultat avec d'autres calculs numériques ou transformations.
• Équivalent de LOG(X, 10) : La fonction LOG10(X) est en réalité équivalente à LOG(X, 10), ce qui la rend plus concise et lisible dans les cas où la base est toujours 10. Cela évite d'écrire des appels plus longs tout en garantissant le même résultat mathématique.
• Attention aux erreurs sur les bornes inférieures : Si l'on ne vérifie pas la validité de X, en particulier si la donnée provient d'une source externe, LOG10 peut provoquer des erreurs inattendues. Utiliser SAFE.LOG10(X) permet de retourner NULL en cas de valeur invalide au lieu d'interrompre l'exécution de la requête.
• Utile pour classer ou filtrer des données par ordre de grandeur : Grâce à LOG10, on peut transformer des valeurs en puissances de 10 pour les grouper, les regrouper par intervalles logarithmique (exemple : FLOOR(LOG10(X))), ou encore créer des catégories d'échelle pour des histogrammes, des segments marketing ou des analyses de marché.