Rails 中如何编写含 GEOGRAPHY、DOUBLE PRECISION 列的数据库迁移？

前置依赖准备 #

• 需使用匹配当前Rails版本的activerecord-postgis-adapter gem支持PostGIS地理类型，添加到Gemfile后执行bundle install安装
• 调整config/database.yml对应环境的数据库adapter为postgis，替换原有的postgresql
• 确保数据库账号拥有创建PostGIS扩展的权限

迁移文件编写 #

执行生成命令创建迁移文件：
rails generate migration CreatePoiTrace

编辑对应生成的db/migrate/[时间戳]_create_poi_trace.rb文件，写入如下逻辑：

# db/migrate/[时间戳]_create_poi_trace.rb
class CreatePoiTrace < ActiveRecord::Migration[7.0] # 替换为你实际使用的Rails版本号
  def change
    # 确保PostGIS扩展已启用，若数据库已提前全局启用可删除此行
    enable_extension 'postgis', if_not_exists: true

    # 目标表无默认自增主键，关闭Rails自动生成主键的逻辑
    create_table :poi_trace, primary_key: false do |t|
      # 对应 poi_id BIGINT REFERENCES pois(id)
      t.bigint :poi_id, foreign_key: { to_table: :pois }

      # 对应 trace_id BIGINT REFERENCES traces(id)
      t.bigint :trace_id, foreign_key: { to_table: :traces }

      # 对应 geog GEOGRAPHY(Point, 4326)
      t.st_point :geog, geographic: true, srid: 4326

      # 对应 advance_on_trace DOUBLE PRECISION
      # limit: 53 明确匹配PostgreSQL双精度浮点的精度要求
      t.float :advance_on_trace, limit: 53

      # 对应 active BOOLEAN
      t.boolean :active
    end
  end
end

关键映射说明 #

• t.st_point 配合 geographic: true 会生成PostGIS的GEOGRAPHY类型，指定srid为4326完全匹配需求中的GEOGRAPHY(Point, 4326)定义
• t.float limit: 53 对应PostgreSQL的DOUBLE PRECISION类型，避免默认映射到单精度浮点
• 关闭自动主键是因为目标建表语句未定义自增id列，若需要添加复合主键（如poi_id+trace_id作为联合主键），可在迁移块中通过t.primary_key [:poi_id, :trace_id]单独定义

执行与验证 #

运行rails db:migrate完成表创建，执行后可在psql控制台执行\d poi_trace核对列类型、外键约束是否与目标建表语句完全一致。

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