From: Mike Bayer <mike_mp@zzzcomputing.com>
Date: Mon, 12 Sep 2016 22:36:01 +0000 (-0400)
Subject: - also caveats for update() / delete() regarding single
X-Git-Tag: rel_1_0_16~29
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=992344334328dba385fe6aa7694cfe3c13adc9d6;p=thirdparty%2Fsqlalchemy%2Fsqlalchemy.git

- also caveats for update() / delete() regarding single
table inheritance

Change-Id: If1511812a22a53537409f902f73e2e52ae3e4a3d
---

diff --git a/lib/sqlalchemy/orm/query.py b/lib/sqlalchemy/orm/query.py
index bbb6cd5193..2b2b110955 100644
--- a/lib/sqlalchemy/orm/query.py
+++ b/lib/sqlalchemy/orm/query.py
@@ -3050,6 +3050,11 @@ class Query(object):
               mappings unless you have taken the additional steps to make
               this feasible**.
 
+            * The polymorphic identity WHERE criteria is **not** included
+              for single- or
+              joined- table updates - this must be added **manually** even
+              for single table inheritance.
+
             * The method does **not** offer in-Python cascading of
               relationships - it is assumed that ON DELETE CASCADE/SET
               NULL/etc. is configured for any foreign key references
@@ -3207,6 +3212,11 @@ class Query(object):
                         filter(Employee.name == 'dilbert').\\
                         update({"engineer_type": "programmer"})
 
+            * The polymorphic identity WHERE criteria is **not** included
+              for single- or
+              joined- table updates - this must be added **manually**, even
+              for single table inheritance.
+
             * The :meth:`.MapperEvents.before_update` and
               :meth:`.MapperEvents.after_update`
               events **are not invoked from this method**.  Instead, the