--- /dev/null
+.. change::
+ :tags: change, general
+ :tickets: 8983
+
+ A new deprecation "uber warning" is now emitted at once at runtime, the
+ first time any SQLAlchemy 2.0 deprecation warning would normally be
+ emitted, but the ``SQLALCHEMY_WARN_20`` environment variable is not set.
+ This deprecation warning intends to notify users who may not have set an
+ appropriate constraint in their requirements files to block against a
+ surprise SQLAlchemy 2.0 upgrade and also alert that the SQLAlchemy 2.0
+ upgrade process is available, as the first full 2.0 release is expected
+ very soon. The deprecation warning can be silenced by setting the
+ environment variable ``SQLALCHEMY_SILENCE_UBER_WARNING`` to ``"1"``.
+
+ .. seealso::
+
+ :ref:`migration_20_toplevel`
:versions: 2.0.0rc1
Fixed bug where the PostgreSQL
- :paramref:`_postgresql.OnConflictClause.constraint` parameter would accept
- an :class:`.Index` object, however would not expand this index out into its
- individual index expressions, instead rendering its name in an ON CONFLICT
- ON CONSTRAINT clause, which is not accepted by PostgreSQL; the "constraint
- name" form only accepts unique or exclude constraint names. The parameter
- continues to accept the index but now expands it out into its component
- expressions for the render.
+ :paramref:`_postgresql.Insert.on_conflict_do_update.constraint` parameter
+ would accept an :class:`.Index` object, however would not expand this index
+ out into its individual index expressions, instead rendering its name in an
+ ON CONFLICT ON CONSTRAINT clause, which is not accepted by PostgreSQL; the
+ "constraint name" form only accepts unique or exclude constraint names. The
+ parameter continues to accept the index but now expands it out into its
+ component expressions for the render.