From: Mike Bayer <mike_mp@zzzcomputing.com>
Date: Wed, 15 Jul 2015 17:07:32 +0000 (-0400)
Subject: - add a note, references #3487
X-Git-Tag: rel_1_0_7~15
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=eed8bcef3ae1341cc9c25f5abff55a9ff880cfac;p=thirdparty%2Fsqlalchemy%2Fsqlalchemy.git

- add a note, references #3487
---

diff --git a/lib/sqlalchemy/dialects/postgresql/base.py b/lib/sqlalchemy/dialects/postgresql/base.py
index 22c66dbbb4..dc7987d741 100644
--- a/lib/sqlalchemy/dialects/postgresql/base.py
+++ b/lib/sqlalchemy/dialects/postgresql/base.py
@@ -883,6 +883,16 @@ class ARRAY(sqltypes.Concatenable, sqltypes.TypeEngine):
             mytable.c.data[2:7]: [1, 2, 3]
         })
 
+    .. note::
+
+        Multi-dimensional support for the ``[]`` operator is not supported
+        in SQLAlchemy 1.0.  Please use the :func:`.type_coerce` function
+        to cast an intermediary expression to ARRAY again as a workaround::
+
+            expr = type_coerce(my_array_column[5], ARRAY(Integer))[6]
+
+        Multi-dimensional support will be provided in a future release.
+
     :class:`.ARRAY` provides special methods for containment operations,
     e.g.::