1 package DBIx::Class::Storage::DBI::mysql;
7 DBIx::Class::Storage::DBI::MultiColumnIn
8 DBIx::Class::Storage::DBI
12 __PACKAGE__->sql_maker_class('DBIx::Class::SQLAHacks::MySQL');
14 sub with_deferred_fk_checks {
15 my ($self, $sub) = @_;
17 $self->_do_query('SET FOREIGN_KEY_CHECKS = 0');
19 $self->_do_query('SET FOREIGN_KEY_CHECKS = 1');
22 sub connect_call_set_strict_mode {
25 # the @@sql_mode puts back what was previously set on the session handle
26 $self->_do_query(q|SET SQL_MODE = CONCAT('ANSI,TRADITIONAL,ONLY_FULL_GROUP_BY,', @@sql_mode)|);
27 $self->_do_query(q|SET SQL_AUTO_IS_NULL = 0|);
30 sub _dbh_last_insert_id {
31 my ($self, $dbh, $source, $col) = @_;
32 $dbh->{mysql_insertid};
35 # we need to figure out what mysql version we're running
39 unless ($self->_sql_maker) {
40 my $maker = $self->next::method (@_);
42 # mysql 3 does not understand a bare JOIN
43 my $mysql_ver = $self->_get_dbh->get_info(18);
44 $maker->{_default_jointype} = 'INNER' if $mysql_ver =~ /^3/;
47 return $self->_sql_maker;
55 my ($self, $name) = @_;
57 $self->_get_dbh->do("SAVEPOINT $name");
61 my ($self, $name) = @_;
63 $self->_get_dbh->do("RELEASE SAVEPOINT $name");
67 my ($self, $name) = @_;
69 $self->_get_dbh->do("ROLLBACK TO SAVEPOINT $name")
73 my $status = shift->_get_dbh->selectrow_hashref('show slave status');
74 return ($status->{Slave_IO_Running} eq 'Yes') && ($status->{Slave_SQL_Running} eq 'Yes');
77 sub lag_behind_master {
78 return shift->_get_dbh->selectrow_hashref('show slave status')->{Seconds_Behind_Master};
81 # MySql can not do subquery update/deletes, only way is slow per-row operations.
82 # This assumes you have set proper transaction isolation and use innodb.
83 sub _subq_update_delete {
84 return shift->_per_row_update_delete (@_);
91 DBIx::Class::Storage::DBI::mysql - Storage::DBI class implementing MySQL specifics
95 Storage::DBI autodetects the underlying MySQL database, and re-blesses the
96 C<$storage> object into this class.
98 my $schema = MyDb::Schema->connect( $dsn, $user, $pass, { on_connect_call => 'set_strict_mode' } );
102 This class implements MySQL specific bits of L<DBIx::Class::Storage::DBI>,
103 like AutoIncrement column support and savepoints. Also it augments the
104 SQL maker to support the MySQL-specific C<STRAIGHT_JOIN> join type, which
105 you can use by specifying C<< join_type => 'straight' >> in the
106 L<relationship attributes|DBIx::Class::Relationship::Base/join_type>
109 It also provides a one-stop on-connect macro C<set_strict_mode> which sets
110 session variables such that MySQL behaves more predictably as far as the
111 SQL standard is concerned.
113 =head1 STORAGE OPTIONS
115 =head2 set_strict_mode
117 Enables session-wide strict options upon connecting. Equivalent to:
121 q|SET SQL_MODE = CONCAT('ANSI,TRADITIONAL,ONLY_FULL_GROUP_BY,', @@sql_mode)|,
122 q|SET SQL_AUTO_IS_NULL = 0|,
128 See L<DBIx::Class/CONTRIBUTORS>
132 You may distribute this code under the same terms as Perl itself.