CEILING

Syntaxe

Paramètres

Description

Cette fonction permet de demander la valeur maximale d'un nombre, soit l'entier le plus proche supérieur ou égal au nombre. Cette fonction est un alias de la fonction CEIL.

Remarques

• Alias direct de la fonction CEIL : CEILING(X) est strictement équivalente à CEIL(X) dans BigQuery. Les deux fonctions effectuent exactement le même calcul : retourner l'entier le plus proche, supérieur ou égal à la valeur fournie. Il s'agit d'une question de préférence syntaxique ou de lisibilité du code.
• Nom plus explicite que CEIL dans certains contextes : Le nom CEILING est parfois préféré dans les scripts SQL pour sa clarté sémantique : il évoque plus clairement l'idée d'un plafond, ou d'une valeur « arrondie vers le haut ». Cela peut améliorer la compréhension pour des lecteurs non familiers avec les abréviations.
• Comportement identique pour tous les types numériques supportés : Comme CEIL, CEILING accepte les types numériques FLOAT64, NUMERIC et BIGNUMERIC. Le résultat est l'entier minimal qui est supérieur ou égal à la valeur fournie, quelle que soit la complexité de sa partie décimale.
• Utile pour garantir une couverture minimale : Dans des situations où un calcul ne doit jamais sous-estimer la valeur réelle - comme des arrondis de durée, de distance ou de prix - CEILING permet d'éviter toute perte. Exemple : pour calculer le nombre de pages nécessaires à imprimer 253 lignes avec 50 lignes par page, on peut utiliser CEILING(253 / 50).
• Comportement logique avec les entiers et les nombres déjà arrondis : Si la valeur fournie est déjà un entier, CEILING la retourne telle quelle. Par exemple, CEILING(5.0) donne 5. Ce comportement permet d'utiliser cette fonction sans se soucier d'une éventuelle déformation des données déjà arrondies.
• Gestion cohérente des valeurs négatives : CEILING retourne toujours l'entier immédiatement supérieur, même pour les nombres négatifs. Ainsi, CEILING(-3.7) retourne -3. Cela respecte la définition mathématique du plafond, ce qui est important dans des logiques de calcul rigoureuses.
• Peut être combinée avec d'autres fonctions numériques : CEILING est souvent utilisée avec des divisions, multiplications ou calculs de pourcentages pour garantir un résultat entier supérieur, surtout lorsqu'on ne souhaite pas arrondir à l'unité inférieure ou à l'unité la plus proche. Elle peut être intégrée facilement dans des expressions complexes.
• Aucune différence de performance entre CEIL et CEILING : Puisque CEILING est simplement un alias de CEIL, les deux fonctions ont exactement les mêmes performances en exécution. Le choix entre les deux dépend donc purement de la lisibilité ou des conventions adoptées dans l'équipe ou le projet.