Skip to content


Subversion checkout URL

You can clone with
Download ZIP
A MySQL Schema Versioning and Migration Utility
Latest commit 9c9655e @mmatuson Merge pull request #19 from dannykopping/master
Updated Sakila link in README


Schema Sync v0.9.2
a MySQL schema synchronization utility

schemasync [options] <source> <target>

# source/target format: mysql://user:pass@host:port/database
# output format: <database>[_<tag>].YYYYMMDD.(patch|revert)[_<version>].sql

Schema Sync will generate the SQL necessary to migrate the schema of a source database to a target database (patch script), as well as a the SQL necessary to undo the changes after you apply them (revert script).

* Schema Sync does not alter your database. It only generates the .sql files containing the differences. You must apply the changes. 
* Schema Sync does not yet recognize Tables or Columns that have been renamed. A rename will result in the old table or column being dropped and the new one added. 
* All ADD|MODIFY COLUMN statements have the AFTER (or FIRST) SQL syntax even if no move is required. 
* COMMENTS and AUTO_INCREMENT values are not by synced by default. See help (-h) for details.
* Partitions (MySQL 5.1+) are not yet supported

-h, --help            show this help message and exit
-V, --version         show version and exit.
-r, --revision        increment the migration script version number
                      if a file with the same name already exists.
-a, --sync-auto-inc   sync the AUTO_INCREMENT value for each table.
-c, --sync-comments   sync the COMMENT field for all tables AND columns
--tag=TAG             tag the migration scripts as <database>_<tag>. 
                      Valid characters include [A-Za-z0-9-_]
                    directory to write the migration scrips. 
                    The default is current working directory. 
                    Must use absolute path if provided.
                    set the directory to write the log to. 
                    Must use absolute path if provided. 
                    Default is output directory. 
                    Log filename is schemasync.log

Download and Install

* To run Schema Sync, you need to have:
    - Python 2.4, 2.5, or 2.6
    - MySQL <>, version 5.0 or higher
    - MySQLdb <>, version 1.2.1p2 or higher
    - SchemaObject <> 0.5.3 or higher
* To run the test suite, you need to install a copy of the Sakila Database <>, version 0.8

Standard Installation
For installation instructions, see

Status & License
Schema Sync is under active development and released under the Apache License, Version 2.0 <>. 

You can obtain a copy of the latest source code from the Git repository <>, or fork it on Github <>.

You can report bugs via the Schema Sync Issues page <>

Comments, questions, and feature requests can be sent to code at matuson com
Something went wrong with that request. Please try again.