1=pod 2 3=head1 NAME 4 5DBIx::Class::Schema::Loader::Manual::UpgradingFromV4 - Important Information 6Related to Upgrading from Version 0.04006 7 8=head1 What Changed 9 10=over 4 11 12=item * 13 14add_column 15 16The new Loader detects much more information about columns and sets flags like 17C<is_auto_increment> that it didn't set before. 18 19=item * 20 21RelBuilder 22 23The new RelBuilder will give you nicer accessor names for relationships, so you 24will no longer have conflicts between a foreign key column and the relationship 25accessor itself (if the FK is named C<_id>.) 26 27It will also more correctly infer the relationship type, e.g. some relationships 28that were previously detected as a C<has_many> will now be a C<might_have> 29(when it detects a unique constraint on the foreign key column.) 30 31Also C<cascade_delete> and C<cascade_copy> are turned off for by default for 32C<has_many> and C<might_have> relationships, while C<belongs_to> relationships 33are created with C<< on_delete => 'CASCADE' >> and C<< on_update => 'CASCADE' >> 34by default. This is overridable via 35L<relationship_attrs|DBIx::Class::Schema::Loader::Base/relationship_attrs>. 36 37=item * 38 39moniker_map 40 41Table names are now singularized when determining the C<Result> class names. So 42the table C<user_roles> would have become C<UserRoles> in C<0.04006> but now 43becomes C<UserRole> instead. 44 45=item * 46 47use_namespaces 48 49Now defaults to on. See L<DBIx::Class::Schema::Loader::Base/use_namespaces> and 50L<DBIx::Class::Schema/"load_namespaces">. 51 52=item * 53 54Support for more databases 55 56We now support Microsoft SQL Server and Sybase, and there are also many 57improvements to the other backends. 58 59=back 60 61=head1 Backward Compatibility 62 63In backward compatibility mode, the Loader will use the old relationship names 64and types, will not singularize monikers for tables, and C<use_namespaces> will 65be off. 66 67To control this behavior see L<DBIx::Class::Schema::Loader::Base/naming> and 68L<DBIx::Class::Schema::Loader::Base/use_namespaces>. 69 70=head2 Static Schemas 71 72When reading a C<Schema.pm> from a static schema generated with an C<0.04> 73version of Loader, backward compatibility mode will default to on, unless 74overridden with the C<naming> and/or C<use_namespaces> attributes. 75 76=head2 Dynamic Schemas 77 78Dynamic schemas will always by default use C<0.04006> mode and have 79C<use_namespaces> off. 80 81To upgrade a dynamic schema, set the C<naming> and C<use_namespaces> attributes 82(which is proxied to the loader) in your C<Schema.pm>: 83 84 __PACKAGE__->naming('current'); 85 __PACKAGE__->use_namespaces(1); 86 87=head1 AUTHOR 88 89See L<DBIx::Class::Schema::Loader/AUTHOR> and L<DBIx::Class::Schema::Loader/CONTRIBUTORS>. 90 91=head1 LICENSE 92 93This library is free software; you can redistribute it and/or modify it under 94the same terms as Perl itself. 95 96=cut 97