activerecord 8.0.3 → 8.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (160) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +538 -512
  3. data/README.rdoc +1 -1
  4. data/lib/active_record/association_relation.rb +1 -1
  5. data/lib/active_record/associations/association.rb +1 -1
  6. data/lib/active_record/associations/belongs_to_association.rb +2 -0
  7. data/lib/active_record/associations/builder/association.rb +16 -5
  8. data/lib/active_record/associations/builder/belongs_to.rb +17 -4
  9. data/lib/active_record/associations/builder/collection_association.rb +7 -3
  10. data/lib/active_record/associations/builder/has_one.rb +1 -1
  11. data/lib/active_record/associations/builder/singular_association.rb +33 -5
  12. data/lib/active_record/associations/collection_proxy.rb +22 -4
  13. data/lib/active_record/associations/deprecation.rb +88 -0
  14. data/lib/active_record/associations/errors.rb +3 -0
  15. data/lib/active_record/associations/join_dependency.rb +2 -0
  16. data/lib/active_record/associations/preloader/branch.rb +1 -0
  17. data/lib/active_record/associations.rb +159 -21
  18. data/lib/active_record/attribute_methods/serialization.rb +16 -3
  19. data/lib/active_record/attribute_methods/time_zone_conversion.rb +10 -2
  20. data/lib/active_record/attributes.rb +3 -0
  21. data/lib/active_record/autosave_association.rb +1 -1
  22. data/lib/active_record/base.rb +0 -2
  23. data/lib/active_record/coders/json.rb +14 -5
  24. data/lib/active_record/connection_adapters/abstract/connection_handler.rb +1 -3
  25. data/lib/active_record/connection_adapters/abstract/connection_pool/queue.rb +16 -3
  26. data/lib/active_record/connection_adapters/abstract/connection_pool/reaper.rb +51 -12
  27. data/lib/active_record/connection_adapters/abstract/connection_pool.rb +405 -72
  28. data/lib/active_record/connection_adapters/abstract/database_statements.rb +55 -40
  29. data/lib/active_record/connection_adapters/abstract/query_cache.rb +19 -3
  30. data/lib/active_record/connection_adapters/abstract/quoting.rb +15 -24
  31. data/lib/active_record/connection_adapters/abstract/schema_creation.rb +7 -2
  32. data/lib/active_record/connection_adapters/abstract/schema_definitions.rb +26 -34
  33. data/lib/active_record/connection_adapters/abstract/schema_dumper.rb +2 -1
  34. data/lib/active_record/connection_adapters/abstract/schema_statements.rb +85 -22
  35. data/lib/active_record/connection_adapters/abstract/transaction.rb +25 -3
  36. data/lib/active_record/connection_adapters/abstract_adapter.rb +86 -20
  37. data/lib/active_record/connection_adapters/abstract_mysql_adapter.rb +43 -13
  38. data/lib/active_record/connection_adapters/column.rb +17 -4
  39. data/lib/active_record/connection_adapters/mysql/database_statements.rb +4 -4
  40. data/lib/active_record/connection_adapters/mysql/schema_creation.rb +2 -0
  41. data/lib/active_record/connection_adapters/mysql/schema_definitions.rb +42 -5
  42. data/lib/active_record/connection_adapters/mysql/schema_statements.rb +26 -4
  43. data/lib/active_record/connection_adapters/mysql2/database_statements.rb +27 -22
  44. data/lib/active_record/connection_adapters/mysql2_adapter.rb +1 -2
  45. data/lib/active_record/connection_adapters/postgresql/column.rb +4 -0
  46. data/lib/active_record/connection_adapters/postgresql/database_statements.rb +17 -15
  47. data/lib/active_record/connection_adapters/postgresql/oid/array.rb +2 -2
  48. data/lib/active_record/connection_adapters/postgresql/oid/type_map_initializer.rb +1 -1
  49. data/lib/active_record/connection_adapters/postgresql/quoting.rb +21 -10
  50. data/lib/active_record/connection_adapters/postgresql/schema_creation.rb +8 -6
  51. data/lib/active_record/connection_adapters/postgresql/schema_definitions.rb +8 -21
  52. data/lib/active_record/connection_adapters/postgresql/schema_dumper.rb +67 -31
  53. data/lib/active_record/connection_adapters/postgresql/schema_statements.rb +81 -48
  54. data/lib/active_record/connection_adapters/postgresql_adapter.rb +23 -7
  55. data/lib/active_record/connection_adapters/schema_cache.rb +2 -2
  56. data/lib/active_record/connection_adapters/sqlite3/database_statements.rb +37 -25
  57. data/lib/active_record/connection_adapters/sqlite3/quoting.rb +0 -8
  58. data/lib/active_record/connection_adapters/sqlite3/schema_statements.rb +4 -13
  59. data/lib/active_record/connection_adapters/sqlite3_adapter.rb +56 -32
  60. data/lib/active_record/connection_adapters/trilogy/database_statements.rb +4 -3
  61. data/lib/active_record/connection_adapters/trilogy_adapter.rb +1 -1
  62. data/lib/active_record/connection_adapters.rb +1 -0
  63. data/lib/active_record/connection_handling.rb +14 -9
  64. data/lib/active_record/core.rb +5 -4
  65. data/lib/active_record/counter_cache.rb +33 -8
  66. data/lib/active_record/database_configurations/database_config.rb +5 -1
  67. data/lib/active_record/database_configurations/hash_config.rb +53 -9
  68. data/lib/active_record/database_configurations/url_config.rb +13 -3
  69. data/lib/active_record/database_configurations.rb +7 -3
  70. data/lib/active_record/delegated_type.rb +1 -1
  71. data/lib/active_record/dynamic_matchers.rb +54 -69
  72. data/lib/active_record/encryption/encryptable_record.rb +4 -4
  73. data/lib/active_record/encryption/encrypted_attribute_type.rb +1 -1
  74. data/lib/active_record/encryption/encryptor.rb +12 -0
  75. data/lib/active_record/encryption/scheme.rb +1 -1
  76. data/lib/active_record/enum.rb +24 -8
  77. data/lib/active_record/errors.rb +20 -4
  78. data/lib/active_record/explain.rb +1 -1
  79. data/lib/active_record/explain_registry.rb +51 -2
  80. data/lib/active_record/filter_attribute_handler.rb +73 -0
  81. data/lib/active_record/fixtures.rb +2 -2
  82. data/lib/active_record/gem_version.rb +2 -2
  83. data/lib/active_record/inheritance.rb +1 -1
  84. data/lib/active_record/insert_all.rb +12 -7
  85. data/lib/active_record/locking/optimistic.rb +7 -0
  86. data/lib/active_record/locking/pessimistic.rb +5 -0
  87. data/lib/active_record/log_subscriber.rb +2 -6
  88. data/lib/active_record/middleware/shard_selector.rb +34 -17
  89. data/lib/active_record/migration/command_recorder.rb +14 -1
  90. data/lib/active_record/migration/compatibility.rb +34 -24
  91. data/lib/active_record/migration/default_schema_versions_formatter.rb +30 -0
  92. data/lib/active_record/migration.rb +26 -16
  93. data/lib/active_record/model_schema.rb +36 -10
  94. data/lib/active_record/nested_attributes.rb +2 -0
  95. data/lib/active_record/persistence.rb +34 -3
  96. data/lib/active_record/query_cache.rb +22 -15
  97. data/lib/active_record/query_logs.rb +3 -7
  98. data/lib/active_record/railtie.rb +32 -3
  99. data/lib/active_record/railties/controller_runtime.rb +11 -6
  100. data/lib/active_record/railties/databases.rake +15 -3
  101. data/lib/active_record/railties/job_checkpoints.rb +15 -0
  102. data/lib/active_record/railties/job_runtime.rb +10 -11
  103. data/lib/active_record/reflection.rb +35 -0
  104. data/lib/active_record/relation/batches.rb +25 -11
  105. data/lib/active_record/relation/calculations.rb +20 -9
  106. data/lib/active_record/relation/delegation.rb +0 -1
  107. data/lib/active_record/relation/finder_methods.rb +27 -11
  108. data/lib/active_record/relation/predicate_builder/association_query_value.rb +9 -9
  109. data/lib/active_record/relation/predicate_builder/polymorphic_array_value.rb +7 -7
  110. data/lib/active_record/relation/predicate_builder.rb +9 -7
  111. data/lib/active_record/relation/query_attribute.rb +3 -1
  112. data/lib/active_record/relation/query_methods.rb +40 -29
  113. data/lib/active_record/relation/where_clause.rb +1 -8
  114. data/lib/active_record/relation.rb +24 -12
  115. data/lib/active_record/result.rb +44 -21
  116. data/lib/active_record/runtime_registry.rb +41 -58
  117. data/lib/active_record/sanitization.rb +2 -0
  118. data/lib/active_record/schema_dumper.rb +12 -10
  119. data/lib/active_record/scoping.rb +0 -1
  120. data/lib/active_record/signed_id.rb +43 -15
  121. data/lib/active_record/statement_cache.rb +13 -9
  122. data/lib/active_record/store.rb +44 -19
  123. data/lib/active_record/structured_event_subscriber.rb +85 -0
  124. data/lib/active_record/table_metadata.rb +5 -20
  125. data/lib/active_record/tasks/abstract_tasks.rb +76 -0
  126. data/lib/active_record/tasks/database_tasks.rb +25 -34
  127. data/lib/active_record/tasks/mysql_database_tasks.rb +3 -40
  128. data/lib/active_record/tasks/postgresql_database_tasks.rb +5 -39
  129. data/lib/active_record/tasks/sqlite_database_tasks.rb +14 -26
  130. data/lib/active_record/test_databases.rb +14 -4
  131. data/lib/active_record/test_fixtures.rb +27 -2
  132. data/lib/active_record/testing/query_assertions.rb +8 -2
  133. data/lib/active_record/timestamp.rb +4 -2
  134. data/lib/active_record/transaction.rb +2 -5
  135. data/lib/active_record/transactions.rb +32 -10
  136. data/lib/active_record/type/hash_lookup_type_map.rb +2 -1
  137. data/lib/active_record/type/internal/timezone.rb +7 -0
  138. data/lib/active_record/type/json.rb +15 -2
  139. data/lib/active_record/type/serialized.rb +11 -4
  140. data/lib/active_record/type/type_map.rb +1 -1
  141. data/lib/active_record/type_caster/connection.rb +2 -1
  142. data/lib/active_record/validations/associated.rb +1 -1
  143. data/lib/active_record.rb +65 -3
  144. data/lib/arel/alias_predication.rb +2 -0
  145. data/lib/arel/crud.rb +6 -11
  146. data/lib/arel/nodes/count.rb +2 -2
  147. data/lib/arel/nodes/function.rb +4 -10
  148. data/lib/arel/nodes/named_function.rb +2 -2
  149. data/lib/arel/nodes/node.rb +1 -1
  150. data/lib/arel/nodes.rb +0 -2
  151. data/lib/arel/select_manager.rb +7 -2
  152. data/lib/arel/visitors/dot.rb +0 -3
  153. data/lib/arel/visitors/postgresql.rb +55 -0
  154. data/lib/arel/visitors/sqlite.rb +55 -8
  155. data/lib/arel/visitors/to_sql.rb +3 -21
  156. data/lib/arel.rb +3 -1
  157. data/lib/rails/generators/active_record/application_record/USAGE +1 -1
  158. metadata +14 -10
  159. data/lib/active_record/explain_subscriber.rb +0 -34
  160. data/lib/active_record/normalization.rb +0 -163
data/CHANGELOG.md CHANGED
@@ -1,808 +1,834 @@
1
- ## Rails 8.0.3 (September 22, 2025) ##
1
+ ## Rails 8.1.0 (October 22, 2025) ##
2
2
 
3
- * Fix query cache for pinned connections in multi threaded transactional tests
4
-
5
- When a pinned connection is used across separate threads, they now use a separate cache store
6
- for each thread.
7
-
8
- This improve accuracy of system tests, and any test using multiple threads.
9
-
10
- *Heinrich Lee Yu*, *Jean Boussier*
11
-
12
- * Don't add `id_value` attribute alias when attribute/column with that name already exists.
13
-
14
- *Rob Lewis*
3
+ * Fix SQLite3 data loss during table alterations with CASCADE foreign keys.
15
4
 
16
- * Fix false positive change detection involving STI and polymorphic has one relationships.
5
+ When altering a table in SQLite3 that is referenced by child tables with
6
+ `ON DELETE CASCADE` foreign keys, ActiveRecord would silently delete all
7
+ data from the child tables. This occurred because SQLite requires table
8
+ recreation for schema changes, and during this process the original table
9
+ is temporarily dropped, triggering CASCADE deletes on child tables.
17
10
 
18
- Polymorphic `has_one` relationships would always be considered changed when defined in a STI child
19
- class, causing nedless extra autosaves.
11
+ The root cause was incorrect ordering of operations. The original code
12
+ wrapped `disable_referential_integrity` inside a transaction, but
13
+ `PRAGMA foreign_keys` cannot be modified inside a transaction in SQLite -
14
+ attempting to do so simply has no effect. This meant foreign keys remained
15
+ enabled during table recreation, causing CASCADE deletes to fire.
20
16
 
21
- *David Fritsch*
17
+ The fix reverses the order to follow the official SQLite 12-step ALTER TABLE
18
+ procedure: `disable_referential_integrity` now wraps the transaction instead
19
+ of being wrapped by it. This ensures foreign keys are properly disabled
20
+ before the transaction starts and re-enabled after it commits, preventing
21
+ CASCADE deletes while maintaining data integrity through atomic transactions.
22
22
 
23
- * Skip calling `PG::Connection#cancel` in `cancel_any_running_query`
24
- when using libpq >= 18 with pg < 1.6.0, due to incompatibility.
25
- Rollback still runs, but may take longer.
26
-
27
- *Yasuo Honda*, *Lars Kanis*
28
-
29
- * Fix stale association detection for polymorphic `belongs_to`.
23
+ *Ruy Rocha*
30
24
 
31
- *Florent Beaurain*, *Thomas Crambert*
25
+ * Add replicas to test database parallelization setup.
32
26
 
33
- * Fix removal of PostgreSQL version comments in `structure.sql` for latest PostgreSQL versions which include `\restrict`
27
+ Setup and configuration of databases for parallel testing now includes replicas.
34
28
 
35
- *Brendan Weibrecht*
29
+ This fixes an issue when using a replica database, database selector middleware,
30
+ and non-transactional tests, where integration tests running in parallel would select
31
+ the base test database, i.e. `db_test`, instead of the numbered parallel worker database,
32
+ i.e. `db_test_{n}`.
36
33
 
37
- * Allow setting `schema_format` in database configuration.
34
+ *Adam Maas*
38
35
 
39
- ```
40
- primary:
41
- schema_format: ruby
42
- ```
36
+ * Support virtual (not persisted) generated columns on PostgreSQL 18+
43
37
 
44
- Useful in multi-database setups to have different formats per-database.
45
-
46
- *T S Vallender*
47
-
48
- * Use ntuples to populate row_count instead of count for Postgres
49
-
50
- *Jonathan Calvert*
51
-
52
- * Fix `#merge` with `#or` or `#and` and a mixture of attributes and SQL strings resulting in an incorrect query.
38
+ PostgreSQL 18 introduces virtual (not persisted) generated columns,
39
+ which are now the default unless the `stored: true` option is explicitly specified on PostgreSQL 18+.
53
40
 
54
41
  ```ruby
55
- base = Comment.joins(:post).where(user_id: 1).where("recent = 1")
56
- puts base.merge(base.where(draft: true).or(Post.where(archived: true))).to_sql
42
+ create_table :users do |t|
43
+ t.string :name
44
+ t.virtual :lower_name, type: :string, as: "LOWER(name)", stored: false
45
+ t.virtual :name_length, type: :integer, as: "LENGTH(name)"
46
+ end
57
47
  ```
58
48
 
59
- Before:
60
-
61
- ```SQL
62
- SELECT "comments".* FROM "comments"
63
- INNER JOIN "posts" ON "posts"."id" = "comments"."post_id"
64
- WHERE (recent = 1)
65
- AND (
66
- "comments"."user_id" = 1
67
- AND (recent = 1)
68
- AND "comments"."draft" = 1
69
- OR "posts"."archived" = 1
70
- )
71
- ```
49
+ *Yasuo Honda*
72
50
 
73
- After:
51
+ * Optimize schema dumping to prevent duplicate file generation.
74
52
 
75
- ```SQL
76
- SELECT "comments".* FROM "comments"
77
- INNER JOIN "posts" ON "posts"."id" = "comments"."post_id"
78
- WHERE "comments"."user_id" = 1
79
- AND (recent = 1)
80
- AND (
81
- "comments"."user_id" = 1
82
- AND (recent = 1)
83
- AND "comments"."draft" = 1
84
- OR "posts"."archived" = 1
85
- )
86
- ```
53
+ `ActiveRecord::Tasks::DatabaseTasks.dump_all` now tracks which schema files
54
+ have already been dumped and skips dumping the same file multiple times.
55
+ This improves performance when multiple database configurations share the
56
+ same schema dump path.
87
57
 
88
- *Joshua Young*
58
+ *Mikey Gough*, *Hartley McGuire*
89
59
 
90
- * Fix inline `has_and_belongs_to_many` fixtures for tables with composite primary keys.
60
+ * Add structured events for Active Record:
61
+ - `active_record.strict_loading_violation`
62
+ - `active_record.sql`
91
63
 
92
- *fatkodima*
64
+ *Gannon McGibbon*
93
65
 
94
- * Fix migration log message for down operations.
66
+ * Add support for integer shard keys.
67
+ ```ruby
68
+ # Now accepts symbols as shard keys.
69
+ ActiveRecord::Base.connects_to(shards: {
70
+ 1: { writing: :primary_shard_one, reading: :primary_shard_one },
71
+ 2: { writing: :primary_shard_two, reading: :primary_shard_two},
72
+ })
95
73
 
96
- *Bernardo Barreto*
74
+ ActiveRecord::Base.connected_to(shard: 1) do
75
+ # ..
76
+ end
77
+ ```
97
78
 
98
- * Prepend `extra_flags` in postgres' `structure_load`
79
+ *Nony Dutton*
99
80
 
100
- When specifying `structure_load_flags` with a postgres adapter, the flags
101
- were appended to the default flags, instead of prepended.
102
- This caused issues with flags not being taken into account by postgres.
81
+ * Add `ActiveRecord::Base.only_columns`
103
82
 
104
- *Alice Loeser*
83
+ Similar in use case to `ignored_columns` but listing columns to consider rather than the ones
84
+ to ignore.
105
85
 
106
- * Fix `annotate` comments to propagate to `update_all`/`delete_all`.
86
+ Can be useful when working with a legacy or shared database schema, or to make safe schema change
87
+ in two deploys rather than three.
107
88
 
108
- *fatkodima*
89
+ *Anton Kandratski*
109
90
 
110
- * Fix checking whether an unpersisted record is `include?`d in a strictly
111
- loaded `has_and_belongs_to_many` association.
91
+ * Use `PG::Connection#close_prepared` (protocol level Close) to deallocate
92
+ prepared statements when available.
112
93
 
113
- *Hartley McGuire*
94
+ To enable its use, you must have pg >= 1.6.0, libpq >= 17, and a PostgreSQL
95
+ database version >= 17.
114
96
 
115
- * `create_or_find_by` will now correctly rollback a transaction.
97
+ *Hartley McGuire*, *Andrew Jackson*
116
98
 
117
- When using `create_or_find_by`, raising a ActiveRecord::Rollback error
118
- in a `after_save` callback had no effect, the transaction was committed
119
- and a record created.
99
+ * Fix query cache for pinned connections in multi threaded transactional tests
120
100
 
121
- *Edouard Chin*
101
+ When a pinned connection is used across separate threads, they now use a separate cache store
102
+ for each thread.
122
103
 
123
- * Gracefully handle `Timeout.timeout` firing during connection configuration.
104
+ This improve accuracy of system tests, and any test using multiple threads.
124
105
 
125
- Use of `Timeout.timeout` could result in improperly initialized database connection.
106
+ *Heinrich Lee Yu*, *Jean Boussier*
126
107
 
127
- This could lead to a partially configured connection being used, resulting in various exceptions,
128
- the most common being with the PostgreSQLAdapter raising `undefined method 'key?' for nil`
129
- or `TypeError: wrong argument type nil (expected PG::TypeMap)`.
108
+ * Fix time attribute dirty tracking with timezone conversions.
130
109
 
131
- *Jean Boussier*
110
+ Time-only attributes now maintain a fixed date of 2000-01-01 during timezone conversions,
111
+ preventing them from being incorrectly marked as changed due to date shifts.
132
112
 
133
- * Fix stale state for composite foreign keys in belongs_to associations.
113
+ This fixes an issue where time attributes would be marked as changed when setting the same time value
114
+ due to timezone conversion causing internal date shifts.
134
115
 
135
- *Varun Sharma*
116
+ *Prateek Choudhary*
136
117
 
118
+ * Skip calling `PG::Connection#cancel` in `cancel_any_running_query`
119
+ when using libpq >= 18 with pg < 1.6.0, due to incompatibility.
120
+ Rollback still runs, but may take longer.
137
121
 
138
- ## Rails 8.0.2.1 (August 13, 2025) ##
122
+ *Yasuo Honda*, *Lars Kanis*
139
123
 
140
- * Call inspect on ids in RecordNotFound error
124
+ * Don't add `id_value` attribute alias when attribute/column with that name already exists.
141
125
 
142
- [CVE-2025-55193]
126
+ *Rob Lewis*
143
127
 
144
- *Gannon McGibbon*, *John Hawthorn*
128
+ * Remove deprecated `:unsigned_float` and `:unsigned_decimal` column methods for MySQL.
145
129
 
130
+ *Rafael Mendonça França*
146
131
 
147
- ## Rails 8.0.2 (March 12, 2025) ##
132
+ * Remove deprecated `:retries` option for the SQLite3 adapter.
148
133
 
149
- * Fix inverting `rename_enum_value` when `:from`/`:to` are provided.
134
+ *Rafael Mendonça França*
150
135
 
151
- *fatkodima*
136
+ * Introduce new database configuration options `keepalive`, `max_age`, and
137
+ `min_connections` -- and rename `pool` to `max_connections` to match.
152
138
 
153
- * Prevent persisting invalid record.
139
+ There are no changes to default behavior, but these allow for more specific
140
+ control over pool behavior.
154
141
 
155
- *Edouard Chin*
142
+ *Matthew Draper*, *Chris AtLee*, *Rachael Wright-Munn*
156
143
 
157
- * Fix inverting `drop_table` without options.
144
+ * Move `LIMIT` validation from query generation to when `limit()` is called.
158
145
 
159
- *fatkodima*
146
+ *Hartley McGuire*, *Shuyang*
160
147
 
161
- * Fix count with group by qualified name on loaded relation.
148
+ * Add `ActiveRecord::CheckViolation` error class for check constraint violations.
162
149
 
163
150
  *Ryuta Kamizono*
164
151
 
165
- * Fix `sum` with qualified name on loaded relation.
166
-
167
- *Chris Gunther*
168
-
169
- * The SQLite3 adapter quotes non-finite Numeric values like "Infinity" and "NaN".
170
-
171
- *Mike Dalessio*
172
-
173
- * Handle libpq returning a database version of 0 on no/bad connection in `PostgreSQLAdapter`.
174
-
175
- Before, this version would be cached and an error would be raised during connection configuration when
176
- comparing it with the minimum required version for the adapter. This meant that the connection could
177
- never be successfully configured on subsequent reconnection attempts.
178
-
179
- Now, this is treated as a connection failure consistent with libpq, raising a `ActiveRecord::ConnectionFailed`
180
- and ensuring the version isn't cached, which allows the version to be retrieved on the next connection attempt.
181
-
182
- *Joshua Young*, *Rian McGuire*
152
+ * Add `ActiveRecord::ExclusionViolation` error class for exclusion constraint violations.
183
153
 
184
- * Fix error handling during connection configuration.
154
+ When an exclusion constraint is violated in PostgreSQL, the error will now be raised
155
+ as `ActiveRecord::ExclusionViolation` instead of the generic `ActiveRecord::StatementInvalid`,
156
+ making it easier to handle these specific constraint violations in application code.
185
157
 
186
- Active Record wasn't properly handling errors during the connection configuration phase.
187
- This could lead to a partially configured connection being used, resulting in various exceptions,
188
- the most common being with the PostgreSQLAdapter raising `undefined method `key?' for nil`
189
- or `TypeError: wrong argument type nil (expected PG::TypeMap)`.
158
+ This follows the same pattern as other constraint violation error classes like
159
+ `RecordNotUnique` for unique constraint violations and `InvalidForeignKey` for
160
+ foreign key constraint violations.
190
161
 
191
- *Jean Boussier*
192
-
193
- * Fix a case where a non-retryable query could be marked retryable.
162
+ *Ryuta Kamizono*
194
163
 
195
- *Hartley McGuire*
164
+ * Attributes filtered by `filter_attributes` will now also be filtered by `filter_parameters`
165
+ so sensitive information is not leaked.
196
166
 
197
- * Handle circular references when autosaving associations.
167
+ *Jill Klang*
198
168
 
199
- *zzak*
169
+ * Add `connection.current_transaction.isolation` API to check current transaction's isolation level.
200
170
 
201
- * PoolConfig no longer keeps a reference to the connection class.
171
+ Returns the isolation level if it was explicitly set via the `isolation:` parameter
172
+ or through `ActiveRecord.with_transaction_isolation_level`, otherwise returns `nil`.
173
+ Nested transactions return the parent transaction's isolation level.
202
174
 
203
- Keeping a reference to the class caused subtle issues when combined with reloading in
204
- development. Fixes #54343.
175
+ ```ruby
176
+ # Returns nil when no transaction
177
+ User.connection.current_transaction.isolation # => nil
205
178
 
206
- *Mike Dalessio*
179
+ # Returns explicitly set isolation level
180
+ User.transaction(isolation: :serializable) do
181
+ User.connection.current_transaction.isolation # => :serializable
182
+ end
207
183
 
208
- * Fix SQL notifications sometimes not sent when using async queries.
184
+ # Returns nil when isolation not explicitly set
185
+ User.transaction do
186
+ User.connection.current_transaction.isolation # => nil
187
+ end
209
188
 
210
- ```ruby
211
- Post.async_count
212
- ActiveSupport::Notifications.subscribed(->(*) { "Will never reach here" }) do
213
- Post.count
189
+ # Nested transactions inherit parent's isolation
190
+ User.transaction(isolation: :read_committed) do
191
+ User.transaction do
192
+ User.connection.current_transaction.isolation # => :read_committed
193
+ end
214
194
  end
215
195
  ```
216
196
 
217
- In rare circumstances and under the right race condition, Active Support notifications
218
- would no longer be dispatched after using an asynchronous query.
219
- This is now fixed.
220
-
221
- *Edouard Chin*
222
-
223
- * Fix support for PostgreSQL enum types with commas in their name.
224
-
225
- *Arthur Hess*
197
+ *Kir Shatrov*
226
198
 
227
- * Fix inserts on MySQL with no RETURNING support for a table with multiple auto populated columns.
228
-
229
- *Nikita Vasilevsky*
230
-
231
- * Fix joining on a scoped association with string joins and bind parameters.
199
+ * Fix `#merge` with `#or` or `#and` and a mixture of attributes and SQL strings resulting in an incorrect query.
232
200
 
233
201
  ```ruby
234
- class Instructor < ActiveRecord::Base
235
- has_many :instructor_roles, -> { active }
236
- end
202
+ base = Comment.joins(:post).where(user_id: 1).where("recent = 1")
203
+ puts base.merge(base.where(draft: true).or(Post.where(archived: true))).to_sql
204
+ ```
237
205
 
238
- class InstructorRole < ActiveRecord::Base
239
- scope :active, -> {
240
- joins("JOIN students ON instructor_roles.student_id = students.id")
241
- .where(students { status: 1 })
242
- }
243
- end
206
+ Before:
244
207
 
245
- Instructor.joins(:instructor_roles).first
208
+ ```SQL
209
+ SELECT "comments".* FROM "comments"
210
+ INNER JOIN "posts" ON "posts"."id" = "comments"."post_id"
211
+ WHERE (recent = 1)
212
+ AND (
213
+ "comments"."user_id" = 1
214
+ AND (recent = 1)
215
+ AND "comments"."draft" = 1
216
+ OR "posts"."archived" = 1
217
+ )
246
218
  ```
247
219
 
248
- The above example would result in `ActiveRecord::StatementInvalid` because the
249
- `active` scope bind parameters would be lost.
220
+ After:
250
221
 
251
- *Jean Boussier*
222
+ ```SQL
223
+ SELECT "comments".* FROM "comments"
224
+ INNER JOIN "posts" ON "posts"."id" = "comments"."post_id"
225
+ WHERE "comments"."user_id" = 1
226
+ AND (recent = 1)
227
+ AND (
228
+ "comments"."user_id" = 1
229
+ AND (recent = 1)
230
+ AND "comments"."draft" = 1
231
+ OR "posts"."archived" = 1
232
+ )
233
+ ```
252
234
 
253
- * Fix a potential race condition with system tests and transactional fixtures.
235
+ *Joshua Young*
254
236
 
255
- *Sjoerd Lagarde*
237
+ * Make schema dumper to account for `ActiveRecord.dump_schemas` when dumping in `:ruby` format.
256
238
 
257
- * Fix autosave associations to no longer validated unmodified associated records.
239
+ *fatkodima*
258
240
 
259
- Active Record was incorrectly performing validation on associated record that
260
- weren't created nor modified as part of the transaction:
241
+ * Add `:touch` option to `update_column`/`update_columns` methods.
261
242
 
262
243
  ```ruby
263
- Post.create!(author: User.find(1)) # Fail if user is invalid
264
- ```
265
-
266
- *Jean Boussier*
267
-
268
- * Remember when a database connection has recently been verified (for
269
- two seconds, by default), to avoid repeated reverifications during a
270
- single request.
244
+ # Will update :updated_at/:updated_on alongside :nice column.
245
+ user.update_column(:nice, true, touch: true)
271
246
 
272
- This should recreate a similar rate of verification as in Rails 7.1,
273
- where connections are leased for the duration of a request, and thus
274
- only verified once.
247
+ # Will update :updated_at/:updated_on alongside :last_ip column
248
+ user.update_columns(last_ip: request.remote_ip, touch: true)
249
+ ```
275
250
 
276
- *Matthew Draper*
251
+ *Dmitrii Ivliev*
277
252
 
253
+ * Optimize Active Record batching further when using ranges.
278
254
 
279
- ## Rails 8.0.1 (December 13, 2024) ##
255
+ Tested on a PostgreSQL table with 10M records and batches of 10k records, the generation
256
+ of relations for the 1000 batches was `4.8x` faster (`6.8s` vs. `1.4s`), used `900x`
257
+ less bandwidth (`180MB` vs. `0.2MB`) and allocated `45x` less memory (`490MB` vs. `11MB`).
280
258
 
281
- * Fix removing foreign keys with :restrict action for MySQL.
259
+ *Maxime Réty*, *fatkodima*
282
260
 
283
- *fatkodima*
261
+ * Include current character length in error messages for index and table name length validations.
284
262
 
285
- * Fix a race condition in `ActiveRecord::Base#method_missing` when lazily defining attributes.
263
+ *Joshua Young*
286
264
 
287
- If multiple thread were concurrently triggering attribute definition on the same model,
288
- it could result in a `NoMethodError` being raised.
265
+ * Add `rename_schema` method for PostgreSQL.
289
266
 
290
- *Jean Boussier*
267
+ *T S Vallender*
291
268
 
292
- * Fix MySQL default functions getting dropped when changing a column's nullability.
269
+ * Implement support for deprecating associations:
293
270
 
294
- *Bastian Bartmann*
271
+ ```ruby
272
+ has_many :posts, deprecated: true
273
+ ```
295
274
 
296
- * Fix `add_unique_constraint`/`add_check_constraint`/`add_foreign_key` to be revertible when given invalid options.
275
+ With that, Active Record will report any usage of the `posts` association.
297
276
 
298
- *fatkodima*
277
+ Three reporting modes are supported (`:warn`, `:raise`, and `:notify`), and
278
+ backtraces can be enabled or disabled. Defaults are `:warn` mode and
279
+ disabled backtraces.
299
280
 
300
- * Fix asynchronous destroying of polymorphic `belongs_to` associations.
281
+ Please, check the docs for further details.
301
282
 
302
- *fatkodima*
283
+ *Xavier Noria*
303
284
 
304
- * Fix `insert_all` to not update existing records.
285
+ * PostgreSQL adapter create DB now supports `locale_provider` and `locale`.
305
286
 
306
- *fatkodima*
287
+ *Bengt-Ove Hollaender*
307
288
 
308
- * `NOT VALID` constraints should not dump in `create_table`.
289
+ * Use ntuples to populate row_count instead of count for Postgres
309
290
 
310
- *Ryuta Kamizono*
291
+ *Jonathan Calvert*
311
292
 
312
- * Fix finding by nil composite primary key association.
293
+ * Fix checking whether an unpersisted record is `include?`d in a strictly
294
+ loaded `has_and_belongs_to_many` association.
313
295
 
314
- *fatkodima*
296
+ *Hartley McGuire*
315
297
 
316
- * Properly reset composite primary key configuration when setting a primary key.
298
+ * Add ability to change transaction isolation for all pools within a block.
317
299
 
318
- *fatkodima*
300
+ This functionality is useful if your application needs to change the database
301
+ transaction isolation for a request or action.
319
302
 
320
- * Fix Mysql2Adapter support for prepared statements
303
+ Calling `ActiveRecord.with_transaction_isolation_level(level) {}` in an around filter or
304
+ middleware will set the transaction isolation for all pools accessed within the block,
305
+ but not for the pools that aren't.
321
306
 
322
- Using prepared statements with MySQL could result in a `NoMethodError` exception.
307
+ This works with explicit and implicit transactions:
323
308
 
324
- *Jean Boussier*, *Leo Arnold*, *zzak*
309
+ ```ruby
310
+ ActiveRecord.with_transaction_isolation_level(:read_committed) do
311
+ Tag.transaction do # opens a transaction explicitly
312
+ Tag.create!
313
+ end
314
+ end
315
+ ```
325
316
 
326
- * Fix parsing of SQLite foreign key names when they contain non-ASCII characters
317
+ ```ruby
318
+ ActiveRecord.with_transaction_isolation_level(:read_committed) do
319
+ Tag.create! # opens a transaction implicitly
320
+ end
321
+ ```
327
322
 
328
- *Zacharias Knudsen*
323
+ *Eileen M. Uchitelle*
329
324
 
330
- * Fix parsing of MySQL 8.0.16+ CHECK constraints when they contain new lines.
325
+ * Raise `ActiveRecord::MissingRequiredOrderError` when order dependent finder methods (e.g. `#first`, `#last`) are
326
+ called without `order` values on the relation, and the model does not have any order columns (`implicit_order_column`,
327
+ `query_constraints`, or `primary_key`) to fall back on.
331
328
 
332
- *Steve Hill*
329
+ This change will be introduced with a new framework default for Rails 8.1, and the current behavior of not raising
330
+ an error has been deprecated with the aim of removing the configuration option in Rails 8.2.
333
331
 
334
- * Ensure normalized attribute queries use `IS NULL` consistently for `nil` and normalized `nil` values.
332
+ ```ruby
333
+ config.active_record.raise_on_missing_required_finder_order_columns = true
334
+ ```
335
335
 
336
336
  *Joshua Young*
337
337
 
338
- * Fix `sum` when performing a grouped calculation.
338
+ * `:class_name` is now invalid in polymorphic `belongs_to` associations.
339
339
 
340
- `User.group(:friendly).sum` no longer worked. This is fixed.
340
+ Reason is `:class_name` does not make sense in those associations because
341
+ the class name of target records is dynamic and stored in the type column.
341
342
 
342
- *Edouard Chin*
343
+ Existing polymorphic associations setting this option can just delete it.
344
+ While it did not raise, it had no effect anyway.
343
345
 
344
- * Restore back the ability to pass only database name to `DATABASE_URL`.
346
+ *Xavier Noria*
345
347
 
346
- *fatkodima*
348
+ * Add support for multiple databases to `db:migrate:reset`.
347
349
 
350
+ *Joé Dupuis*
348
351
 
349
- ## Rails 8.0.0.1 (December 10, 2024) ##
352
+ * Add `affected_rows` to `ActiveRecord::Result`.
350
353
 
351
- * No changes.
354
+ *Jenny Shen*
352
355
 
356
+ * Enable passing retryable SqlLiterals to `#where`.
353
357
 
354
- ## Rails 8.0.0 (November 07, 2024) ##
358
+ *Hartley McGuire*
355
359
 
356
- * Fix support for `query_cache: false` in `database.yml`.
360
+ * Set default for primary keys in `insert_all`/`upsert_all`.
357
361
 
358
- `query_cache: false` would no longer entirely disable the Active Record query cache.
362
+ Previously in Postgres, updating and inserting new records in one upsert wasn't possible
363
+ due to null primary key values. `nil` primary key values passed into `insert_all`/`upsert_all`
364
+ are now implicitly set to the default insert value specified by adapter.
359
365
 
360
- *zzak*
366
+ *Jenny Shen*
361
367
 
368
+ * Add a load hook `active_record_database_configurations` for `ActiveRecord::DatabaseConfigurations`
362
369
 
363
- ## Rails 8.0.0.rc2 (October 30, 2024) ##
370
+ *Mike Dalessio*
364
371
 
365
- * NULLS NOT DISTINCT works with UNIQUE CONSTRAINT as well as UNIQUE INDEX.
372
+ * Use `TRUE` and `FALSE` for SQLite queries with boolean columns.
366
373
 
367
- *Ryuta Kamizono*
374
+ *Hartley McGuire*
368
375
 
369
- * The `db:prepare` task no longer loads seeds when a non-primary database is created.
376
+ * Bump minimum supported SQLite to 3.23.0.
370
377
 
371
- Previously, the `db:prepare` task would load seeds whenever a new database
372
- is created, leading to potential loss of data if a database is added to an
373
- existing environment.
378
+ *Hartley McGuire*
374
379
 
375
- Introduces a new database config property `seeds` to control whether seeds
376
- are loaded during `db:prepare` which defaults to `true` for primary database
377
- configs and `false` otherwise.
380
+ * Allow allocated Active Records to lookup associations.
378
381
 
379
- Fixes #53348.
382
+ Previously, the association cache isn't setup on allocated record objects, so association
383
+ lookups will crash. Test frameworks like mocha use allocate to check for stubbable instance
384
+ methods, which can trigger an association lookup.
380
385
 
381
- *Mike Dalessio*
386
+ *Gannon McGibbon*
382
387
 
383
- * `PG::UnableToSend: no connection to the server` is now retryable as a connection-related exception
388
+ * Encryption now supports `support_unencrypted_data: true` being set per-attribute.
384
389
 
385
- *Kazuma Watanabe*
390
+ Previously this only worked if `ActiveRecord::Encryption.config.support_unencrypted_data == true`.
391
+ Now, if the global config is turned off, you can still opt in for a specific attribute.
386
392
 
387
- * Fix strict loading propagation even if statement cache is not used.
393
+ ```ruby
394
+ # ActiveRecord::Encryption.config.support_unencrypted_data = true
395
+ class User < ActiveRecord::Base
396
+ encrypts :name, support_unencrypted_data: false # only supports encrypted data
397
+ encrypts :email # supports encrypted or unencrypted data
398
+ end
399
+ ```
388
400
 
389
- *Ryuta Kamizono*
401
+ ```ruby
402
+ # ActiveRecord::Encryption.config.support_unencrypted_data = false
403
+ class User < ActiveRecord::Base
404
+ encrypts :name, support_unencrypted_data: true # supports encrypted or unencrypted data
405
+ encrypts :email # only supports encrypted data
406
+ end
407
+ ```
390
408
 
391
- * Allow `rename_enum` accepts two from/to name arguments as `rename_table` does so.
409
+ *Alex Ghiculescu*
392
410
 
393
- *Ryuta Kamizono*
411
+ * Model generator no longer needs a database connection to validate column types.
394
412
 
413
+ *Mike Dalessio*
395
414
 
396
- ## Rails 8.0.0.rc1 (October 19, 2024) ##
415
+ * Allow signed ID verifiers to be configurable via `Rails.application.message_verifiers`
397
416
 
398
- * Remove deprecated support to setting `ENV["SCHEMA_CACHE"]`.
417
+ Prior to this change, the primary way to configure signed ID verifiers was
418
+ to set `signed_id_verifier` on each model class:
399
419
 
400
- *Rafael Mendonça França*
420
+ ```ruby
421
+ Post.signed_id_verifier = ActiveSupport::MessageVerifier.new(...)
422
+ Comment.signed_id_verifier = ActiveSupport::MessageVerifier.new(...)
423
+ ```
401
424
 
402
- * Remove deprecated support to passing a database name to `cache_dump_filename`.
425
+ And if the developer did not set `signed_id_verifier`, a verifier would be
426
+ instantiated with a secret derived from `secret_key_base` and the following
427
+ options:
403
428
 
404
- *Rafael Mendonça França*
429
+ ```ruby
430
+ { digest: "SHA256", serializer: JSON, url_safe: true }
431
+ ```
405
432
 
406
- * Remove deprecated `ActiveRecord::ConnectionAdapters::ConnectionPool#connection`.
433
+ Thus it was cumbersome to rotate configuration for all verifiers.
407
434
 
408
- *Rafael Mendonça França*
435
+ This change defines a new Rails config: [`config.active_record.use_legacy_signed_id_verifier`][].
436
+ The default value is `:generate_and_verify`, which preserves the previous
437
+ behavior. However, when set to `:verify`, signed ID verifiers will use
438
+ configuration from `Rails.application.message_verifiers` (specifically,
439
+ `Rails.application.message_verifiers["active_record/signed_id"]`) to
440
+ generate and verify signed IDs, but will also verify signed IDs using the
441
+ older configuration.
409
442
 
410
- * Remove deprecated `config.active_record.sqlite3_deprecated_warning`.
443
+ To avoid complication, the new behavior only applies when `signed_id_verifier_secret`
444
+ is not set on a model class or any of its ancestors. Additionally,
445
+ `signed_id_verifier_secret` is now deprecated. If you are currently setting
446
+ `signed_id_verifier_secret` on a model class, you can set `signed_id_verifier`
447
+ instead:
411
448
 
412
- *Rafael Mendonça França*
449
+ ```ruby
450
+ # BEFORE
451
+ Post.signed_id_verifier_secret = "my secret"
413
452
 
414
- * Remove deprecated `config.active_record.warn_on_records_fetched_greater_than`.
453
+ # AFTER
454
+ Post.signed_id_verifier = ActiveSupport::MessageVerifier.new("my secret", digest: "SHA256", serializer: JSON, url_safe: true)
455
+ ```
415
456
 
416
- *Rafael Mendonça França*
457
+ To ease migration, `signed_id_verifier` has also been changed to behave as a
458
+ `class_attribute` (i.e. inheritable), but _only when `signed_id_verifier_secret`
459
+ is not set_:
417
460
 
418
- * Remove deprecated support for defining `enum` with keyword arguments.
461
+ ```ruby
462
+ # BEFORE
463
+ ActiveRecord::Base.signed_id_verifier = ActiveSupport::MessageVerifier.new(...)
464
+ Post.signed_id_verifier == ActiveRecord::Base.signed_id_verifier # => false
419
465
 
420
- *Rafael Mendonça França*
466
+ # AFTER
467
+ ActiveRecord::Base.signed_id_verifier = ActiveSupport::MessageVerifier.new(...)
468
+ Post.signed_id_verifier == ActiveRecord::Base.signed_id_verifier # => true
421
469
 
422
- * Remove deprecated support to finding database adapters that aren't registered to Active Record.
470
+ Post.signed_id_verifier_secret = "my secret" # => deprecation warning
471
+ Post.signed_id_verifier == ActiveRecord::Base.signed_id_verifier # => false
472
+ ```
423
473
 
424
- *Rafael Mendonça França*
474
+ Note, however, that it is recommended to eventually migrate from
475
+ model-specific verifiers to a unified configuration managed by
476
+ `Rails.application.message_verifiers`. `ActiveSupport::MessageVerifier#rotate`
477
+ can facilitate that transition. For example:
425
478
 
426
- * Remove deprecated `config.active_record.allow_deprecated_singular_associations_name`.
479
+ ```ruby
480
+ # BEFORE
481
+ # Generate and verify signed Post IDs using Post-specific configuration
482
+ Post.signed_id_verifier = ActiveSupport::MessageVerifier.new("post secret", ...)
427
483
 
428
- *Rafael Mendonça França*
484
+ # AFTER
485
+ # Generate and verify signed Post IDs using the unified configuration
486
+ Post.signed_id_verifier = Post.signed_id_verifier.dup
487
+ # Fall back to Post-specific configuration when verifying signed IDs
488
+ Post.signed_id_verifier.rotate("post secret", ...)
489
+ ```
429
490
 
430
- * Remove deprecated `config.active_record.commit_transaction_on_non_local_return`.
491
+ [`config.active_record.use_legacy_signed_id_verifier`]: https://guides.rubyonrails.org/v8.1/configuring.html#config-active-record-use-legacy-signed-id-verifier
431
492
 
432
- *Rafael Mendonça França*
493
+ *Ali Sepehri*, *Jonathan Hefner*
433
494
 
434
- * Fix incorrect SQL query when passing an empty hash to `ActiveRecord::Base.insert`.
495
+ * Prepend `extra_flags` in postgres' `structure_load`
435
496
 
436
- *David Stosik*
497
+ When specifying `structure_load_flags` with a postgres adapter, the flags
498
+ were appended to the default flags, instead of prepended.
499
+ This caused issues with flags not being taken into account by postgres.
437
500
 
438
- * Allow to save records with polymorphic join tables that have `inverse_of`
439
- specified.
501
+ *Alice Loeser*
440
502
 
441
- *Markus Doits*
503
+ * Allow bypassing primary key/constraint addition in `implicit_order_column`
442
504
 
443
- * Fix association scopes applying on the incorrect join when using a polymorphic `has_many through:`.
505
+ When specifying multiple columns in an array for `implicit_order_column`, adding
506
+ `nil` as the last element will prevent appending the primary key to order
507
+ conditions. This allows more precise control of indexes used by
508
+ generated queries. It should be noted that this feature does introduce the risk
509
+ of API misbehavior if the specified columns are not fully unique.
444
510
 
445
- *Joshua Young*
511
+ *Issy Long*
446
512
 
447
- * Allow `ActiveRecord::Base#pluck` to accept hash arguments with symbol and string values.
513
+ * Allow setting the `schema_format` via database configuration.
448
514
 
449
- ```ruby
450
- Post.joins(:comments).pluck(:id, comments: :id)
451
- Post.joins(:comments).pluck("id", "comments" => "id")
515
+ ```
516
+ primary:
517
+ schema_format: ruby
452
518
  ```
453
519
 
454
- *Joshua Young*
455
-
456
- * Make Float distinguish between `float4` and `float8` in PostgreSQL.
457
-
458
- Fixes #52742
520
+ Useful for multi-database setups when apps require different formats per-database.
459
521
 
460
- *Ryota Kitazawa*, *Takayuki Nagatomi*
522
+ *T S Vallender*
461
523
 
524
+ * Support disabling indexes for MySQL v8.0.0+ and MariaDB v10.6.0+
462
525
 
463
- ## Rails 8.0.0.beta1 (September 26, 2024) ##
526
+ MySQL 8.0.0 added an option to disable indexes from being used by the query
527
+ optimizer by making them "invisible". This allows the index to still be maintained
528
+ and updated but no queries will be permitted to use it. This can be useful for adding
529
+ new invisible indexes or making existing indexes invisible before dropping them
530
+ to ensure queries are not negatively affected.
531
+ See https://dev.mysql.com/blog-archive/mysql-8-0-invisible-indexes/ for more details.
464
532
 
465
- * Allow `drop_table` to accept an array of table names.
533
+ MariaDB 10.6.0 also added support for this feature by allowing indexes to be "ignored"
534
+ in queries. See https://mariadb.com/kb/en/ignored-indexes/ for more details.
466
535
 
467
- This will let you to drop multiple tables in a single call.
536
+ Active Record now supports this option for MySQL 8.0.0+ and MariaDB 10.6.0+ for
537
+ index creation and alteration where the new index option `enabled: true/false` can be
538
+ passed to column and index methods as below:
468
539
 
469
540
  ```ruby
470
- ActiveRecord::Base.lease_connection.drop_table(:users, :posts)
541
+ add_index :users, :email, enabled: false
542
+ enable_index :users, :email
543
+ add_column :users, :dob, :string, index: { enabled: false }
544
+
545
+ change_table :users do |t|
546
+ t.index :name, enabled: false
547
+ t.index :dob
548
+ t.disable_index :dob
549
+ t.column :username, :string, index: { enabled: false }
550
+ t.references :account, index: { enabled: false }
551
+ end
552
+
553
+ create_table :users do |t|
554
+ t.string :name, index: { enabled: false }
555
+ t.string :email
556
+ t.index :email, enabled: false
557
+ end
471
558
  ```
472
559
 
473
- *Gabriel Sobrinho*
560
+ *Merve Taner*
474
561
 
475
- * Add support for PostgreSQL `IF NOT EXISTS` via the `:if_not_exists` option
476
- on the `add_enum_value` method.
562
+ * Respect `implicit_order_column` in `ActiveRecord::Relation#reverse_order`.
477
563
 
478
- *Ariel Rzezak*
564
+ *Joshua Young*
479
565
 
480
- * When running `db:migrate` on a fresh database, load the databases schemas before running migrations.
566
+ * Add column types to `ActiveRecord::Result` for SQLite3.
481
567
 
482
- *Andrew Novoselac*, *Marek Kasztelnik*
568
+ *Andrew Kane*
483
569
 
484
- * Fix an issue where `.left_outer_joins` used with multiple associations that have
485
- the same child association but different parents does not join all parents.
570
+ * Raise `ActiveRecord::ReadOnlyError` when pessimistically locking with a readonly role.
486
571
 
487
- Previously, using `.left_outer_joins` with the same child association would only join one of the parents.
572
+ *Joshua Young*
488
573
 
489
- Now it will correctly join both parents.
574
+ * Fix using the `SQLite3Adapter`'s `dbconsole` method outside of a Rails application.
490
575
 
491
- Fixes #41498.
576
+ *Hartley McGuire*
492
577
 
493
- *Garrett Blehm*
578
+ * Fix migrating multiple databases with `ActiveRecord::PendingMigration` action.
494
579
 
495
- * Deprecate `unsigned_float` and `unsigned_decimal` short-hand column methods.
580
+ *Gannon McGibbon*
496
581
 
497
- As of MySQL 8.0.17, the UNSIGNED attribute is deprecated for columns of type FLOAT, DOUBLE,
498
- and DECIMAL. Consider using a simple CHECK constraint instead for such columns.
582
+ * Enable automatically retrying idempotent association queries on connection
583
+ errors.
499
584
 
500
- https://dev.mysql.com/doc/refman/8.0/en/numeric-type-syntax.html
585
+ *Hartley McGuire*
501
586
 
502
- *Ryuta Kamizono*
587
+ * Add `allow_retry` to `sql.active_record` instrumentation.
503
588
 
504
- * Drop MySQL 5.5 support.
589
+ This enables identifying queries which queries are automatically retryable on connection errors.
505
590
 
506
- MySQL 5.5 is the only version that does not support datetime with precision,
507
- which we have supported in the core. Now we support MySQL 5.6.4 or later, which
508
- is the first version to support datetime with precision.
591
+ *Hartley McGuire*
509
592
 
510
- *Ryuta Kamizono*
593
+ * Better support UPDATE with JOIN for Postgresql and SQLite3
511
594
 
512
- * Make Active Record asynchronous queries compatible with transactional fixtures.
595
+ Previously when generating update queries with one or more JOIN clauses,
596
+ Active Record would use a sub query which would prevent to reference the joined
597
+ tables in the `SET` clause, for instance:
513
598
 
514
- Previously transactional fixtures would disable asynchronous queries, because transactional
515
- fixtures impose all queries use the same connection.
599
+ ```ruby
600
+ Comment.joins(:post).update_all("title = posts.title")
601
+ ```
516
602
 
517
- Now asynchronous queries will use the connection pinned by transactional fixtures, and behave
518
- much closer to production.
603
+ This is now supported as long as the relation doesn't also use a `LIMIT`, `ORDER` or
604
+ `GROUP BY` clause. This was supported by the MySQL adapter for a long time.
519
605
 
520
606
  *Jean Boussier*
521
607
 
522
- * Deserialize binary data before decrypting
523
-
524
- This ensures that we call `PG::Connection.unescape_bytea` on PostgreSQL before decryption.
525
-
526
- *Donal McBreen*
527
-
528
- * Ensure `ActiveRecord::Encryption.config` is always ready before access.
529
-
530
- Previously, `ActiveRecord::Encryption` configuration was deferred until `ActiveRecord::Base`
531
- was loaded. Therefore, accessing `ActiveRecord::Encryption.config` properties before
532
- `ActiveRecord::Base` was loaded would give incorrect results.
533
-
534
- `ActiveRecord::Encryption` now has its own loading hook so that its configuration is set as
535
- soon as needed.
536
-
537
- When `ActiveRecord::Base` is loaded, even lazily, it in turn triggers the loading of
538
- `ActiveRecord::Encryption`, thus preserving the original behavior of having its config ready
539
- before any use of `ActiveRecord::Base`.
540
-
541
- *Maxime Réty*
608
+ * Introduce a before-fork hook in `ActiveSupport::Testing::Parallelization` to clear existing
609
+ connections, to avoid fork-safety issues with the mysql2 adapter.
542
610
 
543
- * Add `TimeZoneConverter#==` method, so objects will be properly compared by
544
- their type, scale, limit & precision.
611
+ Fixes #41776
545
612
 
546
- Address #52699.
613
+ *Mike Dalessio*, *Donal McBreen*
547
614
 
548
- *Ruy Rocha*
549
-
550
- * Add support for SQLite3 full-text-search and other virtual tables.
551
-
552
- Previously, adding sqlite3 virtual tables messed up `schema.rb`.
615
+ * PoolConfig no longer keeps a reference to the connection class.
553
616
 
554
- Now, virtual tables can safely be added using `create_virtual_table`.
617
+ Keeping a reference to the class caused subtle issues when combined with reloading in
618
+ development. Fixes #54343.
555
619
 
556
- *Zacharias Knudsen*
620
+ *Mike Dalessio*
557
621
 
558
- * Support use of alternative database interfaces via the `database_cli` ActiveRecord configuration option.
622
+ * Fix SQL notifications sometimes not sent when using async queries.
559
623
 
560
624
  ```ruby
561
- Rails.application.configure do
562
- config.active_record.database_cli = { postgresql: "pgcli" }
625
+ Post.async_count
626
+ ActiveSupport::Notifications.subscribed(->(*) { "Will never reach here" }) do
627
+ Post.count
563
628
  end
564
629
  ```
565
630
 
566
- *T S Vallender*
631
+ In rare circumstances and under the right race condition, Active Support notifications
632
+ would no longer be dispatched after using an asynchronous query.
633
+ This is now fixed.
567
634
 
568
- * Add support for dumping table inheritance and native partitioning table definitions for PostgeSQL adapter
635
+ *Edouard Chin*
569
636
 
570
- *Justin Talbott*
637
+ * Eliminate queries loading dumped schema cache on Postgres
571
638
 
572
- * Add support for `ActiveRecord::Point` type casts using `Hash` values
639
+ Improve resiliency by avoiding needing to open a database connection to load the
640
+ type map while defining attribute methods at boot when a schema cache file is
641
+ configured on PostgreSQL databases.
573
642
 
574
- This allows `ActiveRecord::Point` to be cast or serialized from a hash
575
- with `:x` and `:y` keys of numeric values, mirroring the functionality of
576
- existing casts for string and array values. Both string and symbol keys are
577
- supported.
643
+ *James Coleman*
578
644
 
579
- ```ruby
580
- class PostgresqlPoint < ActiveRecord::Base
581
- attribute :x, :point
582
- attribute :y, :point
583
- attribute :z, :point
584
- end
645
+ * `ActiveRecord::Coder::JSON` can be instantiated
585
646
 
586
- val = PostgresqlPoint.new({
587
- x: '(12.34, -43.21)',
588
- y: [12.34, '-43.21'],
589
- z: {x: '12.34', y: -43.21}
590
- })
591
- ActiveRecord::Point.new(12.32, -43.21) == val.x == val.y == val.z
647
+ Options can now be passed to `ActiveRecord::Coder::JSON` when instantiating the coder. This allows:
648
+ ```ruby
649
+ serialize :config, coder: ActiveRecord::Coder::JSON.new(symbolize_names: true)
592
650
  ```
651
+ *matthaigh27*
593
652
 
594
- *Stephen Drew*
653
+ * Deprecate using `insert_all`/`upsert_all` with unpersisted records in associations.
595
654
 
596
- * Replace `SQLite3::Database#busy_timeout` with `#busy_handler_timeout=`.
655
+ Using these methods on associations containing unpersisted records will now
656
+ show a deprecation warning, as the unpersisted records will be lost after
657
+ the operation.
597
658
 
598
- Provides a non-GVL-blocking, fair retry interval busy handler implementation.
659
+ *Nick Schwaderer*
599
660
 
600
- *Stephen Margheim*
661
+ * Make column name optional for `index_exists?`.
601
662
 
602
- * SQLite3Adapter: Translate `SQLite3::BusyException` into `ActiveRecord::StatementTimeout`.
663
+ This aligns well with `remove_index` signature as well, where
664
+ index name doesn't need to be derived from the column names.
603
665
 
604
- *Matthew Nguyen*
666
+ *Ali Ismayiliov*
605
667
 
606
- * Include schema name in `enable_extension` statements in `db/schema.rb`.
668
+ * Change the payload name of `sql.active_record` notification for eager
669
+ loading from "SQL" to "#{model.name} Eager Load".
607
670
 
608
- The schema dumper will now include the schema name in generated
609
- `enable_extension` statements if they differ from the current schema.
671
+ *zzak*
610
672
 
611
- For example, if you have a migration:
673
+ * Enable automatically retrying idempotent `#exists?` queries on connection
674
+ errors.
612
675
 
613
- ```ruby
614
- enable_extension "heroku_ext.pgcrypto"
615
- enable_extension "pg_stat_statements"
616
- ```
676
+ *Hartley McGuire*, *classidied*
617
677
 
618
- then the generated schema dump will also contain:
678
+ * Deprecate usage of unsupported methods in conjunction with `update_all`:
619
679
 
620
- ```ruby
621
- enable_extension "heroku_ext.pgcrypto"
622
- enable_extension "pg_stat_statements"
623
- ```
680
+ `update_all` will now print a deprecation message if a query includes either `WITH`,
681
+ `WITH RECURSIVE` or `DISTINCT` statements. Those were never supported and were ignored
682
+ when generating the SQL query.
624
683
 
625
- *Tony Novak*
684
+ An error will be raised in a future Rails release. This behavior will be consistent
685
+ with `delete_all` which currently raises an error for unsupported statements.
626
686
 
627
- * Fix `ActiveRecord::Encryption::EncryptedAttributeType#type` to return
628
- actual cast type.
687
+ *Edouard Chin*
629
688
 
630
- *Vasiliy Ermolovich*
689
+ * The table columns inside `schema.rb` are now sorted alphabetically.
631
690
 
632
- * SQLite3Adapter: Bulk insert fixtures.
691
+ Previously they'd be sorted by creation order, which can cause merge conflicts when two
692
+ branches modify the same table concurrently.
633
693
 
634
- Previously one insert command was executed for each fixture, now they are
635
- aggregated in a single bulk insert command.
694
+ *John Duff*
636
695
 
637
- *Lázaro Nixon*
696
+ * Introduce versions formatter for the schema dumper.
638
697
 
639
- * PostgreSQLAdapter: Allow `disable_extension` to be called with schema-qualified name.
698
+ It is now possible to override how schema dumper formats versions information inside the
699
+ `structure.sql` file. Currently, the versions are simply sorted in the decreasing order.
700
+ Within large teams, this can potentially cause many merge conflicts near the top of the list.
640
701
 
641
- For parity with `enable_extension`, the `disable_extension` method can be called with a schema-qualified
642
- name (e.g. `disable_extension "myschema.pgcrypto"`). Note that PostgreSQL's `DROP EXTENSION` does not
643
- actually take a schema name (unlike `CREATE EXTENSION`), so the resulting SQL statement will only name
644
- the extension, e.g. `DROP EXTENSION IF EXISTS "pgcrypto"`.
702
+ Now, the custom formatter can be provided with a custom sorting logic (e.g. by hash values
703
+ of the versions), which can greatly reduce the number of conflicts.
645
704
 
646
- *Tony Novak*
705
+ *fatkodima*
647
706
 
648
- * Make `create_schema` / `drop_schema` reversible in migrations.
707
+ * Serialized attributes can now be marked as comparable.
649
708
 
650
- Previously, `create_schema` and `drop_schema` were irreversible migration operations.
709
+ A not rare issue when working with serialized attributes is that the serialized representation of an object
710
+ can change over time. Either because you are migrating from one serializer to the other (e.g. YAML to JSON or to msgpack),
711
+ or because the serializer used subtly changed its output.
651
712
 
652
- *Tony Novak*
713
+ One example is libyaml that used to have some extra trailing whitespaces, and recently fixed that.
714
+ When this sorts of thing happen, you end up with lots of records that report being changed even though
715
+ they aren't, which in the best case leads to a lot more writes to the database and in the worst case lead to nasty bugs.
653
716
 
654
- * Support batching using custom columns.
717
+ The solution is to instead compare the deserialized representation of the object, however Active Record
718
+ can't assume the deserialized object has a working `==` method. Hence why this new functionality is opt-in.
655
719
 
656
720
  ```ruby
657
- Product.in_batches(cursor: [:shop_id, :id]) do |relation|
658
- # do something with relation
659
- end
721
+ serialize :config, type: Hash, coder: JSON, comparable: true
660
722
  ```
661
723
 
662
- *fatkodima*
663
-
664
- * Use SQLite `IMMEDIATE` transactions when possible.
665
-
666
- Transactions run against the SQLite3 adapter default to IMMEDIATE mode to improve concurrency support and avoid busy exceptions.
667
-
668
- *Stephen Margheim*
669
-
670
- * Raise specific exception when a connection is not defined.
671
-
672
- The new `ConnectionNotDefined` exception provides connection name, shard and role accessors indicating the details of the connection that was requested.
673
-
674
- *Hana Harencarova*, *Matthew Draper*
724
+ *Jean Boussier*
675
725
 
676
- * Delete the deprecated constant `ActiveRecord::ImmutableRelation`.
726
+ * Fix MySQL default functions getting dropped when changing a column's nullability.
677
727
 
678
- *Xavier Noria*
728
+ *Bastian Bartmann*
679
729
 
680
- * Fix duplicate callback execution when child autosaves parent with `has_one` and `belongs_to`.
730
+ * SQLite extensions can be configured in `config/database.yml`.
681
731
 
682
- Before, persisting a new child record with a new associated parent record would run `before_validation`,
683
- `after_validation`, `before_save` and `after_save` callbacks twice.
732
+ The database configuration option `extensions:` allows an application to load SQLite extensions
733
+ when using `sqlite3` >= v2.4.0. The array members may be filesystem paths or the names of
734
+ modules that respond to `.to_path`:
684
735
 
685
- Now, these callbacks are only executed once as expected.
736
+ ``` yaml
737
+ development:
738
+ adapter: sqlite3
739
+ extensions:
740
+ - SQLean::UUID # module name responding to `.to_path`
741
+ - .sqlpkg/nalgeon/crypto/crypto.so # or a filesystem path
742
+ - <%= AppExtensions.location %> # or ruby code returning a path
743
+ ```
686
744
 
687
- *Joshua Young*
745
+ *Mike Dalessio*
688
746
 
689
- * `ActiveRecord::Encryption::Encryptor` now supports a `:compressor` option to customize the compression algorithm used.
747
+ * `ActiveRecord::Middleware::ShardSelector` supports granular database connection switching.
690
748
 
691
- ```ruby
692
- module ZstdCompressor
693
- def self.deflate(data)
694
- Zstd.compress(data)
695
- end
749
+ A new configuration option, `class_name:`, is introduced to
750
+ `config.active_record.shard_selector` to allow an application to specify the abstract connection
751
+ class to be switched by the shard selection middleware. The default class is
752
+ `ActiveRecord::Base`.
696
753
 
697
- def self.inflate(data)
698
- Zstd.decompress(data)
699
- end
700
- end
754
+ For example, this configuration tells `ShardSelector` to switch shards using
755
+ `AnimalsRecord.connected_to`:
701
756
 
702
- class User
703
- encrypts :name, compressor: ZstdCompressor
704
- end
705
757
  ```
706
-
707
- You disable compression by passing `compress: false`.
708
-
709
- ```ruby
710
- class User
711
- encrypts :name, compress: false
712
- end
758
+ config.active_record.shard_selector = { class_name: "AnimalsRecord" }
713
759
  ```
714
760
 
715
- *heka1024*
716
-
717
- * Add condensed `#inspect` for `ConnectionPool`, `AbstractAdapter`, and
718
- `DatabaseConfig`.
719
-
720
- *Hartley McGuire*
721
-
722
- * Add `.shard_keys`, `.sharded?`, & `.connected_to_all_shards` methods.
723
-
724
- ```ruby
725
- class ShardedBase < ActiveRecord::Base
726
- self.abstract_class = true
727
-
728
- connects_to shards: {
729
- shard_one: { writing: :shard_one },
730
- shard_two: { writing: :shard_two }
731
- }
732
- end
761
+ *Mike Dalessio*
733
762
 
734
- class ShardedModel < ShardedBase
735
- end
763
+ * Reset relations after `insert_all`/`upsert_all`.
736
764
 
737
- ShardedModel.shard_keys => [:shard_one, :shard_two]
738
- ShardedModel.sharded? => true
739
- ShardedBase.connected_to_all_shards { ShardedModel.current_shard } => [:shard_one, :shard_two]
740
- ```
765
+ Bulk insert/upsert methods will now call `reset` if used on a relation, matching the behavior of `update_all`.
741
766
 
742
- *Nony Dutton*
767
+ *Milo Winningham*
743
768
 
744
- * Add a `filter` option to `in_order_of` to prioritize certain values in the sorting without filtering the results
745
- by these values.
769
+ * Use `_N` as a parallel tests databases suffixes
746
770
 
747
- *Igor Depolli*
771
+ Peviously, `-N` was used as a suffix. This can cause problems for RDBMSes
772
+ which do not support dashes in database names.
748
773
 
749
- * Fix an issue where the IDs reader method did not return expected results
750
- for preloaded associations in models using composite primary keys.
751
-
752
- *Jay Ang*
774
+ *fatkodima*
753
775
 
754
- * Allow to configure `strict_loading_mode` globally or within a model.
776
+ * Remember when a database connection has recently been verified (for
777
+ two seconds, by default), to avoid repeated reverifications during a
778
+ single request.
755
779
 
756
- Defaults to `:all`, can be changed to `:n_plus_one_only`.
780
+ This should recreate a similar rate of verification as in Rails 7.1,
781
+ where connections are leased for the duration of a request, and thus
782
+ only verified once.
757
783
 
758
- *Garen Torikian*
784
+ *Matthew Draper*
759
785
 
760
- * Add `ActiveRecord::Relation#readonly?`.
786
+ * Allow to reset cache counters for multiple records.
761
787
 
762
- Reflects if the relation has been marked as readonly.
788
+ ```
789
+ Aircraft.reset_counters([1, 2, 3], :wheels_count)
790
+ ```
763
791
 
764
- *Theodor Tonum*
792
+ It produces much fewer queries compared to the custom implementation using looping over ids.
793
+ Previously: `O(ids.size * counters.size)` queries, now: `O(ids.size + counters.size)` queries.
765
794
 
766
- * Improve `ActiveRecord::Store` to raise a descriptive exception if the column is not either
767
- structured (e.g., PostgreSQL +hstore+/+json+, or MySQL +json+) or declared serializable via
768
- `ActiveRecord.store`.
795
+ *fatkodima*
769
796
 
770
- Previously, a `NoMethodError` would be raised when the accessor was read or written:
797
+ * Add `affected_rows` to `sql.active_record` Notification.
771
798
 
772
- NoMethodError: undefined method `accessor' for an instance of ActiveRecord::Type::Text
799
+ *Hartley McGuire*
773
800
 
774
- Now, a descriptive `ConfigurationError` is raised:
801
+ * Fix `sum` when performing a grouped calculation.
775
802
 
776
- ActiveRecord::ConfigurationError: the column 'metadata' has not been configured as a store.
777
- Please make sure the column is declared serializable via 'ActiveRecord.store' or, if your
778
- database supports it, use a structured column type like hstore or json.
803
+ `User.group(:friendly).sum` no longer worked. This is fixed.
779
804
 
780
- *Mike Dalessio*
805
+ *Edouard Chin*
781
806
 
782
- * Fix inference of association model on nested models with the same demodularized name.
807
+ * Add support for enabling or disabling transactional tests per database.
783
808
 
784
- E.g. with the following setup:
809
+ A test class can now override the default `use_transactional_tests` setting
810
+ for individual databases, which can be useful if some databases need their
811
+ current state to be accessible to an external process while tests are running.
785
812
 
786
813
  ```ruby
787
- class Nested::Post < ApplicationRecord
788
- has_one :post, through: :other
814
+ class MostlyTransactionalTest < ActiveSupport::TestCase
815
+ self.use_transactional_tests = true
816
+ skip_transactional_tests_for_database :shared
789
817
  end
790
818
  ```
791
819
 
792
- Before, `#post` would infer the model as `Nested::Post`, but now it correctly infers `Post`.
820
+ *Matthew Cheetham*, *Morgan Mareve*
793
821
 
794
- *Joshua Young*
822
+ * Cast `query_cache` value when using URL configuration.
795
823
 
796
- * Add public method for checking if a table is ignored by the schema cache.
824
+ *zzak*
797
825
 
798
- Previously, an application would need to reimplement `ignored_table?` from the schema cache class to check if a table was set to be ignored. This adds a public method to support this and updates the schema cache to use that directly.
826
+ * NULLS NOT DISTINCT works with UNIQUE CONSTRAINT as well as UNIQUE INDEX.
799
827
 
800
- ```ruby
801
- ActiveRecord.schema_cache_ignored_tables = ["developers"]
802
- ActiveRecord.schema_cache_ignored_table?("developers")
803
- => true
804
- ```
828
+ *Ryuta Kamizono*
805
829
 
806
- *Eileen M. Uchitelle*
830
+ * `PG::UnableToSend: no connection to the server` is now retryable as a connection-related exception
831
+
832
+ *Kazuma Watanabe*
807
833
 
808
- Please check [7-2-stable](https://github.com/rails/rails/blob/7-2-stable/activerecord/CHANGELOG.md) for previous changes.
834
+ Please check [8-0-stable](https://github.com/rails/rails/blob/8-0-stable/activerecord/CHANGELOG.md) for previous changes.