See L<DBIx::Class::Schema::Loader> and L<DBIx::Class::Schema::Loader::Base> for
usage information.
+=head1 CASE SENSITIVITY
+
+Most MSSQL databases use C<CI> (case-insensitive) collation, for this reason
+generated column names are lower-cased as this makes them easier to work with
+in L<DBIx::Class>.
+
+We attempt to detect the database collation at startup, and set the column
+lowercasing behavior accordingly, as lower-cased column names do not work on
+case-sensitive databases.
+
+To manually set or unset case-sensitive mode, put:
+
+ case_sensitive_collation => 1
+
+in your Loader options.
+
=cut
sub _is_case_sensitive {
$self->next::method;
+ return if defined $self->case_sensitive_collation;
+
my $dbh = $self->schema->storage->dbh;
# We use the sys.databases query for the general case, and fallback to
# which does not work over DBD::ODBC with unixODBC+FreeTDS.
#
# XXX why does databasepropertyex() not work over DBD::ODBC ?
+ #
+ # more on collations here: http://msdn.microsoft.com/en-us/library/ms143515.aspx
my ($collation_name) =
eval { $dbh->selectrow_array('SELECT collation_name FROM sys.databases WHERE name = DB_NAME()') }
- || eval { $dbh->selectrow_array("SELECT databasepropertyex(DB_NAME(), 'Collation')") };
+ || eval { $dbh->selectrow_array("SELECT CAST(databasepropertyex(DB_NAME(), 'Collation') AS VARCHAR)") };
if (not $collation_name) {
- $self->case_sensitive_collation(0); # most likely not
+ warn <<'EOF';
+
+WARNING: MSSQL Collation detection failed. Defaulting to case-insensitive mode.
+Override the 'case_sensitive_collation' attribute in your Loader options if
+needed.
+EOF
+ $self->case_sensitive_collation(0);
return;
}