我非常高兴在宣布Rails 4.0 现在支持 PostgreSQL 数组类型. 你可以方便的在migration通过 :array => true里创建数组类型的字段. 创建数组类型的字段的时候还可以添加其它的选项(length,default,等等)
create_table :table_with_arrays do |t| t.integer :int_array, :array => true # integer[] t.integer :int_array, :array => true, :length => 2 # smallint[] t.string :string_array, :array => true, :length => 30 # char varying(30)[] end
需要注意在是对数组类型的字段设置默认值的时候,你应该用Postgresql里的写法({value,another value}), 如果你想设置数组类型的字段默认值为空数组的时候,你应该使用:default => '{}'
create_table :table_with_arrays do |t|
t.integer :int_array, :array => true, :default => '{}'
# integer[], default == []
t.integer :int_array, :array => true, :length => 2, :default => '{1}'
# smallint[], default == [1]
end
在Model里使用Postgresql数组的例子
我们现在有个包含first_name, last_name, nickname的user model, 其中nickname字段是数组类型. 下面的migration代码会创建相应的表:
create_table :users do |t| t.string :first_name t.string :last_name t.string :nicknames, :array => true end
并且对于这个表,我们有个简单的model
class User < ActiveRecord::Base attr_accessible :first_name, :last_name, :nicknames end
我们没有对字段使用默认值,如果我们实例一个User 对象,代码是这样的.
john = User.create(:first_name => 'John', :last_name => 'Doe')
如果,我们调用john.nickname, 结果会返回nil, 并且在postgreSQL 里存储的是NULL值.
我们通过下面的代码可以在创建时,设置nickname属性值
john = User.create(:first_name => 'John', :last_name => 'Doe', :nicknames => ['Jack', 'Johnny'])
如果我们从数据库获取记录，那么nick_name字段会转变成一个数组，而不是返回字符串{Jack, Johnny}!。Rails 4.0拥有一个纯Ruby数组转换器，但是如果你想让转换过程加速，那么就可以使用之前提到的 pg_array_parser gem。PgArrayParser 拥有一个基于C的扩展，还有一个JRuby的Java的实现（即使这个gem现在在JRuby上存在些问题，我正在尝试去解决这个问题。）
有一个重点需要注意的，就是当在一个model中和数组（或者其他可变数值）交互的时候。ActiveRecord现在并没有跟踪"destructive"，或者更改发生的地方。这包括数组的push和pop操作。如果你需要使用"destructive"更新，你必须使用call<属性>_will_change！这样可以让ActiveRecord知道你需要更改属性的值。对于我们的这个User model，如果你想在nickname后面追加元素，你可以这样做：
john = User.first
john.nicknames += ['Jackie boy']
# 或者
john.nicknames = john.nicknames.push('Jackie boy')
# 任何时候，属性通过"="赋值，ActiveRecord会跟踪这个更改
john.save
john.reload
john.nicknames
#=> ['Jack', 'Johnny', 'Jackie Boy']
john.nicknames.pop
john.nicknames_will_change!
# '#pop'操作会改变数组的值，所以我们需要告诉ActiveRecord它将会发生更改
john.save
最后一项在Postgresql中使用数组要注意的事情是: 数组没有元素数量限制,可以是多维数组,但是在使用多维数组时, 子数组元素个数必须是一样的.
[[1,2,3], [2,3,4], [4,5,nil]] # 在PostgreSQL 可用，每个子数组元素个数一样 [1,2,[3,4]] # 不可用的数组
