Update SUM function syntax and OVER clause details - #10391
Update SUM function syntax and OVER clause details#10391Gabriel Donizeti Candido (donican) wants to merge 2 commits into
Conversation
Added row_or_range_clause to the SUM function syntax and updated the OVER clause description to include its default behavior.
|
Gabriel Donizeti Candido (@donican) : Thanks for your contribution! The author(s) and reviewer(s) have been notified to review your proposed change. |
|
Gabriel Donizeti Candido (@donican) : Thanks for your contribution! The author(s) and reviewer(s) have been notified to review your proposed change. |
|
Learn Build status updates of commit 9024494: ✅ Validation status: passed
For more details, please refer to the build report. |
Clarified the requirements for order_by_clause and row_or_range_clause in the OVER clause section.
|
Learn Build status updates of commit 6dd7423: ✅ Validation status: passed
For more details, please refer to the build report. |
|
Randolph West MSFT (@rwestMSFT) - Can you review the proposed changes? IMPORTANT: When the changes are ready for publication, adding a #label:"aq-pr-triaged" |
prmerger-automator
Bot
added
the
aq-pr-triaged
There was a problem hiding this comment.
🟡 Changes recommended
Qualify the new syntax for platforms that do not support window frames.
Get a fresh assessment by requesting another Copilot review.
Pull request overview
Updates SUM (Transact-SQL) documentation with ROWS/RANGE window-frame syntax and default behavior.
Changes:
- Adds optional window-frame syntax to analytic
SUM. - Documents
ORDER BYrequirements and defaultRANGEbehavior.
File summaries
| File | Summary |
|---|---|
docs/t-sql/functions/sum-transact-sql.md |
Documents ROWS/RANGE support and window-frame defaults; platform-specific syntax qualification remains needed for APS/PDW. |
Review details
- Files reviewed: 1/1 changed files
- Comments generated: 1
- Review effort level: Lite
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
|
|
||
| -- Analytic Function Syntax | ||
| SUM ( [ ALL ] expression) OVER ( [ partition_by_clause ] [ order_by_clause ] ) | ||
| SUM ( [ ALL ] expression) OVER ( [ partition_by_clause ] [ order_by_clause ] [row_or_range_clause] ) |
This article doesn't mention that the OVER clause can include the ROWS or RANGE clause. I believe this is particularly important because when the ORDER BY clause is specified, ROWS or RANGE assumes its default value, which can then be explicitly changed by the user. My suggested change clarifies this point.