Renamed Table to ResultSource::Table, tweaked FAQ
[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 L<Class::DBI>, intended to provide greater
10 functionality and simplicity.
11
12 It is inspired by the L<Class::DBI> framework, and provides a compat
13 layer to ease porting, but with a resultset-oriented, MI-based
14 design that makes extension easier and allows us to support more
15 complex relational operations like self-joins, C<DISTINCT>,
16 C<GROUP BY>s and more.
17
18 =head2 What databases does it support?
19
20 At least MSSQL, MySQL, Oracle, PostgreSQL, SQLite and DB2.
21
22 =head2 What's the current status of this module?
23
24 This project is still at an early stage, so the maintainers don't make
25 any absolute promise that full backwards-compatibility will be
26 supported; however, if we can without compromising the improvements
27 we're trying to make, we will, and any non-compatible changes will
28 merit a full justification on the mailing list and a CPAN developer
29 release for people to test against.
30
31 =head2 Where can I go for support?
32
33   Mailing list: http://lists.rawmode.org/mailman/listinfo/dbix-class/
34
35   SVN: http://dev.catalyst.perl.org/repos/bast/trunk/DBIx-Class/
36
37   Wiki: http://dbix-class.shadowcatsystems.co.uk/
38
39   IRC: irc.perl.org#dbix-class
40
41 =head2 Inflating your date/time columns
42
43 You can use L<DBIx::Class::InflateColumn> to automatically create
44 L<DateTime> objects from your date/time columns. For more information,
45 see L<DBIx::Class::InflateColumn>.
46
47 =head1 POSTGRESQL-SPECIFIC PROBLEMS
48
49 =head2 Can't get last insert ID; inserts with serial primary keys fail
50
51 Older L<DBI> and L<DBD::Pg> versions do not handle C<last_insert_id>
52 correctly, causing code that uses auto-incrementing primary key
53 columns to fail with a message such as:
54
55   Can't get last insert id at /.../DBIx/Class/Row.pm line 95
56
57 In particular the RHEL 4 and FC3 Linux distributions both ship with
58 combinations of L<DBI> and L<DBD::Pg> modules that do not work
59 correctly.
60
61 L<DBI> version 1.50 and L<DBD::Pg> 1.43 are known to work.
62
63 =head1 SEE ALSO
64
65 =over 4
66
67 =item L<DBIx::Class::Manual::Intro>
68
69 =back
70
71 =cut