Failing test about warnings triggered in SQLA::Limit when using a subquery
[dbsrgits/DBIx-Class.git] / lib / DBIx / Class / Storage / DBI / ODBC / Microsoft_SQL_Server.pm
CommitLineData
c1cac633 1package DBIx::Class::Storage::DBI::ODBC::Microsoft_SQL_Server;
2use strict;
3use warnings;
4
5use base qw/DBIx::Class::Storage::DBI/;
6
7sub _prep_for_execute {
8 my $self = shift;
9 my ($op, $extra_bind, $ident, $args) = @_;
10
c3515436 11 my ($sql, $bind) = $self->next::method (@_);
c1cac633 12 $sql .= ';SELECT SCOPE_IDENTITY()' if $op eq 'insert';
13
14 return ($sql, $bind);
15}
16
2eebd801 17sub _execute {
18 my $self = shift;
19 my ($op) = @_;
c1cac633 20
2eebd801 21 my ($rv, $sth, @bind) = $self->dbh_do($self->can('_dbh_execute'), @_);
77af494b 22 if ($op eq 'insert') {
23 $self->{_scope_identity} = $sth->fetchrow_array;
24 $sth->finish;
25 }
c1cac633 26
2eebd801 27 return wantarray ? ($rv, $sth, @bind) : $rv;
c1cac633 28}
29
30sub last_insert_id { shift->{_scope_identity} }
31
32sub sqlt_type { 'SQLServer' }
33
34sub _sql_maker_opts {
35 my ( $self, $opts ) = @_;
36
37 if ( $opts ) {
38 $self->{_sql_maker_opts} = { %$opts };
39 }
40
41 return { limit_dialect => 'Top', %{$self->{_sql_maker_opts}||{}} };
42}
43
6a52811b 44sub build_datetime_parser {
45 my $self = shift;
46 my $type = "DateTime::Format::Strptime";
47 eval "use ${type}";
48 $self->throw_exception("Couldn't load ${type}: $@") if $@;
49 return $type->new( pattern => '%F %T' );
50}
51
c1cac633 521;
53
54__END__
55
56=head1 NAME
57
a89c6fc0 58DBIx::Class::Storage::DBI::ODBC::Microsoft_SQL_Server - Support specific
59to Microsoft SQL Server over ODBC
c1cac633 60
61=head1 DESCRIPTION
62
63This class implements support specific to Microsoft SQL Server over ODBC,
64including auto-increment primary keys and SQL::Abstract::Limit dialect. It
65is loaded automatically by by DBIx::Class::Storage::DBI::ODBC when it
66detects a MSSQL back-end.
67
68=head1 IMPLEMENTATION NOTES
69
70Microsoft SQL Server supports three methods of retrieving the IDENTITY
71value for inserted row: IDENT_CURRENT, @@IDENTITY, and SCOPE_IDENTITY().
72SCOPE_IDENTITY is used here because it is the safest. However, it must
73be called is the same execute statement, not just the same connection.
74
75So, this implementation appends a SELECT SCOPE_IDENTITY() statement
76onto each INSERT to accommodate that requirement.
77
6f96f99f 78=head1 METHODS
79
6f96f99f 80=head2 last_insert_id
81
82=head2 sqlt_type
c1cac633 83
6a52811b 84=head2 build_datetime_parser
85
86The resulting parser handles the MSSQL C<DATETIME> type, but is almost
87certainly not sufficient for the other MSSQL 2008 date/time types.
88
c1cac633 89=head1 AUTHORS
90
91Marc Mims C<< <marc@questright.com> >>
92
93=head1 LICENSE
94
95You may distribute this code under the same terms as Perl itself.
96
97=cut