https://github.com/lwch/mysqlschema

mysql migration tools for golang
https://github.com/lwch/mysqlschema

Last synced: 2 months ago
JSON representation

mysql migration tools for golang

• Host: GitHub
• URL: https://github.com/lwch/mysqlschema
• Owner: lwch
• License: mit
• Created: 2021-04-28T07:56:24.000Z (about 4 years ago)
• Default Branch: master
• Last Pushed: 2022-05-30T09:38:28.000Z (almost 3 years ago)
• Last Synced: 2025-01-03T17:27:53.834Z (4 months ago)
• Language: Go
• Homepage:
• Size: 8.79 KB
• Stars: 2
• Watchers: 2
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# mysqlschema

mysql migration tools for golang

## Installation

    go get github.com/lwch/mysqlschema

## Usage

1. open connection by [go-sql-driver](https://github.com/go-sql-driver/mysql)

2. call Build function and input schema directory

        db, _ := sql.Open("mysql", fmt.Sprintf("%s:%s@tcp(%s:%d)/%s?loc=Local",

            dbUser, dbPass, dbHost, dbPort, dbName))

        defer db.Close()

        Build(db, "testdata", true)

## Directory

    .

    └── table1             # this is the table name

        ├── data           # data scripts

        │   └── v1.sql

        └── schema         # schema scripts

            ├── latest.sql # create table if not exists

            └── v1.sql

## How work

1. create table `__tb_schema__` for saving current schema versions

2. create table `__tb_schema_logs__` for logging schema upgrade

3. load each table version in `__tb_schema__`

4. range each table by given directory

5. build schema

   * if current table is not exists, create table by latest.sql

   * otherwise range v*.sql higher than current version

   * sort by version and upgrade

   * insert or update `__tb_schema__.schema_version`

   * insert `__tb_schema_logs__`

6. build data

   * range v*.sql higher than current version

   * sort by version and upgrade

   * insert or update `__tb_schema__.data_version`

   * insert `__tb_schema_logs__`

7. ``__tb_schema__ and __tb_schema_logs__ table is the protected table, so you can not use this table``

8. ``v0.sql is the protected file, so you can not define this version``

9. ``each sql operation will be the table name in sql file``