如何在Rails 7.0中使用PostgreSQL的real（float4）类型替代double precision？

一、新建字段时指定 float4 类型 #

Rails 默认的 t.float 会映射到 PostgreSQL 的 float8（double precision），要创建 float4（real）类型的字段，有两种直接实现方式：

• 使用 t.column 直接指定类型为 real（PostgreSQL 中 real 等价于 float4）：

  class AddRealFieldToModels < ActiveRecord::Migration[7.0]
    def change
      add_column :your_models, :weight, :real
    end
  end
  

• 或者在 t.float 中通过 sql_type 参数指定：

  class AddFloat4FieldToModels < ActiveRecord::Migration[7.0]
    def change
      add_column :your_models, :height, :float, sql_type: 'float4'
    end
  end
  

模型层无需额外修改，依然用 float 类型声明属性即可，Rails 会自动完成类型映射。

二、现有 float8 字段转 float4 的迁移方案 #

针对百万级数据的大表，直接修改字段类型会导致长时间锁表，建议采用分步迁移的方式，同时注意精度验证：

1. 备份数据 #

迁移前务必全量备份数据库，避免数据丢失。

2. 添加临时 float4 字段 #

先新增一个临时的 real 类型字段用于过渡：

class AddTempRealFieldToModels < ActiveRecord::Migration[7.0]
  def change
    add_column :your_models, :temp_weight, :real
  end
end

3. 批量迁移数据 #

将原 float8 字段的数据迁移到临时字段，大表建议分批处理避免超时：

• 用 Rails 分批更新（适合需要额外处理逻辑的场景）：

  YourModel.find_in_batches(batch_size: 1000) do |batch|
    batch.each do |record|
      record.update_column(:temp_weight, record.weight)
    end
  end
  

• 用原生 SQL 效率更高（适合无额外处理的场景）：

  UPDATE your_models SET temp_weight = weight;
  

4. 验证数据精度 #

抽样对比原字段和临时字段的数值，确认精度损失在业务可接受范围内（float4 约有 6-7 位有效数字，float8 为 15-17 位）。

5. 替换原字段 #

确认数据无误后，删除原字段并将临时字段重命名为原字段名：

class ReplaceFloat8WithFloat4 < ActiveRecord::Migration[7.0]
  def change
    remove_column :your_models, :weight
    rename_column :your_models, :temp_weight, :weight
  end
end

6. 重建索引（若有） #

如果原字段存在索引，需先删除原索引，在临时字段创建索引，最后同步重命名：

# 删除原索引
remove_index :your_models, :weight
# 在临时字段创建索引
add_index :your_models, :temp_weight
# 重命名索引（保持索引名一致）
rename_index :your_models, 'index_your_models_on_temp_weight', 'index_your_models_on_weight'

注意事项 #

• 务必在测试环境完成全流程验证，确认精度损失不影响业务逻辑。
• 大表迁移操作尽量在业务低峰期执行，减少对线上服务的影响。
• 若业务对数值精度要求极高（如金融场景），不建议切换到 float4。

内容的提问来源于stack exchange，提问作者Slth