From: Mike Bayer Date: Thu, 16 Apr 2026 20:02:37 +0000 (-0400) Subject: doc edits X-Git-Tag: rel_2_1_0b2~1 X-Git-Url: http://git.ipfire.org/gitweb/?a=commitdiff_plain;h=e5ec8f3b0a10c59413126bc41dc3c3f63d8a6621;p=thirdparty%2Fsqlalchemy%2Fsqlalchemy.git doc edits Change-Id: I2a30ceba5d27eba858396ab98ccb25e62d3dc3dc --- diff --git a/doc/build/changelog/unreleased_21/11526.rst b/doc/build/changelog/unreleased_21/11526.rst index 61930d0e34..bbff86fc72 100644 --- a/doc/build/changelog/unreleased_21/11526.rst +++ b/doc/build/changelog/unreleased_21/11526.rst @@ -2,7 +2,7 @@ :tags: bug, sql :tickets: 11526 - A warning is emitted when using the standalone :func:`_.sql.distinct` + A warning is emitted when using the standalone :func:`_sql.distinct` function in a :func:`_sql.select` columns list outside of an aggregate function; this function is not intended as a replacement for the use of :meth:`.Select.distinct`. Pull request courtesy bekapono. diff --git a/doc/build/changelog/unreleased_21/11671.rst b/doc/build/changelog/unreleased_21/11671.rst index a9ab9ac731..cf3101f385 100644 --- a/doc/build/changelog/unreleased_21/11671.rst +++ b/doc/build/changelog/unreleased_21/11671.rst @@ -2,8 +2,7 @@ :tags: usecase, sql :tickets: 11671 - Add the `exclude` parameter to the `Over` construct and all `.over()` - methods, enabling SQL standard frame exclusion clauses - `EXCLUDE CURRENT ROW`, `EXCLUDE GROUP`, `EXCLUDE TIES`, - `EXCLUDE NO OTHERS` in window functions. - Pull request courtesy of Varun Chawla. \ No newline at end of file + Added new parameter :paramref:`_sql.over.exclude` to :func:`_sql.over` and + related methods, enabling SQL standard frame exclusion clauses ``EXCLUDE + CURRENT ROW``, ``EXCLUDE GROUP``, ``EXCLUDE TIES``, ``EXCLUDE NO OTHERS`` + in window functions. Pull request courtesy of Varun Chawla. diff --git a/doc/build/changelog/unreleased_21/12869.rst b/doc/build/changelog/unreleased_21/12869.rst index 173ec53d49..6c7858f436 100644 --- a/doc/build/changelog/unreleased_21/12869.rst +++ b/doc/build/changelog/unreleased_21/12869.rst @@ -7,5 +7,5 @@ .. seealso:: - :ref:`change_12869` + :ref:`mssql_python` - Documentation for the mssql-python dialect diff --git a/lib/sqlalchemy/sql/_elements_constructors.py b/lib/sqlalchemy/sql/_elements_constructors.py index 5d596525d1..4816d172b9 100644 --- a/lib/sqlalchemy/sql/_elements_constructors.py +++ b/lib/sqlalchemy/sql/_elements_constructors.py @@ -1725,11 +1725,12 @@ def over( .. versionadded:: 2.0.40 - :param exclude: optional string for the frame exclusion clause. - This is a string value which can be one of ``CURRENT ROW``, - ``GROUP``, ``TIES``, or ``NO OTHERS`` and will render an - EXCLUDE clause within the window frame specification. Requires - that one of ``rows``, ``range_``, or ``groups`` is also specified. + :param exclude: optional string for the frame exclusion clause. This is a + string value which can be one of ``CURRENT ROW``, ``GROUP``, ``TIES``, or + ``NO OTHERS`` and will render an EXCLUDE clause within the window frame + specification. Requires that one of :paramref:`_sql.over.rows`, + :paramref:`_sql.over.range_`, or :paramref:`_sql.over.groups` is also + specified. .. versionadded:: 2.1