ACOS

Syntaxe

Paramètres

Description

Cette fonction permet de demander l'arc cosinus en radian de la valeur spécifié.

Remarques

• La fonction ACOS retourne un angle exprimé en radians, et non en degrés : Cela signifie que le résultat est compris entre 0 (pour une valeur de 1) et π (pour une valeur de -1). Pour obtenir un angle en degrés, il faut convertir manuellement le résultat à l'aide d'une multiplication par 180/PI().
• Le paramètre X doit obligatoirement être compris entre -1 et 1 inclus, sans quoi la fonction retournera une erreur ou NULL : Cette contrainte vient des propriétés mathématiques de la fonction arc cosinus, qui n'est définie que dans ce domaine. Pour éviter des erreurs d'exécution, il est recommandé de valider ou de normaliser les valeurs avant l'appel.
• La fonction ACOS est souvent utilisée en combinaison avec d'autres fonctions trigonométriques ou géométriques : Par exemple, elle peut être utilisée pour calculer l'angle entre deux vecteurs à partir de leur produit scalaire normalisé. Cela en fait une fonction essentielle dans des domaines comme la géométrie analytique, la navigation ou l'analyse spatiale.
• Lorsque le paramètre X est NULL, la fonction retourne également NULL, conformément au comportement standard dans BigQuery : Ce comportement permet une bonne intégration dans des calculs complexes, mais il peut être nécessaire de gérer ces cas avec des fonctions comme IFNULL() pour éviter des résultats incomplets dans des colonnes calculées.
• L'utilisation de ACOS peut mener à des erreurs silencieuses si les valeurs fournies ne sont pas explicitement contrôlées : Par exemple, un arrondi ou une imprécision flottante peut entraîner une valeur très légèrement supérieure à 1, ce qui fera échouer la fonction. Il est souvent judicieux de borner la valeur avec LEAST(1, GREATEST(-1, X)) avant le calcul.
• Le résultat de ACOS(X) est toujours un nombre réel positif compris entre 0 et π radians : Cela garantit que les angles renvoyés représentent toujours la position dans le demi-cercle supérieur d'un cercle trigonométrique, ce qui peut être utile dans des visualisations ou des traitements angulaires.
• Dans les calculs géographiques, ACOS peut être employée dans la formule de Haversine (ou d'autres formules) pour calculer des distances sur une sphère : Cette utilisation est particulièrement courante lorsqu'on veut mesurer la distance entre deux points avec leurs latitudes et longitudes. Il faut toutefois veiller à la précision des coordonnées et aux conversions radian/degré.
• Il est important de noter que la fonction ACOS en SQL (y compris dans BigQuery) repose sur des approximations numériques internes : Ces approximations peuvent parfois donner des résultats très légèrement imprécis, surtout à proximité des bornes -1 ou 1. Cela ne pose pas de problème dans la majorité des cas, mais peut affecter les applications de haute précision (ex : modélisation physique ou scientifique).