Commit | Line | Data |
843f8ecd |
1 | package DBIx::Class::Storage::DBI::mysql; |
2 | |
3 | use strict; |
4 | use warnings; |
5 | |
be64931c |
6 | use base qw/DBIx::Class::Storage::DBI/; |
843f8ecd |
7 | |
45150bc4 |
8 | use namespace::clean; |
9 | |
d5dedbd6 |
10 | __PACKAGE__->sql_maker_class('DBIx::Class::SQLMaker::MySQL'); |
6a247f33 |
11 | __PACKAGE__->sql_limit_dialect ('LimitXY'); |
2b8cc2f2 |
12 | __PACKAGE__->sql_quote_char ('`'); |
843f8ecd |
13 | |
be64931c |
14 | __PACKAGE__->_use_multicolumn_in (1); |
15 | |
e96a93df |
16 | sub with_deferred_fk_checks { |
17 | my ($self, $sub) = @_; |
18 | |
5cf7285e |
19 | $self->_do_query('SET FOREIGN_KEY_CHECKS = 0'); |
e96a93df |
20 | $sub->(); |
5cf7285e |
21 | $self->_do_query('SET FOREIGN_KEY_CHECKS = 1'); |
e96a93df |
22 | } |
23 | |
97a0a148 |
24 | sub connect_call_set_strict_mode { |
0fde80d9 |
25 | my $self = shift; |
97a0a148 |
26 | |
27 | # the @@sql_mode puts back what was previously set on the session handle |
28 | $self->_do_query(q|SET SQL_MODE = CONCAT('ANSI,TRADITIONAL,ONLY_FULL_GROUP_BY,', @@sql_mode)|); |
0fde80d9 |
29 | $self->_do_query(q|SET SQL_AUTO_IS_NULL = 0|); |
30 | } |
31 | |
d4f16b21 |
32 | sub _dbh_last_insert_id { |
33 | my ($self, $dbh, $source, $col) = @_; |
34 | $dbh->{mysql_insertid}; |
843f8ecd |
35 | } |
36 | |
45150bc4 |
37 | sub _prep_for_execute { |
38 | my $self = shift; |
39 | #(my $op, $ident, $args) = @_; |
40 | |
41 | # Only update and delete need special double-subquery treatment |
42 | # Insert referencing the same table (i.e. SELECT MAX(id) + 1) seems |
43 | # to work just fine on MySQL |
44 | return $self->next::method(@_) if ( $_[0] eq 'select' or $_[0] eq 'insert' ); |
45 | |
46 | |
47 | # FIXME FIXME FIXME - this is a terrible, gross, incomplete hack |
48 | # it should be trivial for mst to port this to DQ (and a good |
49 | # exercise as well, since we do not yet have such wide tree walking |
50 | # in place). For the time being this will work in limited cases, |
51 | # mainly complex update/delete, which is really all we want it for |
52 | # currently (allows us to fix some bugs without breaking MySQL in |
53 | # the process, and is also crucial for Shadow to be usable) |
54 | |
55 | # extract the source name, construct modification indicator re |
56 | my $sm = $self->sql_maker; |
57 | |
58 | my $target_name = $_[1]->from; |
59 | |
60 | if (ref $target_name) { |
61 | if ( |
62 | ref $target_name eq 'SCALAR' |
63 | and |
64 | $$target_name =~ /^ (?: |
65 | \` ( [^`]+ ) \` #` |
66 | | ( [\w\-]+ ) |
67 | ) $/x |
68 | ) { |
69 | # this is just a plain-ish name, which has been literal-ed for |
70 | # whatever reason |
d77ee505 |
71 | $target_name = (defined $1) ? $1 : $2; |
45150bc4 |
72 | } |
73 | else { |
74 | # this is something very complex, perhaps a custom result source or whatnot |
75 | # can't deal with it |
76 | undef $target_name; |
77 | } |
78 | } |
79 | |
80 | local $sm->{_modification_target_referenced_re} = |
f4fdfd69 |
81 | qr/ (?<!DELETE) [\s\)] (?: FROM | JOIN ) \s (?: \` \Q$target_name\E \` | \Q$target_name\E ) [\s\(] /xi |
45150bc4 |
82 | if $target_name; |
83 | |
84 | $self->next::method(@_); |
85 | } |
86 | |
f98120e4 |
87 | # here may seem like an odd place to override, but this is the first |
88 | # method called after we are connected *and* the driver is determined |
89 | # ($self is reblessed). See code flow in ::Storage::DBI::_populate_dbh |
90 | sub _run_connection_actions { |
91 | my $self = shift; |
92 | |
93 | # default mysql_auto_reconnect to off unless explicitly set |
94 | if ( |
95 | $self->_dbh->{mysql_auto_reconnect} |
96 | and |
97 | ! exists $self->_dbic_connect_attributes->{mysql_auto_reconnect} |
98 | ) { |
99 | $self->_dbh->{mysql_auto_reconnect} = 0; |
100 | } |
101 | |
102 | $self->next::method(@_); |
103 | } |
104 | |
d3944540 |
105 | # we need to figure out what mysql version we're running |
106 | sub sql_maker { |
107 | my $self = shift; |
108 | |
b6a469f7 |
109 | # it is critical to get the version *before* calling next::method |
110 | # otherwise the potential connect will obliterate the sql_maker |
111 | # next::method will populate in the _sql_maker accessor |
112 | my $mysql_ver = $self->_server_info->{normalized_dbms_version}; |
d3944540 |
113 | |
b6a469f7 |
114 | my $sm = $self->next::method(@_); |
115 | |
116 | # mysql 3 does not understand a bare JOIN |
117 | $sm->{_default_jointype} = 'INNER' if $mysql_ver < 4; |
d3944540 |
118 | |
b6a469f7 |
119 | $sm; |
d3944540 |
120 | } |
121 | |
e8d293df |
122 | sub sqlt_type { |
123 | return 'MySQL'; |
124 | } |
125 | |
96736321 |
126 | sub deployment_statements { |
127 | my $self = shift; |
128 | my ($schema, $type, $version, $dir, $sqltargs, @rest) = @_; |
129 | |
130 | $sqltargs ||= {}; |
131 | |
132 | if ( |
133 | ! exists $sqltargs->{producer_args}{mysql_version} |
8273e845 |
134 | and |
96736321 |
135 | my $dver = $self->_server_info->{normalized_dbms_version} |
136 | ) { |
137 | $sqltargs->{producer_args}{mysql_version} = $dver; |
138 | } |
139 | |
140 | $self->next::method($schema, $type, $version, $dir, $sqltargs, @rest); |
141 | } |
142 | |
90d7422f |
143 | sub _exec_svp_begin { |
eeb8cfeb |
144 | my ($self, $name) = @_; |
adb3554a |
145 | |
90d7422f |
146 | $self->_dbh->do("SAVEPOINT $name"); |
adb3554a |
147 | } |
148 | |
90d7422f |
149 | sub _exec_svp_release { |
eeb8cfeb |
150 | my ($self, $name) = @_; |
adb3554a |
151 | |
90d7422f |
152 | $self->_dbh->do("RELEASE SAVEPOINT $name"); |
adb3554a |
153 | } |
154 | |
90d7422f |
155 | sub _exec_svp_rollback { |
eeb8cfeb |
156 | my ($self, $name) = @_; |
adb3554a |
157 | |
90d7422f |
158 | $self->_dbh->do("ROLLBACK TO SAVEPOINT $name") |
adb3554a |
159 | } |
48fe9087 |
160 | |
106d5f3b |
161 | sub is_replicating { |
9ae966b9 |
162 | my $status = shift->_get_dbh->selectrow_hashref('show slave status'); |
f797e89e |
163 | return ($status->{Slave_IO_Running} eq 'Yes') && ($status->{Slave_SQL_Running} eq 'Yes'); |
106d5f3b |
164 | } |
165 | |
166 | sub lag_behind_master { |
9ae966b9 |
167 | return shift->_get_dbh->selectrow_hashref('show slave status')->{Seconds_Behind_Master}; |
106d5f3b |
168 | } |
169 | |
843f8ecd |
170 | 1; |
171 | |
75d07914 |
172 | =head1 NAME |
843f8ecd |
173 | |
c9d438ff |
174 | DBIx::Class::Storage::DBI::mysql - Storage::DBI class implementing MySQL specifics |
843f8ecd |
175 | |
176 | =head1 SYNOPSIS |
177 | |
c9d438ff |
178 | Storage::DBI autodetects the underlying MySQL database, and re-blesses the |
179 | C<$storage> object into this class. |
180 | |
a5bd5d88 |
181 | my $schema = MyApp::Schema->connect( $dsn, $user, $pass, { on_connect_call => 'set_strict_mode' } ); |
843f8ecd |
182 | |
183 | =head1 DESCRIPTION |
184 | |
b8391c87 |
185 | This class implements MySQL specific bits of L<DBIx::Class::Storage::DBI>, |
186 | like AutoIncrement column support and savepoints. Also it augments the |
187 | SQL maker to support the MySQL-specific C<STRAIGHT_JOIN> join type, which |
188 | you can use by specifying C<< join_type => 'straight' >> in the |
189 | L<relationship attributes|DBIx::Class::Relationship::Base/join_type> |
190 | |
c9d438ff |
191 | |
97a0a148 |
192 | It also provides a one-stop on-connect macro C<set_strict_mode> which sets |
193 | session variables such that MySQL behaves more predictably as far as the |
194 | SQL standard is concerned. |
0fde80d9 |
195 | |
3c01add8 |
196 | =head1 STORAGE OPTIONS |
197 | |
198 | =head2 set_strict_mode |
199 | |
200 | Enables session-wide strict options upon connecting. Equivalent to: |
201 | |
202 | ->connect ( ... , { |
203 | on_connect_do => [ |
204 | q|SET SQL_MODE = CONCAT('ANSI,TRADITIONAL,ONLY_FULL_GROUP_BY,', @@sql_mode)|, |
205 | q|SET SQL_AUTO_IS_NULL = 0|, |
206 | ] |
207 | }); |
208 | |
a2bd3796 |
209 | =head1 FURTHER QUESTIONS? |
843f8ecd |
210 | |
a2bd3796 |
211 | Check the list of L<additional DBIC resources|DBIx::Class/GETTING HELP/SUPPORT>. |
843f8ecd |
212 | |
a2bd3796 |
213 | =head1 COPYRIGHT AND LICENSE |
843f8ecd |
214 | |
a2bd3796 |
215 | This module is free software L<copyright|DBIx::Class/COPYRIGHT AND LICENSE> |
216 | by the L<DBIx::Class (DBIC) authors|DBIx::Class/AUTHORS>. You can |
217 | redistribute it and/or modify it under the same terms as the |
218 | L<DBIx::Class library|DBIx::Class/COPYRIGHT AND LICENSE>. |