]> git.ipfire.org Git - thirdparty/sqlalchemy/sqlalchemy.git/commitdiff
Merge "Deprecate plain string in execute and introduce `exec_driver_sql`"
authormike bayer <mike_mp@zzzcomputing.com>
Sun, 22 Mar 2020 15:04:59 +0000 (15:04 +0000)
committerGerrit Code Review <gerrit@bbpush.zzzcomputing.com>
Sun, 22 Mar 2020 15:04:59 +0000 (15:04 +0000)
1  2 
doc/build/core/metadata.rst

index 3d219ec069832f286c15cb502a426e5fb88f81b2,e4dcc071d7c8d25b5442c3f8d34c2d1d141bde4e..c5865ae27dc373f0dd7c3d7c343d0f6347ab2201
@@@ -233,23 -233,25 +233,24 @@@ To enable the "check first for the tabl
  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