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 # strangely the first time this is called can
134 # differ to subsequent times. so we call it
137 $self->storage->sqlt_type;
139 my $upgrade_file = $self->ddl_filename(
140 $self->storage->sqlt_type,
142 $self->upgrade_directory,
146 $self->create_upgrade_path({ upgrade_file => $upgrade_file });
148 unless (-f $upgrade_file) {
149 carp "Upgrade not possible, no upgrade file found ($upgrade_file), please create one\n";
153 carp "DB version ($db_version) is lower than the schema version (".$self->schema_version."). Attempting upgrade.\n";
155 # backup if necessary then apply upgrade
156 $self->_filedata($self->_read_sql_file($upgrade_file));
157 $self->backup if $self->do_backup;
158 $self->schema->txn_do(sub { $self->do_upgrade });
160 # set row in dbix_class_schema_versions table
161 $self->version_rs->create({
162 version => $target_version,
164 # upgrade_sql => $upgrade_sql,
168 method do_upgrade { $self->run_upgrade(qr/.*?/) }
170 method run_upgrade($stm) {
171 return unless $self->_filedata;
172 my @statements = grep { $_ =~ $stm } @{$self->_filedata};
175 $self->storage->debugobj->query_start($_) if $self->storage->debug;
176 $self->apply_statement($_);
177 $self->storage->debugobj->query_end($_) if $self->storage->debug;
181 method apply_statement($statement) {
182 $self->storage->dbh->do($_) or carp "SQL was: $_"
185 sub _create_db_to_schema_diff {
188 my %driver_to_db_map = (
192 my $db = $driver_to_db_map{$self->storage->dbh->{Driver}{Name}};
194 print "Sorry, this is an unsupported DB\n";
198 $self->throw_exception($self->storage->_sqlt_version_error)
199 unless $self->storage->_sqlt_version_ok;
201 my $db_tr = SQL::Translator->new({
204 parser_args => { dbh => $self->storage->dbh },
208 my $dbic_tr = SQL::Translator->new({
209 parser => 'SQL::Translator::Parser::DBIx::Class',
214 $db_tr->schema->name('db_schema');
215 $dbic_tr->schema->name('dbic_schema');
217 # is this really necessary?
218 foreach my $tr ($db_tr, $dbic_tr) {
219 my $data = $tr->data;
220 $tr->parser->($tr, $$data);
223 my $diff = SQL::Translator::Diff::schema_diff(
225 $dbic_tr->schema, $db, {
226 ignore_constraint_names => 1,
227 ignore_index_names => 1,
232 my $filename = $self->ddl_filename(
234 $self->schema_version,
235 $self->upgrade_directory,
239 open my $file, '>', $filename
240 or $self->throw_exception("Can't open $filename for writing ($!)");
244 carp "WARNING: There may be differences between your DB and your DBIC schema.\n" .
245 "Please review and if necessary run the SQL in $filename to sync your DB.\n";
248 method _read_sql_file($file) {
251 open my $fh, '<', $file or carp("Can't open upgrade file, $file ($!)");
252 my @data = split /\n/, join '', <$fh>;
258 !/^(BEGIN|BEGIN TRANSACTION|COMMIT)/m