FAQ and Troubleshooting additions from Nigel Metheringham
[dbsrgits/DBIx-Class.git] / lib / DBIx / Class / Manual / FAQ.pod
1 =head1 NAME 
2
3 DBIx::Class::Manual::FAQ - Frequently Asked Questions
4
5 =head1 General 
6
7 =head2 What is the point of this module? Is it a fork of Class::DBI?
8
9 This is an alternative to Class::DBI, intended to provide greater
10 functionality and simplicity.
11
12 It is inspired by the Class::DBI framework, and meant to support
13 compability with it, while restructuring the internals and making it
14 possible to support some new features like self-joins, distinct, group
15 bys and more.
16
17 =head2 Who's the intended audience for this module?
18
19 =head2 What databases does it support?
20
21 At least MSSQL, MySQL, Oracle, PostgreSQL and SQLite.
22
23 =head2 What's the current status of this module?
24
25 This project is still at an early stage, so the maintainers don't make
26 any absolute promise that full backwards-compatibility will be
27 supported; however, if we can without compromising the improvements
28 we're trying to make, we will, and any non-compatible changes will
29 merit a full justification on the mailing list and a CPAN developer
30 release for people to test against.
31
32 =head2 What's planned in the future?
33
34 =head2 Where can I go for support?
35
36   Mailing list: http://lists.rawmode.org/mailman/listinfo/dbix-class/
37
38   SVN: http://dev.catalyst.perl.org/repos/bast/trunk/DBIx-Class/
39
40   Wiki: http://dbix-class.shadowcatsystems.co.uk/
41
42   IRC: irc.perl.org#dbix-class
43
44 =head1 PostgresQL Specific Problems
45
46 =head2 Can't get last insert id - inserts with serial primary keys fail
47
48 Older DBI and DBD::Pg versions fail to correctly handle
49 C<last_insert_id> correctly, causing code that uses auto incrementing
50 primary key columns to fail with a message such as:-
51
52   Can't get last insert id at /.../DBIx/Class/Row.pm line 95
53
54 In particular the RHEL 4 and FC3 Linux distributions both ship with
55 combinations of DBI and DBD::Pg modules that do not work correctly.
56
57 DBI version 1.50 and DBD::Pg 1.43 are known to work.
58
59 =cut
60