Gondolier (Golang Datenbank Migrations Bibliothek)

Werbeanzeige

DeKugelschieber

Community-Fossil

Beiträge: 2 641

Wohnort: Rheda-Wiedenbrück

Beruf: Software-Entwickler

25.11.2017, 15:07

Gondolier (Golang Datenbank Migrations Bibliothek)

Hallo Leute,

ich habe meine Migrations Biblothek "fertig" und wollte euch diese mal kurz präsentieren.
Zunächst: es gab bis jetzt keine Migrations Lib die die Migration nur über das Datenmodell in Go (also structs) abbilden kann. Die die existieren führen einfach SQL Scripte in der richtigen Reihenfolge aus, was sicherlich seine Vorteile hat (vor allem zuverlässiger ist), aber ich immer etwas mühsam finde. Gondolier kann nur aus dem Go Code + Dekoratoren das Datenbankschema erzeugen und updaten:

Quellcode

type Customer struct {
    Id   uint64 `gondolier:"type:bigint;id"`
    Name string `gondolier:"type:varchar(255);notnull"`
    Age  int    `gondolier:"type:integer;notnull"`
}

type Order struct {
    Id    uint64 `gondolier:"type:bigint;id"`
    Buyer uint64 `gondolier:"type:bigint;fk:customer.id;notnull"`
}

type OrderPosition struct {
    Id       uint64 `gondolier:"type:bigint;id"`
    Order    uint64 `gondolier:"type:bigint;fk:order.id;notnull"`
    Quantity int    `gondolier:"type:integer;notnull"`
    Cost     int    `gondolier:"type:integer;notnull"`
}

type Obsolete struct{}

func main() {
    // connect to database
    db, _ := sql.Open("postgres", dbString())
    defer db.Close()

    // migrate your schema
    gondolier.Use(db, &gondolier.Postgres{Schema: "public",
        DropColumns: true,
        Log:         true})
    gondolier.Model(Customer{}, Order{}, OrderPosition{})
    gondolier.Drop(Obsolete{})
    gondolier.Migrate()
}

Wie man sieht werden die nötigen Meta Informationen über Dekoratoren (hinten das gondolier:"...) in struct eingefügt und dann einfach an Gondolier übergeben. In diesem Beispiel kommen dann drei Tabellen dabei raus customer, order und order_position mit entsprechenden Spalten, Constraints und Foreign Keys. Wenn man nun etwas am Schema (also am Modell) in Go ändert und die Anwendung neu startet werden die Änderungen auch am Schema übernommen. Natürlich muss man schon gucken, dass die Änderungen auch möglich sind, ich kann also nicht einfach von gondolier:"type:integer" auf gondolier:"type:text" wechseln, weil die Datenbank (nur Postgres aktuell) das nicht kann.

Mich würde mal interessieren was ihr von dieser Bibliothek haltet, ob das ganze sinnvoll ist oder ob ihr sagt das könnte nicht robust genug sein (aktuell kann ich das selbst nicht so genau sagen). Die Testabdeckung ist > 90% und ich habe eine große Anwendung die Gondolier bereits nutzt.

GitHub: https://github.com/emvicom/gondolier
GitHub komplettes Beispiel (lauffähig): https://github.com/emvicom/gondolier-example

Grüße, Kugel

GitHub Meine Firma Pirsch Analytics