migrate下載 - migrate源代碼下載

migrate

其他源碼

v4.18.1

下載

遷移

數據庫遷移寫在GO中。用作CLI或導入作為庫。

遷移讀取從來源遷移，並以正確的順序應用到數據庫。
駕駛員是“愚蠢的”，將所有東西遷移在一起，並確保邏輯是防彈的。（也可以使駕駛員輕巧。）
數據庫驅動程序不假設事物或嘗試糾正用戶輸入。如有疑問，失敗。

從啞光/遷移中分叉

資料庫

數據庫驅動程序運行遷移。添加新數據庫？

Postgresql
PGX V4
PGX V5
紅移
QL
Cassandra / Scylladb
sqlite
sqlite3（todo＃165）
sqlcipher
mysql / mariadb
neo4j
mongodb
cratedb（todo＃170）
殼（Todo＃171）
Google Cloud Spanner
蟑螂
Yugabytedb
Clickhouse
火鳥
MS SQL Server
rqlite

數據庫URL

數據庫連接字符串是通過URL指定的。 URL格式取決於驅動程序，但通常具有： dbdriver://username:password@host:port/dbname?param1=true&param2=false

任何保留的URL字符都需要逃脫。請注意， %字符也需要逃脫

明確地，需要逃脫以下字符： ! ， # ， $ ， % ， & ' ， ( ， ) ， * ， + , / ， : ,， ; ， = ? ， @ ， [ ， ]

始終運行DB連接URL（例如用戶名，密碼等）的URL部分最容易通過URL編碼器運行。請參閱下面的示例python摘要：

$ 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
$

遷移來源

源驅動程序從本地或遠程來源讀取遷移。添加新來源？

文件系統 - 從文件系統中讀取
io/fs-從go io/fs閱讀
go-bindata-從嵌入式二進制數據（jteeuwen/go-bindata）中讀取
PKGER-從嵌入式二進制數據（Markbates/Pkger）中讀取
GitHub-從遠程GitHub存儲庫中讀取
GitHub Enterprise-從遠程GitHub企業存儲庫中讀取
Bitbucket-從遠程Bitbucket存儲庫中讀取
GitLab-從遠程GitLab存儲庫中閱讀
AWS S3-從Amazon Web服務讀取S3
Google雲存儲 - 從Google雲平台存儲中閱讀

CLI用法

這個庫周圍的簡單包裝器。
優雅地處理Ctrl+C（Sigint）。
沒有配置搜索路徑，沒有配置文件，沒有魔術env var注射。

CLI文檔

基本用法

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

Docker用法

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

在您的GO項目中使用

API穩定並凍結了此版本（V3＆V4）。
使用GO模塊來管理依賴關係。
為了幫助防止數據庫腐敗，它通過GracefulStop chan bool支持優雅的停止。
帶上自己的記錄儀。
內部使用io.Reader流以低內存開銷。
螺紋安全，沒有gor洩漏。

去文檔

 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 )
}

想使用現有數據庫客戶端嗎？

 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
}

入門

開始

教程

蟑螂
Postgresql

（更多教程將來）

遷移文件

每個遷移都有上下遷移。為什麼？

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

最佳實踐：如何寫遷移。

來自另一個數據庫遷移工具？

查看偏頭痛者。注意：偏頭痛者沒有該項目的隸屬關係或支持

版本

版本	支持？	進口	筆記
掌握	✅	`import "github.com/golang-migrate/migrate/v4"`	新功能和錯誤修復首先到達這裡
v4	✅	`import "github.com/golang-migrate/migrate/v4"`	用於穩定版本
V3		`import "github.com/golang-migrate/migrate"` （包裝經理）或`import "gopkg.in/golang-migrate/migrate.v3"` （不建議）	不要使用- 不再支持