This page is a quick reference checkpoint for CUME_DIST in BigQuery: behavior, syntax rules, edge cases, and a minimal example; plus the official vendor documentation.
CUME_DIST returns the cumulative distribution, showing the proportion of rows with values less than or equal to the current row.
Returns the relative rank of a row defined as NP/NR, where NP = number of rows that precede or are peers with the current row, and NR = total rows in the partition.
If this behavior feels unintuitive, the tutorial below explains the underlying pattern step-by-step.
CUME_DIST() OVER (window_clause)
SELECT division, runner_name, finish_time, CUME_DIST() OVER (PARTITION BY division ORDER BY finish_time) AS finish_rank FROM race_results;
If you came here to confirm syntax, you’re done. If you came here to get better at window functions, choose your next step.
CUME_DIST is part of a bigger window-function pattern. If you want the “why”, start here: Percentile Distribution
Reading docs is useful. Writing the query correctly under pressure is the skill.
For the authoritative spec, use the vendor docs. This page is the fast “sanity check”.
View BigQuery Documentation →Looking for more functions across all SQL dialects? Visit the full SQL Dialects & Window Functions Documentation.