1 package DBIx::Class::Storage::DBI::SQLAnywhere;
5 use base qw/DBIx::Class::Storage::DBI::UniqueIdentifier/;
7 use List::Util 'first';
8 use DBIx::Class::_Util 'dbic_internal_try';
12 __PACKAGE__->mk_group_accessors(simple => qw/_identity/);
13 __PACKAGE__->sql_limit_dialect ('RowNumberOver');
14 __PACKAGE__->sql_quote_char ('"');
16 __PACKAGE__->new_guid('UUIDTOSTR(NEWID())');
18 # default to the UUID decoding cursor, overridable by the user
19 __PACKAGE__->cursor_class('DBIx::Class::Storage::DBI::SQLAnywhere::Cursor');
23 DBIx::Class::Storage::DBI::SQLAnywhere - Driver for SQL Anywhere
27 This class implements autoincrements for SQL Anywhere and provides
28 L<DBIx::Class::InflateColumn::DateTime> support and support for the
29 C<uniqueidentifier> type (via
30 L<DBIx::Class::Storage::DBI::SQLAnywhere::Cursor>.)
32 You need the C<DBD::SQLAnywhere> driver that comes with the SQL Anywhere
33 distribution, B<NOT> the one on CPAN. It is usually under a path such as:
35 /opt/sqlanywhere11/sdk/perl
37 Recommended L<connect_info|DBIx::Class::Storage::DBI/connect_info> settings:
39 on_connect_call => 'datetime_setup'
45 sub last_insert_id { shift->_identity }
47 sub _prefetch_autovalues {
49 my ($source, $colinfo, $to_insert) = @_;
51 my $values = $self->next::method(@_);
54 first { $colinfo->{$_}{is_auto_increment} } keys %$colinfo;
56 # user might have an identity PK without is_auto_increment
58 # FIXME we probably should not have supported the above, see what
59 # does it take to move away from it
60 if (not $identity_col) {
61 foreach my $pk_col ($source->primary_columns) {
63 ! exists $to_insert->{$pk_col}
65 $colinfo->{$pk_col}{data_type}
67 $colinfo->{$pk_col}{data_type} !~ /^uniqueidentifier/i
69 $identity_col = $pk_col;
75 if ($identity_col && (not exists $to_insert->{$identity_col})) {
76 my $dbh = $self->_get_dbh;
77 my $table_name = $source->from;
78 $table_name = $$table_name if ref $table_name;
80 my ($identity) = dbic_internal_try {
81 $dbh->selectrow_array("SELECT GET_IDENTITY('$table_name')")
84 if (defined $identity) {
85 $values->{$identity_col} = $identity;
86 $self->_identity($identity);
94 my ($self, $data) = @_;
96 $data = unpack 'H*', $data;
98 for my $pos (8, 13, 18, 23) {
99 substr($data, $pos, 0) = '-';
105 # select_single does not invoke a cursor object at all, hence UUID decoding happens
106 # here if the proper cursor class is set
110 my @row = $self->next::method(@_);
113 unless $self->cursor_class->isa('DBIx::Class::Storage::DBI::SQLAnywhere::Cursor');
115 my ($ident, $select) = @_;
117 my $col_info = $self->_resolve_column_info($ident);
119 for my $select_idx (0..$#$select) {
120 my $selected = $select->[$select_idx];
122 next if ref $selected;
124 my $data_type = $col_info->{$selected}{data_type}
127 if ($self->_is_guid_type($data_type)) {
128 my $returned = $row[$select_idx];
130 if (length $returned == 16) {
131 $row[$select_idx] = $self->_uuid_to_str($returned);
139 # this sub stolen from MSSQL
141 sub build_datetime_parser {
144 require DateTime::Format::Strptime;
147 $self->throw_exception("Couldn't load DateTime::Format::Strptime: $_");
150 return DateTime::Format::Strptime->new( pattern => '%Y-%m-%d %H:%M:%S.%6N' );
153 =head2 connect_call_datetime_setup
157 on_connect_call => 'datetime_setup'
159 In L<connect_info|DBIx::Class::Storage::DBI/connect_info> to set the date and
160 timestamp formats (as temporary options for the session) for use with
161 L<DBIx::Class::InflateColumn::DateTime>.
163 The C<TIMESTAMP> data type supports up to 6 digits after the decimal point for
164 second precision. The full precision is used.
166 The C<DATE> data type supposedly stores hours and minutes too, according to the
167 documentation, but I could not get that to work. It seems to only store the
170 You will need the L<DateTime::Format::Strptime> module for inflation to work.
174 sub connect_call_datetime_setup {
178 "set temporary option timestamp_format = 'yyyy-mm-dd hh:mm:ss.ssssss'"
181 "set temporary option date_format = 'yyyy-mm-dd hh:mm:ss.ssssss'"
185 sub _exec_svp_begin {
186 my ($self, $name) = @_;
188 $self->_dbh->do("SAVEPOINT $name");
191 # can't release savepoints that have been rolled back
192 sub _exec_svp_release { 1 }
194 sub _exec_svp_rollback {
195 my ($self, $name) = @_;
197 $self->_dbh->do("ROLLBACK TO SAVEPOINT $name")
202 =head1 MAXIMUM CURSORS
204 A L<DBIx::Class> application can use a lot of cursors, due to the usage of
205 L<prepare_cached|DBI/prepare_cached>.
207 The default cursor maximum is C<50>, which can be a bit too low. This limit can
208 be turned off (or increased) by the DBA by executing:
210 set option max_statement_count = 0
211 set option max_cursor_count = 0
215 =head1 FURTHER QUESTIONS?
217 Check the list of L<additional DBIC resources|DBIx::Class/GETTING HELP/SUPPORT>.
219 =head1 COPYRIGHT AND LICENSE
221 This module is free software L<copyright|DBIx::Class/COPYRIGHT AND LICENSE>
222 by the L<DBIx::Class (DBIC) authors|DBIx::Class/AUTHORS>. You can
223 redistribute it and/or modify it under the same terms as the
224 L<DBIx::Class library|DBIx::Class/COPYRIGHT AND LICENSE>.