• Active Record: 資料庫遷移(Migration) (转)


    Active Record: 資料庫遷移(Migration)

    Programming today is a race between software engineers striving to build bigger and better idiot-proof programs, and the Universe trying to produce bigger and better idiots. So far, the Universe is winning. - Rick Cook

    Migrations(資料庫遷移)可以讓你用 Ruby 程式來修改資料庫結構。相較於直接進資料庫系統使用 SQL 修改結構(例如使用 phpMyAdmin 工具來修改),使用 Migrations 可以讓我們有記錄地進行資料庫修改,每次變更就是一筆 Migration 記錄。在沒有 Migration 之前,如果你手動修改了資料庫,那麼你就必須通知其他開發者也進行一樣的修改步驟。另外,在正式佈署的伺服器上,你也必須追蹤並執行同樣的變更才行。而這些步驟如果沒有記錄下來,就很容易出錯。

    Migrations 會自動追蹤哪些變更已經執行過了、那些還沒有,你只要新增 Migration 檔案,然後執行 rake db:migrate 就搞定了。它會自己搞清楚該跑哪些 migrations,如此所有的開發者和正式佈署的伺服器上,就可以輕易的同步最新的資料庫結構。另外一個優點是: Migration 是獨立於資料庫系統的,所以你不需要煩惱各種資料庫系統的語法差異,像是不同型態之類的。當然,如果要針對某個特定資料庫系統撰寫專屬功能的話,還是可以透過直接寫 SQL 的方式。

    新增一個 Migration 檔案

    執行以下指令,就會在 db/migrate/ 目錄下產生如 20110203070100_migration_name.rb 的檔案

    rails g migration migration_name

    注意到在 migration_name.rb 前面有著如 YYYYMMDDHHMMSS 的時序前置,用來表明執行的順序。在早先的 Rails 版本中,是使用編號 1,2,3 來指名執行的順序,但是如果有不同分支多人開發就可能會有重複的編號,因此在 Rails 2.1 之後的版本改採用時間戳章,讓 Rails 能夠應付多人開發的狀況。

    migration_name 常見的命名方式有Add欄位名To表格名或是Remove欄位名From表格名,不過這沒有一定,能描述目的即可。

    讓我們打開這個檔案看看:

    class MigrationName < ActiveRecord::Migration
      def up
      end
    
      def down
      end
    end

    在這個類別中,包含了兩個類別方法分別是 up 和 down。其中 up 會在執行這個 migration 時執行,反之 down 會在滾回(Roll back)這個 Migration 時執行。例如,我們在 up 時新增一個資料庫表格(table),那麼就可以在 down 的時候把這個table刪除。

    Migration 可用的方法

    在up或down方法裡,我們有以下方法可以使用:

    對資料表做修改:

    • create_table(name, options) 新增資料表
    • drop_table(name) 移除資料表
    • rename_table(old_name, new_name) 修改資料表名稱
    • change_table 修改資料表欄位

    個別修改資料表欄位:

    • add_column(table, column, type, options) 新增一個欄位
    • rename_column(table, old_column_name, new_column_name) 修改欄位名稱
    • change_column(table, column, type, options) 修改欄位的型態(type)
    • remove_column(table , column) 移除欄位

    新增、移除索引:

    • add_index(table, columns, options) 新增索引
    • remove_index(table, index) 移除索引

    記得將所有外部鍵 foreign key 加上索引

    新增和移除 Table

    執行 rails g model 時,Rails就會順便新增對應的 Migration 檔案。以上一章產生的categories migration為例:

    class CreateCategories < ActiveRecord::Migration
        def change
            create_table :categories do |t|
              t.string :name
              t.integer :position
              t.timestamps
            end
            
            add_column :events, :category_id, :integer
            add_index :events, :category_id
        end
    end

    其中的 timestamps 會建立叫做 created_at 和 updated_at 的時間欄位,這是Rails的常用慣例。它會自動設成資料新增的時間以及會後更新時間。

    疑,這裡怎麼不是用updown方法? Rails 3.1 版新增了change方法可以很聰明的自動處理大部分down的情況,上述情況的down就是移除catrgories資料表和移除eventscategory_id欄位,因此就不需要分別寫updown了。如果Rails無法判斷,會在跑rake db:migrate時提醒你不能用change,需要分開寫updown

    修改 Table

    我們來試著新增一個欄位吧:

    rails g migration add_description_to_categories

    打開 db/migrate/20110411163049_add_description_to_categories.rb

    class AddDescriptionToCategories < ActiveRecord::Migration
      def change
        add_column :categories, :description, :text
      end
    end

    完成後,執行bundle exec rake db:migrate便會實際在資料庫新增這個欄位。

    資料庫的欄位定義

    為了能夠讓不同資料庫通用,以下是Migration中的資料型態與實際資料庫使用的型態對照:

    Rails中的型態說明MySQLPostgresSQLite3
    :string 有限長度字串 varchar(255) character varying(255) varchar(255)
    :text 不限長度文字 text text text
    :integer 整數 int(4) integer integer
    :float 浮點數 float float float
    :decimal 十進位數 decimal decimal decimal
    :datetime 日期時間 datetime timestamp datetime
    :timestamp 時間戳章 datetime timestamp datetime
    :time 時間 time time datetime
    :date 日期 date date date
    :binary 二進位 blob bytea blob
    :boolean 布林值 tinyint boolean boolean
    :references 用來參照到其他Table的外部鍵 int(4) integer integer

    另外,欄位也還有一些參數可以設定:

    • :null 是否允許NULL,預設是允許
    • :default 預設值
    • :limit 用於stringtextintegerbinary指定最大值

    例如:

    create_table :events do |t|
        t.string :name, :null => false, :limit => 60, :default => "N/A"
        t.references :category # 等同於 t.integer :category_id
    end

    參考資料:ActiveRecord::ConnectionAdapters::TableDefinition

    欄位名稱慣例

    我們已經介紹過了 timestamps 方法會自動新增兩個時間欄位,Rails 還保留了幾個名稱作為慣例之用:

    欄位名稱用途
    id 預設的主鍵欄位名稱
    {tablename}_id 預設的外部鍵欄位名稱
    created_at 如果有這個欄位,Rails便會在新增時設定時間
    updated_at 如果有這個欄位,Rails便會在修改時設定時間
    created_on 如果有這個欄位,Rails便會在新增時設定時間
    updated_on 如果有這個欄位,Rails便會在修改時設定時間
    {tablename}_count 如果有使用 Counter Cache 功能,這是預設的欄位名稱
    type 如果有這個欄位,Rails便會啟動STI功能(詳見ActiveRecord章節)
    lock_version 如果有這個欄位,Rails便會啟動Optimistic Locking功能(詳見ActiveRecord章節)

    Migration 搭配的 Rake 任務

    • rake db:create 依照目前的 RAILS_ENV 環境建立資料庫
    • rake db:create:all 建立所有環境的資料庫
    • rake db:drop 依照目前的 RAILS_ENV 環境刪除資料庫
    • rake db:drop:all 刪除所有環境的資料庫
    • rake db:migrate 執行Migration動作
    • rake db:rollback STEP=n 回復上N個 Migration 動作
    • rake db:migrate:up VERSION=20080906120000 執行特定版本的Migration
    • rake db:migrate:down VERSION=20080906120000 回復特定版本的Migration
    • rake db:version 目前資料庫的Migration版本
    • rake db:seed 執行 db/seeds.rb 載入種子資料

    如果需要指定Rails環境,例如production,可以輸入 RAILS_ENV=production rake db:migrate

    種子資料 Seed

    種子資料Seed的意思是,有一些資料是應用程式跑起來必要基本資料,而這些資料的產生我們會放在db/seeds.rb這個檔案。例如,讓我們打開來,加入一些基本的Category資料:

    # This file should contain all the record creation needed to seed the database with its default values.
    # The data can then be loaded with the rake db:seed (or created alongside the db with db:setup).
    #
    # Examples:
    #
    #   cities = City.create([{ name: 'Chicago' }, { name: 'Copenhagen' }])
    #   Mayor.create(name: 'Emanuel', city: cities.first)
    
    Category.create!( :name => "Science" )
    Category.create!( :name => "Art" )
    Category.create!( :name => "Education" )

    輸入rake db:seed就會執行這個檔案了。通常執行的時機是第一次建立好資料庫和跑完Migration之後。

    資料 Migration

    Migrations 不只可以用來變更資料表定義,它也很常用來遷移資料。新增或修改欄位時,還蠻常也需要根據現有的資料,來設定新欄位的值。這時候我們就會在 Migration 利用 ActiveRecord 來操作資料。

    不過,如果你在Migration中修改了資料表欄位,隨即又使用這個Model來做資料更新,那麼因為Rails會快取資料表的欄位定義,所以會無法讀到剛剛修改的資料表。這時候有幾個辦法可以處理:

    第一是呼叫 reset_column_information 重新讀取資料表定義。

    第二是在 Migration 中用 ActiveReocrd::Base 定義一個新的空白 Model 來暫時使用。

    第三是用 execute 功能來執行任意的 SQL。

    Production上跑Migration注意事項

    當有上萬筆資料的時候,如果有修改資料庫表格ALTER TABLE的話,他會Lock table無法寫入,可能會跑好幾個小時很難事前預估。建議用staging server用接近production的資料來先測試會跑多久。

    bulk參數

    :bulk => true可以讓變更資料庫欄位的Migration更有效率的執行,如果沒有加這個參數,或是直接使用add_columnrename_columnremove_column等方法,那麼Rails會拆開SQL來執行,例如:

    change_table(:users) do |t|
      t.string :company_name
      t.change :birthdate, :datetime
    end

    會產生:

    ALTER TABLE `users` ADD `im_handle` varchar(255)
    ALTER TABLE `users` ADD `company_id` int(11)
    ALTER TABLE `users` CHANGE `updated_at` `updated_at` datetime DEFAULT NULL

    加上:bulk => true之後:

    change_table(:users, :bulk => true) do |t|
      t.string :company_name
      t.change :birthdate, :datetime
    end

    會合併產生一行SQL

    ALTER TABLE `users` ADD COLUMN `im_handle` varchar(255), ADD COLUMN `company_id` int(11), CHANGE `updated_at` `updated_at` datetime DEFAULT NULL

    這對已有不少資料量的資料庫來說,會有不少執行速度上的差異,可以減少資料庫因為修改被Lock鎖定的時間。

  • 相关阅读:
    源代码的下载与编译
    Git使用入门
    搭建Android开发环境
    Android系统移植与驱动开发
    Android探索与驱动开发学与思(10)
    Android探索与驱动开发学与思(9)
    Android探索与驱动开发学与思(8)
    第七章
    第六章
    第五章
  • 原文地址:https://www.cnblogs.com/zqn518/p/4128841.html
Copyright © 2020-2023  润新知