From: Matt S Trout Date: Tue, 21 Mar 2006 20:35:38 +0000 (+0000) Subject: Nuked FAQ and shifted it the useful bits into Troubleshooting X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=01afee83a917866ef60276f6d29f5c08766d9741;p=dbsrgits%2FDBIx-Class-Historic.git Nuked FAQ and shifted it the useful bits into Troubleshooting --- diff --git a/lib/DBIx/Class/Manual/FAQ.pod b/lib/DBIx/Class/Manual/FAQ.pod deleted file mode 100644 index 2ff5e61..0000000 --- a/lib/DBIx/Class/Manual/FAQ.pod +++ /dev/null @@ -1,71 +0,0 @@ -=head1 NAME - -DBIx::Class::Manual::FAQ - Frequently asked questions - -=head1 GENERAL - -=head2 What is the point of this module? Is it a fork of Class::DBI? - -This is an alternative to L, intended to provide greater -functionality and simplicity. - -It is inspired by the L framework, and provides a compat -layer to ease porting, but with a resultset-oriented, MI-based -design that makes extension easier and allows us to support more -complex relational operations like self-joins, C, -Cs and more. - -=head2 What databases does it support? - -At least MSSQL, MySQL, Oracle, PostgreSQL, SQLite and DB2. - -=head2 What's the current status of this module? - -This project is still at an early stage, so the maintainers don't make -any absolute promise that full backwards-compatibility will be -supported; however, if we can without compromising the improvements -we're trying to make, we will, and any non-compatible changes will -merit a full justification on the mailing list and a CPAN developer -release for people to test against. - -=head2 Where can I go for support? - - Mailing list: http://lists.rawmode.org/mailman/listinfo/dbix-class/ - - SVN: http://dev.catalyst.perl.org/repos/bast/trunk/DBIx-Class/ - - Wiki: http://dbix-class.shadowcatsystems.co.uk/ - - IRC: irc.perl.org#dbix-class - -=head2 Inflating your date/time columns - -You can use L to automatically create -L objects from your date/time columns. For more information, -see L. - -=head1 POSTGRESQL-SPECIFIC PROBLEMS - -=head2 Can't get last insert ID; inserts with serial primary keys fail - -Older L and L versions do not handle C -correctly, causing code that uses auto-incrementing primary key -columns to fail with a message such as: - - Can't get last insert id at /.../DBIx/Class/Row.pm line 95 - -In particular the RHEL 4 and FC3 Linux distributions both ship with -combinations of L and L modules that do not work -correctly. - -L version 1.50 and L 1.43 are known to work. - -=head1 SEE ALSO - -=over 4 - -=item L - -=back - -=cut diff --git a/lib/DBIx/Class/Manual/Troubleshooting.pod b/lib/DBIx/Class/Manual/Troubleshooting.pod index 6d7dc86..643add5 100644 --- a/lib/DBIx/Class/Manual/Troubleshooting.pod +++ b/lib/DBIx/Class/Manual/Troubleshooting.pod @@ -4,6 +4,10 @@ DBIx::Class::Manual::Troubleshooting - Got a problem? Shoot it. =head2 "Can't locate storage blabla" +You're trying to make a query on a non-connected schema. Make sure you got +the current resultset from $schema->resultset('Artist') on a schema object +you got back from connect(). + =head2 Tracing SQL The C environment variable controls @@ -23,5 +27,25 @@ Alternatively you can do this with the environment variable too:- export DBIX_CLASS_STORAGE_DBI_DEBUG="1=/tmp/trace.out" +=head2 Can't locate method result_source_instance + +For some reason the table class in question didn't load fully, so the +ResultSource object for it hasn't been created. Debug this class in +isolation, then try loading the full schema again. + +=head2 Can't get last insert ID under Postgres with serial primary keys + +Older L and L versions do not handle C +correctly, causing code that uses auto-incrementing primary key +columns to fail with a message such as: + + Can't get last insert id at /.../DBIx/Class/Row.pm line 95 + +In particular the RHEL 4 and FC3 Linux distributions both ship with +combinations of L and L modules that do not work +correctly. + +L version 1.50 and L 1.43 are known to work. + =cut