ActiveRecord::Migration 弃用警告 - 要求提供 Rails 版本，但我没有使用 Rails

Question

这是一个使用 ActiveRecord 与数据库对话的 Ruby 非 Web 项目。

有一个文件包含数据库连接代码、迁移和模型。请参阅此处（但不必阅读此内容来回答问题）

require 'sqlite3'
require 'active_record'
require 'yaml'
require 'active_support/all'
require 'securerandom'

BasePath = "#{File.dirname(__FILE__)}/.."
DATABASE_FILENAME = "database.sqlite"
DATABASE_PATH = "#{BasePath}/#{DATABASE_FILENAME}"
SQLite3::Database.new(DATABASE_PATH)
ActiveRecord::Base.establish_connection(
  adapter: 'sqlite3',
  database: DATABASE_PATH
)

class Migrations < ActiveRecord::Migration
  def up
    create_table :todos do |t|
      t.string :content
      t.boolean :completed
      t.timestamps null: false
    end
  end
  def down
    puts "backing up database".red_on_black if File.file?(DATABASE_PATH)
    loop { (`cp #{DATABASE_PATH} #{DATABASE_PATH}-#{SecureRandom.urlsafe_base64}.backup`; break) rescue next }
    sleep 0.5
    drop_table :todos
    puts "dropped todos table"
  end
end # Migrations

class Todo < ActiveRecord::Base
end

问题是关于这一行的：

class Migrations < ActiveRecord::Migration

当我使用 Migrations.migrate(:up) 运行迁移时，我收到了弃用警告：

DEPRECATION WARNING: Directly inheriting from ActiveRecord::Migration is deprecated.
Please specify the Rails release the migration was written for:

  class Migrations < ActiveRecord::Migration[4.2]

就像它建议我将我的类定义更改为

  class Migrations < ActiveRecord::Migration[4.2]

然后我不再收到警告。

我想知道是否有人可以解释这样做的目的。

我的应用不依赖于任何版本的 Rails。为什么我需要

指定 Rails 版本？

Answer 1

因为 Active Record 想知道迁移是在哪个版本中生成的。有时，迁移中的默认值可能会在 Rails 版本之间发生变化（当我说 Rails 版本时，我指的是 Rails 框架的版本，而不是 rails gem）。

假设你有这样的迁移：

create_table :todos do |t|
  t.string :content
end

它是使用 Active Record 4.2（以及 Rails 4.2 版本）生成的。在 Rails 4.2 中，字符串列的默认大小为 4 字节。 在 Rails 5.0 中，Rails 团队决定将默认大小更改为 8 字节。如果您将 gem 升级到 5.0，则回滚此迁移并再次运行，您的数据库将有一个 8 字节大小的字符串列。

如果您在迁移中指定版本，则无论您使用哪个版本的 Active Record，该列将始终以生成的 Rails 版本中的默认大小生成。在我的示例中，如果您指定 4.2 作为版本，它将始终是一个 4 字节的字符串列。

Answer 2

如果从rails 4升级到rails 5，您可以在回滚或删除后将版本号添加到迁移中：

Rails 4.2.6

class CreateStudents < ActiveRecord::Migration
  def change
    create_table :students do |t|
      t.belongs_to :user, index: true
      t.string :first_name
      t.string :last_name
      t.string :phone
      t.timestamps null: false
    end
  end
end

Rails 5.1.3

class CreateStudents < ActiveRecord::Migration[5.1]
  def change
    create_table :students do |t|
      t.belongs_to :user, index: true
      t.string :first_name
      t.string :last_name
      t.string :phone
      t.timestamps null: false
    end
  end
end