Re: Documentation error in tutorial page for Window Functions - Mailing list pgsql-docs

From Scott Preschern
Subject Re: Documentation error in tutorial page for Window Functions
Date
Msg-id CAGDjFt_0P_+-Hfp144iDYHb0oWogAYqQZ2LYzABGPunRSVOmPA@mail.gmail.com
Whole thread Raw
In response to Re: Documentation error in tutorial page for Window Functions  ("David G. Johnston" <david.g.johnston@gmail.com>)
List pgsql-docs
Thanks, I see now. Then I'll suggest this clarification instead:

"The rank function produces a numerical rank for each distinct value in the ORDER BY clause within the current row's partition. In this example, ranks are incremented in order of salary within each partition of depname. If the ORDER BY clause refers to multiple columns, the rank is incremented at each unique combination of those columns. rank needs no explicit parameter, because its behavior is entirely determined by the OVER clause."

Scott

On Mon, Nov 11, 2024 at 5:39 AM David G. Johnston <david.g.johnston@gmail.com> wrote:


On Sunday, November 10, 2024, PG Doc comments form <noreply@postgresql.org> wrote:
The following documentation comment has been logged on the website:

Page: https://www.postgresql.org/docs/17/tutorial-window.html
Description:

In Section 3.5 Window Functions, the sentence that currently says:
"As shown here, the rank function produces a numerical rank for each
distinct ORDER BY value in the current row's partition..."

should say:
"As shown here, the rank function produces a numerical rank for each
distinct depname value in the current row's partition..."

https://www.postgresql.org/docs/current/tutorial-window.html

If we wanted to name the relevant column it would be salary, not depname. It is the column(s) in the order by that matter here.  Or I suppose the combination of depname and salary.  Though it was already covered that each partition resets all aggregates.  Here we are not talking about reset but when something increments.

David J.

pgsql-docs by date:

Previous
From: Alvaro Herrera
Date:
Subject: Re: CREATE UNIQUE INDEX name ON table (column [, ...]) [ NULLS [ NOT ] DISTINCT ];
Next
From: Bear Giles
Date:
Subject: Re: Improved security for https://www.postgresql.org/docs/current/install-make.html