1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214
|
package DBIx::Class::Storage::DBI::InterBase;
use strict;
use warnings;
use base qw/DBIx::Class::Storage::DBI::Firebird::Common/;
use mro 'c3';
use Try::Tiny;
use namespace::clean;
=head1 NAME
DBIx::Class::Storage::DBI::InterBase - Driver for the Firebird RDBMS via
L<DBD::InterBase>
=head1 DESCRIPTION
This driver is a subclass of L<DBIx::Class::Storage::DBI::Firebird::Common> for
use with L<DBD::InterBase>, see that driver for general details.
You need to use either the
L<disable_sth_caching|DBIx::Class::Storage::DBI/disable_sth_caching> option or
L</connect_call_use_softcommit> (see L</CAVEATS>) for your code to function
correctly with this driver. Otherwise you will likely get bizarre error messages
such as C<no statement executing>. The alternative is to use the
L<ODBC|DBIx::Class::Storage::DBI::ODBC::Firebird> driver, which is more suitable
for long running processes such as under L<Catalyst>.
To turn on L<DBIx::Class::InflateColumn::DateTime> support, see
L</connect_call_datetime_setup>.
=cut
__PACKAGE__->datetime_parser_type(
'DBIx::Class::Storage::DBI::InterBase::DateTime::Format'
);
sub _ping {
my $self = shift;
my $dbh = $self->_dbh or return 0;
local $dbh->{RaiseError} = 1;
local $dbh->{PrintError} = 0;
return try {
$dbh->do('select 1 from rdb$database');
1;
} catch {
0;
};
}
# We want dialect 3 for new features and quoting to work, DBD::InterBase uses
# dialect 1 (interbase compat) by default.
sub _init {
my $self = shift;
$self->_set_sql_dialect(3);
}
sub _set_sql_dialect {
my $self = shift;
my $val = shift || 3;
my $dsn = $self->_dbi_connect_info->[0];
return if ref($dsn) eq 'CODE';
if ($dsn !~ /ib_dialect=/) {
$self->_dbi_connect_info->[0] = "$dsn;ib_dialect=$val";
my $connected = defined $self->_dbh;
$self->disconnect;
$self->ensure_connected if $connected;
}
}
=head2 connect_call_use_softcommit
Used as:
on_connect_call => 'use_softcommit'
In L<connect_info|DBIx::Class::Storage::DBI/connect_info> to set the
L<DBD::InterBase> C<ib_softcommit> option.
You need either this option or C<< disable_sth_caching => 1 >> for
L<DBIx::Class> code to function correctly (otherwise you may get C<no statement
executing> errors.) Or use the L<ODBC|DBIx::Class::Storage::DBI::ODBC::Firebird>
driver.
The downside of using this option is that your process will B<NOT> see UPDATEs,
INSERTs and DELETEs from other processes for already open statements.
=cut
sub connect_call_use_softcommit {
my $self = shift;
$self->_dbh->{ib_softcommit} = 1;
}
=head2 connect_call_datetime_setup
Used as:
on_connect_call => 'datetime_setup'
In L<connect_info|DBIx::Class::Storage::DBI/connect_info> to set the date and
timestamp formats using:
$dbh->{ib_time_all} = 'ISO';
See L<DBD::InterBase> for more details.
The C<TIMESTAMP> data type supports up to 4 digits after the decimal point for
second precision. The full precision is used.
The C<DATE> data type stores the date portion only, and it B<MUST> be declared
with:
data_type => 'date'
in your Result class.
Timestamp columns can be declared with either C<datetime> or C<timestamp>.
You will need the L<DateTime::Format::Strptime> module for inflation to work.
For L<DBIx::Class::Storage::DBI::ODBC::Firebird>, this is a noop.
=cut
sub connect_call_datetime_setup {
my $self = shift;
$self->_get_dbh->{ib_time_all} = 'ISO';
}
package # hide from PAUSE
DBIx::Class::Storage::DBI::InterBase::DateTime::Format;
my $timestamp_format = '%Y-%m-%d %H:%M:%S.%4N'; # %F %T
my $date_format = '%Y-%m-%d';
my ($timestamp_parser, $date_parser);
sub parse_datetime {
shift;
require DateTime::Format::Strptime;
$timestamp_parser ||= DateTime::Format::Strptime->new(
pattern => $timestamp_format,
on_error => 'croak',
);
return $timestamp_parser->parse_datetime(shift);
}
sub format_datetime {
shift;
require DateTime::Format::Strptime;
$timestamp_parser ||= DateTime::Format::Strptime->new(
pattern => $timestamp_format,
on_error => 'croak',
);
return $timestamp_parser->format_datetime(shift);
}
sub parse_date {
shift;
require DateTime::Format::Strptime;
$date_parser ||= DateTime::Format::Strptime->new(
pattern => $date_format,
on_error => 'croak',
);
return $date_parser->parse_datetime(shift);
}
sub format_date {
shift;
require DateTime::Format::Strptime;
$date_parser ||= DateTime::Format::Strptime->new(
pattern => $date_format,
on_error => 'croak',
);
return $date_parser->format_datetime(shift);
}
1;
=head1 CAVEATS
=over 4
=item *
with L</connect_call_use_softcommit>, you will not be able to see changes made
to data in other processes. If this is an issue, use
L<disable_sth_caching|DBIx::Class::Storage::DBI/disable_sth_caching> as a
workaround for the C<no statement executing> errors, this of course adversely
affects performance.
Alternately, use the L<ODBC|DBIx::Class::Storage::DBI::ODBC::Firebird> driver.
=back
=head1 AUTHOR
See L<DBIx::Class/AUTHOR> and L<DBIx::Class/CONTRIBUTORS>.
=head1 LICENSE
You may distribute this code under the same terms as Perl itself.
=cut
# vim:sts=2 sw=2:
|