++ed by:

103 PAUSE user(s)
102 non-PAUSE user(s).

Peter Rabbitson
and 194 contributors


DBIx::Class::Storage::DBI::SQLite - Automatic primary key class for SQLite


  # In your table classes
  use base 'DBIx::Class::Core';


This class implements autoincrements for SQLite.

Known Issues

 NOTE - This section applies to you only if ALL of these are true:

  * You are or were using DBD::SQLite with a version lesser than 1.38_01

  * You are or were using DBIx::Class versions between 0.08191 and 0.08209
    (inclusive) or between 0.08240-TRIAL and 0.08242-TRIAL (also inclusive)

  * You use objects with overloaded stringification and are feeding them
    to DBIC CRUD methods directly

An unfortunate chain of events led to DBIx::Class silently hitting the problem described in RT#79576.

In order to trigger the bug condition one needs to supply more than one bind value that is an object with overloaded stringification (numification is not relevant, only stringification is). When this is the case the internal DBIx::Class call to $sth->bind_param would be executed in a way that triggers the above-mentioned DBD::SQLite bug. As a result all the logs and tracers will contain the expected values, however SQLite will receive all these bind positions being set to the value of the last supplied stringifiable object.

Even if you upgrade DBIx::Class (which works around the bug starting from version 0.08210) you may still have corrupted/incorrect data in your database. DBIx::Class will currently detect when this condition (more than one stringifiable object in one CRUD call) is encountered and will issue a warning pointing to this section. This warning will be removed 2 years from now, around April 2015, You can disable it after you've audited your data by setting the DBIC_RT79576_NOWARN environment variable. Note - the warning is emitted only once per callsite per process and only when the condition in question is encountered. Thus it is very unlikely that your logsystem will be flooded as a result of this.



Used as:

    on_connect_call => 'use_foreign_keys'

In connect_info to turn on foreign key (including cascading) support for recent versions of SQLite and DBD::SQLite.


  PRAGMA foreign_keys = ON

See http://www.sqlite.org/foreignkeys.html for more information.


Check the list of additional DBIC resources.


This module is free software copyright by the DBIx::Class (DBIC) authors. You can redistribute it and/or modify it under the same terms as the DBIx::Class library.