migrate
v4.18.1
Datenbankmigrationen geschrieben in Go. Verwenden Sie als CLI oder als Bibliothek importieren.
Von Mattes/Migrate gegabelt
Datenbanktreiber führen Migrationen aus. Eine neue Datenbank hinzufügen?
Datenbankverbindungszeichenfolgen werden über URLs angegeben. Das URL -Format ist treiberabhängig, hat aber im Allgemeinen das Formular: dbdriver://username:password@host:port/dbname?param1=true¶m2=false
Alle reservierten URL -Zeichen müssen entkommen werden. Beachten Sie, dass der % -Scharakter auch entkommen muss
Explizit müssen die folgenden Charaktere entkommen werden : ! , # , $ , % & , ' , ( , ) , * , + , / : : ; , = ? , @ , [ , ]
Es ist am einfachsten, die URL -Teile Ihrer DB -Verbindungs -URL (z. B. Benutzername, Passwort usw.) über einen URL -Encoder auszuführen. Siehe Beispiele Python Snippets unten:
$ 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
$Quellentreiber lesen Migrationen aus lokalen oder entfernten Quellen. Eine neue Quelle hinzufügen?
CLI -Dokumentation
$ migrate -source file://path/to/migrations -database postgres://localhost:5432/database up 2$ docker run -v {{ migration dir }}:/migrations --network host migrate/migrate
-path=/migrations/ -database postgres://localhost:5432/database up 2GracefulStop chan bool .io.Reader -Streams intern, um einen leichten Speicher -Overhead zu erhalten.Gehen Sie Dokumentation
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 )
}Möchten Sie einen vorhandenen Datenbank -Client verwenden?
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
}Anfangen
(Weitere Tutorials kommen)
Jede Migration hat eine Auf- und Ab -Migration. Warum?
1481574547_create_users_table.up.sql
1481574547_create_users_table.down.sqlBest Practices: Wie man Migrationen schreibt.
Schauen Sie sich MigRadaptor an. Hinweis: MigRadaptor ist nicht von diesem Projekt verbunden oder unterstützt
| Version | Unterstützt? | Import | Notizen |
|---|---|---|---|
| Master | ✅ | import "github.com/golang-migrate/migrate/v4" | Neue Funktionen und Fehlerbehebungen kommen zuerst hier an |
| v4 | ✅ | import "github.com/golang-migrate/migrate/v4" | Wird für stabile Veröffentlichungen verwendet |
| v3 | import "github.com/golang-migrate/migrate" import "gopkg.in/golang-migrate/migrate.v3" | NICHT verwenden - nicht mehr unterstützt |
Ja, bitte! Makefile ist Ihr Freund, lesen Sie den Entwicklungsführer.
Schauen Sie sich auch die FAQ an.
Auf der Suche nach Alternativen? https://awesome-go.com/#database.
