From: Mike Bayer <mike_mp@zzzcomputing.com>
Date: Wed, 25 Jan 2017 14:34:41 +0000 (-0500)
Subject: - add a note that alter_column->postgresql_using is raw SQL,
X-Git-Tag: rel_0_9_0~17
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=e52106e91c6fbf0c5f12c5c81d9df62f517034a1;p=thirdparty%2Fsqlalchemy%2Falembic.git

- add a note that alter_column->postgresql_using is raw SQL,
fixes #408

Change-Id: Ia569191d43d49178f78a7bcef458b671f750583e
---

diff --git a/alembic/operations/ops.py b/alembic/operations/ops.py
index f892227c..8957982c 100644
--- a/alembic/operations/ops.py
+++ b/alembic/operations/ops.py
@@ -1399,7 +1399,9 @@ class AlterColumnOp(AlterTableOp):
 
         :param postgresql_using: String argument which will indicate a
          SQL expression to render within the Postgresql-specific USING clause
-         within ALTER COLUMN.
+         within ALTER COLUMN.    This string is taken directly as raw SQL which
+         must explicitly include any necessary quoting or escaping of tokens
+         within the expression.
 
          .. versionadded:: 0.8.8