activerecord-cockroachdb-adapter 8.1.0 → 8.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f24596dd159836cb67f7a9f181e32e8370d01420cdb574a96bdf901e802b2669
-  data.tar.gz: 126991cc6c0e158ee27386132fc6cc046566720006b020df28cb5495e38d0a08
+  metadata.gz: 89db3d0e5b53942784db247fbdf247790cc0e8a06861f6881546e348d0c151bb
+  data.tar.gz: 26e1b278cf2abe8dc532eaa3ab187c356760d40cb1b42c1a3561117ab4a32c58
 SHA512:
-  metadata.gz: ceab189ddbb6c54dbf586c2f3b70c520076c727447304d244924d75029d545fab8c4ebd6864ed00016c8c5cd04476141c64eb1758466cac6762162ce5fbf199e
-  data.tar.gz: 1a4fb49e5189772b207e1633c4375943fdee80f3cf8350372d53cf0f1f34a3e7e425a99ae504be585868e2f5565c4a5703bd428692de8d2cf8d0658c42b035d5
+  metadata.gz: 599a68d0aeb772af6fb102004deb44d5d548a5d0dcc16e38d187c324c7957f023f8bd3cae6438922f103a6b813e661f0e429848b9cc2ec5b65a89f4491141df1
+  data.tar.gz: 26257cf4314a3654444f4154e75acb626c8ccf4d6a1237f18153c78a253dfd93125f663f803e01303492766e9db6e3478f87f4abdbbeb299d36cf425c84dc043

data/CHANGELOG.md

@@ -2,7 +2,18 @@
 
 ## Ongoing
 
-## 8.01 - 2025-11-25
+## 8.1.2 - 2026-09-25
+
+- Verified compatibility with Rails 8.1.4 ([#407](https://github.com/cockroachdb/activerecord-cockroachdb-adapter/pull/407))
+
+## 8.1.1 - 2026-08-18
+
+- Disabled `schema_locked` by default on connect for CockroachDB v25.3+ and unlocked tables around batched foreign key changes ([#404](https://github.com/cockroachdb/activerecord-cockroachdb-adapter/pull/404))
+- Improved error classification by detecting cached plan failures from the error message instead of the source function ([#403](https://github.com/cockroachdb/activerecord-cockroachdb-adapter/pull/403))
+- Stopped advertising support for restarting database transactions ([#398](https://github.com/cockroachdb/activerecord-cockroachdb-adapter/pull/398))
+- Fixed enum columns being misdetected as spatial columns ([#396](https://github.com/cockroachdb/activerecord-cockroachdb-adapter/pull/396))
+
+## 8.1.0 - 2025-11-25
 - Add support for Rails 8.1 ([#386](https://github.com/cockroachdb/activerecord-cockroachdb-adapter/pull/386))
 
 ## 8.0.3 - 2025-08-19

data/lib/active_record/connection_adapters/cockroachdb/column.rb

@@ -27,9 +27,12 @@ module ActiveRecord
           super(name, cast_type, default, sql_type_metadata, null, default_function,
             collation: collation, comment: comment, serial: serial, generated: generated, identity: identity)
 
-          @geographic = sql_type_metadata.sql_type.match?(/geography\(/i)
           @hidden = hidden
 
+          return unless spatial?
+
+          @geographic = sql_type_metadata.sql_type.match?(/geography\(/i)
+
           if @geographic
             # Geographic type information is embedded in the SQL type
             @srid = 4326

data/lib/active_record/connection_adapters/cockroachdb/referential_integrity.rb

@@ -84,7 +84,9 @@ WARNING
 
             schema_creation.accept(at)
           end
-          execute_batch(statements, "Disable referential integrity -> remove foreign keys")
+          with_schema_unlocked(foreign_keys.flat_map { |fk| [fk.from_table, fk.to_table] }) do
+            execute_batch(statements, "Disable referential integrity -> remove foreign keys")
+          end
         end
 
         # NOTE: This method should never raise, otherwise we risk polluting table name
@@ -95,16 +97,68 @@ WARNING
           # for every key. This method is performance critical for the test suite, hence
           # we use the `#all_foreign_keys` method that only make one query to the database.
           already_inserted_foreign_keys = all_foreign_keys
-          statements = foreign_keys.map do |foreign_key|
-            next if already_inserted_foreign_keys.any? { |fk| fk.from_table == foreign_key.from_table && fk.options[:name] == foreign_key.options[:name] }
-
+          foreign_keys_to_add = foreign_keys.reject do |foreign_key|
+            already_inserted_foreign_keys.any? { |fk| fk.from_table == foreign_key.from_table && fk.options[:name] == foreign_key.options[:name] }
+          end
+          statements = foreign_keys_to_add.map do |foreign_key|
             options = foreign_key_options(foreign_key.from_table, foreign_key.to_table, foreign_key.options)
             at = create_alter_table foreign_key.from_table
             at.add_foreign_key foreign_key.to_table, options
 
             schema_creation.accept(at)
           end
-          execute_batch(statements.compact, "Disable referential integrity -> add foreign keys")
+          with_schema_unlocked(foreign_keys_to_add.flat_map { |fk| [fk.from_table, fk.to_table] }) do
+            execute_batch(statements, "Disable referential integrity -> add foreign keys")
+          end
+        end
+
+        # Starting in CockroachDB v26.x, tables are created with the
+        # `schema_locked` storage parameter enabled by default (it improves
+        # changefeed performance). CockroachDB transparently unlocks a table to
+        # run a single-statement DDL, but it cannot do so for the multi-statement
+        # batches used to drop and re-add foreign keys above: it raises instead
+        # of unlocking automatically. So we unlock the affected tables ourselves,
+        # run the batch, then restore their locked state. Adding a foreign key
+        # also writes a back-reference into the referenced table, so callers must
+        # pass both the referencing and referenced tables.
+        #
+        # See https://www.cockroachlabs.com/docs/stable/schema-locked
+        def with_schema_unlocked(tables)
+          locked = schema_locked_tables(tables.uniq)
+          return yield if locked.empty?
+
+          set_schema_locked(locked, false)
+          begin
+            yield
+          ensure
+            set_schema_locked(locked, true)
+          end
+        end
+
+        # Returns the subset of +tables+ whose `schema_locked` storage parameter
+        # is currently enabled. CockroachDB exposes storage parameters through
+        # `pg_class.reloptions`. On versions (or configurations) that do not lock
+        # tables this returns an empty array, so callers stay on the fast path.
+        def schema_locked_tables(tables)
+          return [] if tables.empty?
+
+          locked = query_values(<<~SQL, "SCHEMA")
+            SELECT (CASE WHEN n.nspname = current_schema() THEN '' ELSE n.nspname || '.' END) || c.relname
+            FROM pg_class c
+            JOIN pg_namespace n ON n.oid = c.relnamespace
+            WHERE c.relkind = 'r' AND 'schema_locked=true' = ANY (c.reloptions)
+          SQL
+          tables & locked
+        end
+
+        # Toggles the `schema_locked` storage parameter for the given tables.
+        # CockroachDB only allows changing `schema_locked` in a single-statement
+        # implicit transaction, so unlike the foreign key statements above these
+        # cannot be batched together.
+        def set_schema_locked(tables, value)
+          tables.each do |table|
+            execute("ALTER TABLE #{quote_table_name(table)} SET (schema_locked = #{value})", "Toggle schema_locked")
+          end
         end
 
         # NOTE: Copy/paste of the `#foreign_keys(table)` method adapted

data/lib/active_record/connection_adapters/cockroachdb_adapter.rb

@@ -202,6 +202,12 @@ module ActiveRecord
         false
       end
 
+      def supports_restart_db_transaction?
+        # In PostgreSQL, this would call 'ROLLBACK AND CHAIN'
+        # which is not available with CRDB.
+        false
+      end
+
       # OVERRIDE: UNIQUE CONSTRAINTS will create indexes anyway, so we only consider
       #   then as indexes.
       # See https://github.com/cockroachdb/activerecord-cockroachdb-adapter/issues/347.
@@ -259,6 +265,26 @@ module ActiveRecord
       def configure_connection(...)
         super
 
+        # Starting in CockroachDB v26.x, tables are created with the
+        # `schema_locked` storage parameter enabled by default (controlled by the
+        # `sql.create_table_with_schema_locked.enabled` cluster setting). While it
+        # improves changefeed performance, it blocks the transactional DDL that
+        # Active Record migrations and the test suite rely on: CockroachDB can
+        # only auto-unlock a locked table for single-statement implicit
+        # transactions, not for DDL run inside a transaction. Opt out at the
+        # session level so Active Record keeps working out of the box; users who
+        # want the changefeed benefit can still lock individual tables or set
+        # `create_table_with_schema_locked: true` in their connection variables.
+        #
+        # The session variable was introduced in CockroachDB v25.3, and we let an
+        # explicit `:variables` entry take precedence over this default.
+        #
+        # See https://www.cockroachlabs.com/docs/stable/schema-locked
+        variables = @config.fetch(:variables, {}).stringify_keys
+        if database_version >= 25_03_00 && !variables.key?("create_table_with_schema_locked")
+          internal_execute("SET create_table_with_schema_locked = false", "SCHEMA")
+        end
+
       # This rescue flow appears in new_client, but it is needed here as well
       # since Cockroach will sometimes not raise until a query is made.
       #
@@ -479,22 +505,22 @@ module ActiveRecord
         end
 
         # override
-        # This method is used to determine if a
-        # FEATURE_NOT_SUPPORTED error from the PG gem should
-        # be an ActiveRecord::PreparedStatementCacheExpired
-        # error.
-        #
-        # ActiveRecord handles this by checking that the sql state matches the
-        # FEATURE_NOT_SUPPORTED code and that the source function
-        # is "RevalidateCachedQuery" since that is the only function
-        # in postgres that will create this error.
+        # Classifies a FEATURE_NOT_SUPPORTED error from the PG gem as an
+        # ActiveRecord::PreparedStatementCacheExpired.
         #
-        # That method will not work for CockroachDB because the error
-        # originates from the "runExecBuilder" function, so we need
-        # to modify the original to match the CockroachDB behavior.
+        # Upstream matches PG_DIAG_SOURCE_FUNCTION == "RevalidateCachedQuery",
+        # the one PostgreSQL C function that raises this error. CockroachDB's
+        # raising function is an internal detail that has already moved
+        # (runExecBuilder before cockroachdb/cockroach#164406, execBind after),
+        # so match the message instead. The message is not formally guaranteed,
+        # but it has been unchanged in PostgreSQL since 8.3 and drivers such as
+        # pgx assert the exact string. Upstream avoids message matching because
+        # PostgreSQL localizes messages via lc_messages (rails/rails@d507ae2a74);
+        # CockroachDB does not localize, so that concern does not apply.
+        CACHED_PLAN_HEURISTIC = "cached plan must not change result type"
         def is_cached_plan_failure?(pgerror)
           pgerror.result.result_error_field(PG::PG_DIAG_SQLSTATE) == FEATURE_NOT_SUPPORTED &&
-            pgerror.result.result_error_field(PG::PG_DIAG_SOURCE_FUNCTION) == "runExecBuilder"
+            pgerror.result.result_error_field(PG::PG_DIAG_MESSAGE_PRIMARY).include?(CACHED_PLAN_HEURISTIC)
         rescue
           false
         end

data/lib/version.rb

@@ -15,5 +15,5 @@
 # limitations under the License.
 
 module ActiveRecord
-  COCKROACH_DB_ADAPTER_VERSION = "8.1.0"
+  COCKROACH_DB_ADAPTER_VERSION = "8.1.2"
 end

data/test/cases/adapters/cockroachdb/cached_plan_failure_test.rb

@@ -0,0 +1,106 @@
+# frozen_string_literal: true
+
+require "cases/helper_cockroachdb"
+
+class CockroachDBCachedPlanFailureTest < ActiveRecord::PostgreSQLTestCase
+  FakeResult = Struct.new(:fields) do
+    def result_error_field(code)
+      fields[code]
+    end
+  end
+  FakeError = Struct.new(:result)
+
+  # Reference the adapter's constant so the tests can't drift from the
+  # heuristic they are meant to verify.
+  CACHED_PLAN_MESSAGE =
+    ActiveRecord::ConnectionAdapters::CockroachDBAdapter::CACHED_PLAN_HEURISTIC
+
+  def setup
+    @connection = ActiveRecord::Base.lease_connection
+  end
+
+  # CockroachDB has raised this error from "runExecBuilder" (Execute
+  # phase) and, since cockroachdb/cockroach#164406, from "execBind"
+  # (Bind phase). Detection must not depend on the source function.
+  def test_detects_cached_plan_failure_from_any_source_function
+    %w[runExecBuilder execBind].each do |source_function|
+      pgerror = FakeError.new(FakeResult.new({
+        PG::PG_DIAG_SQLSTATE => "0A000",
+        PG::PG_DIAG_MESSAGE_PRIMARY => CACHED_PLAN_MESSAGE,
+        PG::PG_DIAG_SOURCE_FUNCTION => source_function
+      }))
+      assert @connection.send(:is_cached_plan_failure?, pgerror),
+        "expected cached plan failure to be detected when raised from #{source_function}"
+    end
+  end
+
+  def test_detects_cached_plan_failure_with_wrapped_message
+    pgerror = FakeError.new(FakeResult.new({
+      PG::PG_DIAG_SQLSTATE => "0A000",
+      PG::PG_DIAG_MESSAGE_PRIMARY => "portal \"p1\": #{CACHED_PLAN_MESSAGE}"
+    }))
+    assert @connection.send(:is_cached_plan_failure?, pgerror)
+  end
+
+  def test_ignores_other_feature_not_supported_errors
+    pgerror = FakeError.new(FakeResult.new({
+      PG::PG_DIAG_SQLSTATE => "0A000",
+      PG::PG_DIAG_MESSAGE_PRIMARY => "unimplemented: something else"
+    }))
+    assert_not @connection.send(:is_cached_plan_failure?, pgerror)
+  end
+
+  def test_ignores_cached_plan_message_with_other_sqlstate
+    pgerror = FakeError.new(FakeResult.new({
+      PG::PG_DIAG_SQLSTATE => "XX000",
+      PG::PG_DIAG_MESSAGE_PRIMARY => CACHED_PLAN_MESSAGE
+    }))
+    assert_not @connection.send(:is_cached_plan_failure?, pgerror)
+  end
+
+  def test_returns_false_when_error_fields_unavailable
+    assert_not @connection.send(:is_cached_plan_failure?, Object.new)
+  end
+
+  # End-to-end check that a real cached-plan failure is caught and recovered
+  # from against a live server, rather than only exercising the classifier
+  # with fabricated errors. Adding a column changes the result type of a
+  # cached `SELECT *`, which makes CockroachDB raise FEATURE_NOT_SUPPORTED
+  # ("cached plan must not change result type") the next time the prepared
+  # statement runs. The adapter must evict the stale statement and retry.
+  #
+  # Recovery only happens outside a transaction (inside one, the adapter can
+  # only raise PreparedStatementCacheExpired), so this test must not run in
+  # the suite's wrapping transaction.
+  exclude_from_transactional_tests :test_recovers_from_real_cached_plan_failure
+
+  def test_recovers_from_real_cached_plan_failure
+    @connection.execute("DROP TABLE IF EXISTS cached_plan_things")
+    @connection.execute("CREATE TABLE cached_plan_things (id INT PRIMARY KEY, a INT)")
+    @connection.execute("INSERT INTO cached_plan_things (id, a) VALUES (1, 10)")
+
+    sql = "SELECT * FROM cached_plan_things WHERE id = $1"
+    bind = ActiveRecord::Relation::QueryAttribute.new(
+      "id", 1, ActiveRecord::Type::Integer.new
+    )
+
+    # Prime the server-side prepared statement cache. `prepare: true` forces
+    # the prepared-statement code path that contains the recovery logic.
+    first = @connection.exec_query(sql, "SQL", [bind], prepare: true)
+    assert_equal ["id", "a"], first.columns
+
+    # Invalidate the cached plan by changing the result type.
+    @connection.execute("ALTER TABLE cached_plan_things ADD COLUMN b INT")
+
+    # Re-running the same prepared statement would raise without recovery;
+    # the adapter should transparently flush the stale statement and retry.
+    second = assert_nothing_raised do
+      @connection.exec_query(sql, "SQL", [bind], prepare: true)
+    end
+    assert_equal ["id", "a", "b"], second.columns
+    assert_equal 1, second.rows.length
+  ensure
+    @connection.execute("DROP TABLE IF EXISTS cached_plan_things")
+    @connection.clear_cache!
+  end
+end

data/test/cases/adapters/cockroachdb/referential_integrity_test.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 require "cases/helper_cockroachdb"
-require "support/connection_helper" # for #reset_connection
+require "support/connection_helper" # for #reset_pool
 require "support/copy_cat"
 
 class CockroachDBReferentialIntegrityTest < ActiveRecord::PostgreSQLTestCase
@@ -18,8 +18,10 @@ class CockroachDBReferentialIntegrityTest < ActiveRecord::PostgreSQLTestCase
     @connection = ActiveRecord::Base.lease_connection
   end
 
+  # A new pool, not just a reset connection: the connection extended with
+  # ProgrammerMistake must not be reused by the next test.
   def teardown
-    reset_connection
+    reset_pool
   end
 
   exclude_from_transactional_tests :test_only_catch_active_record_errors_others_bubble_up
@@ -48,4 +50,44 @@ class CockroachDBReferentialIntegrityTest < ActiveRecord::PostgreSQLTestCase
     end
     assert_predicate warning, :blank?, "expected no warnings but got:\n#{warning}"
   end
+
+  # `#disable_referential_integrity` drops and re-adds every foreign key using
+  # batched DDL. CockroachDB cannot auto-unlock a `schema_locked` table for a
+  # multi-statement batch, so the adapter must unlock the affected tables (both
+  # the referencing and referenced ones) around the batch and restore their
+  # locked state. This must run outside a transaction: the batched DDL only
+  # takes the unlocking path when no transaction is open, and toggling
+  # `schema_locked` is only allowed in single-statement implicit transactions.
+  exclude_from_transactional_tests :test_disable_referential_integrity_unlocks_schema_locked_tables
+  def test_disable_referential_integrity_unlocks_schema_locked_tables
+    skip "schema_locked requires CockroachDB v25.3+" if @connection.database_version < 25_03_00
+
+    # `authors.author_address_id` references `author_addresses`, so this covers
+    # both the referencing and referenced sides of a foreign key.
+    begin
+      @connection.execute("ALTER TABLE authors SET (schema_locked = true)")
+      @connection.execute("ALTER TABLE author_addresses SET (schema_locked = true)")
+      assert schema_locked?(:authors), "precondition: authors should be schema_locked"
+      assert schema_locked?(:author_addresses), "precondition: author_addresses should be schema_locked"
+
+      assert_nothing_raised do
+        @connection.disable_referential_integrity { }
+      end
+
+      assert schema_locked?(:authors), "authors should be re-locked afterwards"
+      assert schema_locked?(:author_addresses), "author_addresses should be re-locked afterwards"
+    ensure
+      @connection.execute("ALTER TABLE authors SET (schema_locked = false)")
+      @connection.execute("ALTER TABLE author_addresses SET (schema_locked = false)")
+    end
+  end
+
+  private
+
+  def schema_locked?(table)
+    reloptions = @connection.query_value(<<~SQL)
+      SELECT array_to_string(reloptions, ',') FROM pg_class WHERE relname = #{@connection.quote(table.to_s)}
+    SQL
+    reloptions.to_s.include?("schema_locked=true")
+  end
 end

data/test/cases/adapters/postgresql/postgis_test.rb

@@ -169,6 +169,20 @@ class PostGISTest < ActiveRecord::PostgreSQLTestCase
     assert_equal wkt, rec.m_poly.to_s
   end
 
+  def test_spatial_column_matching_enum
+    SpatialModel.lease_connection.create_enum(:point_type, ["point", "line_string", "polygon"])
+    SpatialModel.lease_connection.create_table(:spatial_models, force: true) do |t|
+      t.enum "point_type", enum_type: :point_type
+      t.column "latlon", :st_point, srid: 3785, geographic: true
+    end
+    SpatialModel.reset_column_information
+    _id, enum, geo = SpatialModel.columns
+    refute_predicate enum, :geographic?
+    refute_predicate enum, :spatial?
+    assert_predicate geo, :geographic?
+    assert_predicate geo, :spatial?
+  end
+
   private
 
   def klass

data/test/cases/defaults_test.rb

@@ -39,7 +39,7 @@ module CockroachDB
     def test_default_decimal_zero_with_large_scale
       record = DefaultNumber.new
       assert_equal 0.0, record.decimal_number
-      assert_equal 0.0, record.decimal_number_before_type_cast
+      assert_equal "0.0000000000000000", record.decimal_number_before_type_cast
     end
   end
 end

data/test/excludes/ActiveRecord/ConnectionAdapters/PostgreSQLAdapterTest.rb

@@ -32,6 +32,13 @@ exclude :test_warnings_behavior_can_be_customized_with_a_proc, plpgsql_needed
 exclude :test_allowlist_of_warnings_to_ignore, plpgsql_needed
 exclude :test_allowlist_of_warning_codes_to_ignore, plpgsql_needed
 
+if ActiveRecord::Base.with_connection(&:database_version) < 25_01_00
+  do_needed = "DO blocks are supported from CockroachDB v25.1."
+  exclude :test_clears_warnings_after_handling_non_execute_query, do_needed
+  exclude :test_clears_warnings_after_non_execute_warning_action_raises, do_needed
+  exclude :test_handles_warnings_after_non_execute_query_raises, do_needed
+end
+
 exclude :test_translate_no_connection_exception_to_not_established, "CRDB doesn't implement pg_terminate_backend()"
 
 exclude :test_disable_extension_without_schema, ExcludeMessage::NO_HSTORE

data/test/excludes/PostgreSQLReferentialIntegrityTest.rb

@@ -12,3 +12,7 @@ exclude :test_does_not_break_nested_transactions, break_tx
 exclude :test_only_catch_active_record_errors_others_bubble_up,
     "Reimplemented in test/cases/adapters/cockroachdb/referential_integrity_test.rb" \
     " to use a different trigger for the error."
+
+exclude :test_all_foreign_keys_valid_having_foreign_keys_with_partitioned_table,
+    "CockroachDB does not support PostgreSQL's declarative partitioning " \
+    "(CREATE TABLE ... PARTITION OF)."

data/test/excludes/QueryCacheExpiryTest.rb

@@ -0,0 +1,10 @@
+# `test_cache_gets_cleared_after_migration` runs `change_column :posts, :title,
+# :string, limit: 80`, which adds a length limit to a VARCHAR column. Since
+# cockroachdb/cockroach@5a8fd7226192 (v26.2), converting an unbounded string to a
+# bounded one validates existing data, and CockroachDB does not allow such a
+# conversion inside an explicit transaction (see
+# https://go.crdb.dev/issue-v/49351/v26.2). Running the test non-transactionally
+# lets change_column execute as an implicit single-statement transaction, which
+# is allowed. Earlier versions treat the change as metadata-only and are
+# unaffected, so this is safe across all supported versions.
+exclude_from_transactional_tests :test_cache_gets_cleared_after_migration

data/test/excludes/SchemaIndexOpclassTest.rb

@@ -1,3 +1,4 @@
 exclude :test_string_opclass_is_dumped, "Operator classes on indexes are not supported in CockroachDB."
 exclude :test_non_default_opclass_is_dumped, "Operator classes on indexes are not supported in CockroachDB."
 exclude :test_opclass_class_parsing_on_non_reserved_and_cannot_be_function_or_type_keyword, "Operator classes on indexes are not supported in CockroachDB."
+exclude :test_opclass_class_parsing_from_another_schema, "CockroachDB does not support CREATE EXTENSION ... SCHEMA or schema-qualified operator classes."

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: activerecord-cockroachdb-adapter
 version: !ruby/object:Gem::Version
-  version: 8.1.0
+  version: 8.1.2
 platform: ruby
 authors:
 - Cockroach Labs
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-11-25 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord
@@ -74,8 +73,8 @@ executables: []
 extensions: []
 extra_rdoc_files:
 - CHANGELOG.md
-- README.md
 - CONTRIBUTING.md
+- README.md
 files:
 - CHANGELOG.md
 - CONTRIBUTING.md
@@ -108,6 +107,7 @@ files:
 - lib/arel/nodes/join_source_ext.rb
 - lib/version.rb
 - test/cases/adapter_test.rb
+- test/cases/adapters/cockroachdb/cached_plan_failure_test.rb
 - test/cases/adapters/cockroachdb/referential_integrity_test.rb
 - test/cases/adapters/postgresql/active_schema_test.rb
 - test/cases/adapters/postgresql/change_schema_test.rb
@@ -276,6 +276,7 @@ files:
 - test/excludes/PrimaryKeyIntegerNilDefaultTest.rb
 - test/excludes/PrimaryKeyIntegerTest.rb
 - test/excludes/PrimaryKeysTest.rb
+- test/excludes/QueryCacheExpiryTest.rb
 - test/excludes/RelationMergingTest.rb
 - test/excludes/RelationTest.rb
 - test/excludes/ReservedWordsMigrationTest.rb
@@ -315,7 +316,6 @@ licenses:
 - Apache-2.0
 metadata:
   allowed_push_host: https://rubygems.org
-post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -330,211 +330,212 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3.1
-signing_key: 
+rubygems_version: 4.0.10
 specification_version: 4
 summary: CockroachDB adapter for ActiveRecord.
 test_files:
-- test/cases/dirty_test.rb
-- test/cases/primary_keys_test.rb
-- test/cases/associations/left_outer_join_association_test.rb
-- test/cases/associations/eager_load_nested_include_test.rb
-- test/cases/tasks/cockroachdb_rake_test.rb
-- test/cases/relation/aost_test.rb
-- test/cases/relation/or_test.rb
-- test/cases/relation/table_hints_test.rb
-- test/cases/show_create_test.rb
-- test/cases/invertible_migration_test.rb
-- test/cases/associations_test.rb
-- test/cases/inheritance_test.rb
-- test/cases/strict_loading_test.rb
-- test/cases/migration_test.rb
-- test/cases/marshal_serialization_test.rb
-- test/cases/schema_dumper_test.rb
+- test/cases/adapter_test.rb
+- test/cases/adapters/cockroachdb/cached_plan_failure_test.rb
+- test/cases/adapters/cockroachdb/referential_integrity_test.rb
+- test/cases/adapters/postgresql/active_schema_test.rb
+- test/cases/adapters/postgresql/change_schema_test.rb
+- test/cases/adapters/postgresql/connection_test.rb
 - test/cases/adapters/postgresql/ddl_test.rb
 - test/cases/adapters/postgresql/interval_test.rb
-- test/cases/adapters/postgresql/schema_statements_test.rb
-- test/cases/adapters/postgresql/spatial_queries_test.rb
+- test/cases/adapters/postgresql/nested_class_test.rb
+- test/cases/adapters/postgresql/numeric_test.rb
+- test/cases/adapters/postgresql/postgis_test.rb
 - test/cases/adapters/postgresql/postgresql_adapter_test.rb
-- test/cases/adapters/postgresql/active_schema_test.rb
 - test/cases/adapters/postgresql/quoting_test.rb
+- test/cases/adapters/postgresql/schema_statements_test.rb
+- test/cases/adapters/postgresql/serial_test.rb
+- test/cases/adapters/postgresql/spatial_queries_test.rb
+- test/cases/adapters/postgresql/spatial_setup_test.rb
 - test/cases/adapters/postgresql/spatial_type_test.rb
-- test/cases/adapters/postgresql/nested_class_test.rb
 - test/cases/adapters/postgresql/timestamp_test.rb
-- test/cases/adapters/postgresql/postgis_test.rb
-- test/cases/adapters/postgresql/connection_test.rb
 - test/cases/adapters/postgresql/virtual_column_test.rb
-- test/cases/adapters/postgresql/numeric_test.rb
-- test/cases/adapters/postgresql/spatial_setup_test.rb
-- test/cases/adapters/postgresql/serial_test.rb
-- test/cases/adapters/postgresql/change_schema_test.rb
-- test/cases/adapters/cockroachdb/referential_integrity_test.rb
-- test/cases/defaults_test.rb
-- test/cases/persistence_test.rb
+- test/cases/associations/eager_load_nested_include_test.rb
+- test/cases/associations/left_outer_join_association_test.rb
+- test/cases/associations_test.rb
+- test/cases/base_test.rb
+- test/cases/comment_test.rb
 - test/cases/connection_adapters/type_test.rb
-- test/cases/adapter_test.rb
-- test/cases/relations_test.rb
 - test/cases/database_configurations/resolver_test.rb
-- test/cases/unsafe_raw_sql_test.rb
-- test/cases/comment_test.rb
+- test/cases/defaults_test.rb
+- test/cases/dirty_test.rb
 - test/cases/fixtures_test.rb
-- test/cases/relation_test.rb
-- test/cases/migration/references_foreign_key_test.rb
+- test/cases/helper_cockroachdb.rb
+- test/cases/inheritance_test.rb
+- test/cases/invertible_migration_test.rb
+- test/cases/marshal_serialization_test.rb
+- test/cases/migration/change_schema_test.rb
 - test/cases/migration/check_constraint_test.rb
+- test/cases/migration/columns_test.rb
 - test/cases/migration/create_join_table_test.rb
 - test/cases/migration/foreign_key_test.rb
-- test/cases/migration/columns_test.rb
 - test/cases/migration/hidden_column_test.rb
-- test/cases/migration/change_schema_test.rb
-- test/cases/transactions_test.rb
-- test/cases/base_test.rb
+- test/cases/migration/references_foreign_key_test.rb
+- test/cases/migration_test.rb
+- test/cases/persistence_test.rb
+- test/cases/primary_keys_test.rb
+- test/cases/relation/aost_test.rb
+- test/cases/relation/or_test.rb
+- test/cases/relation/table_hints_test.rb
+- test/cases/relation_test.rb
+- test/cases/relations_test.rb
+- test/cases/schema_dumper_test.rb
+- test/cases/show_create_test.rb
+- test/cases/strict_loading_test.rb
+- test/cases/tasks/cockroachdb_rake_test.rb
 - test/cases/test_fixtures_test.rb
-- test/cases/helper_cockroachdb.rb
-- test/models/spatial_model.rb
-- test/models/building.rb
-- test/schema/cockroachdb_specific_schema.rb
-- test/support/exclude_from_transactional_tests.rb
-- test/support/paths_cockroachdb.rb
-- test/support/rake_helpers.rb
-- test/support/copy_cat.rb
-- test/support/template_creator.rb
-- test/support/sql_logger.rb
+- test/cases/transactions_test.rb
+- test/cases/unsafe_raw_sql_test.rb
 - test/config.yml
-- test/excludes/ExplicitlyNamedIndexMigrationTest.rb
-- test/excludes/InheritanceComputeTypeTest.rb
-- test/excludes/MarshalSerializationTest.rb
-- test/excludes/PostgresqlInfinityTest.rb
-- test/excludes/WithAnnotationsTest.rb
-- test/excludes/CommentTest.rb
-- test/excludes/SequenceNameDetectionTestCases/CollidedSequenceNameTest.rb
-- test/excludes/SequenceNameDetectionTestCases/LongerSequenceNameDetectionTest.rb
-- test/excludes/SchemaForeignKeyTest.rb
-- test/excludes/LegacyPrimaryKeyTest/V5_0.rb
-- test/excludes/LegacyPrimaryKeyTest/V4_2.rb
-- test/excludes/PessimisticLockingTest.rb
-- test/excludes/FixturesWithForeignKeyViolationsTest.rb
-- test/excludes/SchemaIndexOpclassTest.rb
-- test/excludes/PostgreSQLPartitionsTest.rb
-- test/excludes/PrimaryKeyIntegerNilDefaultTest.rb
-- test/excludes/CalculationsTest.rb
-- test/excludes/PostgresqlLtreeTest.rb
-- test/excludes/DirtyTest.rb
-- test/excludes/RelationMergingTest.rb
-- test/excludes/PersistenceTest.rb
-- test/excludes/PostgreSQLGeometricTypesTest.rb
-- test/excludes/TypeTest.rb
-- test/excludes/PostgresqlNumberTest.rb
-- test/excludes/PostgresqlXMLTest.rb
-- test/excludes/PostgresqlTimestampFixtureTest.rb
-- test/excludes/PostgresqlIntervalTest.rb
-- test/excludes/LeftOuterJoinAssociationTest.rb
-- test/excludes/SchemaIndexNullsOrderTest.rb
-- test/excludes/NestedRelationScopingTest.rb
-- test/excludes/UnloggedTablesTest.rb
-- test/excludes/PostgresqlHstoreTest.rb
-- test/excludes/CoreTest.rb
-- test/excludes/TransactionIsolationTest.rb
-- test/excludes/PostgresqlTimestampMigrationTest.rb
-- test/excludes/PostgresqlVirtualColumnTest.rb
-- test/excludes/SchemaDumperTest.rb
-- test/excludes/RelationTest.rb
-- test/excludes/BasicsTest.rb
-- test/excludes/SanitizeTest.rb
-- test/excludes/PostgresqlGeometricTest.rb
-- test/excludes/SameNameDifferentDatabaseFixturesTest.rb
-- test/excludes/MigrationTest.rb
-- test/excludes/EagerLoadPolyAssocsTest.rb
-- test/excludes/ActiveSupportSubclassWithFixturesTest.rb
-- test/excludes/PostgresqlCollationTest.rb
-- test/excludes/ForeignTableTest.rb
-- test/excludes/SchemaAuthorizationTest.rb
-- test/excludes/PostgresqlUUIDTest.rb
-- test/excludes/PostgresqlFullTextTest.rb
-- test/excludes/MaterializedViewTest.rb
-- test/excludes/PostgresqlDeferredConstraintsTest.rb
-- test/excludes/TestFixturesTest.rb
-- test/excludes/PostgresqlJSONTest.rb
-- test/excludes/PostgresqlExtensionMigrationTest.rb
-- test/excludes/PostgresqlJSONBTest.rb
-- test/excludes/PostgresqlDataTypeTest.rb
-- test/excludes/PostgresqlCompositeWithCustomOIDTest.rb
-- test/excludes/ReservedWordsMigrationTest.rb
-- test/excludes/SchemaCreateTableOptionsTest.rb
-- test/excludes/PostgresqlBitStringTest.rb
-- test/excludes/PostgresqlCitextTest.rb
-- test/excludes/PostgreSQLExplainTest.rb
-- test/excludes/PostgresqlTypeLookupTest.rb
-- test/excludes/PostgreSQLGeometricLineTest.rb
-- test/excludes/PostgresqlMoneyTest.rb
-- test/excludes/SchemaTest.rb
-- test/excludes/PostgresqlArrayTest.rb
-- test/excludes/ActiveRecord/PostgresqlConnectionTest.rb
-- test/excludes/ActiveRecord/Encryption/ExtendedDeterministicQueriesPerformanceTest.rb
-- test/excludes/ActiveRecord/Encryption/EnvelopeEncryptionPerformanceTest.rb
-- test/excludes/ActiveRecord/Encryption/StoragePerformanceTest.rb
-- test/excludes/ActiveRecord/Encryption/EncryptionPerformanceTest.rb
-- test/excludes/ActiveRecord/InvertibleMigrationTest.rb
-- test/excludes/ActiveRecord/ConnectionAdapters/PostgreSQLAdapterTest.rb
-- test/excludes/ActiveRecord/ConnectionAdapters/RegistrationIsolatedTest.rb
-- test/excludes/ActiveRecord/ConnectionAdapters/PostgreSQLAdapterPreventWritesTest.rb
-- test/excludes/ActiveRecord/ConnectionAdapters/PostgreSQLAdapterPreventWritesLegacyTest.rb
+- test/excludes/ActiveRecord/AdapterTest.rb
+- test/excludes/ActiveRecord/AdapterTestWithoutTransaction.rb
 - test/excludes/ActiveRecord/ConnectionAdapters/PoolConfig/ResolverTest.rb
 - test/excludes/ActiveRecord/ConnectionAdapters/PostgreSQLAdapter/BindParameterTest.rb
 - test/excludes/ActiveRecord/ConnectionAdapters/PostgreSQLAdapter/QuotingTest.rb
-- test/excludes/ActiveRecord/AdapterTestWithoutTransaction.rb
-- test/excludes/ActiveRecord/RelationTest.rb
-- test/excludes/ActiveRecord/MysqlDBCreateWithInvalidPermissionsTest.rb
-- test/excludes/ActiveRecord/PostgresqlTransactionNestedTest.rb
+- test/excludes/ActiveRecord/ConnectionAdapters/PostgreSQLAdapterPreventWritesLegacyTest.rb
+- test/excludes/ActiveRecord/ConnectionAdapters/PostgreSQLAdapterPreventWritesTest.rb
+- test/excludes/ActiveRecord/ConnectionAdapters/PostgreSQLAdapterTest.rb
+- test/excludes/ActiveRecord/ConnectionAdapters/RegistrationIsolatedTest.rb
+- test/excludes/ActiveRecord/Encryption/EncryptionPerformanceTest.rb
+- test/excludes/ActiveRecord/Encryption/EnvelopeEncryptionPerformanceTest.rb
+- test/excludes/ActiveRecord/Encryption/ExtendedDeterministicQueriesPerformanceTest.rb
+- test/excludes/ActiveRecord/Encryption/StoragePerformanceTest.rb
 - test/excludes/ActiveRecord/InstrumentationTest.rb
-- test/excludes/ActiveRecord/PostgreSQLStructureDumpTest.rb
-- test/excludes/ActiveRecord/AdapterTest.rb
-- test/excludes/ActiveRecord/TooManyOrTest.rb
-- test/excludes/ActiveRecord/PostgresqlTransactionTest.rb
+- test/excludes/ActiveRecord/InvertibleMigrationTest.rb
+- test/excludes/ActiveRecord/Migration/ChangeSchemaTest.rb
+- test/excludes/ActiveRecord/Migration/CheckConstraintTest.rb
+- test/excludes/ActiveRecord/Migration/ColumnsTest.rb
+- test/excludes/ActiveRecord/Migration/CompatibilityTest.rb
+- test/excludes/ActiveRecord/Migration/CompositeForeignKeyTest.rb
 - test/excludes/ActiveRecord/Migration/CreateJoinTableTest.rb
-- test/excludes/ActiveRecord/Migration/ReferencesForeignKeyTest.rb
+- test/excludes/ActiveRecord/Migration/ForeignKeyInCreateTest.rb
+- test/excludes/ActiveRecord/Migration/ForeignKeyTest.rb
+- test/excludes/ActiveRecord/Migration/InvalidOptionsTest.rb
 - test/excludes/ActiveRecord/Migration/PGChangeSchemaTest.rb
+- test/excludes/ActiveRecord/Migration/ReferencesForeignKeyTest.rb
 - test/excludes/ActiveRecord/Migration/ReferencesIndexTest.rb
-- test/excludes/ActiveRecord/Migration/ForeignKeyTest.rb
-- test/excludes/ActiveRecord/Migration/CompatibilityTest.rb
-- test/excludes/ActiveRecord/Migration/CheckConstraintTest.rb
-- test/excludes/ActiveRecord/Migration/ForeignKeyInCreateTest.rb
-- test/excludes/ActiveRecord/Migration/CompositeForeignKeyTest.rb
 - test/excludes/ActiveRecord/Migration/ReferencesStatementsTest.rb
-- test/excludes/ActiveRecord/Migration/ChangeSchemaTest.rb
-- test/excludes/ActiveRecord/Migration/InvalidOptionsTest.rb
-- test/excludes/ActiveRecord/Migration/ColumnsTest.rb
+- test/excludes/ActiveRecord/MysqlDBCreateWithInvalidPermissionsTest.rb
 - test/excludes/ActiveRecord/OrTest.rb
-- test/excludes/PostgresqlBigSerialTest.rb
-- test/excludes/PostgresqlUUIDGenerationTest.rb
-- test/excludes/PostgresqlRangeTest.rb
-- test/excludes/PostgresqlByteaTest.rb
-- test/excludes/PrimaryKeyIntegerTest.rb
-- test/excludes/UpdateableViewTest.rb
-- test/excludes/FixturesTest.rb
-- test/excludes/PostgresqlNetworkTest.rb
-- test/excludes/AssociationDeprecationTest/WarnModeTest.rb
-- test/excludes/AssociationDeprecationTest/fix_backtrace_cleaner.rb
-- test/excludes/AssociationDeprecationTest/RaiseModeTest.rb
+- test/excludes/ActiveRecord/PostgreSQLStructureDumpTest.rb
+- test/excludes/ActiveRecord/PostgresqlConnectionTest.rb
+- test/excludes/ActiveRecord/PostgresqlTransactionNestedTest.rb
+- test/excludes/ActiveRecord/PostgresqlTransactionTest.rb
+- test/excludes/ActiveRecord/RelationTest.rb
+- test/excludes/ActiveRecord/TooManyOrTest.rb
+- test/excludes/ActiveSupportSubclassWithFixturesTest.rb
 - test/excludes/AssociationDeprecationTest/NotifyModeTest.rb
 - test/excludes/AssociationDeprecationTest/RaiseBacktraceModeTest.rb
+- test/excludes/AssociationDeprecationTest/RaiseModeTest.rb
 - test/excludes/AssociationDeprecationTest/WarnBacktraceModeTest.rb
-- test/excludes/PostgresqlPointTest.rb
-- test/excludes/PostgreSQLReferentialIntegrityTest.rb
+- test/excludes/AssociationDeprecationTest/WarnModeTest.rb
+- test/excludes/AssociationDeprecationTest/fix_backtrace_cleaner.rb
+- test/excludes/BasicsTest.rb
 - test/excludes/BulkAlterTableMigrationsTest.rb
-- test/excludes/UniquenessValidationTest.rb
-- test/excludes/StrictLoadingFixturesTest.rb
-- test/excludes/SchemaDumperDefaultsTest.rb
-- test/excludes/PostgresqlRenameTableTest.rb
-- test/excludes/UnsafeRawSqlTest.rb
-- test/excludes/PrimaryKeysTest.rb
-- test/excludes/PostgresqlDefaultExpressionTest.rb
+- test/excludes/CalculationsTest.rb
+- test/excludes/CommentTest.rb
+- test/excludes/CoreTest.rb
 - test/excludes/CreateOrFindByWithinTransactions.rb
-- test/excludes/MultiDbMigratorTest.rb
-- test/excludes/PostgresqlSerialTest.rb
-- test/excludes/PostgresqlCompositeTest.rb
-- test/excludes/EachTest.rb
 - test/excludes/DefaultsUsingMultipleSchemasAndDomainTest.rb
+- test/excludes/DirtyTest.rb
+- test/excludes/EachTest.rb
+- test/excludes/EagerLoadPolyAssocsTest.rb
+- test/excludes/ExplicitlyNamedIndexMigrationTest.rb
+- test/excludes/FixturesResetPkSequenceTest.rb
+- test/excludes/FixturesTest.rb
+- test/excludes/FixturesWithForeignKeyViolationsTest.rb
+- test/excludes/ForeignTableTest.rb
+- test/excludes/InheritanceComputeTypeTest.rb
+- test/excludes/LeftOuterJoinAssociationTest.rb
+- test/excludes/LegacyPrimaryKeyTest/V4_2.rb
+- test/excludes/LegacyPrimaryKeyTest/V5_0.rb
+- test/excludes/MarshalSerializationTest.rb
+- test/excludes/MaterializedViewTest.rb
+- test/excludes/MigrationTest.rb
+- test/excludes/MultiDbMigratorTest.rb
+- test/excludes/NestedRelationScopingTest.rb
 - test/excludes/OrTest.rb
-- test/excludes/TransactionInstrumentationTest.rb
+- test/excludes/PersistenceTest.rb
+- test/excludes/PessimisticLockingTest.rb
+- test/excludes/PostgreSQLExplainTest.rb
+- test/excludes/PostgreSQLGeometricLineTest.rb
+- test/excludes/PostgreSQLGeometricTypesTest.rb
+- test/excludes/PostgreSQLPartitionsTest.rb
+- test/excludes/PostgreSQLReferentialIntegrityTest.rb
+- test/excludes/PostgresqlArrayTest.rb
+- test/excludes/PostgresqlBigSerialTest.rb
+- test/excludes/PostgresqlBitStringTest.rb
+- test/excludes/PostgresqlByteaTest.rb
+- test/excludes/PostgresqlCitextTest.rb
+- test/excludes/PostgresqlCollationTest.rb
+- test/excludes/PostgresqlCompositeTest.rb
+- test/excludes/PostgresqlCompositeWithCustomOIDTest.rb
+- test/excludes/PostgresqlDataTypeTest.rb
+- test/excludes/PostgresqlDefaultExpressionTest.rb
+- test/excludes/PostgresqlDeferredConstraintsTest.rb
 - test/excludes/PostgresqlDomainTest.rb
-- test/excludes/FixturesResetPkSequenceTest.rb
+- test/excludes/PostgresqlExtensionMigrationTest.rb
+- test/excludes/PostgresqlFullTextTest.rb
+- test/excludes/PostgresqlGeometricTest.rb
+- test/excludes/PostgresqlHstoreTest.rb
+- test/excludes/PostgresqlInfinityTest.rb
+- test/excludes/PostgresqlIntervalTest.rb
+- test/excludes/PostgresqlJSONBTest.rb
+- test/excludes/PostgresqlJSONTest.rb
+- test/excludes/PostgresqlLtreeTest.rb
+- test/excludes/PostgresqlMoneyTest.rb
+- test/excludes/PostgresqlNetworkTest.rb
+- test/excludes/PostgresqlNumberTest.rb
+- test/excludes/PostgresqlPointTest.rb
+- test/excludes/PostgresqlRangeTest.rb
+- test/excludes/PostgresqlRenameTableTest.rb
+- test/excludes/PostgresqlSerialTest.rb
+- test/excludes/PostgresqlTimestampFixtureTest.rb
+- test/excludes/PostgresqlTimestampMigrationTest.rb
+- test/excludes/PostgresqlTypeLookupTest.rb
+- test/excludes/PostgresqlUUIDGenerationTest.rb
+- test/excludes/PostgresqlUUIDTest.rb
+- test/excludes/PostgresqlVirtualColumnTest.rb
+- test/excludes/PostgresqlXMLTest.rb
+- test/excludes/PrimaryKeyIntegerNilDefaultTest.rb
+- test/excludes/PrimaryKeyIntegerTest.rb
+- test/excludes/PrimaryKeysTest.rb
+- test/excludes/QueryCacheExpiryTest.rb
+- test/excludes/RelationMergingTest.rb
+- test/excludes/RelationTest.rb
+- test/excludes/ReservedWordsMigrationTest.rb
+- test/excludes/SameNameDifferentDatabaseFixturesTest.rb
+- test/excludes/SanitizeTest.rb
+- test/excludes/SchemaAuthorizationTest.rb
+- test/excludes/SchemaCreateTableOptionsTest.rb
+- test/excludes/SchemaDumperDefaultsTest.rb
+- test/excludes/SchemaDumperTest.rb
+- test/excludes/SchemaForeignKeyTest.rb
+- test/excludes/SchemaIndexNullsOrderTest.rb
+- test/excludes/SchemaIndexOpclassTest.rb
+- test/excludes/SchemaTest.rb
+- test/excludes/SequenceNameDetectionTestCases/CollidedSequenceNameTest.rb
+- test/excludes/SequenceNameDetectionTestCases/LongerSequenceNameDetectionTest.rb
+- test/excludes/StrictLoadingFixturesTest.rb
+- test/excludes/TestFixturesTest.rb
+- test/excludes/TransactionInstrumentationTest.rb
+- test/excludes/TransactionIsolationTest.rb
+- test/excludes/TypeTest.rb
+- test/excludes/UniquenessValidationTest.rb
+- test/excludes/UnloggedTablesTest.rb
+- test/excludes/UnsafeRawSqlTest.rb
+- test/excludes/UpdateableViewTest.rb
+- test/excludes/WithAnnotationsTest.rb
+- test/models/building.rb
+- test/models/spatial_model.rb
+- test/schema/cockroachdb_specific_schema.rb
+- test/support/copy_cat.rb
+- test/support/exclude_from_transactional_tests.rb
+- test/support/paths_cockroachdb.rb
+- test/support/rake_helpers.rb
+- test/support/sql_logger.rb
+- test/support/template_creator.rb