https://github.com/altipla-consulting/migrator

Apply SQL migrations from a folder.
https://github.com/altipla-consulting/migrator

migrations mysql

Last synced: about 1 month ago
JSON representation

Apply SQL migrations from a folder.

• Host: GitHub
• URL: https://github.com/altipla-consulting/migrator
• Owner: altipla-consulting
• License: mit
• Created: 2018-08-15T06:31:52.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2019-03-18T23:23:53.000Z (almost 6 years ago)
• Last Synced: 2024-06-20T03:54:13.305Z (7 months ago)
• Topics: migrations, mysql
• Language: Go
• Homepage: https://github.com/altipla-consulting/migrator
• Size: 3 MB
• Stars: 0
• Watchers: 10
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        

# migrator

Apply SQL migrations from a folder.

### Install

```shell

go get github.com/altipla-consulting/migrator/cmd/init-migrator

go get github.com/altipla-consulting/migrator/cmd/migrator

```

### Usage

Run the initialize one time per database server to create the state needed to track the applied migrations:

```shell

init-migrator -user foo -password bar -address mysql.example.com

```

Then run the application as many times as yu want in your CI process or machine. Each time the app is called only the new migrations will be applied.

```shell

```

The folder `./migrations` of the example commands should contain one file per migration. Each file can have multiple SQL statements and every one of them should finish with a `;` character.

The first statement should always be `USE mydbname;` selecting the database you want to use for the rest of the file. If you want to migrate two different databases use two different files, `USE` can only be used once per file.

Example migrations:

```sql

USE information_schema;

CREATE SCHEMA foo;

```

```sql

USE foo;

CREATE TABLE images (

  id INT(11) NOT NULL AUTO_INCREMENT,

  filename VARCHAR(255) NOT NULL,

  revision INT(11) NOT NULL,

  

  PRIMARY KEY (id)

) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin;

```

If you want to track different migration directories (for different projects or clients) pass the `namespace` argument to all the commands:

```shell

init-migrator -namespace my_app -user foo -password bar -address mysql.example.com

migrator -namespace my_app -user foo -password bar -address mysql.example.com -directory ./migrations

```

### Contributing

You can make pull requests or create issues in GitHub. Any code you send should be formatted using `gofmt`.

### Running tests

Run a full test suite from a blank state:

```shell

make test

```

### License

[MIT License](LICENSE)