Migrations trong AdonisJS

## Migrations

Để sử dụng Migrations, cần khai báo `Migrations Provider` ở file `start/app.js`.

Mặc định sẽ có sẵn 2 file migration ở database/migrations

1. Chạy các files bên trong thư mục database/migrations

> adonis migration:run

Các file nào đã chạy rồi thì lần sau khi gõ command trên nó sẽ không chạy lại các files đó.

2. Kiểm tra status của các migration

> adonis migration:status

3. Nếu có sai sót thì rollback trở lại bản trước khi chạy `migration:run`

> adonis migration:rollback

4. Tạo file migration mới:

> adonis make:migration users

==> Output: database/migrations/1502691651527_users_schema.js

## Cấu trúc file Migration (Schema Files)

Một schema file bao gồm 2 phương thức là up và down.

1. `up()`

Phần xử lý chính (tạo mới table, chỉnh sửa field..)

2. `down()`

Được dùng để revert lại các thay đổi do phần `up()` tạo ra.

## Kiểu dữ liệu của một cột

Method Description

table.bigInteger(name) Adds a bigint column.

table.binary(name, [length]) Adds a binary column.

table.boolean(name) Adds a boolean column.

table.date(name) Adds a date column.

table.datetime(name, [precision]) Adds a datetime column.

table.decimal(name, [precision], [scale]) Adds a decimal column.

table.enu(col, values, [options]) Adds a enum column.

table.float(name, [precision], [scale]) Adds a float column.

table.increments(name) Adds an auto incrementing column.

table.integer(name) Adds an integer column.

table.json(name) Adds a json column.

table.string(name, [length=255]) Adds a string column.

table.text(name, [textType]) Adds a text column.

table.time(name, [precision]) Adds a time column.

table.timestamp(name, [useTz], [precision]) Adds a timestamp column.

table.timestamps([useTimestamps], [defaultToNow]) Adds created/updated columns.

table.uuid(name) Adds a uuid column.

## Column Modifiers

https://adonisjs.com/docs/4.1/migrations

Document: https://knexjs.org/#Schema-after

Method Description

.after(field) Set column to be inserted after field.

.alter() Marks the column as an alter/modify.

.collate(collation) Set column collation (e.g. utf8_unicode_ci).

.comment(value) Set column comment.

.defaultTo(value) Set column default value.

.first() Set column to be inserted at the first position.

.index([indexName], [indexType]) Specifies column as an index.

.inTable(table) Set foreign key table (chain after .references).

.notNullable() Set column to not null.

.nullable() Set column to be nullable.

.primary([constraintName]) Set column as the primary key for a table.

.references(column) Set foreign key column.

.unique() Set column as unique.

.unsigned() Set column to unsigned (if integer).

## Sử dụng một connection khác

<!-->

const Schema = use('Schema')

class UsersSchema extends Schema {

static get connection () {

return 'mysql'

}

// ...

}

module.exports = UsersSchema

<-->

## Migration Commands

Command Description

`make:migration` Create a new migration file.

`migration:run` Run all pending migrations.

`migration:rollback` Rollback last set of migrations.

`migration:refresh` Rollback all migrations to the 0 batch then re-run them

`migration:reset` Rollback all migrations to the 0 batch.

`migration:status` Get the status of all the migrations.

- Command Help: `adonis migration:run --help`

## Danh sách schema method sẵn có

1. Tạo bảng mới

> this.create('users', (table) => { .. })

2. Tạo bảng mới nếu nó chưa tồn tại

> this.createIfNotExists('users', (table) => { .. })

3. Đổi tên table

> this.rename('users', 'my_users')

4. Xóa một table

> this.drop('users')

5. Xóa table nếu đã tồn tại

> this.dropIfExists('users')

6. Chỉnh sửa table

<!-->

this.alter('users', (table) => {

// add new columns or remove existing

})

<-->

7. SQL query thuần (raw)

<!-->

up () {

this

.raw("SET sql_mode='TRADITIONAL'")

.table('users', (table) => {

table.dropColumn('name')

table.string('first_name')

table.string('last_name')

})

}

<-->

8. Kiểm tra một table tồn tại hay không

> const exists = await this.hasTable('users')

9. set timestamp với `knex.fn.now()`

> table.timestamp('created_at').defaultTo(this.fn.now())'

## Chạy code tùy ý

<!-->

class UserSchema {

up () {

// create new table

this.create('new_users', (table) => {

})

// copy data

this.schedule(async (trx) => {

const users = await Database.table('users').transacting(trx)

await Database.table('new_users').transacting(trx).insert(users)

})

// drop old table

this.drop('users')

}

}

-->