1 package DBIx::Class::DeploymentHandler;
4 use Method::Signatures::Simple;
5 require DBIx::Class::Schema; # loaded for type constraint
6 require DBIx::Class::Storage; # loaded for type constraint
7 require DBIx::Class::ResultSet; # loaded for type constraint
11 isa => 'DBIx::Class::Schema',
14 handles => [qw{schema_version}],
17 has upgrade_directory => (
24 has backup_directory => (
30 isa => 'DBIx::Class::Storage',
35 method _build_storage {
36 my $s = $self->schema->storage;
37 $s->_determine_driver;
52 has do_diff_on_init => (
59 isa => 'DBIx::Class::ResultSet',
62 handles => [qw( is_installed db_version )],
65 method _build_version_rs { $self->schema->resultset('VersionResult') }
67 method backup { $self->storage->backup($self->backup_directory) }
69 method install($new_version) {
70 carp 'Install not possible as versions table already exists in database'
71 unless $self->is_installed;
73 $new_version ||= $self->schema_version;
76 $self->schema->deploy;
78 $self->version_rs->create({
79 version => $new_version,
81 # upgrade_sql => $upgrade_sql,
86 method create_upgrade_path { }
88 method ordered_schema_versions { }
91 my $db_version = $self->db_version;
92 my $schema_version = $self->schema_version;
94 unless ($db_version) {
95 carp 'Upgrade not possible as database is unversioned. Please call install first.';
99 if ( $db_version eq $schema_version ) {
100 carp "Upgrade not necessary\n";
104 my @version_list = $self->ordered_schema_versions ||
105 ( $db_version, $schema_version );
107 # remove all versions in list above the required version
108 while ( @version_list && ( $version_list[-1] ne $schema_version ) ) {
112 # remove all versions in list below the current version
113 while ( @version_list && ( $version_list[0] ne $db_version ) ) {
117 # check we have an appropriate list of versions
118 die if @version_list < 2;
121 while ( @version_list >= 2 ) {
122 $self->upgrade_single_step( $version_list[0], $version_list[1] );
127 method upgrade_single_step($db_version, $target_version) {
128 if ($db_version eq $target_version) {
129 carp "Upgrade not necessary\n";
133 my $upgrade_file = $self->ddl_filename(
134 $self->storage->sqlt_type,
136 $self->upgrade_directory,
140 $self->create_upgrade_path({ upgrade_file => $upgrade_file });
142 unless (-f $upgrade_file) {
143 carp "Upgrade not possible, no upgrade file found ($upgrade_file), please create one\n";
147 carp "DB version ($db_version) is lower than the schema version (".$self->schema_version."). Attempting upgrade.\n";
149 # backup if necessary then apply upgrade
150 $self->_filedata($self->_read_sql_file($upgrade_file));
151 $self->backup if $self->do_backup;
152 $self->schema->txn_do(sub { $self->do_upgrade });
154 # set row in dbix_class_schema_versions table
155 $self->version_rs->create({
156 version => $target_version,
158 # upgrade_sql => $upgrade_sql,
162 method do_upgrade { $self->run_upgrade(qr/.*?/) }
164 method run_upgrade($stm) {
165 return unless $self->_filedata;
166 my @statements = grep { $_ =~ $stm } @{$self->_filedata};
169 $self->storage->debugobj->query_start($_) if $self->storage->debug;
170 $self->apply_statement($_);
171 $self->storage->debugobj->query_end($_) if $self->storage->debug;
175 method apply_statement($statement) {
176 $self->storage->dbh->do($_) or carp "SQL was: $_"
179 sub _create_db_to_schema_diff {
182 my %driver_to_db_map = (
186 my $db = $driver_to_db_map{$self->storage->dbh->{Driver}{Name}};
188 print "Sorry, this is an unsupported DB\n";
192 $self->throw_exception($self->storage->_sqlt_version_error)
193 unless $self->storage->_sqlt_version_ok;
195 my $db_tr = SQL::Translator->new({
198 parser_args => { dbh => $self->storage->dbh },
202 my $dbic_tr = SQL::Translator->new({
203 parser => 'SQL::Translator::Parser::DBIx::Class',
208 $db_tr->schema->name('db_schema');
209 $dbic_tr->schema->name('dbic_schema');
211 # is this really necessary?
212 foreach my $tr ($db_tr, $dbic_tr) {
213 my $data = $tr->data;
214 $tr->parser->($tr, $$data);
217 my $diff = SQL::Translator::Diff::schema_diff(
219 $dbic_tr->schema, $db, {
220 ignore_constraint_names => 1,
221 ignore_index_names => 1,
226 my $filename = $self->ddl_filename(
228 $self->schema_version,
229 $self->upgrade_directory,
233 open my $file, '>', $filename
234 or $self->throw_exception("Can't open $filename for writing ($!)");
238 carp "WARNING: There may be differences between your DB and your DBIC schema.\n" .
239 "Please review and if necessary run the SQL in $filename to sync your DB.\n";
242 method _read_sql_file($file) {
245 open my $fh, '<', $file or carp("Can't open upgrade file, $file ($!)");
246 my @data = split /\n/, join '', <$fh>;
252 !/^(BEGIN|BEGIN TRANSACTION|COMMIT)/m