Altering Schemas through Migrations
-----------------------------------
- While SQLAlchemy directly supports emitting CREATE and DROP statements for schema
- constructs, the ability to alter those constructs, usually via the ALTER statement
- as well as other database-specific constructs, is outside of the scope of SQLAlchemy
- itself. While it's easy enough to emit ALTER statements and similar by hand,
- such as by passing a string to :meth:`.Connection.execute` or by using the
- :class:`.DDL` construct, it's a common practice to automate the maintenance of
- database schemas in relation to application code using schema migration tools.
+ While SQLAlchemy directly supports emitting CREATE and DROP statements for
+ schema constructs, the ability to alter those constructs, usually via the ALTER
+ statement as well as other database-specific constructs, is outside of the
+ scope of SQLAlchemy itself. While it's easy enough to emit ALTER statements
+ and similar by hand, such as by passing a :func:`.text` construct to
+ :meth:`.Connection.execute` or by using the :class:`.DDL` construct, it's a
+ common practice to automate the maintenance of database schemas in relation to
+ application code using schema migration tools.
-There are two major migration tools available for SQLAlchemy:
-
-* `Alembic <https://alembic.sqlalchemy.org>`_ - Written by the author of SQLAlchemy,
- Alembic features a highly customizable environment and a minimalistic usage pattern,
- supporting such features as transactional DDL, automatic generation of "candidate"
- migrations, an "offline" mode which generates SQL scripts, and support for branch
- resolution.
-* `SQLAlchemy-Migrate <https://github.com/openstack/sqlalchemy-migrate>`_ - The original
- migration tool for SQLAlchemy, SQLAlchemy-Migrate is still used by projects
- such as Openstack, however is being superseded by Alembic.
+The SQLAlchemy project offers the `Alembic <https://alembic.sqlalchemy.org>`_
+migration tool for this purpose. Alembic features a highly customizable
+environment and a minimalistic usage pattern, supporting such features as
+transactional DDL, automatic generation of "candidate" migrations, an "offline"
+mode which generates SQL scripts, and support for branch resolution.
+
+Alembic supersedes the `SQLAlchemy-Migrate
+<https://github.com/openstack/sqlalchemy-migrate>`_ project, which is the
+original migration tool for SQLAlchemy and is now considered legacy.
Specifying the Schema Name