migrate
資料庫遷移。命令列工具與 Golang 函式庫。
migrate 是什麼?
資料庫遷移。命令列工具與 Golang 函式庫。。。。。。.
migrate 概覽
這是什麼
用 Go 寫成的資料庫遷移工具。可作為 CLI 使用,或作為函式庫匯入。
Migrate 從來源讀取遷移腳本,並按正確順序套用到資料庫。
驅動程式是「笨的」,migrate 將所有部分黏合在一起,確保邏輯無懈可擊。(同時也保持驅動程式輕量。)
資料庫驅動程式不會假設任何情況或試圖修正使用者輸入。有疑問時就失敗。
從 mattes/migrate 分支出來。
主要功能
- 支援多種資料庫:PostgreSQL、PGX v4、PGX v5、Redshift、Ql、Cassandra / ScyllaDB、SQLite、SQLCipher、MySQL / MariaDB、Neo4j、MongoDB、CrateDB(待辦)、Shell(待辦)、Google Cloud Spanner、CockroachDB、YugabyteDB、ClickHouse、Firebird、MS SQL Server、rqlite。
- 支援多種遷移來源:檔案系統、io/fs、Go-Bindata、pkger、GitHub、GitHub Enterprise、Bitbucket、Gitlab、AWS S3、Google Cloud Storage。
- CLI 使用:圍繞此函式庫的簡單包裝,優雅處理 ctrl+c(SIGINT),無設定檔搜尋路徑、無設定檔、無魔術環境變數注入。
- Go 函式庫:API 在 v3 與 v4 穩定且凍結,使用 Go modules,透過 GracefulStop chan bool 支援優雅停止,可自訂 logger,內部使用 io.Reader 串流以降低記憶體開銷,執行緒安全且無 goroutine 洩漏。
- 遷移檔案:每個遷移有 up 與 down 遷移(例如 1481574547_create_users_table.up.sql 與 .down.sql)。
使用情境
- 以受控、版本化的方式套用資料庫結構變更。
- 使用 CLI 工具從本機檔案或遠端來源執行遷移。
- 在 Go 專案中作為函式庫整合,以程式方式管理遷移。
- 在 Docker 容器中執行遷移。
快速開始
詳細的快速開始指南請參閱儲存庫的 README。基本 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
授權與價格
授權未標明(NOASSERTION)。價格開源免費。
內容整理自該專案公開的 README 與儲存庫資訊。