summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorDavid Sanders <shang.xiao.sanders@gmail.com>2024-04-17 02:11:06 +1000
committerGitHub <noreply@github.com>2024-04-16 13:11:06 -0300
commitf0d50a937910571fc4adb7e6fb91045cdc215aa8 (patch)
tree719cdbecbf4312ab9a0d35ce4cb6c84d5ed5a602 /docs
parentd048f0d311cc9cb9578d687968f2d24a0a9efddb (diff)
Doc'd that RemoveField also drops related database objects in PostgreSQL.
Diffstat (limited to 'docs')
-rw-r--r--docs/ref/migration-operations.txt10
1 files changed, 10 insertions, 0 deletions
diff --git a/docs/ref/migration-operations.txt b/docs/ref/migration-operations.txt
index cd852f537d..9e90b78623 100644
--- a/docs/ref/migration-operations.txt
+++ b/docs/ref/migration-operations.txt
@@ -195,6 +195,16 @@ if the field is nullable or if it has a default value that can be used to
populate the recreated column. If the field is not nullable and does not have a
default value, the operation is irreversible.
+.. admonition:: PostgreSQL
+
+ ``RemoveField`` will also delete any additional database objects that are
+ related to the removed field (like views, for example). This is because the
+ resulting ``DROP COLUMN`` statement will include the ``CASCADE`` clause to
+ ensure `dependent objects outside the table are also dropped`_.
+
+.. _dependent objects outside the table are also dropped: https://www.postgresql.org/docs/current/sql-altertable.html#SQL-ALTERTABLE-PARMS-CASCADE
+
+
``AlterField``
--------------