From 05459b1c8fcfc9e33888687a3499987d48901537 Mon Sep 17 00:00:00 2001 From: Matthew Peveler Date: Sun, 28 Mar 2021 13:00:33 -0400 Subject: [PATCH] add MySQL limitation section to docs Signed-off-by: Matthew Peveler --- docs/en/configuration.rst | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/docs/en/configuration.rst b/docs/en/configuration.rst index 4dc4bbf3d..376829373 100644 --- a/docs/en/configuration.rst +++ b/docs/en/configuration.rst @@ -346,6 +346,16 @@ For example, to set the above example options: By default, the only attribute that Phinx sets is ``\PDO::ATTR_ERRMODE`` to ``PDO::ERRMODE_EXCEPTION``. It is not recommended to override this. +MySQL +````````````````` + +The MySQL adapter has an unfortunate limitation in that it certain actions causes an +`implicit commit `_ regardless of transaction +state. Notably this list includes ``CREATE TABLE``, ``ALTER TABLE``, and ``DROP TABLE``, which are the most +common operations that Phinx will run. This means that unlike other adapters which will attempt to gracefully +rollback a transaction on a failed migration, if a migration fails for MySQL, it may leave your DB in a partially +migrated state. + SQLite `````````````````