migrate

bermigrasi

Migrasi basis data ditulis dalam go. Gunakan sebagai CLI atau impor sebagai perpustakaan.

• Migrasi membaca migrasi dari sumber dan menerapkannya dalam urutan yang benar ke database.
• Pengemudi adalah "bodoh", bermigrasi merekatkan semuanya bersama -sama dan memastikan logikanya anti peluru. (Menjaga pengemudi juga lebih ringan.)
• Driver database tidak menganggap sesuatu atau mencoba untuk memperbaiki input pengguna. Jika ragu, gagal.

Bercabang dari mattes/migrasi

Database

Driver database menjalankan migrasi. Tambahkan database baru?

• PostgreSQL
• PGX V4
• PGX V5
• Pergeseran merah
• Ql
• Cassandra / Scylladb
• Sqlite
• SQLite3 (Todo #165)
• SQLCIPHER
• Mysql / mariadb
• Neo4j
• Mongodb
• CatedB (Todo #170)
• Shell (Todo #171)
• Google Cloud Spanner
• Cokroachdb
• Yugabytedb
• Clickhouse
• Firebird
• MS SQL Server
• rqlite

URL database

String koneksi database ditentukan melalui URL. Format URL tergantung pada driver tetapi umumnya memiliki formulir: dbdriver://username:password@host:port/dbname?param1=true&param2=false

Karakter URL yang dipesan perlu diloloskan. Catatan, karakter % juga perlu diloloskan

Secara eksplisit, karakter berikut perlu diloloskan : ! , # , $ , % , & , ' , ( , ) , * , + , / , : , ; , = ? , @ , [ , ]

Paling termudah untuk selalu menjalankan bagian URL dari URL koneksi DB Anda (mis. Nama pengguna, kata sandi, dll) melalui encoder URL. Lihat contoh cuplikan Python di bawah ini:

$ python3 -c ' import urllib.parse; print(urllib.parse.quote(input("String to encode: "), "")) '
String to encode: FAKEpassword!#$%&' () * +,/:;= ? @[]
FAKEpassword%21%23%24%25%26%27%28%29%2A%2B%2C%2F%3A%3B%3D%3F%40%5B%5D
$ python2 -c ' import urllib; print urllib.quote(raw_input("String to encode: "), "") '
String to encode: FAKEpassword!#$%&' () * +,/:;= ? @[]
FAKEpassword%21%23%24%25%26%27%28%29%2A%2B%2C%2F%3A%3B%3D%3F%40%5B%5D
$

Sumber Migrasi

Pengemudi sumber membaca migrasi dari sumber lokal atau jarak jauh. Tambahkan sumber baru?

• FileSystem - Baca dari Sistem File
• IO/FS - BACA DARI A GO IO/FS
• Go-Bindata-Baca dari Data Biner Tertanam (Jteeuwen/Go-Bindata)
• PKGER - Baca dari data biner tertanam (Markbates/Pkger)
• GitHub - Baca dari Repositori Github Jarak Jauh
• Github Enterprise - Baca dari Repositori Remote Github Enterprise
• Bitbucket - Baca dari repositori Bitbucket jarak jauh
• Gitlab - Baca dari Repositori Gitlab Jarak Jauh
• AWS S3 - Baca dari Amazon Web Services S3
• Google Cloud Storage - Baca dari Google Cloud Platform Storage

Penggunaan CLI

• Pembungkus sederhana di sekitar perpustakaan ini.
• Menangani Ctrl+C (Sigint) dengan anggun.
• Tidak ada jalur pencarian konfigurasi, tidak ada file konfigurasi, tidak ada suntikan ajaib var.

Dokumentasi CLI

Penggunaan dasar

$ migrate -source file://path/to/migrations -database postgres://localhost:5432/database up 2

Penggunaan Docker

$ docker run -v {{ migration dir }}:/migrations --network host migrate/migrate
    -path=/migrations/ -database postgres://localhost:5432/database up 2

Gunakan di proyek GO Anda

• API stabil dan beku untuk rilis ini (V3 & V4).
• Penggunaan Modul GO untuk mengelola dependensi.
• Untuk membantu mencegah korupsi basis data, ia mendukung pemberhentian anggun melalui GracefulStop chan bool .
• Bawa logger Anda sendiri.
• Menggunakan io.Reader Stream secara internal untuk overhead memori rendah.
• Thread-Safe dan No Goroutine Leaks.

GO Dokumentasi

 import (
    "github.com/golang-migrate/migrate/v4"
    _ "github.com/golang-migrate/migrate/v4/database/postgres"
    _ "github.com/golang-migrate/migrate/v4/source/github"
)

func main () {
    m , err := migrate . New (
        "github://mattes:personal-access-token@mattes/migrate_test" ,
        "postgres://localhost:5432/database?sslmode=enable" )
    m . Steps ( 2 )
}

Ingin menggunakan klien database yang ada?

 import (
    "database/sql"
    _ "github.com/lib/pq"
    "github.com/golang-migrate/migrate/v4"
    "github.com/golang-migrate/migrate/v4/database/postgres"
    _ "github.com/golang-migrate/migrate/v4/source/file"
)

func main () {
    db , err := sql . Open ( "postgres" , "postgres://localhost:5432/database?sslmode=enable" )
    driver , err := postgres . WithInstance ( db , & postgres. Config {})
    m , err := migrate . NewWithDatabaseInstance (
        "file:///migrations" ,
        "postgres" , driver )
    m . Up () // or m.Steps(2) if you want to explicitly set the number of migrations to run
}

Memulai

Pergi untuk memulai

Tutorial

• Cokroachdb
• PostgreSQL

(Tutorial lainnya yang akan datang)

File migrasi

Setiap migrasi memiliki migrasi naik turun. Mengapa?

1481574547_create_users_table.up.sql
1481574547_create_users_table.down.sql

Praktik Terbaik: Cara Menulis Migrasi.

Berasal dari alat migrasi DB lainnya?

Lihat Migradaptor. Catatan: Migradaptor tidak berafiliasi atau didukung oleh proyek ini

Versi

Versi	Didukung?	Impor	Catatan
menguasai	✅	import "github.com/golang-migrate/migrate/v4"	Fitur baru dan perbaikan bug tiba di sini terlebih dahulu
v4	✅	import "github.com/golang-migrate/migrate/v4"	Digunakan untuk pelepasan stabil
v3		import "github.com/golang-migrate/migrate" (dengan manajer paket) atau import "gopkg.in/golang-migrate/migrate.v3" (tidak disarankan)	Jangan gunakan - tidak lagi didukung

Pengembangan dan berkontribusi

Ya, tolong! Makefile adalah teman Anda, baca panduan pengembangan.

Juga lihat FAQ.

---

Mencari alternatif? https://awesome-go.com/#database.