- add a note, references #3487

diff --git a/lib/sqlalchemy/dialects/postgresql/base.py b/lib/sqlalchemy/dialects/postgresql/base.py
index 22c66dbbb402957eeb7cae6103a418dca0920e5f..dc7987d74181e7a91bf7162ddb1c9c0cf8c282c0 100644 (file)
--- 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.::