The DBIC docs have lately got much better but they are compartmentalized pretty well so you might miss things unless you read the relevant (and sometimes "invisible") class: DBIx::Class::Row. It's been there as long as I can remember and it's not going anywhere.