Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 5 additions & 3 deletions README.rst
Original file line number Diff line number Diff line change
Expand Up @@ -158,12 +158,14 @@ primary key:
)

As Spanner restricts changing a primary key value, not setting the flag
to ``False`` can cause migration problems.
to ``False`` can cause migration problems.

Also notice that DDL statements in Spanner are not transactional and will not be automatically reverted in case of a migration fail.
Copy link
Contributor Author

@IlyaFaer IlyaFaer Aug 18, 2022

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Let's add a small note about DDLs into this section as well to make sure users understand the mechanism


| **Warning!**
| A migration script can produce a lot of DDL statements. If each of the
statements are executed separately, performance issues can occur. To
avoid these, it's highly recommended to use the `Alembic batch
statements is executed separately, performance issues can occur. To
avoid it, it's highly recommended to use the `Alembic batch
context <https://alembic.sqlalchemy.org/en/latest/batch.html>`__
feature to pack DDL statements into groups of statements.

Expand Down