lib/DBIx/Class/Schema/Loader/Manual/UpgradingFromV4.pod

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