REDROOM

Navigation

Breadcrumbs

Create

Edit File Size: 1.87 KB

/opt/alt/python37/share/doc/alt-python37-alembic/docs/build/ops.rst

Text Base64

.. _ops:

===================
Operation Reference
===================

This file provides documentation on Alembic migration directives.

The directives here are used within user-defined migration files,
within the ``upgrade()`` and ``downgrade()`` functions, as well as
any functions further invoked by those.

All directives exist as methods on a class called :class:`.Operations`.
When migration scripts are run, this object is made available
to the script via the ``alembic.op`` datamember, which is
a *proxy* to an actual instance of :class:`.Operations`.
Currently, ``alembic.op`` is a real Python module, populated
with individual proxies for each method on :class:`.Operations`,
so symbols can be imported safely from the ``alembic.op`` namespace.

The :class:`.Operations` system is also fully extensible.  See
:ref:`operation_plugins` for details on this.

A key design philosophy to the :ref:`alembic.operations.toplevel` methods is that
to the greatest degree possible, they internally generate the
appropriate SQLAlchemy metadata, typically involving
:class:`~sqlalchemy.schema.Table` and :class:`~sqlalchemy.schema.Constraint`
objects.  This so that migration instructions can be
given in terms of just the string names and/or flags involved.
The exceptions to this
rule include the :meth:`~.Operations.add_column` and :meth:`~.Operations.create_table`
directives, which require full :class:`~sqlalchemy.schema.Column`
objects, though the table metadata is still generated here.

The functions here all require that a :class:`.MigrationContext` has been
configured within the ``env.py`` script first, which is typically
via :meth:`.EnvironmentContext.configure`.   Under normal
circumstances they are called from an actual migration script, which
itself would be invoked by the :meth:`.EnvironmentContext.run_migrations`
method.

.. automodule:: alembic.operations
	:members: Operations, BatchOperations

Exit & Reset Text mode: syntax highlighting auto-detects file type.

Name	Size	Perms	Modified	Actions
api DIR	-	drwxr-xr-x	2023-12-06 03:19:41	Edit Download recursive recursive
_static DIR	-	drwxr-xr-x	2023-12-06 03:19:41	Edit Download recursive recursive
autogenerate.rst	17.36 KB	lrw-r--r--	2015-10-16 19:18:36	Edit Download recursive recursive
batch.rst	14.09 KB	lrw-r--r--	2015-10-16 19:18:36	Edit Download recursive recursive
branches.rst	35.21 KB	lrw-r--r--	2015-10-16 19:18:36	Edit Download recursive recursive
changelog.rst	88.86 KB	lrw-r--r--	2015-10-16 19:19:20	Edit Download recursive recursive
conf.py	7.23 KB	lrw-r--r--	2015-10-16 19:18:36	Edit Download recursive recursive
cookbook.rst	29.83 KB	lrw-r--r--	2015-10-16 19:18:36	Edit Download recursive recursive
front.rst	2.39 KB	lrw-r--r--	2015-10-16 19:18:36	Edit Download recursive recursive
index.rst	537 B	lrw-r--r--	2015-10-16 19:18:36	Edit Download recursive recursive
Makefile	3.23 KB	lrw-r--r--	2015-10-16 19:18:36	Edit Download recursive recursive
naming.rst	8.92 KB	lrw-r--r--	2015-10-16 19:18:36	Edit Download recursive recursive
offline.rst	5.49 KB	lrw-r--r--	2015-10-16 19:18:36	Edit Download recursive recursive
ops.rst	1.87 KB	lrw-r--r--	2015-10-16 19:18:36	Edit Download recursive recursive
requirements.txt	89 B	lrw-r--r--	2015-10-16 19:18:36	Edit Download recursive recursive
tutorial.rst	20.74 KB	lrw-r--r--	2015-10-16 19:18:36	Edit Download recursive recursive

Directory Contents