如何将ActiveRecord模型属性从json迁移至jsonb？迁移写法及jsonb数组查询

嘿，这个问题我太熟悉了！把ActiveRecord模型里的JSON类型字段改成JSONB绝对是个提升查询能力的好选择——毕竟JSONB支持索引、更高效的查询操作，尤其是你提到的数组查询场景。下面我一步步给你讲清楚怎么做：

首先，你需要生成一个迁移文件来修改字段类型。假设你的字段名是metadata（可以替换成你实际的字段名），操作如下：

1. 生成迁移文件：

rails generate migration ChangeMetadataToJsonb

2. 打开生成的迁移文件，根据你的场景选择合适的迁移逻辑：

情况1：数据量小，允许短暂锁表 #

如果你的表数据不多，直接修改字段类型最简单：

class ChangeMetadataToJsonb < ActiveRecord::Migration[6.1]
  def change
    # 把json类型改成jsonb，同时保留原有数据
    change_column :your_table_name, :metadata, :jsonb, using: 'metadata::jsonb'
  end
end

这里的using: 'metadata::jsonb'是PostgreSQL的语法，用于把原有JSON数据转换成JSONB格式，必须加上，否则迁移会失败。

情况2：生产环境大数据量，避免锁表 #

如果你的表数据很大，直接修改会锁表影响业务，建议用分步迁移：

class ChangeMetadataToJsonb < ActiveRecord::Migration[6.1]
  def up
    # 1. 添加一个临时的jsonb字段
    add_column :your_table_name, :metadata_jsonb, :jsonb

    # 2. 复制原有json数据到新字段
    YourTableName.update_all("metadata_jsonb = metadata::jsonb")

    # 3. 删除旧字段
    remove_column :your_table_name, :metadata

    # 4. 把新字段重命名成原来的名字
    rename_column :your_table_name, :metadata_jsonb, :metadata
  end

  def down
    # 回滚操作，把jsonb改回json
    add_column :your_table_name, :metadata_json, :json
    YourTableName.update_all("metadata_json = metadata::json")
    remove_column :your_table_name, :metadata
    rename_column :your_table_name, :metadata_json, :metadata
  end
end

这种方式不会长时间锁表，更适合生产环境。

其实ActiveRecord会自动识别JSONB字段，所以大部分情况下你不需要修改模型代码。不过如果之前你为JSON字段加了serialize方法（比如serialize :metadata, JSON），记得把它删掉——JSONB字段会自动处理序列化和反序列化，不需要额外配置。

现在重点来了！JSONB的数组查询能力非常实用，我给你几个常见场景的例子：

假设你的模型是Post，有一个tags字段是JSONB类型，存储的是字符串数组（比如["ruby", "rails", "postgres"]）：

1. 查询数组包含某个元素 #

用PostgreSQL的@>操作符，检查数组是否包含指定元素：

# 查询包含"ruby"的帖子
Post.where("tags @> ?", '["ruby"]')

如果是对象数组（比如[{name: "ruby", version: "3.2"}, {name: "rails", version: "7.0"}]），可以这样查：

# 查询包含name为"ruby"的对象的帖子
Post.where("tags @> ?", [{name: "ruby"}].to_json)

2. 查询数组包含多个元素（全部匹配） #

# 查询同时包含"ruby"和"rails"的帖子
Post.where("tags @> ?", '["ruby", "rails"]')

3. 查询数组包含任意一个元素（OR匹配） #

用?|操作符：

# 查询包含"ruby"或"postgres"的帖子
Post.where("tags ?| array[:tags]", tags: ["ruby", "postgres"])

4. 展开数组进行更复杂的查询 #

如果需要对数组里的每个元素做条件过滤，可以用jsonb_array_elements函数把数组展开成行：

# 查询数组中存在version大于"7.0"的rails标签的帖子
Post.joins("JOIN jsonb_array_elements(tags) AS tag ON true")
    .where("tag->>'name' = ? AND tag->>'version' > ?", "rails", "7.0")

5. 添加索引优化查询 #

如果经常做数组查询，建议给JSONB字段加GIN索引，大幅提升查询速度：
在迁移文件里添加：

add_index :posts, :tags, using: :gin

或者针对特定的查询模式加部分索引，比如只索引数组里的name字段：

add_index :posts, "(tags->>'name')", using: :gin

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