use strict;
use warnings;
-use Class::C3;
use base qw/DBIx::Class::Storage::DBI/;
-use Carp::Clan qw/^DBIx::Class/;
-
=head1 NAME
-DBIx::Class::Storage::DBI::Sybase - Storage::DBI subclass for Sybase
-
-=head1 SYNOPSIS
-
-This subclass supports L<DBD::Sybase> for real Sybase databases. If you are
-using an MSSQL database via L<DBD::Sybase>, your storage will be reblessed to
-L<DBIx::Class::Storage::DBI::Sybase::Microsoft_SQL_Server>.
+DBIx::Class::Storage::DBI::Sybase - Base class for drivers using
+L<DBD::Sybase>
=head1 DESCRIPTION
-If your version of Sybase does not support placeholders, then your storage
-will be reblessed to L<DBIx::Class::Storage::DBI::Sybase::NoBindVars>. You can
-also enable that driver explicitly, see the documentation for more details.
-
-With this driver there is unfortunately no way to get the C<last_insert_id>
-without doing a C<select max(col)>.
-
-But your queries will be cached.
-
-A recommended L<DBIx::Class::Storage::DBI/connect_info> setting:
-
- on_connect_call => [qw/datetime_setup blob_setup/]
+This is the base class/dispatcher for Storage's designed to work with
+L<DBD::Sybase>
=head1 METHODS
sub _rebless {
my $self = shift;
- if (ref($self) eq 'DBIx::Class::Storage::DBI::Sybase') {
- my $dbtype = eval {
- @{$self->dbh->selectrow_arrayref(qq{sp_server_info \@attribute_id=1})}[2]
- } || '';
+ my $dbtype = eval {
+ @{$self->_get_dbh->selectrow_arrayref(qq{sp_server_info \@attribute_id=1})}[2]
+ };
+
+ $self->throw_exception("Unable to estable connection to determine database type: $@")
+ if $@;
- my $exception = $@;
+ if ($dbtype) {
$dbtype =~ s/\W/_/gi;
- my $subclass = "DBIx::Class::Storage::DBI::Sybase::${dbtype}";
- if (!$exception && $dbtype && $self->load_optional_class($subclass)) {
+ # saner class name
+ $dbtype = 'ASE' if $dbtype eq 'SQL_Server';
+
+ my $subclass = __PACKAGE__ . "::$dbtype";
+ if ($self->load_optional_class($subclass)) {
bless $self, $subclass;
$self->_rebless;
- } else {
- # real Sybase
- if (not $self->dbh->{syb_dynamic_supported}) {
- bless $self, 'DBIx::Class::Storage:DBI::Sybase::NoBindVars';
- $self->_rebless;
- }
- $self->connect_call_datetime_setup;
- $self->connect_call_blob_setup;
}
}
}
-sub _populate_dbh {
+sub _ping {
my $self = shift;
- $self->next::method(@_);
- $self->connect_call_datetime_setup;
- $self->connect_call_blob_setup;
- 1;
-}
-
-=head2 connect_call_blob_setup
-
-Used as:
- on_connect_call => 'blob_setup'
+ my $dbh = $self->_dbh or return 0;
-Does C<< $dbh->{syb_binary_images} = 1; >> to return C<IMAGE> data as raw binary
-instead of as a hex string.
+ local $dbh->{RaiseError} = 1;
+ local $dbh->{PrintError} = 0;
-Recommended.
+ if ($dbh->{syb_no_child_con}) {
+# if extra connections are not allowed, then ->ping is reliable
+ my $ping = eval { $dbh->ping };
+ return $@ ? 0 : $ping;
+ }
-=cut
+ eval {
+# XXX if the main connection goes stale, does opening another for this statement
+# really determine anything?
+ $dbh->do('select 1');
+ };
-sub connect_call_blob_setup {
- my $self = shift;
- my $dbh = $self->_dbh;
- $dbh->{syb_binary_images} = 1;
+ return $@ ? 0 : 1;
}
-=head2 connect_call_datetime_setup
-
-Used as:
+sub _set_max_connect {
+ my $self = shift;
+ my $val = shift || 256;
- on_connect_call => 'datetime_setup'
+ my $dsn = $self->_dbi_connect_info->[0];
-In L<DBIx::Class::Storage::DBI/connect_info> to set:
+ return if ref($dsn) eq 'CODE';
- $dbh->syb_date_fmt('ISO_strict'); # output fmt: 2004-08-21T14:36:48.080Z
- $dbh->do('set dateformat mdy'); # input fmt: 08/13/1979 18:08:55.080
+ if ($dsn !~ /maxConnect=/) {
+ $self->_dbi_connect_info->[0] = "$dsn;maxConnect=$val";
+ my $connected = defined $self->_dbh;
+ $self->disconnect;
+ $self->ensure_connected if $connected;
+ }
+}
-On connection for use with L<DBIx::Class::InflateColumn::DateTime>, using
-L<DateTime::Format::Sybase>, which you will need to install.
+=head2 using_freetds
-This works for both C<DATETIME> and C<SMALLDATETIME> columns, although
-C<SMALLDATETIME> columns only have minute precision.
+Whether or not L<DBD::Sybase> was compiled against FreeTDS. If false, it means
+the Sybase OpenClient libraries were used.
=cut
-{
- my $old_dbd_warned = 0;
-
- sub connect_call_datetime_setup {
- my $self = shift;
- my $dbh = $self->_dbh;
-
- if ($dbh->can('syb_date_fmt')) {
- $dbh->syb_date_fmt('ISO_strict');
- } elsif (not $old_dbd_warned) {
- carp "Your DBD::Sybase is too old to support ".
- "DBIx::Class::InflateColumn::DateTime, please upgrade!";
- $old_dbd_warned = 1;
- }
-
- $dbh->do('set dateformat mdy');
+sub using_freetds {
+ my $self = shift;
- 1;
- }
+ return $self->_get_dbh->{syb_oc_version} =~ /freetds/i;
}
-sub datetime_parser_type { "DateTime::Format::Sybase" }
-
-sub _dbh_last_insert_id {
- my ($self, $dbh, $source, $col) = @_;
+=head2 set_textsize
- # sorry, there's no other way!
- my $sth = $dbh->prepare_cached("select max($col) from ".$source->from);
- return ($dbh->selectrow_array($sth))[0];
-}
+When using FreeTDS and/or MSSQL, C<< $dbh->{LongReadLen} >> is not available,
+use this function instead. It does:
-# previous implementation of limited count for Sybase, does not include
-# count_grouped.
-
-#sub _copy_attributes_for_count {
-# my ($self, $source, $attrs) = @_;
-# my %attrs = %$attrs;
-#
-# # take off any column specs, any pagers, record_filter is cdbi, and no point of ordering a count
-# delete @attrs{qw/select as rows offset page order_by record_filter/};
-#
-# return \%attrs;
-#}
-#
-#=head2 count
-#
-#Counts for limited queries are emulated by executing select queries and
-#returning the number of successful executions minus the offset.
-#
-#This is necessary due to the limitations of Sybase.
-#
-#=cut
-#
-#sub count {
-# my $self = shift;
-# my ($source, $attrs) = @_;
-#
-# my $new_attrs = $self->_copy_attributes_for_count($source, $attrs);
-#
-# if (exists $attrs->{rows}) {
-# my $offset = $attrs->{offset} || 0;
-# my $total = $attrs->{rows} + $offset;
-#
-# my $first_pk = ($source->primary_columns)[0];
-#
-# $new_attrs->{select} = $first_pk ? "me.$first_pk" : 1;
-#
-# my $tmp_rs = $source->resultset_class->new($source, $new_attrs);
-#
-# $self->dbh->{syb_rowcount} = $total;
-#
-# my $count = 0;
-# $count++ while $tmp_rs->cursor->next;
-#
-# $self->dbh->{syb_rowcount} = 0;
-#
-# return $count - $offset;
-# } else {
-# # overwrite the selector
-# $new_attrs->{select} = { count => '*' };
-#
-# my $tmp_rs = $source->resultset_class->new($source, $new_attrs);
-# my ($count) = $tmp_rs->cursor->next;
-#
-# # if the offset/rows attributes are still present, we did not use
-# # a subquery, so we need to make the calculations in software
-# $count -= $attrs->{offset} if $attrs->{offset};
-# $count = $attrs->{rows} if $attrs->{rows} and $attrs->{rows} < $count;
-# $count = 0 if ($count < 0);
-#
-# return $count;
-# }
-#}
+ $dbh->do("SET TEXTSIZE $bytes");
-1;
+Takes the number of bytes, or uses the C<LongReadLen> value from your
+L<DBIx::Class/connect_info> if omitted, lastly falls back to the C<32768> which
+is the L<DBD::Sybase> default.
-=head1 DATES
+=cut
-See L</connect_call_datetime_setup> to setup date formats
-for L<DBIx::Class::InflateColumn::DateTime>.
+sub set_textsize {
+ my $self = shift;
+ my $text_size = shift ||
+ eval { $self->_dbi_connect_info->[-1]->{LongReadLen} } ||
+ 32768; # the DBD::Sybase default
-=head1 IMAGE AND TEXT COLUMNS
+ return unless defined $text_size;
-See L</connect_call_blob_setup> for a L<DBIx::Class::Storage::DBI/connect_info>
-setting you need to work with C<IMAGE> columns.
+ $self->_dbh->do("SET TEXTSIZE $text_size");
+}
-Due to limitations in L<DBD::Sybase> and this driver, it is only possible to
-select one C<TEXT> or C<IMAGE> column at a time.
+1;
=head1 AUTHORS
You may distribute this code under the same terms as Perl itself.
=cut
-# vim:sts=2 sw=2: