ridgepole 3.2.2 → 3.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: aa8b60187f54d3f6f510aae6326606c4d0885c3867cc48c6b51d27fd5ac1c5e1
-  data.tar.gz: 5c52635dff367490eeb5ebda435ea26e4c90f784ef4036c21fb6d58865b93674
+  metadata.gz: 1a307f88c8f4187e3ec20de74f563caa0041e66749b0c2bf0345724a2a15103b
+  data.tar.gz: b74fc6cae628ac13466fd7dde31679d518f3bcc963bb7dd5877c193720bebf25
 SHA512:
-  metadata.gz: 54c4b813601a1bc68891456a7d95ab41641dc63270ca22b0652f06d6757d49b6740a6c0738cc3f5f28c69c5d80c22bd2ecb0b7e7d7de12e6c321f591b95db6cd
-  data.tar.gz: df2418e5c2bb8ebfe5759c04d3656e524f3b94e995ba24c67f6e74629bdce00667c324d0265433a7333b335ab9245b133c5212a5f0dc282a57692bb6c83b41cf
+  metadata.gz: 9b6d880d3b5f91ab5947dd416180c097df2ea99c566df051195357898ee457dbcc35a724467e43b23620d8fc62b1dba7a44460d71535ad7977f1f851a616f08b
+  data.tar.gz: 37b2b51fbbf5aadb34fd85d1526b30ddc550bbd85467e3183148f8f8376caf78c0b25f62ed7a32585c6f03caddae73a6e8b8dcbeb762058b609fc382b971bec9

data/CHANGELOG.md

@@ -2,6 +2,11 @@
 
 ## 3.2
 
+### 3.2.3 (2026/08/01)
+
+- Emit `validate_constraint` when DB is NOT VALID and DSL implies validated. [pull#718](https://github.com/ridgepole/ridgepole/pull/718)
+- Ignore `validate: false` diff when existing constraint lacks `:validate`. [pull#716](https://github.com/ridgepole/ridgepole/pull/716)
+
 ### 3.2.2 (2026/06/14)
 
 - Fix constraint removal order when dropping columns. [pull#705](https://github.com/ridgepole/ridgepole/pull/705)

data/lib/ridgepole/delta.rb

@@ -568,6 +568,10 @@ remove_index(#{table_name.inspect}, #{target})
       (delta[:add] || {}).each_value do |attrs|
         append_add_foreign_key(table_name, attrs, post_buf, options)
       end
+
+      (delta[:validate] || {}).each_value do |attrs|
+        append_validate_foreign_key(table_name, attrs, post_buf)
+      end
     end
 
     def append_add_foreign_key(table_name, attrs, buf, _options)
@@ -594,6 +598,21 @@ remove_foreign_key(#{table_name.inspect}, #{target})
     RUBY
     end
 
+    def append_validate_foreign_key(table_name, attrs, buf)
+      attrs_options = attrs[:options] || {}
+      fk_name = attrs_options[:name]
+
+      target = if fk_name
+                 "name: #{fk_name.inspect}"
+               else
+                 attrs.fetch(:to_table).inspect
+               end
+
+      buf.puts(<<-RUBY)
+validate_foreign_key(#{table_name.inspect}, #{target})
+      RUBY
+    end
+
     def append_change_check_constraints(table_name, delta, pre_buf, post_buf)
       (delta[:delete] || {}).each_value do |attrs|
         append_remove_check_constraint(table_name, attrs, pre_buf)
@@ -602,6 +621,10 @@ remove_foreign_key(#{table_name.inspect}, #{target})
       (delta[:add] || {}).each_value do |attrs|
         append_add_check_constraint(table_name, attrs, post_buf)
       end
+
+      (delta[:validate] || {}).each_value do |attrs|
+        append_validate_check_constraint(table_name, attrs, post_buf)
+      end
     end
 
     def append_add_check_constraint(table_name, attrs, buf, force_bulk_change = false)
@@ -628,6 +651,15 @@ remove_check_constraint(#{table_name.inspect}, #{expression.inspect}, **#{attrs_
       RUBY
     end
 
+    def append_validate_check_constraint(table_name, attrs, buf)
+      attrs_options = attrs[:options] || {}
+      name = attrs_options[:name]
+
+      buf.puts(<<-RUBY)
+validate_check_constraint(#{table_name.inspect}, name: #{name.inspect})
+      RUBY
+    end
+
     def append_change_exclusion_constraints(table_name, delta, pre_buf, post_buf)
       (delta[:delete] || {}).each_value do |attrs|
         append_remove_exclusion_constraint(table_name, attrs, pre_buf)

data/lib/ridgepole/diff.rb

@@ -524,13 +524,18 @@ module Ridgepole
         next if ignore_fk
 
         if from_attrs
-          if from_attrs != to_attrs
-            foreign_keys_delta[:add] ||= {}
-            foreign_keys_delta[:add][foreign_key_name_or_tables] = to_attrs
+          if from_attrs != to_attrs && !ignorable_validate_diff?(from_attrs, to_attrs)
+            if validate_only_diff?(from_attrs, to_attrs)
+              foreign_keys_delta[:validate] ||= {}
+              foreign_keys_delta[:validate][foreign_key_name_or_tables] = to_attrs
+            else
+              foreign_keys_delta[:add] ||= {}
+              foreign_keys_delta[:add][foreign_key_name_or_tables] = to_attrs
 
-            unless options[:merge]
-              foreign_keys_delta[:delete] ||= {}
-              foreign_keys_delta[:delete][foreign_key_name_or_tables] = from_attrs
+              unless options[:merge]
+                foreign_keys_delta[:delete] ||= {}
+                foreign_keys_delta[:delete][foreign_key_name_or_tables] = from_attrs
+              end
             end
           end
         else
@@ -558,12 +563,19 @@ module Ridgepole
         from_attrs = from.delete(name)
 
         if from_attrs
-          if normalize_check_constraint(from_attrs) != normalize_check_constraint(to_attrs)
-            check_constraints_delta[:add] ||= {}
-            check_constraints_delta[:add][name] = to_attrs
+          from_normalized = normalize_check_constraint(from_attrs)
+          to_normalized = normalize_check_constraint(to_attrs)
+          if from_normalized != to_normalized && !ignorable_validate_diff?(from_normalized, to_normalized)
+            if validate_only_diff?(from_normalized, to_normalized)
+              check_constraints_delta[:validate] ||= {}
+              check_constraints_delta[:validate][name] = to_attrs
+            else
+              check_constraints_delta[:add] ||= {}
+              check_constraints_delta[:add][name] = to_attrs
 
-            check_constraints_delta[:delete] ||= {}
-            check_constraints_delta[:delete][name] = from_attrs
+              check_constraints_delta[:delete] ||= {}
+              check_constraints_delta[:delete][name] = from_attrs
+            end
           end
         else
           check_constraints_delta[:add] ||= {}
@@ -587,6 +599,33 @@ module Ridgepole
       attr
     end
 
+    # 'validate: false' (NOT VALID) is a strategy for ALTER TABLE ADD CONSTRAINT to avoid
+    # ACCESS EXCLUSIVE lock on large tables. NOT VALID state itself is persisted by the DB,
+    # but PostgreSQL ignores NOT VALID for constraints created inline within CREATE TABLE, so
+    # whether the resulting constraint is NOT VALID depends on how it was created. Restoring
+    # NOT VALID via DROP + ADD has no benefit, so ignore the diff when the DB dump lacks
+    # :validate and the DSL specifies validate: false.
+    def ignorable_validate_diff?(from_attrs, to_attrs)
+      from_options = from_attrs[:options] || {}
+      to_options = to_attrs[:options] || {}
+      return false unless to_options[:validate] == false && !from_options.key?(:validate)
+
+      from_attrs == to_attrs.merge(options: to_options.except(:validate))
+    end
+
+    # Reverse of ignorable_validate_diff?: DB has a NOT VALID constraint (validate: false)
+    # and the DSL implies validated (:validate missing or true). Emit VALIDATE CONSTRAINT
+    # instead of DROP + re-ADD so the full-table scan runs under SHARE UPDATE EXCLUSIVE
+    # (concurrent DML allowed) rather than ACCESS EXCLUSIVE lock.
+    def validate_only_diff?(from_attrs, to_attrs)
+      from_options = from_attrs[:options] || {}
+      to_options = to_attrs[:options] || {}
+      return false unless from_options[:validate] == false && to_options[:validate] != false
+
+      from_attrs.merge(options: from_options.except(:validate)) ==
+        to_attrs.merge(options: to_options.except(:validate))
+    end
+
     def scan_exclusion_constraints_change(from, to, table_delta)
       from = (from || {}).dup
       to = (to || {}).dup

data/lib/ridgepole/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Ridgepole
-  VERSION = '3.2.2'
+  VERSION = '3.2.3'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ridgepole
 version: !ruby/object:Gem::Version
-  version: 3.2.2
+  version: 3.2.3
 platform: ruby
 authors:
 - Genki Sugawara
@@ -245,14 +245,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.87.0
+        version: 1.88.2
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.87.0
+        version: 1.88.2
 - !ruby/object:Gem::Dependency
   name: rubocop-rake
   requirement: !ruby/object:Gem::Requirement