Yoyo-migrations

Yoyo-di cư là một tiện ích cơ sở dữ liệu di cư schema sử dụng SQL đồng bằng và DB-API.
không yoyo-di cư làm gì?
Khi các ứng dụng cơ sở dữ liệu phát triển, thay đổi lược đồ cơ sở dữ liệu thường được yêu cầu. Chúng thường có thể được viết như kịch bản SQL một lần chứa CREATE / ALTER bảng báo cáo (mặc dù bất kỳ SQL hoặc python script có thể được sử dụng với yoyo-di cư).
Yoyo-di cư cung cấp một công cụ dòng lệnh để đọc một thư mục của kịch bản như vậy và áp dụng chúng vào cơ sở dữ liệu của bạn theo yêu cầu.
Cơ sở dữ liệu hỗ trợ
PostgreSQL, MySQL và SQLite cơ sở dữ liệu được hỗ trợ.
Cách sử dụng
Yoyo-di cư thường được gọi như là một kịch bản dòng lệnh.
Ví dụ:
Đọc tất cả các di cư từ di chuyển thư mục và áp dụng chúng vào một cơ sở dữ liệu PostgreSQL:
yoyo-di cư áp dụng ./migrations/ postgres: // user: password @ localhost / cơ sở dữ liệu
Rollback di cư trước đây áp dụng cho một cơ sở dữ liệu MySQL:
yoyo-di cư rollback ./migrations/ mysql: // user: password @ localhost / cơ sở dữ liệu
Thoa lại (tức là rollback sau đó áp dụng một lần nữa) di cư đối với một cơ sở dữ liệu SQLite tại vị trí /home/sheila/important-data.db:
yoyo-di chuyển SQLite Nộp đơn xin ./migrations/: ////home/sheila/important-data.db
Theo mặc định, yoyo-di cư bắt đầu trong chế độ tương tác, nhắc bạn cho mỗi tập tin di chuyển trước khi áp dụng nó, làm cho nó dễ dàng để lựa chọn mà di cư để áp dụng và rollback.
Các thư mục di cư nên chứa một loạt các kịch bản di cư. Mỗi kịch bản di cư là một file python (py) có chứa một loạt các bước. Mỗi bước nên bao gồm một truy vấn di cư và (tùy chọn) một truy vấn rollback. Ví dụ như:
#
# File: di cư / 0001.create-foo.py
#
bước (
& Nbsp; "CREATE TABLE foo (id INT, thanh VARCHAR (20), PRIMARY KEY (id))",
& Nbsp; "DROP TABLE foo",
)
Các tên tập tin của mỗi tập tin (không có phần mở rộng py) được sử dụng như là các định danh cho mỗi di cư. Di cư được áp dụng theo thứ tự tên tập tin, do đó, nó là hữu ích để đặt tên cho tập tin của bạn bằng cách sử dụng một ngày (ví dụ: '20090115-xyz.py') hoặc với một số cách tăng.
yoyo-di cư tạo ra một bảng trong cơ sở dữ liệu mục tiêu, _yoyo_migration của bạn, để theo dõi mà di cư đã được áp dụng.
Bước này cũng có thể mất một ignore_errors đối số tùy chọn, mà cần phải có một trong các áp dụng, rollback, hoặc tất cả. Nếu trong ví dụ trên bảng foo có thể đã được tạo ra bởi một phương tiện khác, chúng ta có thể thêm ignore_errors = 'áp dụng' để bước để cho phép sự di cư tiếp tục bất kể:
#
# File: 0001.create-foo.py
#
bước (
& Nbsp; "CREATE TABLE foo (id INT, thanh VARCHAR (20), PRIMARY KEY (id))",
& Nbsp; "DROP TABLE foo",
& Nbsp; ignore_errors = 'áp dụng',
)
Bước này cũng có thể là đối tượng có thể được gọi python mà phải mất một kết nối cơ sở dữ liệu như là đối số duy nhất của họ. Ví dụ như:
#
# File: 0002.update_keys.py
#
def do_step (conn):
& Nbsp; con trỏ = conn.cursor ()
& Nbsp; cursor.execute (
& Nbsp; "INSERT INTO sysinfo"
& Nbsp; "(osname, tên máy, phát hành, phiên bản, kiến ​​trúc)"
& Nbsp; "VALUES (% s,% s,% s,% s,% s% s)",
& Nbsp; os.uname ()
& Nbsp;)
bước (do_step)
Password bảo mật
Bạn thường chỉ định tên người dùng và mật khẩu cơ sở dữ liệu của bạn như là một phần của chuỗi kết nối cơ sở dữ liệu trên dòng lệnh. Trên một máy tính đa người dùng, những người khác có thể xem mật khẩu cơ sở dữ liệu của bạn trong danh sách tiến trình.
-p Hoặc --prompt-password cờ gây yoyo-di cư để nhắc nhở cho một mật khẩu, bỏ qua bất kỳ mật khẩu được quy định trong chuỗi kết nối. Mật khẩu này sẽ không có sẵn cho người dùng khác thông qua danh sách tiến trình của hệ thống.
Kết nối chuỗi bộ nhớ đệm
Lần đầu tiên bạn chạy yoyo-di chuyển trên một tập mới của di cư, bạn sẽ được hỏi nếu bạn muốn để cache các chuỗi kết nối cơ sở dữ liệu trong một tập tin gọi là .yoyo-di chuyển trong các thư mục di cư.
Bộ nhớ cache này là địa phương đến thư mục di cư, do đó chạy tiếp theo trên bộ chuyển đổi tương tự không cần các chuỗi kết nối cơ sở dữ liệu được xác định.
Điều này tiết kiệm gõ, tránh tên cơ sở dữ liệu của bạn và mật khẩu hiển thị trong danh sách tiến trình và làm giảm nguy cơ vô tình chạy yoyo-di chuyển trên cơ sở dữ liệu sai (tức là bằng cách chạy lại một entry yoyo-di chuyển trước đó trong lịch sử lệnh của bạn khi bạn đã chuyển đến một thư mục khác nhau).
Nếu bạn không muốn file cache này sẽ được sử dụng, thêm tham số --no-cache để các tùy chọn dòng lệnh

là gì mới trong phiên bản này:.

• Fix cho quản lý yếu kém 4.2.3 phát hành

là gì mới trong phiên bản 4.2.1:

• Sửa lỗi phát hành trước đó, mà bỏ qua các tập tin quan trọng.

là gì mới trong phiên bản 4.1.6:

• Thêm hỗ trợ cửa sổ (nhờ Peter Shinners)

là gì mới trong phiên bản 4.1.5:

• Cấu hình xử lý khai thác gỗ để các nguyên nhân tắc -v lượng để đi đến giao diện điều khiển (nhờ Andrew Nelis).
• `` -v`` chuyển đổi dòng lệnh không còn có một đối số nhưng có thể được chỉ định nhiều lần thay vì (tức là sử dụng `` -vvv`` thay vì `` -v3``). `` --verbosity`` Giữ các hành vi cũ.

là gì mới trong phiên bản 4.1.3:

• Thay đổi mặc định tên bảng di cư trở lại '_yoyo_migration'

Yêu cầu :

• Python