1 package DBIx::Class::Storage::DBI::Sybase;
7 DBIx::Class::Storage::DBI::Sybase::Base
8 DBIx::Class::Storage::DBI
11 use Carp::Clan qw/^DBIx::Class/;
15 DBIx::Class::Storage::DBI::Sybase - Storage::DBI subclass for Sybase
19 This subclass supports L<DBD::Sybase> for real Sybase databases. If you are
20 using an MSSQL database via L<DBD::Sybase>, your storage will be reblessed to
21 L<DBIx::Class::Storage::DBI::Sybase::Microsoft_SQL_Server>.
25 If your version of Sybase does not support placeholders, then your storage
26 will be reblessed to L<DBIx::Class::Storage::DBI::Sybase::NoBindVars>. You can
27 also enable that driver explicitly, see the documentation for more details.
29 With this driver there is unfortunately no way to get the C<last_insert_id>
30 without doing a C<select max(col)>.
32 But your queries will be cached.
34 A recommended L<DBIx::Class::Storage::DBI/connect_info> settings:
36 on_connect_call => [['datetime_setup'], [blob_setup => log_on_update => 0]]
42 __PACKAGE__->mk_group_accessors('simple' =>
43 qw/_blob_log_on_update/
49 if (ref($self) eq 'DBIx::Class::Storage::DBI::Sybase') {
51 @{$self->dbh->selectrow_arrayref(qq{sp_server_info \@attribute_id=1})}[2]
56 my $subclass = "DBIx::Class::Storage::DBI::Sybase::${dbtype}";
58 if (!$exception && $dbtype && $self->load_optional_class($subclass)) {
59 bless $self, $subclass;
63 if (not $self->dbh->{syb_dynamic_supported}) {
64 $self->ensure_class_loaded('DBIx::Class::Storage::DBI::Sybase::NoBindVars');
65 bless $self, 'DBIx::Class::Storage::DBI::Sybase::NoBindVars';
72 =head2 connect_call_blob_setup
76 on_connect_call => [ [ blob_setup => log_on_update => 0 ] ]
78 Does C<< $dbh->{syb_binary_images} = 1; >> to return C<IMAGE> data as raw binary
79 instead of as a hex string.
83 Also sets the C<log_on_update> value for blob write operations. The default is
84 C<1>, but C<0> is better if your database is configured for it.
87 L<DBD::Sybase/Handling_IMAGE/TEXT_data_with_syb_ct_get_data()/syb_ct_send_data()>.
91 sub connect_call_blob_setup {
94 my $dbh = $self->_dbh;
95 $dbh->{syb_binary_images} = 1;
97 $self->_blob_log_on_update($args{log_on_update})
98 if exists $args{log_on_update};
103 shift =~ /(?:text|image|lob|bytea|binary)/i;
107 my ($self, $source, $to_insert) = splice @_, 0, 3;
109 my $blob_cols = $self->_remove_blob_cols($source, $to_insert);
111 my $updated_cols = $self->next::method($source, $to_insert, @_);
113 $self->_update_blobs($source, $blob_cols, $to_insert) if %$blob_cols;
115 return $updated_cols;
119 # my ($self, $source) = splice @_, 0, 2;
122 # my $blob_cols = $self->_remove_blob_cols($source, $fields);
128 # @res = $self->next::method($source, @_);
130 # $res[0] = $self->next::method($source, @_);
134 # $self->_update_blobs($source, $blob_cols, $fields) if %$blob_cols;
136 # return wantarray ? @res : $res[0];
139 sub _remove_blob_cols {
140 my ($self, $source, $fields) = @_;
144 for my $col (keys %$fields) {
145 $blob_cols{$col} = delete $fields->{$col}
146 if $self->_is_lob_type($source->column_info($col)->{data_type});
153 my ($self, $source, $blob_cols, $inserted) = @_;
154 my $dbh = $self->dbh;
156 my $table = $source->from;
158 my (@primary_cols) = $source->primary_columns;
160 croak "Cannot update TEXT/IMAGE without a primary key!"
161 unless @primary_cols;
163 my $search_cond = join ',' => map "$_ = ?", @primary_cols;
165 for my $col (keys %$blob_cols) {
166 my $blob = $blob_cols->{$col};
168 # First update to empty string in case it's NULL, can't update a NULL blob using
170 my $sth = $dbh->prepare_cached(
171 qq{update $table set $col = '' where $search_cond}
173 $sth->execute(map $inserted->{$_}, @primary_cols) or die $sth->errstr;
176 $sth = $dbh->prepare_cached(
177 "select $col from $table where $search_cond"
179 $sth->execute(map $inserted->{$_}, @primary_cols);
182 while ($sth->fetch) {
183 $sth->func('CS_GET', 1, 'ct_data_info') or die $sth->errstr;
185 $sth->func('ct_prepare_send') or die $sth->errstr;
187 my $log_on_update = $self->_blob_log_on_update;
188 $log_on_update = 1 if not defined $log_on_update;
190 $sth->func('CS_SET', 1, {
191 total_txtlen => length($blob),
192 log_on_update => $log_on_update
193 }, 'ct_data_info') or die $sth->errstr;
195 $sth->func($blob, length($blob), 'ct_send_data') or die $sth->errstr;
197 $sth->func('ct_finish_send') or die $sth->errstr;
201 croak $exception if $exception;
205 =head2 connect_call_datetime_setup
209 on_connect_call => 'datetime_setup'
211 In L<DBIx::Class::Storage::DBI/connect_info> to set:
213 $dbh->syb_date_fmt('ISO_strict'); # output fmt: 2004-08-21T14:36:48.080Z
214 $dbh->do('set dateformat mdy'); # input fmt: 08/13/1979 18:08:55.080
216 On connection for use with L<DBIx::Class::InflateColumn::DateTime>, using
217 L<DateTime::Format::Sybase>, which you will need to install.
219 This works for both C<DATETIME> and C<SMALLDATETIME> columns, although
220 C<SMALLDATETIME> columns only have minute precision.
225 my $old_dbd_warned = 0;
227 sub connect_call_datetime_setup {
229 my $dbh = $self->_dbh;
231 if ($dbh->can('syb_date_fmt')) {
232 $dbh->syb_date_fmt('ISO_strict');
233 } elsif (not $old_dbd_warned) {
234 carp "Your DBD::Sybase is too old to support ".
235 "DBIx::Class::InflateColumn::DateTime, please upgrade!";
239 $dbh->do('set dateformat mdy');
245 sub datetime_parser_type { "DateTime::Format::Sybase" }
247 sub _dbh_last_insert_id {
248 my ($self, $dbh, $source, $col) = @_;
250 # sorry, there's no other way!
251 my $sth = $dbh->prepare_cached("select max($col) from ".$source->from);
252 return ($dbh->selectrow_array($sth))[0];
259 See L</connect_call_datetime_setup> to setup date formats
260 for L<DBIx::Class::InflateColumn::DateTime>.
262 =head1 IMAGE AND TEXT COLUMNS
264 See L</connect_call_blob_setup> for a L<DBIx::Class::Storage::DBI/connect_info>
265 setting you need to work with C<IMAGE> columns.
267 Due to limitations in L<DBD::Sybase> and this driver, it is only possible to
268 select one C<TEXT> or C<IMAGE> column at a time.
272 See L<DBIx::Class/CONTRIBUTORS>.
276 You may distribute this code under the same terms as Perl itself.