Add a warning for DBD::Pg < 1.49
[dbsrgits/DBIx-Class.git] / lib / DBIx / Class / Storage / DBI.pm
CommitLineData
8b445e33 1package DBIx::Class::Storage::DBI;
e673f011 2# -*- mode: cperl; cperl-indent-level: 2 -*-
8b445e33 3
a62cf8d4 4use base 'DBIx::Class::Storage';
5
20a2c954 6use strict;
7use warnings;
8b445e33 8use DBI;
aeaf3ce2 9use SQL::Abstract::Limit;
28927b50 10use DBIx::Class::Storage::DBI::Cursor;
4c248161 11use DBIx::Class::Storage::Statistics;
92b858c9 12use IO::File;
701da8c4 13use Carp::Clan qw/DBIx::Class/;
bd7efd39 14BEGIN {
15
cb5f2eea 16package DBIC::SQL::Abstract; # Would merge upstream, but nate doesn't reply :(
bd7efd39 17
18use base qw/SQL::Abstract::Limit/;
19
54540863 20sub select {
21 my ($self, $table, $fields, $where, $order, @rest) = @_;
6346a152 22 $table = $self->_quote($table) unless ref($table);
54540863 23 @rest = (-1) unless defined $rest[0];
0823196c 24 die "LIMIT 0 Does Not Compute" if $rest[0] == 0;
25 # and anyway, SQL::Abstract::Limit will cause a barf if we don't first
8839560b 26 local $self->{having_bind} = [];
bc0c9800 27 my ($sql, @ret) = $self->SUPER::select(
28 $table, $self->_recurse_fields($fields), $where, $order, @rest
29 );
8839560b 30 return wantarray ? ($sql, @ret, @{$self->{having_bind}}) : $sql;
54540863 31}
32
6346a152 33sub insert {
34 my $self = shift;
35 my $table = shift;
36 $table = $self->_quote($table) unless ref($table);
37 $self->SUPER::insert($table, @_);
38}
39
40sub update {
41 my $self = shift;
42 my $table = shift;
43 $table = $self->_quote($table) unless ref($table);
44 $self->SUPER::update($table, @_);
45}
46
47sub delete {
48 my $self = shift;
49 my $table = shift;
50 $table = $self->_quote($table) unless ref($table);
51 $self->SUPER::delete($table, @_);
52}
53
54540863 54sub _emulate_limit {
55 my $self = shift;
56 if ($_[3] == -1) {
57 return $_[1].$self->_order_by($_[2]);
58 } else {
59 return $self->SUPER::_emulate_limit(@_);
60 }
61}
62
63sub _recurse_fields {
64 my ($self, $fields) = @_;
65 my $ref = ref $fields;
66 return $self->_quote($fields) unless $ref;
67 return $$fields if $ref eq 'SCALAR';
68
69 if ($ref eq 'ARRAY') {
70 return join(', ', map { $self->_recurse_fields($_) } @$fields);
71 } elsif ($ref eq 'HASH') {
72 foreach my $func (keys %$fields) {
73 return $self->_sqlcase($func)
74 .'( '.$self->_recurse_fields($fields->{$func}).' )';
75 }
76 }
77}
78
79sub _order_by {
80 my $self = shift;
81 my $ret = '';
8839560b 82 my @extra;
54540863 83 if (ref $_[0] eq 'HASH') {
84 if (defined $_[0]->{group_by}) {
85 $ret = $self->_sqlcase(' group by ')
86 .$self->_recurse_fields($_[0]->{group_by});
87 }
8839560b 88 if (defined $_[0]->{having}) {
89 my $frag;
90 ($frag, @extra) = $self->_recurse_where($_[0]->{having});
91 push(@{$self->{having_bind}}, @extra);
92 $ret .= $self->_sqlcase(' having ').$frag;
93 }
54540863 94 if (defined $_[0]->{order_by}) {
95 $ret .= $self->SUPER::_order_by($_[0]->{order_by});
96 }
e535069e 97 } elsif(ref $_[0] eq 'SCALAR') {
98 $ret = $self->_sqlcase(' order by ').${ $_[0] };
54540863 99 } else {
100 $ret = $self->SUPER::_order_by(@_);
101 }
102 return $ret;
103}
104
f48dd03f 105sub _order_directions {
106 my ($self, $order) = @_;
107 $order = $order->{order_by} if ref $order eq 'HASH';
108 return $self->SUPER::_order_directions($order);
109}
110
2a816814 111sub _table {
bd7efd39 112 my ($self, $from) = @_;
113 if (ref $from eq 'ARRAY') {
114 return $self->_recurse_from(@$from);
115 } elsif (ref $from eq 'HASH') {
116 return $self->_make_as($from);
117 } else {
6346a152 118 return $from; # would love to quote here but _table ends up getting called
119 # twice during an ->select without a limit clause due to
120 # the way S::A::Limit->select works. should maybe consider
121 # bypassing this and doing S::A::select($self, ...) in
122 # our select method above. meantime, quoting shims have
123 # been added to select/insert/update/delete here
bd7efd39 124 }
125}
126
127sub _recurse_from {
128 my ($self, $from, @join) = @_;
129 my @sqlf;
130 push(@sqlf, $self->_make_as($from));
131 foreach my $j (@join) {
132 my ($to, $on) = @$j;
73856587 133
54540863 134 # check whether a join type exists
135 my $join_clause = '';
136 if (ref($to) eq 'HASH' and exists($to->{-join_type})) {
137 $join_clause = ' '.uc($to->{-join_type}).' JOIN ';
138 } else {
139 $join_clause = ' JOIN ';
140 }
73856587 141 push(@sqlf, $join_clause);
142
bd7efd39 143 if (ref $to eq 'ARRAY') {
144 push(@sqlf, '(', $self->_recurse_from(@$to), ')');
145 } else {
96cdbbab 146 push(@sqlf, $self->_make_as($to));
bd7efd39 147 }
148 push(@sqlf, ' ON ', $self->_join_condition($on));
149 }
150 return join('', @sqlf);
151}
152
153sub _make_as {
154 my ($self, $from) = @_;
54540863 155 return join(' ', map { (ref $_ eq 'SCALAR' ? $$_ : $self->_quote($_)) }
bc0c9800 156 reverse each %{$self->_skip_options($from)});
73856587 157}
158
159sub _skip_options {
54540863 160 my ($self, $hash) = @_;
161 my $clean_hash = {};
162 $clean_hash->{$_} = $hash->{$_}
163 for grep {!/^-/} keys %$hash;
164 return $clean_hash;
bd7efd39 165}
166
167sub _join_condition {
168 my ($self, $cond) = @_;
5efe4c79 169 if (ref $cond eq 'HASH') {
170 my %j;
bc0c9800 171 for (keys %$cond) {
172 my $x = '= '.$self->_quote($cond->{$_}); $j{$_} = \$x;
173 };
5efe4c79 174 return $self->_recurse_where(\%j);
175 } elsif (ref $cond eq 'ARRAY') {
176 return join(' OR ', map { $self->_join_condition($_) } @$cond);
177 } else {
178 die "Can't handle this yet!";
179 }
bd7efd39 180}
181
2a816814 182sub _quote {
183 my ($self, $label) = @_;
184 return '' unless defined $label;
3b24f6ea 185 return "*" if $label eq '*';
41728a6e 186 return $label unless $self->{quote_char};
3b24f6ea 187 if(ref $self->{quote_char} eq "ARRAY"){
188 return $self->{quote_char}->[0] . $label . $self->{quote_char}->[1]
189 if !defined $self->{name_sep};
190 my $sep = $self->{name_sep};
191 return join($self->{name_sep},
192 map { $self->{quote_char}->[0] . $_ . $self->{quote_char}->[1] }
193 split(/\Q$sep\E/,$label));
194 }
2a816814 195 return $self->SUPER::_quote($label);
196}
197
f66596f9 198sub _RowNum {
199 my $self = shift;
200 my $c;
201 $_[0] =~ s/SELECT (.*?) FROM/
202 'SELECT '.join(', ', map { $_.' AS col'.++$c } split(', ', $1)).' FROM'/e;
203 $self->SUPER::_RowNum(@_);
204}
205
7be93b07 206# Accessor for setting limit dialect. This is useful
207# for JDBC-bridge among others where the remote SQL-dialect cannot
208# be determined by the name of the driver alone.
209#
210sub limit_dialect {
211 my $self = shift;
212 $self->{limit_dialect} = shift if @_;
213 return $self->{limit_dialect};
214}
215
2437a1e3 216sub quote_char {
217 my $self = shift;
218 $self->{quote_char} = shift if @_;
219 return $self->{quote_char};
220}
221
222sub name_sep {
223 my $self = shift;
224 $self->{name_sep} = shift if @_;
225 return $self->{name_sep};
226}
227
bd7efd39 228} # End of BEGIN block
229
8b445e33 230use base qw/DBIx::Class/;
231
1f692767 232__PACKAGE__->load_components(qw/AccessorGroup/);
8b445e33 233
223b8fe3 234__PACKAGE__->mk_group_accessors('simple' =>
4c248161 235 qw/_connect_info _dbh _sql_maker _conn_pid _conn_tid debug debugobj
1346e22d 236 cursor on_connect_do transaction_depth/);
8091aa91 237
8b445e33 238sub new {
223b8fe3 239 my $new = bless({}, ref $_[0] || $_[0]);
28927b50 240 $new->cursor("DBIx::Class::Storage::DBI::Cursor");
d79f59b9 241 $new->transaction_depth(0);
4c248161 242
243 $new->debugobj(new DBIx::Class::Storage::Statistics());
244
245 my $fh;
5e65c358 246 if (defined($ENV{DBIX_CLASS_STORAGE_DBI_DEBUG}) &&
247 ($ENV{DBIX_CLASS_STORAGE_DBI_DEBUG} =~ /=(.+)$/)) {
4c248161 248 $fh = IO::File->new($1, 'w')
bc0c9800 249 or $new->throw_exception("Cannot open trace file $1");
92b858c9 250 } else {
4c248161 251 $fh = IO::File->new('>&STDERR');
92b858c9 252 }
4c248161 253 $new->debugobj->debugfh($fh);
28927b50 254 $new->debug(1) if $ENV{DBIX_CLASS_STORAGE_DBI_DEBUG};
223b8fe3 255 return $new;
8b445e33 256}
257
1c339d71 258sub throw_exception {
259 my ($self, $msg) = @_;
3b042bcb 260 croak($msg);
1c339d71 261}
262
75d07914 263=head1 NAME
8b445e33 264
265DBIx::Class::Storage::DBI - DBI storage handler
266
267=head1 SYNOPSIS
268
269=head1 DESCRIPTION
270
271This class represents the connection to the database
272
273=head1 METHODS
274
8b445e33 275=cut
276
1b45b01e 277=head2 connect_info
278
279Connection information arrayref. Can either be the same arguments
280one would pass to DBI->connect, or a code-reference which returns
281a connected database handle. In either case, there is an optional
282final element in the arrayref, which can hold a hashref of
283connection-specific Storage::DBI options. These include
284C<on_connect_do>, and the sql_maker options C<limit_dialect>,
285C<quote_char>, and C<name_sep>. Examples:
286
287 ->connect_info([ 'dbi:SQLite:./foo.db' ]);
288 ->connect_info(sub { DBI->connect(...) });
289 ->connect_info([ 'dbi:Pg:dbname=foo',
290 'postgres',
291 '',
292 { AutoCommit => 0 },
293 { quote_char => q{`}, name_sep => q{@} },
294 ]);
295
d7c4c15c 296=head2 on_connect_do
297
298Executes the sql statements given as a listref on every db connect.
299
6789ebe3 300=head2 quote_char
301
302Specifies what characters to use to quote table and column names. If
303you use this you will want to specify L<name_sep> as well.
304
305quote_char expectes either a single character, in which case is it is placed
306on either side of the table/column, or an array of length 2 in which case the
307table/column name is placed between the elements.
308
309For example under MySQL you'd use C<quote_char('`')>, and user SQL Server you'd
310use C<quote_char(qw/[ ]/)>.
311
312=head2 name_sep
313
314This only needs to be used in conjunction with L<quote_char>, and is used to
315specify the charecter that seperates elements (schemas, tables, columns) from
316each other. In most cases this is simply a C<.>.
317
92b858c9 318=head2 debug
319
4c248161 320Causes SQL trace information to be emitted on the C<debugobj> object.
321(or C<STDERR> if C<debugobj> has not specifically been set).
92b858c9 322
323=head2 debugfh
324
4c248161 325Set or retrieve the filehandle used for trace/debug output. This should be
326an IO::Handle compatible ojbect (only the C<print> method is used. Initially
327set to be STDERR - although see information on the
92b858c9 328L<DBIX_CLASS_STORAGE_DBI_DEBUG> environment variable.
329
4c248161 330=head2 debugobj
331
332Sets or retrieves the object used for metric collection. Defaults to an instance
333of L<DBIx::Class::Storage::Statistics> that is campatible with the original
334method of using a coderef as a callback. See the aforementioned Statistics
335class for more information.
336
486ad69b 337=head2 debugcb
338
339Sets a callback to be executed each time a statement is run; takes a sub
4c248161 340reference. Callback is executed as $sub->($op, $info) where $op is
341SELECT/INSERT/UPDATE/DELETE and $info is what would normally be printed.
486ad69b 342
4c248161 343See L<debugobj> for a better way.
d7c4c15c 344
4c248161 345=cut
486ad69b 346sub debugcb {
4c248161 347 my $self = shift();
348
349 if($self->debugobj()->can('callback')) {
350 $self->debugobj()->callback(shift());
351 }
486ad69b 352}
353
412db1f4 354sub disconnect {
355 my ($self) = @_;
356
92925617 357 if( $self->connected ) {
358 $self->_dbh->rollback unless $self->_dbh->{AutoCommit};
359 $self->_dbh->disconnect;
360 $self->_dbh(undef);
361 }
412db1f4 362}
363
364sub connected {
8b445e33 365 my ($self) = @_;
412db1f4 366
1346e22d 367 if(my $dbh = $self->_dbh) {
368 if(defined $self->_conn_tid && $self->_conn_tid != threads->tid) {
369 $self->_sql_maker(undef);
370 return $self->_dbh(undef);
371 }
372 elsif($self->_conn_pid != $$) {
373 $self->_dbh->{InactiveDestroy} = 1;
374 $self->_sql_maker(undef);
375 return $self->_dbh(undef)
376 }
377 return ($dbh->FETCH('Active') && $dbh->ping);
378 }
379
380 return 0;
412db1f4 381}
382
383sub ensure_connected {
384 my ($self) = @_;
385
386 unless ($self->connected) {
8b445e33 387 $self->_populate_dbh;
388 }
412db1f4 389}
390
c235bbae 391=head2 dbh
392
393Returns the dbh - a data base handle of class L<DBI>.
394
395=cut
396
412db1f4 397sub dbh {
398 my ($self) = @_;
399
400 $self->ensure_connected;
8b445e33 401 return $self->_dbh;
402}
403
f1f56aad 404sub _sql_maker_args {
405 my ($self) = @_;
406
407 return ( limit_dialect => $self->dbh );
408}
409
48c69e7c 410sub sql_maker {
411 my ($self) = @_;
fdc1c3d0 412 unless ($self->_sql_maker) {
f1f56aad 413 $self->_sql_maker(new DBIC::SQL::Abstract( $self->_sql_maker_args ));
48c69e7c 414 }
415 return $self->_sql_maker;
416}
417
1b45b01e 418sub connect_info {
419 my ($self, $info_arg) = @_;
420
421 if($info_arg) {
422 my $info = [ @$info_arg ]; # copy because we can alter it
423 my $last_info = $info->[-1];
424 if(ref $last_info eq 'HASH') {
425 my $used;
426 if(my $on_connect_do = $last_info->{on_connect_do}) {
427 $used = 1;
67008979 428 $self->on_connect_do($on_connect_do);
1b45b01e 429 }
67008979 430 for my $sql_maker_opt (qw/limit_dialect quote_char name_sep/) {
1b45b01e 431 if(my $opt_val = $last_info->{$sql_maker_opt}) {
432 $used = 1;
433 $self->sql_maker->$sql_maker_opt($opt_val);
434 }
435 }
436
437 # remove our options hashref if it was there, to avoid confusing
438 # DBI in the case the user didn't use all 4 DBI options, as in:
439 # [ 'dbi:SQLite:foo.db', { quote_char => q{`} } ]
440 pop(@$info) if $used;
441 }
442
443 $self->_connect_info($info);
444 }
445
446 $self->_connect_info;
447}
448
8b445e33 449sub _populate_dbh {
450 my ($self) = @_;
1b45b01e 451 my @info = @{$self->_connect_info || []};
8b445e33 452 $self->_dbh($self->_connect(@info));
2a57124d 453 my $driver = $self->_dbh->{Driver}->{Name};
34470972 454 eval "require DBIx::Class::Storage::DBI::${driver}";
455 unless ($@) {
843f8ecd 456 bless $self, "DBIx::Class::Storage::DBI::${driver}";
2a57124d 457 $self->_rebless() if $self->can('_rebless');
843f8ecd 458 }
d7c4c15c 459 # if on-connect sql statements are given execute them
460 foreach my $sql_statement (@{$self->on_connect_do || []}) {
4c248161 461 $self->debugobj->query_start($sql_statement) if $self->debug();
d7c4c15c 462 $self->_dbh->do($sql_statement);
4c248161 463 $self->debugobj->query_end($sql_statement) if $self->debug();
d7c4c15c 464 }
5ef3e508 465
1346e22d 466 $self->_conn_pid($$);
467 $self->_conn_tid(threads->tid) if $INC{'threads.pm'};
8b445e33 468}
469
470sub _connect {
471 my ($self, @info) = @_;
5ef3e508 472
9d31f7dc 473 $self->throw_exception("You failed to provide any connection info")
474 if !@info;
475
90ec6cad 476 my ($old_connect_via, $dbh);
477
5ef3e508 478 if ($INC{'Apache/DBI.pm'} && $ENV{MOD_PERL}) {
90ec6cad 479 $old_connect_via = $DBI::connect_via;
5ef3e508 480 $DBI::connect_via = 'connect';
5ef3e508 481 }
482
75db246c 483 eval {
484 if(ref $info[0] eq 'CODE') {
485 $dbh = &{$info[0]};
486 }
487 else {
488 $dbh = DBI->connect(@info);
489 }
490 };
90ec6cad 491
492 $DBI::connect_via = $old_connect_via if $old_connect_via;
493
75db246c 494 if (!$dbh || $@) {
495 $self->throw_exception("DBI Connection failed: " . ($@ || $DBI::errstr));
496 }
90ec6cad 497
e571e823 498 $dbh;
8b445e33 499}
500
8091aa91 501=head2 txn_begin
8b445e33 502
8091aa91 503Calls begin_work on the current dbh.
8b445e33 504
181a28f4 505See L<DBIx::Class::Schema> for the txn_do() method, which allows for
506an entire code block to be executed transactionally.
507
8b445e33 508=cut
509
8091aa91 510sub txn_begin {
d79f59b9 511 my $self = shift;
a32e8402 512 if ($self->{transaction_depth}++ == 0) {
513 my $dbh = $self->dbh;
514 if ($dbh->{AutoCommit}) {
4c248161 515 $self->debugobj->txn_begin()
a32e8402 516 if ($self->debug);
517 $dbh->begin_work;
518 }
986e4fca 519 }
8091aa91 520}
8b445e33 521
8091aa91 522=head2 txn_commit
8b445e33 523
8091aa91 524Issues a commit against the current dbh.
8b445e33 525
8091aa91 526=cut
527
528sub txn_commit {
d79f59b9 529 my $self = shift;
7c5a8b60 530 my $dbh = $self->dbh;
d79f59b9 531 if ($self->{transaction_depth} == 0) {
a32e8402 532 unless ($dbh->{AutoCommit}) {
4c248161 533 $self->debugobj->txn_commit()
986e4fca 534 if ($self->debug);
a32e8402 535 $dbh->commit;
986e4fca 536 }
8091aa91 537 }
538 else {
986e4fca 539 if (--$self->{transaction_depth} == 0) {
4c248161 540 $self->debugobj->txn_commit()
986e4fca 541 if ($self->debug);
7c5a8b60 542 $dbh->commit;
986e4fca 543 }
8091aa91 544 }
545}
546
547=head2 txn_rollback
548
181a28f4 549Issues a rollback against the current dbh. A nested rollback will
550throw a L<DBIx::Class::Storage::NESTED_ROLLBACK_EXCEPTION> exception,
551which allows the rollback to propagate to the outermost transaction.
8b445e33 552
553=cut
554
8091aa91 555sub txn_rollback {
d79f59b9 556 my $self = shift;
a62cf8d4 557
558 eval {
7c5a8b60 559 my $dbh = $self->dbh;
a62cf8d4 560 if ($self->{transaction_depth} == 0) {
a32e8402 561 unless ($dbh->{AutoCommit}) {
4c248161 562 $self->debugobj->txn_rollback()
986e4fca 563 if ($self->debug);
a32e8402 564 $dbh->rollback;
986e4fca 565 }
a62cf8d4 566 }
567 else {
986e4fca 568 if (--$self->{transaction_depth} == 0) {
4c248161 569 $self->debugobj->txn_rollback()
986e4fca 570 if ($self->debug);
7c5a8b60 571 $dbh->rollback;
986e4fca 572 }
573 else {
1346e22d 574 die DBIx::Class::Storage::NESTED_ROLLBACK_EXCEPTION->new;
986e4fca 575 }
a62cf8d4 576 }
577 };
578
579 if ($@) {
580 my $error = $@;
581 my $exception_class = "DBIx::Class::Storage::NESTED_ROLLBACK_EXCEPTION";
582 $error =~ /$exception_class/ and $self->throw_exception($error);
583 $self->{transaction_depth} = 0; # ensure that a failed rollback
584 $self->throw_exception($error); # resets the transaction depth
8091aa91 585 }
586}
8b445e33 587
223b8fe3 588sub _execute {
589 my ($self, $op, $extra_bind, $ident, @args) = @_;
590 my ($sql, @bind) = $self->sql_maker->$op($ident, @args);
944f30bf 591 unshift(@bind, @$extra_bind) if $extra_bind;
f59ffc79 592 if ($self->debug) {
e673f011 593 my @debug_bind = map { defined $_ ? qq{'$_'} : q{'NULL'} } @bind;
4c248161 594 $self->debugobj->query_start($sql, @debug_bind);
f59ffc79 595 }
75db246c 596 my $sth = eval { $self->sth($sql,$op) };
597
598 if (!$sth || $@) {
ec0ff6f6 599 $self->throw_exception(
600 'no sth generated via sql (' . ($@ || $self->_dbh->errstr) . "): $sql"
601 );
75db246c 602 }
438adc0e 603 @bind = map { ref $_ ? ''.$_ : $_ } @bind; # stringify args
701da8c4 604 my $rv;
75d07914 605 if ($sth) {
4c248161 606 my $time = time();
95dad7e2 607 $rv = eval { $sth->execute(@bind) };
608
609 if ($@ || !$rv) {
610 $self->throw_exception("Error executing '$sql': ".($@ || $sth->errstr));
611 }
75d07914 612 } else {
1c339d71 613 $self->throw_exception("'$sql' did not generate a statement.");
701da8c4 614 }
4c248161 615 if ($self->debug) {
616 my @debug_bind = map { defined $_ ? qq{`$_'} : q{`NULL'} } @bind;
617 $self->debugobj->query_end($sql, @debug_bind);
618 }
223b8fe3 619 return (wantarray ? ($rv, $sth, @bind) : $rv);
620}
621
8b445e33 622sub insert {
623 my ($self, $ident, $to_insert) = @_;
bc0c9800 624 $self->throw_exception(
625 "Couldn't insert ".join(', ',
626 map "$_ => $to_insert->{$_}", keys %$to_insert
627 )." into ${ident}"
628 ) unless ($self->_execute('insert' => [], $ident, $to_insert));
8b445e33 629 return $to_insert;
630}
631
632sub update {
223b8fe3 633 return shift->_execute('update' => [], @_);
8b445e33 634}
635
636sub delete {
223b8fe3 637 return shift->_execute('delete' => [], @_);
8b445e33 638}
639
de705b51 640sub _select {
8b445e33 641 my ($self, $ident, $select, $condition, $attrs) = @_;
223b8fe3 642 my $order = $attrs->{order_by};
643 if (ref $condition eq 'SCALAR') {
644 $order = $1 if $$condition =~ s/ORDER BY (.*)$//i;
645 }
8839560b 646 if (exists $attrs->{group_by} || $attrs->{having}) {
bc0c9800 647 $order = {
648 group_by => $attrs->{group_by},
649 having => $attrs->{having},
650 ($order ? (order_by => $order) : ())
651 };
54540863 652 }
5c91499f 653 my @args = ('select', $attrs->{bind}, $ident, $select, $condition, $order);
9229f20a 654 if ($attrs->{software_limit} ||
655 $self->sql_maker->_default_limit_syntax eq "GenericSubQ") {
656 $attrs->{software_limit} = 1;
5c91499f 657 } else {
0823196c 658 $self->throw_exception("rows attribute must be positive if present")
659 if (defined($attrs->{rows}) && !($attrs->{rows} > 0));
5c91499f 660 push @args, $attrs->{rows}, $attrs->{offset};
661 }
de705b51 662 return $self->_execute(@args);
663}
664
665sub select {
666 my $self = shift;
667 my ($ident, $select, $condition, $attrs) = @_;
cb5f2eea 668 return $self->cursor->new($self, \@_, $attrs);
8b445e33 669}
670
6157db4f 671# Need to call finish() to work round broken DBDs
672
1a14aa3f 673sub select_single {
de705b51 674 my $self = shift;
675 my ($rv, $sth, @bind) = $self->_select(@_);
6157db4f 676 my @row = $sth->fetchrow_array;
677 $sth->finish();
678 return @row;
1a14aa3f 679}
680
8b445e33 681sub sth {
cb5f2eea 682 my ($self, $sql) = @_;
91fa659e 683 # 3 is the if_active parameter which avoids active sth re-use
684 return $self->dbh->prepare_cached($sql, {}, 3);
8b445e33 685}
686
a953d8d9 687=head2 columns_info_for
688
689Returns database type info for a given table columns.
690
691=cut
692
693sub columns_info_for {
0d67fe74 694 my ($self, $table) = @_;
bfe10d87 695
a32e8402 696 my $dbh = $self->dbh;
697
698 if ($dbh->can('column_info')) {
a953d8d9 699 my %result;
a32e8402 700 my $old_raise_err = $dbh->{RaiseError};
701 my $old_print_err = $dbh->{PrintError};
702 $dbh->{RaiseError} = 1;
703 $dbh->{PrintError} = 0;
0d67fe74 704 eval {
4d272ce5 705 my ($schema,$tab) = $table =~ /^(.+?)\.(.+)$/ ? ($1,$2) : (undef,$table);
706 my $sth = $dbh->column_info( undef,$schema, $tab, '%' );
0d67fe74 707 $sth->execute();
708 while ( my $info = $sth->fetchrow_hashref() ){
bfe10d87 709 my %column_info;
0d67fe74 710 $column_info{data_type} = $info->{TYPE_NAME};
711 $column_info{size} = $info->{COLUMN_SIZE};
712 $column_info{is_nullable} = $info->{NULLABLE} ? 1 : 0;
713 $column_info{default_value} = $info->{COLUMN_DEF};
0b88a5bb 714 my $col_name = $info->{COLUMN_NAME};
715 $col_name =~ s/^\"(.*)\"$/$1/;
0d67fe74 716
0b88a5bb 717 $result{$col_name} = \%column_info;
0d67fe74 718 }
719 };
a32e8402 720 $dbh->{RaiseError} = $old_raise_err;
721 $dbh->{PrintError} = $old_print_err;
0d67fe74 722 return \%result if !$@;
723 }
724
725 my %result;
a32e8402 726 my $sth = $dbh->prepare("SELECT * FROM $table WHERE 1=0");
0d67fe74 727 $sth->execute;
728 my @columns = @{$sth->{NAME_lc}};
729 for my $i ( 0 .. $#columns ){
730 my %column_info;
731 my $type_num = $sth->{TYPE}->[$i];
732 my $type_name;
a32e8402 733 if(defined $type_num && $dbh->can('type_info')) {
734 my $type_info = $dbh->type_info($type_num);
0d67fe74 735 $type_name = $type_info->{TYPE_NAME} if $type_info;
a953d8d9 736 }
0d67fe74 737 $column_info{data_type} = $type_name ? $type_name : $type_num;
738 $column_info{size} = $sth->{PRECISION}->[$i];
739 $column_info{is_nullable} = $sth->{NULLABLE}->[$i] ? 1 : 0;
740
741 if ($column_info{data_type} =~ m/^(.*?)\((.*?)\)$/) {
742 $column_info{data_type} = $1;
743 $column_info{size} = $2;
744 }
745
746 $result{$columns[$i]} = \%column_info;
747 }
bfe10d87 748
0d67fe74 749 return \%result;
a953d8d9 750}
751
843f8ecd 752sub last_insert_id {
753 my ($self, $row) = @_;
754
755 return $self->dbh->func('last_insert_rowid');
756
757}
758
90ec6cad 759sub sqlt_type { shift->dbh->{Driver}->{Name} }
1c339d71 760
e673f011 761sub create_ddl_dir
762{
763 my ($self, $schema, $databases, $version, $dir, $sqltargs) = @_;
764
765 if(!$dir || !-d $dir)
766 {
767 warn "No directory given, using ./\n";
768 $dir = "./";
769 }
770 $databases ||= ['MySQL', 'SQLite', 'PostgreSQL'];
771 $databases = [ $databases ] if(ref($databases) ne 'ARRAY');
772 $version ||= $schema->VERSION || '1.x';
773
1c339d71 774 eval "use SQL::Translator";
775 $self->throw_exception("Can't deploy without SQL::Translator: $@") if $@;
e673f011 776
777 my $sqlt = SQL::Translator->new({
778# debug => 1,
779 add_drop_table => 1,
780 });
781 foreach my $db (@$databases)
782 {
783 $sqlt->reset();
784 $sqlt->parser('SQL::Translator::Parser::DBIx::Class');
785# $sqlt->parser_args({'DBIx::Class' => $schema);
786 $sqlt->data($schema);
787 $sqlt->producer($db);
788
789 my $file;
790 my $filename = $schema->ddl_filename($db, $dir, $version);
791 if(-e $filename)
792 {
793 $self->throw_exception("$filename already exists, skipping $db");
794 next;
795 }
796 open($file, ">$filename")
797 or $self->throw_exception("Can't open $filename for writing ($!)");
798 my $output = $sqlt->translate;
799#use Data::Dumper;
800# print join(":", keys %{$schema->source_registrations});
801# print Dumper($sqlt->schema);
802 if(!$output)
803 {
804 $self->throw_exception("Failed to translate to $db. (" . $sqlt->error . ")");
805 next;
806 }
807 print $file $output;
808 close($file);
809 }
810
811}
812
813sub deployment_statements {
814 my ($self, $schema, $type, $version, $dir, $sqltargs) = @_;
815 $type ||= $self->sqlt_type;
816 $version ||= $schema->VERSION || '1.x';
817 $dir ||= './';
0382d607 818 eval "use SQL::Translator";
819 if(!$@)
820 {
821 eval "use SQL::Translator::Parser::DBIx::Class;";
822 $self->throw_exception($@) if $@;
823 eval "use SQL::Translator::Producer::${type};";
824 $self->throw_exception($@) if $@;
825 my $tr = SQL::Translator->new(%$sqltargs);
826 SQL::Translator::Parser::DBIx::Class::parse( $tr, $schema );
827 return "SQL::Translator::Producer::${type}"->can('produce')->($tr);
828 }
e673f011 829
830 my $filename = $schema->ddl_filename($type, $dir, $version);
831 if(!-f $filename)
832 {
0382d607 833# $schema->create_ddl_dir([ $type ], $version, $dir, $sqltargs);
834 $self->throw_exception("No SQL::Translator, and no Schema file found, aborting deploy");
835 return;
e673f011 836 }
837 my $file;
838 open($file, "<$filename")
839 or $self->throw_exception("Can't open $filename ($!)");
840 my @rows = <$file>;
841 close($file);
842
843 return join('', @rows);
844
1c339d71 845}
843f8ecd 846
1c339d71 847sub deploy {
cb561d1a 848 my ($self, $schema, $type, $sqltargs) = @_;
e673f011 849 foreach my $statement ( $self->deployment_statements($schema, $type, undef, undef, $sqltargs) ) {
e4fe9ba3 850 for ( split(";\n", $statement)) {
e673f011 851 next if($_ =~ /^--/);
852 next if(!$_);
853# next if($_ =~ /^DROP/m);
854 next if($_ =~ /^BEGIN TRANSACTION/m);
855 next if($_ =~ /^COMMIT/m);
4c248161 856 $self->debugobj->query_begin($_) if $self->debug;
e4fe9ba3 857 $self->dbh->do($_) or warn "SQL was:\n $_";
4c248161 858 $self->debugobj->query_end($_) if $self->debug;
e4fe9ba3 859 }
75d07914 860 }
1c339d71 861}
843f8ecd 862
f86fcf0d 863sub datetime_parser {
864 my $self = shift;
865 return $self->{datetime_parser} ||= $self->build_datetime_parser(@_);
866}
867
868sub datetime_parser_type { "DateTime::Format::MySQL"; }
869
870sub build_datetime_parser {
871 my $self = shift;
872 my $type = $self->datetime_parser_type(@_);
873 eval "use ${type}";
874 $self->throw_exception("Couldn't load ${type}: $@") if $@;
875 return $type;
876}
877
92925617 878sub DESTROY { shift->disconnect }
879
8b445e33 8801;
881
92b858c9 882=head1 ENVIRONMENT VARIABLES
883
884=head2 DBIX_CLASS_STORAGE_DBI_DEBUG
885
886If C<DBIX_CLASS_STORAGE_DBI_DEBUG> is set then SQL trace information
887is produced (as when the L<debug> method is set).
888
889If the value is of the form C<1=/path/name> then the trace output is
890written to the file C</path/name>.
891
d1cceec4 892This environment variable is checked when the storage object is first
893created (when you call connect on your schema). So, run-time changes
894to this environment variable will not take effect unless you also
895re-connect on your schema.
896
8b445e33 897=head1 AUTHORS
898
daec44b8 899Matt S. Trout <mst@shadowcatsystems.co.uk>
8b445e33 900
9f19b1d6 901Andy Grundman <andy@hybridized.org>
902
8b445e33 903=head1 LICENSE
904
905You may distribute this code under the same terms as Perl itself.
906
907=cut
908