lib/DBIx/Class/Storage/DBI/ODBC/Microsoft_SQL_Server.pm

   1 package DBIx::Class::Storage::DBI::ODBC::Microsoft_SQL_Server;
   2 use strict;
   3 use warnings;
   4
   5 use base qw/DBIx::Class::Storage::DBI::MSSQL/;
   6
   7 sub _prep_for_execute {
   8     my $self = shift;
   9     my ($op, $extra_bind, $ident, $args) = @_;
  10
  11     my ($sql, $bind) = $self->next::method (@_);
  12     $sql .= ';SELECT SCOPE_IDENTITY()' if $op eq 'insert';
  13
  14     return ($sql, $bind);
  15 }
  16
  17 sub _execute {
  18     my $self = shift;
  19     my ($op) = @_;
  20
  21     my ($rv, $sth, @bind) = $self->dbh_do($self->can('_dbh_execute'), @_);
  22     if ($op eq 'insert') {
  23       $self->{_scope_identity} = $sth->fetchrow_array;
  24       $sth->finish;
  25     }
  26
  27     return wantarray ? ($rv, $sth, @bind) : $rv;
  28 }
  29
  30 sub last_insert_id { shift->{_scope_identity} }
  31
  32 1;
  33
  34 __END__
  35
  36 =head1 NAME
  37
  38 DBIx::Class::Storage::DBI::ODBC::Microsoft_SQL_Server - Support specific
  39 to Microsoft SQL Server over ODBC
  40
  41 =head1 DESCRIPTION
  42
  43 This class implements support specific to Microsoft SQL Server over ODBC,
  44 including auto-increment primary keys and SQL::Abstract::Limit dialect.  It
  45 is loaded automatically by by DBIx::Class::Storage::DBI::ODBC when it
  46 detects a MSSQL back-end.
  47
  48 =head1 IMPLEMENTATION NOTES
  49
  50 Microsoft SQL Server supports three methods of retrieving the IDENTITY
  51 value for inserted row: IDENT_CURRENT, @@IDENTITY, and SCOPE_IDENTITY().
  52 SCOPE_IDENTITY is used here because it is the safest.  However, it must
  53 be called is the same execute statement, not just the same connection.
  54
  55 So, this implementation appends a SELECT SCOPE_IDENTITY() statement
  56 onto each INSERT to accommodate that requirement.
  57
  58 =head1 AUTHORS
  59
  60 Marc Mims C<< <marc@questright.com> >>
  61
  62 =head1 LICENSE
  63
  64 You may distribute this code under the same terms as Perl itself.
  65
  66 =cut