1 package DBIx::Class::Schema::Loader::DBI::MSSQL;
5 use base 'DBIx::Class::Schema::Loader::DBI::Sybase::Common';
8 use List::MoreUtils 'any';
11 use DBIx::Class::Schema::Loader::Table::Sybase ();
13 our $VERSION = '0.07018';
17 DBIx::Class::Schema::Loader::DBI::MSSQL - DBIx::Class::Schema::Loader::DBI MSSQL Implementation.
21 Base driver for Microsoft SQL Server, used by
22 L<DBIx::Class::Schema::Loader::DBI::Sybase::Microsoft_SQL_Server> for support
23 via L<DBD::Sybase> and
24 L<DBIx::Class::Schema::Loader::DBI::ODBC::Microsoft_SQL_Server> for support via
27 See L<DBIx::Class::Schema::Loader> and L<DBIx::Class::Schema::Loader::Base> for
30 =head1 CASE SENSITIVITY
32 Most MSSQL databases use C<CI> (case-insensitive) collation, for this reason
33 generated column names are lower-cased as this makes them easier to work with
36 We attempt to detect the database collation at startup for any database
37 included in L<db_schema|DBIx::Class::Schema::Loader::Base/db_schema>, and set
38 the column lowercasing behavior accordingly, as lower-cased column names do not
39 work on case-sensitive databases.
41 To manually control case-sensitive mode, put:
45 in your Loader options.
47 See L<preserve_case|DBIx::Class::Schema::Loader::Base/preserve_case>.
49 B<NOTE:> this option used to be called C<case_sensitive_collation>, but has
50 been renamed to a more generic option.
54 sub _system_databases {
56 master model tempdb msdb
62 spt_fallback_db spt_fallback_dev spt_fallback_usg spt_monitor spt_values MSreplication_options
69 my $owners = $self->dbh->selectcol_arrayref(<<"EOF");
71 FROM [$db].dbo.sysusers
75 return grep !/^(?:#|guest|INFORMATION_SCHEMA|sys)/, @$owners;
80 return ($self->dbh->selectrow_array('SELECT db_name()'))[0];
85 $self->dbh->do("use [$db]");
91 $self->next::method(@_);
93 my $current_db = $self->_current_db;
95 if (ref $self->db_schema eq 'HASH') {
96 if (keys %{ $self->db_schema } < 2) {
97 my ($db) = keys %{ $self->db_schema };
102 my $owners = $self->db_schema->{$db};
104 my $db_names = $self->dbh->selectcol_arrayref(<<'EOF');
106 FROM master.dbo.sysdatabases
111 foreach my $db_name (@$db_names) {
113 unless any { $_ eq $db_name } $self->_system_databases;
116 $self->db_schema({});
118 DB: foreach my $db (@dbs) {
119 if (not ((ref $owners eq 'ARRAY' && $owners->[0] eq '%') || $owners eq '%')) {
122 foreach my $owner (@$owners) {
124 if $self->dbh->selectrow_array(<<"EOF");
126 FROM [$db].dbo.sysusers
127 WHERE name = @{[ $self->dbh->quote($owner) ]}
131 next DB unless @owners;
133 $self->db_schema->{$db} = \@owners;
136 # for post-processing below
137 $self->db_schema->{$db} = '%';
141 $self->qualify_objects(1);
144 if ($db ne $current_db) {
145 $self->dbh->do("USE [$db]");
147 $self->qualify_objects(1);
152 $self->qualify_objects(1);
155 elsif (ref $self->db_schema eq 'ARRAY' || (not defined $self->db_schema)) {
156 my $owners = $self->db_schema;
157 $owners ||= [ $self->dbh->selectrow_array('SELECT user_name()') ];
159 $self->qualify_objects(1) if @$owners > 1;
161 $self->db_schema({ $current_db => $owners });
164 foreach my $db (keys %{ $self->db_schema }) {
165 if ($self->db_schema->{$db} eq '%') {
166 $self->db_schema->{$db} = [ $self->_owners($db) ];
168 $self->qualify_objects(1);
172 if (not defined $self->preserve_case) {
173 foreach my $db (keys %{ $self->db_schema }) {
174 # We use the sys.databases query for the general case, and fallback to
175 # databasepropertyex() if for some reason sys.databases is not available,
176 # which does not work over DBD::ODBC with unixODBC+FreeTDS.
178 # XXX why does databasepropertyex() not work over DBD::ODBC ?
180 # more on collations here: http://msdn.microsoft.com/en-us/library/ms143515.aspx
182 my $current_db = $self->_current_db;
184 $self->_switch_db($db);
187 (eval { $self->dbh->selectrow_array("SELECT collation_name FROM [$db].sys.databases WHERE name = @{[ $self->dbh->quote($db) ]}") })[0]
188 || (eval { $self->dbh->selectrow_array("SELECT CAST(databasepropertyex(@{[ $self->dbh->quote($db) ]}, 'Collation') AS VARCHAR)") })[0];
190 $self->_switch_db($current_db);
192 if (not $collation_name) {
195 WARNING: MSSQL Collation detection failed for database '$db'. Defaulting to
196 case-insensitive mode. Override the 'preserve_case' attribute in your Loader
199 See 'preserve_case' in
200 perldoc DBIx::Class::Schema::Loader::Base
202 $self->preserve_case(0) unless $self->preserve_case;
205 my $case_sensitive = $collation_name =~ /_(?:CS|BIN2?)(?:_|\z)/;
207 if ($case_sensitive && (not $self->preserve_case)) {
208 $self->preserve_case(1);
211 $self->preserve_case(0);
219 my ($self, $opts) = @_;
223 while (my ($db, $owners) = each %{ $self->db_schema }) {
224 foreach my $owner (@$owners) {
225 my $table_names = $self->dbh->selectcol_arrayref(<<"EOF");
227 FROM [$db].INFORMATION_SCHEMA.TABLES
228 WHERE table_schema = @{[ $self->dbh->quote($owner) ]}
231 TABLE: foreach my $table_name (@$table_names) {
232 next TABLE if any { $_ eq $table_name } $self->_system_tables;
234 push @tables, DBIx::Class::Schema::Loader::Table::Sybase->new(
244 return $self->_filter_tables(\@tables, $opts);
248 my ($self, $table) = @_;
250 my $db = $table->database;
252 my $pk = $self->dbh->selectcol_arrayref(<<"EOF");
253 SELECT kcu.column_name
254 FROM [$db].INFORMATION_SCHEMA.TABLE_CONSTRAINTS tc
255 JOIN [$db].INFORMATION_SCHEMA.KEY_COLUMN_USAGE kcu
256 ON kcu.table_name = tc.table_name
257 AND kcu.table_schema = tc.table_schema
258 AND kcu.constraint_name = tc.constraint_name
259 WHERE tc.table_name = @{[ $self->dbh->quote($table->name) ]}
260 AND tc.table_schema = @{[ $self->dbh->quote($table->schema) ]}
261 AND tc.constraint_type = 'PRIMARY KEY'
262 ORDER BY kcu.ordinal_position
265 $pk = [ map $self->_lc($_), @$pk ];
271 my ($self, $table) = @_;
273 my $db = $table->database;
275 my $sth = $self->dbh->prepare(<<"EOF");
276 SELECT rc.constraint_name, rc.unique_constraint_schema, uk_tc.table_name, fk_kcu.column_name, uk_kcu.column_name
277 FROM [$db].INFORMATION_SCHEMA.TABLE_CONSTRAINTS fk_tc
278 JOIN [$db].INFORMATION_SCHEMA.REFERENTIAL_CONSTRAINTS rc
279 ON rc.constraint_name = fk_tc.constraint_name
280 AND rc.constraint_schema = fk_tc.table_schema
281 JOIN [$db].INFORMATION_SCHEMA.KEY_COLUMN_USAGE fk_kcu
282 ON fk_kcu.constraint_name = fk_tc.constraint_name
283 AND fk_kcu.table_name = fk_tc.table_name
284 AND fk_kcu.table_schema = fk_tc.table_schema
285 JOIN [$db].INFORMATION_SCHEMA.TABLE_CONSTRAINTS uk_tc
286 ON uk_tc.constraint_name = rc.unique_constraint_name
287 AND uk_tc.table_schema = rc.unique_constraint_schema
288 JOIN [$db].INFORMATION_SCHEMA.KEY_COLUMN_USAGE uk_kcu
289 ON uk_kcu.constraint_name = rc.unique_constraint_name
290 AND uk_kcu.ordinal_position = fk_kcu.ordinal_position
291 AND uk_kcu.table_name = uk_tc.table_name
292 AND uk_kcu.table_schema = rc.unique_constraint_schema
293 WHERE fk_tc.table_name = @{[ $self->dbh->quote($table->name) ]}
294 AND fk_tc.table_schema = @{[ $self->dbh->quote($table->schema) ]}
295 ORDER BY fk_kcu.ordinal_position
302 while (my ($fk, $remote_schema, $remote_table, $col, $remote_col) = $sth->fetchrow_array) {
303 push @{ $rels{$fk}{local_columns} }, $self->_lc($col);
304 push @{ $rels{$fk}{remote_columns} }, $self->_lc($remote_col);
306 $rels{$fk}{remote_table} = DBIx::Class::Schema::Loader::Table::Sybase->new(
308 name => $remote_table,
310 schema => $remote_schema,
311 ) unless exists $rels{$fk}{remote_table};
314 return [ values %rels ];
317 sub _table_uniq_info {
318 my ($self, $table) = @_;
320 my $db = $table->database;
322 my $sth = $self->dbh->prepare(<<"EOF");
323 SELECT tc.constraint_name, kcu.column_name
324 FROM [$db].INFORMATION_SCHEMA.TABLE_CONSTRAINTS tc
325 JOIN [$db].INFORMATION_SCHEMA.KEY_COLUMN_USAGE kcu
326 ON kcu.constraint_name = tc.constraint_name
327 AND kcu.table_name = tc.table_name
328 AND kcu.table_schema = tc.table_schema
329 wHERE tc.table_name = @{[ $self->dbh->quote($table->name) ]}
330 AND tc.table_schema = @{[ $self->dbh->quote($table->schema) ]}
331 AND tc.constraint_type = 'UNIQUE'
332 ORDER BY kcu.ordinal_position
339 while (my ($constr, $col) = $sth->fetchrow_array) {
340 push @{ $uniq{$constr} }, $self->_lc($col);
343 return [ map [ $_ => $uniq{$_} ], keys %uniq ];
346 sub _columns_info_for {
350 my $db = $table->database;
352 my $result = $self->next::method(@_);
354 while (my ($col, $info) = each %$result) {
356 my ($char_max_length, $data_type, $datetime_precision, $default) =
357 $self->dbh->selectrow_array(<<"EOF");
358 SELECT character_maximum_length, data_type, datetime_precision, column_default
359 FROM [$db].INFORMATION_SCHEMA.COLUMNS
360 WHERE table_name = @{[ $self->dbh->quote($table->name) ]}
361 AND table_schema = @{[ $self->dbh->quote($table->schema) ]}
362 AND @{[ $self->preserve_case ?
363 "column_name = @{[ $self->dbh->quote($col) ]}"
365 "lower(column_name) = @{[ $self->dbh->quote(lc $col) ]}" ]}
368 $info->{data_type} = $data_type;
370 if (defined $char_max_length) {
371 $info->{size} = $char_max_length;
372 $info->{size} = 0 if $char_max_length < 0;
376 my ($is_identity) = $self->dbh->selectrow_array(<<"EOF");
378 FROM [$db].sys.columns
381 FROM [$db].sys.objects
382 WHERE name = @{[ $self->dbh->quote($table->name) ]}
385 FROM [$db].sys.schemas
386 WHERE name = @{[ $self->dbh->quote($table->schema) ]}
388 ) AND @{[ $self->preserve_case ?
389 "name = @{[ $self->dbh->quote($col) ]}"
391 "lower(name) = @{[ $self->dbh->quote(lc $col) ]}" ]}
394 $info->{is_auto_increment} = 1;
395 $info->{data_type} =~ s/\s*identity//i;
396 delete $info->{size};
400 if ($data_type eq 'int') {
401 $info->{data_type} = 'integer';
403 elsif ($data_type eq 'timestamp') {
404 $info->{inflate_datetime} = 0;
406 elsif ($data_type =~ /^(?:numeric|decimal)\z/) {
407 if (ref($info->{size}) && $info->{size}[0] == 18 && $info->{size}[1] == 0) {
408 delete $info->{size};
411 elsif ($data_type eq 'float') {
412 $info->{data_type} = 'double precision';
413 delete $info->{size};
415 elsif ($data_type =~ /^(?:small)?datetime\z/) {
416 # fixup for DBD::Sybase
417 if ($info->{default_value} && $info->{default_value} eq '3') {
418 delete $info->{default_value};
421 elsif ($data_type =~ /^(?:datetime(?:2|offset)|time)\z/) {
422 $info->{size} = $datetime_precision;
424 delete $info->{size} if $info->{size} == 7;
426 elsif ($data_type eq 'varchar' && $info->{size} == 0) {
427 $info->{data_type} = 'text';
428 delete $info->{size};
430 elsif ($data_type eq 'nvarchar' && $info->{size} == 0) {
431 $info->{data_type} = 'ntext';
432 delete $info->{size};
434 elsif ($data_type eq 'varbinary' && $info->{size} == 0) {
435 $info->{data_type} = 'image';
436 delete $info->{size};
439 if ($data_type !~ /^(?:n?char|n?varchar|binary|varbinary|numeric|decimal|float|datetime(?:2|offset)|time)\z/) {
440 delete $info->{size};
443 if (defined $default) {
445 $default =~ s/^\( (.*) \)\z/$1/x;
447 # Literal strings are in ''s, numbers are in ()s (in some versions of
448 # MSSQL, in others they are unquoted) everything else is a function.
449 $info->{default_value} =
450 $default =~ /^['(] (.*) [)']\z/x ? $1 :
451 $default =~ /^\d/ ? $default : \$default;
453 if ((eval { lc ${ $info->{default_value} } }||'') eq 'getdate()') {
454 ${ $info->{default_value} } = 'current_timestamp';
456 my $getdate = 'getdate()';
457 $info->{original}{default_value} = \$getdate;
467 L<DBIx::Class::Schema::Loader::DBI::Sybase::Microsoft_SQL_Server>,
468 L<DBIx::Class::Schema::Loader::DBI::ODBC::Microsoft_SQL_Server>,
469 L<DBIx::Class::Schema::Loader>, L<DBIx::Class::Schema::Loader::Base>,
470 L<DBIx::Class::Schema::Loader::DBI>
474 See L<DBIx::Class::Schema::Loader/AUTHOR> and L<DBIx::Class::Schema::Loader/CONTRIBUTORS>.
478 This library is free software; you can redistribute it and/or modify it under
479 the same terms as Perl itself.
484 # vim:et sts=4 sw=4 tw=0: