From: Mike Bayer Date: Fri, 19 Sep 2025 14:32:43 +0000 (-0400) Subject: clarify clauses argument for order_by, group_by X-Git-Tag: rel_2_0_44~26 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=0aeaaccf3e914217475f5e24553231aeb7deb90f;p=thirdparty%2Fsqlalchemy%2Fsqlalchemy.git clarify clauses argument for order_by, group_by Change-Id: Idabfde4a6850a2649a2f32dc42d0320f1ec7692d (cherry picked from commit 38008698207dc3703f2565aa8b41f95596724272) --- diff --git a/lib/sqlalchemy/sql/selectable.py b/lib/sqlalchemy/sql/selectable.py index 9e7c647d93..fc60436bbb 100644 --- a/lib/sqlalchemy/sql/selectable.py +++ b/lib/sqlalchemy/sql/selectable.py @@ -4392,8 +4392,13 @@ class GenerativeSelect(DialectKWArgs, SelectBase, Generative): stmt = stmt.order_by(None).order_by(new_col) :param \*clauses: a series of :class:`_expression.ColumnElement` - constructs - which will be used to generate an ORDER BY clause. + constructs which will be used to generate an ORDER BY clause. + + Alternatively, an individual entry may also be the string name of a + label located elsewhere in the columns clause of the statement which + will be matched and rendered in a backend-specific way based on + context; see :ref:`tutorial_order_by_label` for background on string + label matching in ORDER BY and GROUP BY expressions. .. seealso:: @@ -4433,8 +4438,13 @@ class GenerativeSelect(DialectKWArgs, SelectBase, Generative): stmt = select(table.c.name, func.max(table.c.stat)).group_by(table.c.name) :param \*clauses: a series of :class:`_expression.ColumnElement` - constructs - which will be used to generate an GROUP BY clause. + constructs which will be used to generate an GROUP BY clause. + + Alternatively, an individual entry may also be the string name of a + label located elsewhere in the columns clause of the statement which + will be matched and rendered in a backend-specific way based on + context; see :ref:`tutorial_order_by_label` for background on string + label matching in ORDER BY and GROUP BY expressions. .. seealso::