activerecord 7.1.3.4 → 7.2.2.1

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 (196) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +652 -2032
  3. data/README.rdoc +15 -15
  4. data/examples/performance.rb +2 -2
  5. data/lib/active_record/association_relation.rb +1 -1
  6. data/lib/active_record/associations/alias_tracker.rb +25 -19
  7. data/lib/active_record/associations/association.rb +15 -8
  8. data/lib/active_record/associations/belongs_to_association.rb +18 -11
  9. data/lib/active_record/associations/belongs_to_polymorphic_association.rb +3 -2
  10. data/lib/active_record/associations/builder/belongs_to.rb +1 -0
  11. data/lib/active_record/associations/builder/has_and_belongs_to_many.rb +2 -2
  12. data/lib/active_record/associations/builder/has_many.rb +3 -4
  13. data/lib/active_record/associations/builder/has_one.rb +3 -4
  14. data/lib/active_record/associations/collection_association.rb +11 -5
  15. data/lib/active_record/associations/collection_proxy.rb +14 -1
  16. data/lib/active_record/associations/errors.rb +265 -0
  17. data/lib/active_record/associations/has_many_association.rb +3 -3
  18. data/lib/active_record/associations/has_many_through_association.rb +7 -1
  19. data/lib/active_record/associations/has_one_association.rb +2 -2
  20. data/lib/active_record/associations/join_dependency/join_association.rb +30 -27
  21. data/lib/active_record/associations/join_dependency.rb +10 -12
  22. data/lib/active_record/associations/nested_error.rb +47 -0
  23. data/lib/active_record/associations/preloader/association.rb +2 -1
  24. data/lib/active_record/associations/preloader/branch.rb +7 -1
  25. data/lib/active_record/associations/preloader/through_association.rb +1 -3
  26. data/lib/active_record/associations/singular_association.rb +6 -0
  27. data/lib/active_record/associations/through_association.rb +1 -1
  28. data/lib/active_record/associations.rb +62 -289
  29. data/lib/active_record/attribute_assignment.rb +0 -2
  30. data/lib/active_record/attribute_methods/composite_primary_key.rb +84 -0
  31. data/lib/active_record/attribute_methods/dirty.rb +2 -2
  32. data/lib/active_record/attribute_methods/primary_key.rb +23 -55
  33. data/lib/active_record/attribute_methods/read.rb +4 -16
  34. data/lib/active_record/attribute_methods/serialization.rb +4 -24
  35. data/lib/active_record/attribute_methods/time_zone_conversion.rb +11 -6
  36. data/lib/active_record/attribute_methods/write.rb +3 -3
  37. data/lib/active_record/attribute_methods.rb +89 -58
  38. data/lib/active_record/attributes.rb +61 -47
  39. data/lib/active_record/autosave_association.rb +17 -31
  40. data/lib/active_record/base.rb +2 -3
  41. data/lib/active_record/callbacks.rb +1 -1
  42. data/lib/active_record/connection_adapters/abstract/connection_handler.rb +24 -107
  43. data/lib/active_record/connection_adapters/abstract/connection_pool/reaper.rb +1 -0
  44. data/lib/active_record/connection_adapters/abstract/connection_pool.rb +270 -58
  45. data/lib/active_record/connection_adapters/abstract/database_statements.rb +35 -18
  46. data/lib/active_record/connection_adapters/abstract/query_cache.rb +190 -75
  47. data/lib/active_record/connection_adapters/abstract/quoting.rb +65 -91
  48. data/lib/active_record/connection_adapters/abstract/schema_definitions.rb +1 -1
  49. data/lib/active_record/connection_adapters/abstract/schema_statements.rb +23 -10
  50. data/lib/active_record/connection_adapters/abstract/transaction.rb +125 -62
  51. data/lib/active_record/connection_adapters/abstract_adapter.rb +38 -59
  52. data/lib/active_record/connection_adapters/abstract_mysql_adapter.rb +73 -19
  53. data/lib/active_record/connection_adapters/mysql/database_statements.rb +9 -1
  54. data/lib/active_record/connection_adapters/mysql/quoting.rb +43 -48
  55. data/lib/active_record/connection_adapters/mysql/schema_statements.rb +8 -1
  56. data/lib/active_record/connection_adapters/mysql2/database_statements.rb +16 -15
  57. data/lib/active_record/connection_adapters/mysql2_adapter.rb +20 -32
  58. data/lib/active_record/connection_adapters/pool_config.rb +7 -6
  59. data/lib/active_record/connection_adapters/postgresql/database_statements.rb +27 -4
  60. data/lib/active_record/connection_adapters/postgresql/oid/cidr.rb +6 -0
  61. data/lib/active_record/connection_adapters/postgresql/oid/interval.rb +1 -1
  62. data/lib/active_record/connection_adapters/postgresql/oid/uuid.rb +14 -4
  63. data/lib/active_record/connection_adapters/postgresql/quoting.rb +58 -58
  64. data/lib/active_record/connection_adapters/postgresql/schema_definitions.rb +20 -0
  65. data/lib/active_record/connection_adapters/postgresql/schema_statements.rb +18 -12
  66. data/lib/active_record/connection_adapters/postgresql_adapter.rb +29 -24
  67. data/lib/active_record/connection_adapters/schema_cache.rb +123 -128
  68. data/lib/active_record/connection_adapters/sqlite3/column.rb +14 -1
  69. data/lib/active_record/connection_adapters/sqlite3/database_statements.rb +10 -6
  70. data/lib/active_record/connection_adapters/sqlite3/quoting.rb +44 -46
  71. data/lib/active_record/connection_adapters/sqlite3/schema_creation.rb +22 -0
  72. data/lib/active_record/connection_adapters/sqlite3/schema_definitions.rb +13 -0
  73. data/lib/active_record/connection_adapters/sqlite3/schema_dumper.rb +16 -0
  74. data/lib/active_record/connection_adapters/sqlite3/schema_statements.rb +25 -2
  75. data/lib/active_record/connection_adapters/sqlite3_adapter.rb +127 -77
  76. data/lib/active_record/connection_adapters/trilogy/database_statements.rb +15 -15
  77. data/lib/active_record/connection_adapters/trilogy_adapter.rb +32 -65
  78. data/lib/active_record/connection_adapters.rb +121 -0
  79. data/lib/active_record/connection_handling.rb +56 -41
  80. data/lib/active_record/core.rb +93 -40
  81. data/lib/active_record/counter_cache.rb +23 -10
  82. data/lib/active_record/database_configurations/connection_url_resolver.rb +8 -3
  83. data/lib/active_record/database_configurations/database_config.rb +19 -4
  84. data/lib/active_record/database_configurations/hash_config.rb +44 -36
  85. data/lib/active_record/database_configurations/url_config.rb +20 -1
  86. data/lib/active_record/database_configurations.rb +1 -1
  87. data/lib/active_record/delegated_type.rb +30 -6
  88. data/lib/active_record/destroy_association_async_job.rb +1 -1
  89. data/lib/active_record/dynamic_matchers.rb +2 -2
  90. data/lib/active_record/encryption/encryptable_record.rb +3 -3
  91. data/lib/active_record/encryption/encrypted_attribute_type.rb +26 -6
  92. data/lib/active_record/encryption/encryptor.rb +18 -3
  93. data/lib/active_record/encryption/key_provider.rb +1 -1
  94. data/lib/active_record/encryption/message_pack_message_serializer.rb +76 -0
  95. data/lib/active_record/encryption/message_serializer.rb +4 -0
  96. data/lib/active_record/encryption/null_encryptor.rb +4 -0
  97. data/lib/active_record/encryption/read_only_null_encryptor.rb +4 -0
  98. data/lib/active_record/encryption/scheme.rb +8 -4
  99. data/lib/active_record/encryption.rb +2 -0
  100. data/lib/active_record/enum.rb +19 -2
  101. data/lib/active_record/errors.rb +46 -20
  102. data/lib/active_record/explain.rb +13 -24
  103. data/lib/active_record/fixtures.rb +37 -31
  104. data/lib/active_record/future_result.rb +17 -4
  105. data/lib/active_record/gem_version.rb +3 -3
  106. data/lib/active_record/inheritance.rb +4 -2
  107. data/lib/active_record/insert_all.rb +18 -15
  108. data/lib/active_record/integration.rb +4 -1
  109. data/lib/active_record/internal_metadata.rb +48 -34
  110. data/lib/active_record/locking/optimistic.rb +8 -7
  111. data/lib/active_record/log_subscriber.rb +0 -21
  112. data/lib/active_record/marshalling.rb +4 -1
  113. data/lib/active_record/message_pack.rb +2 -2
  114. data/lib/active_record/migration/command_recorder.rb +2 -3
  115. data/lib/active_record/migration/compatibility.rb +11 -3
  116. data/lib/active_record/migration/default_strategy.rb +4 -5
  117. data/lib/active_record/migration/pending_migration_connection.rb +2 -2
  118. data/lib/active_record/migration.rb +85 -76
  119. data/lib/active_record/model_schema.rb +38 -70
  120. data/lib/active_record/nested_attributes.rb +24 -5
  121. data/lib/active_record/normalization.rb +3 -7
  122. data/lib/active_record/persistence.rb +32 -354
  123. data/lib/active_record/query_cache.rb +19 -8
  124. data/lib/active_record/query_logs.rb +15 -0
  125. data/lib/active_record/query_logs_formatter.rb +1 -1
  126. data/lib/active_record/querying.rb +21 -9
  127. data/lib/active_record/railtie.rb +50 -68
  128. data/lib/active_record/railties/controller_runtime.rb +13 -4
  129. data/lib/active_record/railties/databases.rake +42 -45
  130. data/lib/active_record/reflection.rb +106 -38
  131. data/lib/active_record/relation/batches/batch_enumerator.rb +15 -2
  132. data/lib/active_record/relation/batches.rb +14 -8
  133. data/lib/active_record/relation/calculations.rb +96 -63
  134. data/lib/active_record/relation/delegation.rb +8 -11
  135. data/lib/active_record/relation/finder_methods.rb +16 -2
  136. data/lib/active_record/relation/merger.rb +4 -6
  137. data/lib/active_record/relation/predicate_builder/array_handler.rb +2 -2
  138. data/lib/active_record/relation/predicate_builder/association_query_value.rb +9 -3
  139. data/lib/active_record/relation/predicate_builder/polymorphic_array_value.rb +6 -1
  140. data/lib/active_record/relation/predicate_builder.rb +3 -3
  141. data/lib/active_record/relation/query_methods.rb +245 -65
  142. data/lib/active_record/relation/record_fetch_warning.rb +3 -0
  143. data/lib/active_record/relation/spawn_methods.rb +2 -18
  144. data/lib/active_record/relation/where_clause.rb +7 -19
  145. data/lib/active_record/relation.rb +500 -66
  146. data/lib/active_record/result.rb +32 -45
  147. data/lib/active_record/runtime_registry.rb +39 -0
  148. data/lib/active_record/sanitization.rb +24 -19
  149. data/lib/active_record/schema.rb +8 -6
  150. data/lib/active_record/schema_dumper.rb +19 -9
  151. data/lib/active_record/schema_migration.rb +30 -14
  152. data/lib/active_record/scoping/named.rb +1 -0
  153. data/lib/active_record/signed_id.rb +20 -1
  154. data/lib/active_record/statement_cache.rb +7 -7
  155. data/lib/active_record/table_metadata.rb +1 -10
  156. data/lib/active_record/tasks/database_tasks.rb +98 -48
  157. data/lib/active_record/tasks/mysql_database_tasks.rb +1 -1
  158. data/lib/active_record/tasks/postgresql_database_tasks.rb +1 -1
  159. data/lib/active_record/tasks/sqlite_database_tasks.rb +2 -1
  160. data/lib/active_record/test_fixtures.rb +87 -89
  161. data/lib/active_record/testing/query_assertions.rb +121 -0
  162. data/lib/active_record/timestamp.rb +5 -3
  163. data/lib/active_record/token_for.rb +22 -12
  164. data/lib/active_record/touch_later.rb +1 -1
  165. data/lib/active_record/transaction.rb +132 -0
  166. data/lib/active_record/transactions.rb +70 -14
  167. data/lib/active_record/translation.rb +0 -2
  168. data/lib/active_record/type/serialized.rb +1 -3
  169. data/lib/active_record/type_caster/connection.rb +4 -4
  170. data/lib/active_record/validations/associated.rb +9 -3
  171. data/lib/active_record/validations/uniqueness.rb +15 -10
  172. data/lib/active_record/validations.rb +4 -1
  173. data/lib/active_record.rb +150 -41
  174. data/lib/arel/alias_predication.rb +1 -1
  175. data/lib/arel/collectors/bind.rb +2 -0
  176. data/lib/arel/collectors/composite.rb +7 -0
  177. data/lib/arel/collectors/sql_string.rb +1 -1
  178. data/lib/arel/collectors/substitute_binds.rb +1 -1
  179. data/lib/arel/nodes/binary.rb +0 -6
  180. data/lib/arel/nodes/bound_sql_literal.rb +9 -5
  181. data/lib/arel/nodes/{and.rb → nary.rb} +5 -2
  182. data/lib/arel/nodes/node.rb +4 -3
  183. data/lib/arel/nodes/sql_literal.rb +7 -0
  184. data/lib/arel/nodes.rb +2 -2
  185. data/lib/arel/predications.rb +1 -1
  186. data/lib/arel/select_manager.rb +1 -1
  187. data/lib/arel/tree_manager.rb +8 -3
  188. data/lib/arel/update_manager.rb +2 -1
  189. data/lib/arel/visitors/dot.rb +1 -0
  190. data/lib/arel/visitors/mysql.rb +9 -4
  191. data/lib/arel/visitors/postgresql.rb +1 -12
  192. data/lib/arel/visitors/sqlite.rb +25 -0
  193. data/lib/arel/visitors/to_sql.rb +31 -17
  194. data/lib/arel.rb +7 -3
  195. data/lib/rails/generators/active_record/migration/templates/create_table_migration.rb.tt +4 -1
  196. metadata +21 -15
data/CHANGELOG.md CHANGED
@@ -1,2478 +1,1098 @@
1
- ## Rails 7.1.3.4 (June 04, 2024) ##
1
+ ## Rails 7.2.2.1 (December 10, 2024) ##
2
2
 
3
3
  * No changes.
4
4
 
5
5
 
6
- ## Rails 7.1.3.3 (May 16, 2024) ##
6
+ ## Rails 7.2.2 (October 30, 2024) ##
7
7
 
8
- * No changes.
9
-
10
-
11
- ## Rails 7.1.3.2 (February 21, 2024) ##
12
-
13
- * No changes.
14
-
15
-
16
- ## Rails 7.1.3.1 (February 21, 2024) ##
17
-
18
- * No changes.
19
-
20
-
21
- ## Rails 7.1.3 (January 16, 2024) ##
22
-
23
- * Fix Migrations with versions older than 7.1 validating options given to
24
- `add_reference`.
25
-
26
- *Hartley McGuire*
27
-
28
- * Ensure `reload` sets correct owner for each association.
29
-
30
- *Dmytro Savochkin*
31
-
32
- * Fix view runtime for controllers with async queries.
33
-
34
- *fatkodima*
35
-
36
- * Fix `load_async` to work with query cache.
37
-
38
- *fatkodima*
39
-
40
- * Fix polymorphic `belongs_to` to correctly use parent's `query_constraints`.
41
-
42
- *fatkodima*
43
-
44
- * Fix `Preloader` to not generate a query for already loaded association with `query_constraints`.
45
-
46
- *fatkodima*
47
-
48
- * Fix multi-database polymorphic preloading with equivalent table names.
49
-
50
- When preloading polymorphic associations, if two models pointed to two
51
- tables with the same name but located in different databases, the
52
- preloader would only load one.
53
-
54
- *Ari Summer*
55
-
56
- * Fix `encrypted_attribute?` to take into account context properties passed to `encrypts`.
57
-
58
- *Maxime Réty*
59
-
60
- * Fix `find_by` to work correctly in presence of composite primary keys.
61
-
62
- *fatkodima*
63
-
64
- * Fix async queries sometimes returning a raw result if they hit the query cache.
65
-
66
- `ShipPart.async_count` could return a raw integer rather than a Promise
67
- if it found the result in the query cache.
68
-
69
- *fatkodima*
70
-
71
- * Fix `Relation#transaction` to not apply a default scope.
72
-
73
- The method was incorrectly setting a default scope around its block:
74
-
75
- ```ruby
76
- Post.where(published: true).transaction do
77
- Post.count # SELECT COUNT(*) FROM posts WHERE published = FALSE;
78
- end
79
- ```
80
-
81
- *Jean Boussier*
82
-
83
- * Fix calling `async_pluck` on a `none` relation.
84
-
85
- `Model.none.async_pluck(:id)` was returning a naked value
86
- instead of a promise.
87
-
88
- *Jean Boussier*
89
-
90
- * Fix calling `load_async` on a `none` relation.
91
-
92
- `Model.none.load_async` was returning a broken result.
93
-
94
- *Lucas Mazza*
95
-
96
- * TrilogyAdapter: ignore `host` if `socket` parameter is set.
97
-
98
- This allows to configure a connection on a UNIX socket via DATABASE_URL:
99
-
100
- ```
101
- DATABASE_URL=trilogy://does-not-matter/my_db_production?socket=/var/run/mysql.sock
102
- ```
103
-
104
- *Jean Boussier*
105
-
106
- * Fix `has_secure_token` calls the setter method on initialize.
107
-
108
- *Abeid Ahmed*
109
-
110
- * Allow using `object_id` as a database column name.
111
- It was available before rails 7.1 and may be used as a part of polymorphic relationship to `object` where `object` can be any other database record.
112
-
113
- *Mikhail Doronin*
114
-
115
- * Fix `rails db:create:all` to not touch databases before they are created.
116
-
117
- *fatkodima*
118
-
119
-
120
- ## Rails 7.1.2 (November 10, 2023) ##
121
-
122
- * Fix renaming primary key index when renaming a table with a UUID primary key
123
- in PostgreSQL.
124
-
125
- *fatkodima*
126
-
127
- * Fix `where(field: values)` queries when `field` is a serialized attribute
128
- (for example, when `field` uses `ActiveRecord::Base.serialize` or is a JSON
129
- column).
130
-
131
- *João Alves*
132
-
133
- * Prevent marking broken connections as verified.
134
-
135
- *Daniel Colson*
136
-
137
- * Don't mark Float::INFINITY as changed when reassigning it
138
-
139
- When saving a record with a float infinite value, it shouldn't mark as changed
140
-
141
- *Maicol Bentancor*
142
-
143
- * `ActiveRecord::Base.table_name` now returns `nil` instead of raising
144
- "undefined method `abstract_class?` for Object:Class".
145
-
146
- *a5-stable*
147
-
148
- * Fix upserting for custom `:on_duplicate` and `:unique_by` consisting of all
149
- inserts keys.
150
-
151
- *fatkodima*
152
-
153
- * Fixed an [issue](https://github.com/rails/rails/issues/49809) where saving a
154
- record could innappropriately `dup` its attributes.
155
-
156
- *Jonathan Hefner*
157
-
158
- * Dump schema only for a specific db for rollback/up/down tasks for multiple dbs.
159
-
160
- *fatkodima*
161
-
162
- * Fix `NoMethodError` when casting a PostgreSQL `money` value that uses a
163
- comma as its radix point and has no leading currency symbol. For example,
164
- when casting `"3,50"`.
165
-
166
- *Andreas Reischuck* and *Jonathan Hefner*
167
-
168
- * Re-enable support for using `enum` with non-column-backed attributes.
169
- Non-column-backed attributes must be previously declared with an explicit
170
- type. For example:
171
-
172
- ```ruby
173
- class Post < ActiveRecord::Base
174
- attribute :topic, :string
175
- enum topic: %i[science tech engineering math]
176
- end
177
- ```
178
-
179
- *Jonathan Hefner*
180
-
181
- * Raise on `foreign_key:` being passed as an array in associations
182
-
183
- *Nikita Vasilevsky*
184
-
185
- * Return back maximum allowed PostgreSQL table name to 63 characters.
186
-
187
- *fatkodima*
188
-
189
- * Fix detecting `IDENTITY` columns for PostgreSQL < 10.
190
-
191
- *fatkodima*
192
-
193
-
194
- ## Rails 7.1.1 (October 11, 2023) ##
195
-
196
- * Fix auto populating IDENTITY columns for PostgreSQL.
197
-
198
- *fatkodima*
199
-
200
- * Fix "ArgumentError: wrong number of arguments (given 3, expected 2)" when
201
- down migrating `rename_table` in older migrations.
202
-
203
- *fatkodima*
204
-
205
- * Do not require the Action Text, Active Storage and Action Mailbox tables
206
- to be present when running when running test on CI.
207
-
208
- *Rafael Mendonça França*
209
-
210
-
211
- ## Rails 7.1.0 (October 05, 2023) ##
212
-
213
- * No changes.
214
-
215
-
216
- ## Rails 7.1.0.rc2 (October 01, 2023) ##
217
-
218
- * Remove -shm and -wal SQLite files when `rails db:drop` is run.
219
-
220
- *Niklas Häusele*
221
-
222
- * Revert the change to raise an `ArgumentError` when `#accepts_nested_attributes_for` is declared more than once for
223
- an association in the same class.
224
-
225
- The reverted behavior broke the case where the `#accepts_nested_attributes_for` was defined in a concern and
226
- where overridden in the class that included the concern.
227
-
228
- *Rafael Mendonça França*
229
-
230
-
231
- ## Rails 7.1.0.rc1 (September 27, 2023) ##
232
-
233
- * Better naming for unique constraints support.
234
-
235
- Naming unique keys leads to misunderstanding it's a short-hand of unique indexes.
236
- Just naming it unique constraints is not misleading.
237
-
238
- In Rails 7.1.0.beta1 or before:
239
-
240
- ```ruby
241
- add_unique_key :sections, [:position], deferrable: :deferred, name: "unique_section_position"
242
- remove_unique_key :sections, name: "unique_section_position"
243
- ```
244
-
245
- Now:
246
-
247
- ```ruby
248
- add_unique_constraint :sections, [:position], deferrable: :deferred, name: "unique_section_position"
249
- remove_unique_constraint :sections, name: "unique_section_position"
250
- ```
251
-
252
- *Ryuta Kamizono*
253
-
254
- * Fix duplicate quoting for check constraint expressions in schema dump when using MySQL
255
-
256
- A check constraint with an expression, that already contains quotes, lead to an invalid schema
257
- dump with the mysql2 adapter.
258
-
259
- Fixes #42424.
260
-
261
- *Felix Tscheulin*
262
-
263
- * Performance tune the SQLite3 adapter connection configuration
264
-
265
- For Rails applications, the Write-Ahead-Log in normal syncing mode with a capped journal size, a healthy shared memory buffer and a shared cache will perform, on average, 2× better.
266
-
267
- *Stephen Margheim*
268
-
269
- * Allow SQLite3 `busy_handler` to be configured with simple max number of `retries`
270
-
271
- Retrying busy connections without delay is a preferred practice for performance-sensitive applications. Add support for a `database.yml` `retries` integer, which is used in a simple `busy_handler` function to retry busy connections without exponential backoff up to the max number of `retries`.
272
-
273
- *Stephen Margheim*
274
-
275
- * The SQLite3 adapter now supports `supports_insert_returning?`
276
-
277
- Implementing the full `supports_insert_returning?` contract means the SQLite3 adapter supports auto-populated columns (#48241) as well as custom primary keys.
278
-
279
- *Stephen Margheim*
280
-
281
- * Ensure the SQLite3 adapter handles default functions with the `||` concatenation operator
282
-
283
- Previously, this default function would produce the static string `"'Ruby ' || 'on ' || 'Rails'"`.
284
- Now, the adapter will appropriately receive and use `"Ruby on Rails"`.
285
-
286
- ```ruby
287
- change_column_default "test_models", "ruby_on_rails", -> { "('Ruby ' || 'on ' || 'Rails')" }
288
- ```
289
-
290
- *Stephen Margheim*
291
-
292
- * Dump PostgreSQL schemas as part of the schema dump.
293
-
294
- *Lachlan Sylvester*
295
-
296
-
297
- ## Rails 7.1.0.beta1 (September 13, 2023) ##
298
-
299
- * Encryption now supports `support_unencrypted_data` being set per-attribute.
300
-
301
- You can now opt out of `support_unencrypted_data` on a specific encrypted attribute.
302
- This only has an effect if `ActiveRecord::Encryption.config.support_unencrypted_data == true`.
303
-
304
- ```ruby
305
- class User < ActiveRecord::Base
306
- encrypts :name, deterministic: true, support_unencrypted_data: false
307
- encrypts :email, deterministic: true
308
- end
309
- ```
310
-
311
- *Alex Ghiculescu*
312
-
313
- * Add instrumentation for Active Record transactions
314
-
315
- Allows subscribing to transaction events for tracking/instrumentation. The event payload contains the connection and the outcome (commit, rollback, restart, incomplete), as well as timing details.
316
-
317
- ```ruby
318
- ActiveSupport::Notifications.subscribe("transaction.active_record") do |event|
319
- puts "Transaction event occurred!"
320
- connection = event.payload[:connection]
321
- puts "Connection: #{connection.inspect}"
322
- end
323
- ```
324
-
325
- *Daniel Colson*, *Ian Candy*
326
-
327
- * Support composite foreign keys via migration helpers.
328
-
329
- ```ruby
330
- # Assuming "carts" table has "(shop_id, user_id)" as a primary key.
331
-
332
- add_foreign_key(:orders, :carts, primary_key: [:shop_id, :user_id])
333
-
334
- remove_foreign_key(:orders, :carts, primary_key: [:shop_id, :user_id])
335
- foreign_key_exists?(:orders, :carts, primary_key: [:shop_id, :user_id])
336
- ```
337
-
338
- *fatkodima*
339
-
340
- * Adds support for `if_not_exists` when adding a check constraint.
341
-
342
- ```ruby
343
- add_check_constraint :posts, "post_type IN ('blog', 'comment', 'share')", if_not_exists: true
344
- ```
345
-
346
- *Cody Cutrer*
347
-
348
- * Raise an `ArgumentError` when `#accepts_nested_attributes_for` is declared more than once for an association in
349
- the same class. Previously, the last declaration would silently override the previous one. Overriding in a subclass
350
- is still allowed.
351
-
352
- *Joshua Young*
353
-
354
- * Deprecate `rewhere` argument on `#merge`.
355
-
356
- The `rewhere` argument on `#merge`is deprecated without replacement and
357
- will be removed in Rails 7.2.
358
-
359
- *Adam Hess*
360
-
361
- * Deprecate aliasing non-attributes with `alias_attribute`.
362
-
363
- *Ian Candy*
364
-
365
- * Fix unscope is not working in specific case
366
-
367
- Before:
368
- ```ruby
369
- Post.where(id: 1...3).unscope(where: :id).to_sql # "SELECT `posts`.* FROM `posts` WHERE `posts`.`id` >= 1 AND `posts`.`id` < 3"
370
-
371
- ```
372
-
373
- After:
374
- ```ruby
375
- Post.where(id: 1...3).unscope(where: :id).to_sql # "SELECT `posts`.* FROM `posts`"
376
- ```
377
-
378
- Fixes #48094.
379
-
380
- *Kazuya Hatanaka*
381
-
382
- * Change `has_secure_token` default to `on: :initialize`
383
-
384
- Change the new default value from `on: :create` to `on: :initialize`
385
-
386
- Can be controlled by the `config.active_record.generate_secure_token_on`
387
- configuration:
388
-
389
- ```ruby
390
- config.active_record.generate_secure_token_on = :create
391
- ```
392
-
393
- *Sean Doyle*
394
-
395
- * Fix `change_column` not setting `precision: 6` on `datetime` columns when
396
- using 7.0+ Migrations and SQLite.
397
-
398
- *Hartley McGuire*
399
-
400
- * Support composite identifiers in `to_key`
401
-
402
- `to_key` avoids wrapping `#id` value into an `Array` if `#id` already an array
403
-
404
- *Nikita Vasilevsky*
405
-
406
- * Add validation option for `enum`
407
-
408
- ```ruby
409
- class Contract < ApplicationRecord
410
- enum :status, %w[in_progress completed], validate: true
411
- end
412
- Contract.new(status: "unknown").valid? # => false
413
- Contract.new(status: nil).valid? # => false
414
- Contract.new(status: "completed").valid? # => true
415
-
416
- class Contract < ApplicationRecord
417
- enum :status, %w[in_progress completed], validate: { allow_nil: true }
418
- end
419
- Contract.new(status: "unknown").valid? # => false
420
- Contract.new(status: nil).valid? # => true
421
- Contract.new(status: "completed").valid? # => true
422
- ```
423
-
424
- *Edem Topuzov*, *Ryuta Kamizono*
425
-
426
- * Allow batching methods to use already loaded relation if available
427
-
428
- Calling batch methods on already loaded relations will use the records previously loaded instead of retrieving
429
- them from the database again.
430
-
431
- *Adam Hess*
432
-
433
- * Deprecate `read_attribute(:id)` returning the primary key if the primary key is not `:id`.
434
-
435
- Starting in Rails 7.2, `read_attribute(:id)` will return the value of the id column, regardless of the model's
436
- primary key. To retrieve the value of the primary key, use `#id` instead. `read_attribute(:id)` for composite
437
- primary key models will now return the value of the id column.
438
-
439
- *Adrianna Chang*
440
-
441
- * Fix `change_table` setting datetime precision for 6.1 Migrations
442
-
443
- *Hartley McGuire*
444
-
445
- * Fix change_column setting datetime precision for 6.1 Migrations
446
-
447
- *Hartley McGuire*
448
-
449
- * Add `ActiveRecord::Base#id_value` alias to access the raw value of a record's id column.
450
-
451
- This alias is only provided for models that declare an `:id` column.
452
-
453
- *Adrianna Chang*
454
-
455
- * Fix previous change tracking for `ActiveRecord::Store` when using a column with JSON structured database type
456
-
457
- Before, the methods to access the changes made during the last save `#saved_change_to_key?`, `#saved_change_to_key`, and `#key_before_last_save` did not work if the store was defined as a `store_accessor` on a column with a JSON structured database type
458
-
459
- *Robert DiMartino*
460
-
461
- * Fully support `NULLS [NOT] DISTINCT` for PostgreSQL 15+ indexes.
462
-
463
- Previous work was done to allow the index to be created in a migration, but it was not
464
- supported in schema.rb. Additionally, the matching for `NULLS [NOT] DISTINCT` was not
465
- in the correct order, which could have resulted in inconsistent schema detection.
466
-
467
- *Gregory Jones*
468
-
469
- * Allow escaping of literal colon characters in `sanitize_sql_*` methods when named bind variables are used
470
-
471
- *Justin Bull*
472
-
473
- * Fix `#previously_new_record?` to return true for destroyed records.
474
-
475
- Before, if a record was created and then destroyed, `#previously_new_record?` would return true.
476
- Now, any UPDATE or DELETE to a record is considered a change, and will result in `#previously_new_record?`
477
- returning false.
478
-
479
- *Adrianna Chang*
480
-
481
- * Specify callback in `has_secure_token`
482
-
483
- ```ruby
484
- class User < ApplicationRecord
485
- has_secure_token on: :initialize
486
- end
487
-
488
- User.new.token # => "abc123...."
489
- ```
490
-
491
- *Sean Doyle*
492
-
493
- * Fix incrementation of in memory counter caches when associations overlap
494
-
495
- When two associations had a similarly named counter cache column, Active Record
496
- could sometime increment the wrong one.
497
-
498
- *Jacopo Beschi*, *Jean Boussier*
499
-
500
- * Don't show secrets for Active Record's `Cipher::Aes256Gcm#inspect`.
501
-
502
- Before:
503
-
504
- ```ruby
505
- ActiveRecord::Encryption::Cipher::Aes256Gcm.new(secret).inspect
506
- "#<ActiveRecord::Encryption::Cipher::Aes256Gcm:0x0000000104888038 ... @secret=\"\\xAF\\bFh]LV}q\\nl\\xB2U\\xB3 ... >"
507
- ```
508
-
509
- After:
510
-
511
- ```ruby
512
- ActiveRecord::Encryption::Cipher::Aes256Gcm(secret).inspect
513
- "#<ActiveRecord::Encryption::Cipher::Aes256Gcm:0x0000000104888038>"
514
- ```
515
-
516
- *Petrik de Heus*
517
-
518
- * Bring back the historical behavior of committing transaction on non-local return.
519
-
520
- ```ruby
521
- Model.transaction do
522
- model.save
523
- return
524
- other_model.save # not executed
525
- end
526
- ```
527
-
528
- Historically only raised errors would trigger a rollback, but in Ruby `2.3`, the `timeout` library
529
- started using `throw` to interrupt execution which had the adverse effect of committing open transactions.
530
-
531
- To solve this, in Active Record 6.1 the behavior was changed to instead rollback the transaction as it was safer
532
- than to potentially commit an incomplete transaction.
533
-
534
- Using `return`, `break` or `throw` inside a `transaction` block was essentially deprecated from Rails 6.1 onwards.
535
-
536
- However with the release of `timeout 0.4.0`, `Timeout.timeout` now raises an error again, and Active Record is able
537
- to return to its original, less surprising, behavior.
538
-
539
- This historical behavior can now be opt-ed in via:
540
-
541
- ```
542
- Rails.application.config.active_record.commit_transaction_on_non_local_return = true
543
- ```
544
-
545
- And is the default for new applications created in Rails 7.1.
546
-
547
- *Jean Boussier*
548
-
549
- * Deprecate `name` argument on `#remove_connection`.
550
-
551
- The `name` argument is deprecated on `#remove_connection` without replacement. `#remove_connection` should be called directly on the class that established the connection.
552
-
553
- *Eileen M. Uchitelle*
554
-
555
- * Fix has_one through singular building with inverse.
556
-
557
- Allows building of records from an association with a has_one through a
558
- singular association with inverse. For belongs_to through associations,
559
- linking the foreign key to the primary key model isn't needed.
560
- For has_one, we cannot build records due to the association not being mutable.
561
-
562
- *Gannon McGibbon*
563
-
564
- * Disable database prepared statements when query logs are enabled
565
-
566
- Prepared Statements and Query Logs are incompatible features due to query logs making every query unique.
567
-
568
- *zzak, Jean Boussier*
569
-
570
- * Support decrypting data encrypted non-deterministically with a SHA1 hash digest.
571
-
572
- This adds a new Active Record encryption option to support decrypting data encrypted
573
- non-deterministically with a SHA1 hash digest:
574
-
575
- ```
576
- Rails.application.config.active_record.encryption.support_sha1_for_non_deterministic_encryption = true
577
- ```
578
-
579
- The new option addresses a problem when upgrading from 7.0 to 7.1. Due to a bug in how Active Record
580
- Encryption was getting initialized, the key provider used for non-deterministic encryption were using
581
- SHA-1 as its digest class, instead of the one configured globally by Rails via
582
- `Rails.application.config.active_support.key_generator_hash_digest_class`.
583
-
584
- *Cadu Ribeiro and Jorge Manrubia*
585
-
586
- * Added PostgreSQL migration commands for enum rename, add value, and rename value.
587
-
588
- `rename_enum` and `rename_enum_value` are reversible. Due to Postgres
589
- limitation, `add_enum_value` is not reversible since you cannot delete enum
590
- values. As an alternative you should drop and recreate the enum entirely.
591
-
592
- ```ruby
593
- rename_enum :article_status, to: :article_state
594
- ```
595
-
596
- ```ruby
597
- add_enum_value :article_state, "archived" # will be at the end of existing values
598
- add_enum_value :article_state, "in review", before: "published"
599
- add_enum_value :article_state, "approved", after: "in review"
600
- ```
601
-
602
- ```ruby
603
- rename_enum_value :article_state, from: "archived", to: "deleted"
604
- ```
605
-
606
- *Ray Faddis*
607
-
608
- * Allow composite primary key to be derived from schema
609
-
610
- Booting an application with a schema that contains composite primary keys
611
- will not issue warning and won't `nil`ify the `ActiveRecord::Base#primary_key` value anymore.
612
-
613
- Given a `travel_routes` table definition and a `TravelRoute` model like:
614
- ```ruby
615
- create_table :travel_routes, primary_key: [:origin, :destination], force: true do |t|
616
- t.string :origin
617
- t.string :destination
618
- end
619
-
620
- class TravelRoute < ActiveRecord::Base; end
621
- ```
622
- The `TravelRoute.primary_key` value will be automatically derived to `["origin", "destination"]`
623
-
624
- *Nikita Vasilevsky*
625
-
626
- * Include the `connection_pool` with exceptions raised from an adapter.
627
-
628
- The `connection_pool` provides added context such as the connection used
629
- that led to the exception as well as which role and shard.
630
-
631
- *Luan Vieira*
632
-
633
- * Support multiple column ordering for `find_each`, `find_in_batches` and `in_batches`.
634
-
635
- When find_each/find_in_batches/in_batches are performed on a table with composite primary keys, ascending or descending order can be selected for each key.
636
-
637
- ```ruby
638
- Person.find_each(order: [:desc, :asc]) do |person|
639
- person.party_all_night!
640
- end
641
- ```
642
-
643
- *Takuya Kurimoto*
644
-
645
- * Fix where on association with has_one/has_many polymorphic relations.
646
-
647
- Before:
648
- ```ruby
649
- Treasure.where(price_estimates: PriceEstimate.all)
650
- #=> SELECT (...) WHERE "treasures"."id" IN (SELECT "price_estimates"."estimate_of_id" FROM "price_estimates")
651
- ```
652
-
653
- Later:
654
- ```ruby
655
- Treasure.where(price_estimates: PriceEstimate.all)
656
- #=> SELECT (...) WHERE "treasures"."id" IN (SELECT "price_estimates"."estimate_of_id" FROM "price_estimates" WHERE "price_estimates"."estimate_of_type" = 'Treasure')
657
- ```
658
-
659
- *Lázaro Nixon*
660
-
661
- * Assign auto populated columns on Active Record record creation.
662
-
663
- Changes record creation logic to allow for the `auto_increment` column to be assigned
664
- immediately after creation regardless of it's relation to the model's primary key.
665
-
666
- The PostgreSQL adapter benefits the most from the change allowing for any number of auto-populated
667
- columns to be assigned on the object immediately after row insertion utilizing the `RETURNING` statement.
668
-
669
- *Nikita Vasilevsky*
670
-
671
- * Use the first key in the `shards` hash from `connected_to` for the `default_shard`.
672
-
673
- Some applications may not want to use `:default` as a shard name in their connection model. Unfortunately Active Record expects there to be a `:default` shard because it must assume a shard to get the right connection from the pool manager. Rather than force applications to manually set this, `connects_to` can infer the default shard name from the hash of shards and will now assume that the first shard is your default.
674
-
675
- For example if your model looked like this:
676
-
677
- ```ruby
678
- class ShardRecord < ApplicationRecord
679
- self.abstract_class = true
680
-
681
- connects_to shards: {
682
- shard_one: { writing: :shard_one },
683
- shard_two: { writing: :shard_two }
684
- }
685
- ```
686
-
687
- Then the `default_shard` for this class would be set to `shard_one`.
688
-
689
- Fixes: #45390
690
-
691
- *Eileen M. Uchitelle*
692
-
693
- * Fix mutation detection for serialized attributes backed by binary columns.
694
-
695
- *Jean Boussier*
696
-
697
- * Add `ActiveRecord.disconnect_all!` method to immediately close all connections from all pools.
698
-
699
- *Jean Boussier*
700
-
701
- * Discard connections which may have been left in a transaction.
702
-
703
- There are cases where, due to an error, `within_new_transaction` may unexpectedly leave a connection in an open transaction. In these cases the connection may be reused, and the following may occur:
704
- - Writes appear to fail when they actually succeed.
705
- - Writes appear to succeed when they actually fail.
706
- - Reads return stale or uncommitted data.
707
-
708
- Previously, the following case was detected:
709
- - An error is encountered during the transaction, then another error is encountered while attempting to roll it back.
710
-
711
- Now, the following additional cases are detected:
712
- - An error is encountered just after successfully beginning a transaction.
713
- - An error is encountered while committing a transaction, then another error is encountered while attempting to roll it back.
714
- - An error is encountered while rolling back a transaction.
715
-
716
- *Nick Dower*
717
-
718
- * Active Record query cache now evicts least recently used entries
719
-
720
- By default it only keeps the `100` most recently used queries.
721
-
722
- The cache size can be configured via `database.yml`
723
-
724
- ```yaml
725
- development:
726
- adapter: mysql2
727
- query_cache: 200
728
- ```
729
-
730
- It can also be entirely disabled:
731
-
732
- ```yaml
733
- development:
734
- adapter: mysql2
735
- query_cache: false
736
- ```
737
-
738
- *Jean Boussier*
739
-
740
- * Deprecate `check_pending!` in favor of `check_all_pending!`.
741
-
742
- `check_pending!` will only check for pending migrations on the current database connection or the one passed in. This has been deprecated in favor of `check_all_pending!` which will find all pending migrations for the database configurations in a given environment.
743
-
744
- *Eileen M. Uchitelle*
745
-
746
- * Make `increment_counter`/`decrement_counter` accept an amount argument
747
-
748
- ```ruby
749
- Post.increment_counter(:comments_count, 5, by: 3)
750
- ```
751
-
752
- *fatkodima*
753
-
754
- * Add support for `Array#intersect?` to `ActiveRecord::Relation`.
755
-
756
- `Array#intersect?` is only available on Ruby 3.1 or later.
757
-
758
- This allows the Rubocop `Style/ArrayIntersect` cop to work with `ActiveRecord::Relation` objects.
759
-
760
- *John Harry Kelly*
761
-
762
- * The deferrable foreign key can be passed to `t.references`.
763
-
764
- *Hiroyuki Ishii*
765
-
766
- * Deprecate `deferrable: true` option of `add_foreign_key`.
767
-
768
- `deferrable: true` is deprecated in favor of `deferrable: :immediate`, and
769
- will be removed in Rails 7.2.
770
-
771
- Because `deferrable: true` and `deferrable: :deferred` are hard to understand.
772
- Both true and :deferred are truthy values.
773
- This behavior is the same as the deferrable option of the add_unique_key method, added in #46192.
774
-
775
- *Hiroyuki Ishii*
776
-
777
- * `AbstractAdapter#execute` and `#exec_query` now clear the query cache
778
-
779
- If you need to perform a read only SQL query without clearing the query
780
- cache, use `AbstractAdapter#select_all`.
781
-
782
- *Jean Boussier*
783
-
784
- * Make `.joins` / `.left_outer_joins` work with CTEs.
785
-
786
- For example:
787
-
788
- ```ruby
789
- Post
790
- .with(commented_posts: Comment.select(:post_id).distinct)
791
- .joins(:commented_posts)
792
- #=> WITH (...) SELECT ... INNER JOIN commented_posts on posts.id = commented_posts.post_id
793
- ```
794
-
795
- *Vladimir Dementyev*
796
-
797
- * Add a load hook for `ActiveRecord::ConnectionAdapters::Mysql2Adapter`
798
- (named `active_record_mysql2adapter`) to allow for overriding aspects of the
799
- `ActiveRecord::ConnectionAdapters::Mysql2Adapter` class. This makes `Mysql2Adapter`
800
- consistent with `PostgreSQLAdapter` and `SQLite3Adapter` that already have load hooks.
801
-
802
- *fatkodima*
803
-
804
- * Introduce adapter for Trilogy database client
805
-
806
- Trilogy is a MySQL-compatible database client. Rails applications can use Trilogy
807
- by configuring their `config/database.yml`:
808
-
809
- ```yaml
810
- development:
811
- adapter: trilogy
812
- database: blog_development
813
- pool: 5
814
- ```
815
-
816
- Or by using the `DATABASE_URL` environment variable:
817
-
818
- ```ruby
819
- ENV['DATABASE_URL'] # => "trilogy://localhost/blog_development?pool=5"
820
- ```
821
-
822
- *Adrianna Chang*
823
-
824
- * `after_commit` callbacks defined on models now execute in the correct order.
825
-
826
- ```ruby
827
- class User < ActiveRecord::Base
828
- after_commit { puts("this gets called first") }
829
- after_commit { puts("this gets called second") }
830
- end
831
- ```
832
-
833
- Previously, the callbacks executed in the reverse order. To opt in to the new behaviour:
834
-
835
- ```ruby
836
- config.active_record.run_after_transaction_callbacks_in_order_defined = true
837
- ```
838
-
839
- This is the default for new apps.
840
-
841
- *Alex Ghiculescu*
842
-
843
- * Infer `foreign_key` when `inverse_of` is present on `has_one` and `has_many` associations.
844
-
845
- ```ruby
846
- has_many :citations, foreign_key: "book1_id", inverse_of: :book
847
- ```
848
-
849
- can be simplified to
850
-
851
- ```ruby
852
- has_many :citations, inverse_of: :book
853
- ```
854
-
855
- and the foreign_key will be read from the corresponding `belongs_to` association.
856
-
857
- *Daniel Whitney*
858
-
859
- * Limit max length of auto generated index names
860
-
861
- Auto generated index names are now limited to 62 bytes, which fits within
862
- the default index name length limits for MySQL, Postgres and SQLite.
863
-
864
- Any index name over the limit will fallback to the new short format.
865
-
866
- Before (too long):
867
- ```
868
- index_testings_on_foo_and_bar_and_first_name_and_last_name_and_administrator
869
- ```
870
-
871
- After (short format):
872
- ```
873
- idx_on_foo_bar_first_name_last_name_administrator_5939248142
874
- ```
875
-
876
- The short format includes a hash to ensure the name is unique database-wide.
877
-
878
- *Mike Coutermarsh*
879
-
880
- * Introduce a more stable and optimized Marshal serializer for Active Record models.
881
-
882
- Can be enabled with `config.active_record.marshalling_format_version = 7.1`.
883
-
884
- *Jean Boussier*
885
-
886
- * Allow specifying where clauses with column-tuple syntax.
887
-
888
- Querying through `#where` now accepts a new tuple-syntax which accepts, as
889
- a key, an array of columns and, as a value, an array of corresponding tuples.
890
- The key specifies a list of columns, while the value is an array of
891
- ordered-tuples that conform to the column list.
892
-
893
- For instance:
894
-
895
- ```ruby
896
- # Cpk::Book => Cpk::Book(author_id: integer, number: integer, title: string, revision: integer)
897
- # Cpk::Book.primary_key => ["author_id", "number"]
898
-
899
- book = Cpk::Book.create!(author_id: 1, number: 1)
900
- Cpk::Book.where(Cpk::Book.primary_key => [[1, 2]]) # => [book]
901
-
902
- # Topic => Topic(id: integer, title: string, author_name: string...)
903
-
904
- Topic.where([:title, :author_name] => [["The Alchemist", "Paulo Coelho"], ["Harry Potter", "J.K Rowling"]])
905
- ```
906
-
907
- *Paarth Madan*
908
-
909
- * Allow warning codes to be ignore when reporting SQL warnings.
910
-
911
- Active Record config that can ignore warning codes
912
-
913
- ```ruby
914
- # Configure allowlist of warnings that should always be ignored
915
- config.active_record.db_warnings_ignore = [
916
- "1062", # MySQL Error 1062: Duplicate entry
917
- ]
918
- ```
919
-
920
- This is supported for the MySQL and PostgreSQL adapters.
921
-
922
- *Nick Borromeo*
923
-
924
- * Introduce `:active_record_fixtures` lazy load hook.
925
-
926
- Hooks defined with this name will be run whenever `TestFixtures` is included
927
- in a class.
928
-
929
- ```ruby
930
- ActiveSupport.on_load(:active_record_fixtures) do
931
- self.fixture_paths << "test/fixtures"
932
- end
933
-
934
- klass = Class.new
935
- klass.include(ActiveRecord::TestFixtures)
936
-
937
- klass.fixture_paths # => ["test/fixtures"]
938
- ```
8
+ * Fix support for `query_cache: false` in `database.yml`.
939
9
 
940
- *Andrew Novoselac*
10
+ `query_cache: false` would no longer entirely disable the Active Record query cache.
941
11
 
942
- * Introduce `TestFixtures#fixture_paths`.
12
+ *zzak*
943
13
 
944
- Multiple fixture paths can now be specified using the `#fixture_paths` accessor.
945
- Apps will continue to have `test/fixtures` as their one fixture path by default,
946
- but additional fixture paths can be specified.
14
+ * Set `.attributes_for_inspect` to `:all` by default.
947
15
 
948
- ```ruby
949
- ActiveSupport::TestCase.fixture_paths << "component1/test/fixtures"
950
- ActiveSupport::TestCase.fixture_paths << "component2/test/fixtures"
951
- ```
16
+ For new applications it is set to `[:id]` in config/environment/production.rb.
952
17
 
953
- `TestFixtures#fixture_path` is now deprecated.
18
+ In the console all the attributes are always shown.
954
19
 
955
20
  *Andrew Novoselac*
956
21
 
957
- * Adds support for deferrable exclude constraints in PostgreSQL.
958
-
959
- By default, exclude constraints in PostgreSQL are checked after each statement.
960
- This works for most use cases, but becomes a major limitation when replacing
961
- records with overlapping ranges by using multiple statements.
22
+ * `PG::UnableToSend: no connection to the server` is now retryable as a connection-related exception
962
23
 
963
- ```ruby
964
- exclusion_constraint :users, "daterange(valid_from, valid_to) WITH &&", deferrable: :immediate
965
- ```
24
+ *Kazuma Watanabe*
966
25
 
967
- Passing `deferrable: :immediate` checks constraint after each statement,
968
- but allows manually deferring the check using `SET CONSTRAINTS ALL DEFERRED`
969
- within a transaction. This will cause the excludes to be checked after the transaction.
26
+ * Fix marshalling of unsaved associated records in 7.1 format.
970
27
 
971
- It's also possible to change the default behavior from an immediate check
972
- (after the statement), to a deferred check (after the transaction):
973
-
974
- ```ruby
975
- exclusion_constraint :users, "daterange(valid_from, valid_to) WITH &&", deferrable: :deferred
976
- ```
28
+ The 7.1 format would only marshal associated records if the association was loaded.
29
+ But associations that would only contain unsaved records would be skipped.
977
30
 
978
- *Hiroyuki Ishii*
31
+ *Jean Boussier*
979
32
 
980
- * Respect `foreign_type` option to `delegated_type` for `{role}_class` method.
33
+ * Fix incorrect SQL query when passing an empty hash to `ActiveRecord::Base.insert`.
981
34
 
982
- Usage of `delegated_type` with non-conventional `{role}_type` column names can now be specified with `foreign_type` option.
983
- This option is the same as `foreign_type` as forwarded to the underlying `belongs_to` association that `delegated_type` wraps.
35
+ *David Stosik*
984
36
 
985
- *Jason Karns*
37
+ * Allow to save records with polymorphic join tables that have `inverse_of`
38
+ specified.
986
39
 
987
- * Add support for unique constraints (PostgreSQL-only).
40
+ *Markus Doits*
988
41
 
989
- ```ruby
990
- add_unique_key :sections, [:position], deferrable: :deferred, name: "unique_section_position"
991
- remove_unique_key :sections, name: "unique_section_position"
992
- ```
42
+ * Fix association scopes applying on the incorrect join when using a polymorphic `has_many through:`.
993
43
 
994
- See PostgreSQL's [Unique Constraints](https://www.postgresql.org/docs/current/ddl-constraints.html#DDL-CONSTRAINTS-UNIQUE-CONSTRAINTS) documentation for more on unique constraints.
44
+ *Joshua Young*
995
45
 
996
- By default, unique constraints in PostgreSQL are checked after each statement.
997
- This works for most use cases, but becomes a major limitation when replacing
998
- records with unique column by using multiple statements.
46
+ * Fix `dependent: :destroy` for bi-directional has one through association.
999
47
 
1000
- An example of swapping unique columns between records.
48
+ Fixes #50948.
1001
49
 
1002
50
  ```ruby
1003
- # position is unique column
1004
- old_item = Item.create!(position: 1)
1005
- new_item = Item.create!(position: 2)
1006
-
1007
- Item.transaction do
1008
- old_item.update!(position: 2)
1009
- new_item.update!(position: 1)
51
+ class Left < ActiveRecord::Base
52
+ has_one :middle, dependent: :destroy
53
+ has_one :right, through: :middle
1010
54
  end
1011
- ```
1012
-
1013
- Using the default behavior, the transaction would fail when executing the
1014
- first `UPDATE` statement.
1015
-
1016
- By passing the `:deferrable` option to the `add_unique_key` statement in
1017
- migrations, it's possible to defer this check.
1018
-
1019
- ```ruby
1020
- add_unique_key :items, [:position], deferrable: :immediate
1021
- ```
1022
-
1023
- Passing `deferrable: :immediate` does not change the behaviour of the previous example,
1024
- but allows manually deferring the check using `SET CONSTRAINTS ALL DEFERRED` within a transaction.
1025
- This will cause the unique constraints to be checked after the transaction.
1026
-
1027
- It's also possible to adjust the default behavior from an immediate
1028
- check (after the statement), to a deferred check (after the transaction):
1029
-
1030
- ```ruby
1031
- add_unique_key :items, [:position], deferrable: :deferred
1032
- ```
1033
-
1034
- If you want to change an existing unique index to deferrable, you can use :using_index
1035
- to create deferrable unique constraints.
1036
-
1037
- ```ruby
1038
- add_unique_key :items, deferrable: :deferred, using_index: "index_items_on_position"
1039
- ```
1040
-
1041
- *Hiroyuki Ishii*
1042
-
1043
- * Remove deprecated `Tasks::DatabaseTasks.schema_file_type`.
1044
-
1045
- *Rafael Mendonça França*
1046
-
1047
- * Remove deprecated `config.active_record.partial_writes`.
1048
-
1049
- *Rafael Mendonça França*
1050
-
1051
- * Remove deprecated `ActiveRecord::Base` config accessors.
1052
-
1053
- *Rafael Mendonça França*
1054
-
1055
- * Remove the `:include_replicas` argument from `configs_for`. Use `:include_hidden` argument instead.
1056
-
1057
- *Eileen M. Uchitelle*
1058
-
1059
- * Allow applications to lookup a config via a custom hash key.
1060
-
1061
- If you have registered a custom config or want to find configs where the hash matches a specific key, now you can pass `config_key` to `configs_for`. For example if you have a `db_config` with the key `vitess` you can look up a database configuration hash by matching that key.
1062
-
1063
- ```ruby
1064
- ActiveRecord::Base.configurations.configs_for(env_name: "development", name: "primary", config_key: :vitess)
1065
- ActiveRecord::Base.configurations.configs_for(env_name: "development", config_key: :vitess)
1066
- ```
1067
-
1068
- *Eileen M. Uchitelle*
1069
-
1070
- * Allow applications to register a custom database configuration handler.
1071
-
1072
- Adds a mechanism for registering a custom handler for cases where you want database configurations to respond to custom methods. This is useful for non-Rails database adapters or tools like Vitess that you may want to configure differently from a standard `HashConfig` or `UrlConfig`.
1073
-
1074
- Given the following database YAML we want the `animals` db to create a `CustomConfig` object instead while the `primary` database will be a `UrlConfig`:
1075
-
1076
- ```yaml
1077
- development:
1078
- primary:
1079
- url: postgres://localhost/primary
1080
- animals:
1081
- url: postgres://localhost/animals
1082
- custom_config:
1083
- sharded: 1
1084
- ```
1085
-
1086
- To register a custom handler first make a class that has your custom methods:
1087
-
1088
- ```ruby
1089
- class CustomConfig < ActiveRecord::DatabaseConfigurations::UrlConfig
1090
- def sharded?
1091
- custom_config.fetch("sharded", false)
1092
- end
1093
55
 
1094
- private
1095
- def custom_config
1096
- configuration_hash.fetch(:custom_config)
1097
- end
56
+ class Middle < ActiveRecord::Base
57
+ belongs_to :left, dependent: :destroy
58
+ belongs_to :right, dependent: :destroy
1098
59
  end
1099
- ```
1100
-
1101
- Then register the config in an initializer:
1102
60
 
1103
- ```ruby
1104
- ActiveRecord::DatabaseConfigurations.register_db_config_handler do |env_name, name, url, config|
1105
- next unless config.key?(:custom_config)
1106
- CustomConfig.new(env_name, name, url, config)
61
+ class Right < ActiveRecord::Base
62
+ has_one :middle, dependent: :destroy
63
+ has_one :left, through: :middle
1107
64
  end
1108
65
  ```
66
+ In the above example `left.destroy` wouldn't destroy its associated `Right`
67
+ record.
1109
68
 
1110
- When the application is booted, configuration hashes with the `:custom_config` key will be `CustomConfig` objects and respond to `sharded?`. Applications must handle the condition in which Active Record should use their custom handler.
1111
-
1112
- *Eileen M. Uchitelle and John Crepezzi*
1113
-
1114
- * `ActiveRecord::Base.serialize` no longer uses YAML by default.
1115
-
1116
- YAML isn't particularly performant and can lead to security issues
1117
- if not used carefully.
69
+ *Andy Stewart*
1118
70
 
1119
- Unfortunately there isn't really any good serializers in Ruby's stdlib
1120
- to replace it.
71
+ * Properly handle lazily pinned connection pools.
1121
72
 
1122
- The obvious choice would be JSON, which is a fine format for this use case,
1123
- however the JSON serializer in Ruby's stdlib isn't strict enough, as it fallback
1124
- to casting unknown types to strings, which could lead to corrupted data.
73
+ Fixes #53147.
1125
74
 
1126
- Some third party JSON libraries like `Oj` have a suitable strict mode.
1127
-
1128
- So it's preferable that users choose a serializer based on their own constraints.
1129
-
1130
- The original default can be restored by setting `config.active_record.default_column_serializer = YAML`.
75
+ When using transactional fixtures with system tests to similar tools
76
+ such as capybara, it could happen that a connection end up pinned by the
77
+ server thread rather than the test thread, causing
78
+ `"Cannot expire connection, it is owned by a different thread"` errors.
1131
79
 
1132
80
  *Jean Boussier*
1133
81
 
1134
- * `ActiveRecord::Base.serialize` signature changed.
1135
-
1136
- Rather than a single positional argument that accepts two possible
1137
- types of values, `serialize` now accepts two distinct keyword arguments.
1138
-
1139
- Before:
1140
-
1141
- ```ruby
1142
- serialize :content, JSON
1143
- serialize :backtrace, Array
1144
- ```
82
+ * Fix `ActiveRecord::Base.with` to accept more than two sub queries.
1145
83
 
1146
- After:
84
+ Fixes #53110.
1147
85
 
1148
86
  ```ruby
1149
- serialize :content, coder: JSON
1150
- serialize :backtrace, type: Array
87
+ User.with(foo: [User.select(:id), User.select(:id), User.select(:id)]).to_sql
88
+ undefined method `union' for an instance of Arel::Nodes::UnionAll (NoMethodError)
1151
89
  ```
1152
90
 
1153
- *Jean Boussier*
1154
-
1155
- * YAML columns use `YAML.safe_dump` if available.
1156
-
1157
- As of `psych 5.1.0`, `YAML.safe_dump` can now apply the same permitted
1158
- types restrictions than `YAML.safe_load`.
91
+ The above now works as expected.
1159
92
 
1160
- It's preferable to ensure the payload only use allowed types when we first
1161
- try to serialize it, otherwise you may end up with invalid records in the
1162
- database.
1163
-
1164
- *Jean Boussier*
93
+ *fatkodima*
1165
94
 
1166
- * `ActiveRecord::QueryLogs` better handle broken encoding.
95
+ * Properly release pinned connections with non joinable connections.
1167
96
 
1168
- It's not uncommon when building queries with BLOB fields to contain
1169
- binary data. Unless the call carefully encode the string in ASCII-8BIT
1170
- it generally end up being encoded in `UTF-8`, and `QueryLogs` would
1171
- end up failing on it.
97
+ Fixes #52973
1172
98
 
1173
- `ActiveRecord::QueryLogs` no longer depend on the query to be properly encoded.
99
+ When running system tests with transactional fixtures on, it could happen that
100
+ the connection leased by the Puma thread wouldn't be properly released back to the pool,
101
+ causing "Cannot expire connection, it is owned by a different thread" errors in later tests.
1174
102
 
1175
103
  *Jean Boussier*
1176
104
 
1177
- * Fix a bug where `ActiveRecord::Generators::ModelGenerator` would not respect create_table_migration template overrides.
1178
-
1179
- ```
1180
- rails g model create_books title:string content:text
1181
- ```
1182
- will now read from the create_table_migration.rb.tt template in the following locations in order:
1183
- ```
1184
- lib/templates/active_record/model/create_table_migration.rb
1185
- lib/templates/active_record/migration/create_table_migration.rb
1186
- ```
1187
-
1188
- *Spencer Neste*
1189
-
1190
- * `ActiveRecord::Relation#explain` now accepts options.
1191
-
1192
- For databases and adapters which support them (currently PostgreSQL
1193
- and MySQL), options can be passed to `explain` to provide more
1194
- detailed query plan analysis:
1195
-
1196
- ```ruby
1197
- Customer.where(id: 1).joins(:orders).explain(:analyze, :verbose)
1198
- ```
1199
-
1200
- *Reid Lynch*
1201
-
1202
- * Multiple `Arel::Nodes::SqlLiteral` nodes can now be added together to
1203
- form `Arel::Nodes::Fragments` nodes. This allows joining several pieces
1204
- of SQL.
1205
-
1206
- *Matthew Draper*, *Ole Friis*
1207
-
1208
- * `ActiveRecord::Base#signed_id` raises if called on a new record.
1209
-
1210
- Previously it would return an ID that was not usable, since it was based on `id = nil`.
1211
-
1212
- *Alex Ghiculescu*
1213
-
1214
- * Allow SQL warnings to be reported.
1215
-
1216
- Active Record configs can be set to enable SQL warning reporting.
1217
-
1218
- ```ruby
1219
- # Configure action to take when SQL query produces warning
1220
- config.active_record.db_warnings_action = :raise
1221
-
1222
- # Configure allowlist of warnings that should always be ignored
1223
- config.active_record.db_warnings_ignore = [
1224
- /Invalid utf8mb4 character string/,
1225
- "An exact warning message",
1226
- ]
1227
- ```
1228
-
1229
- This is supported for the MySQL and PostgreSQL adapters.
1230
-
1231
- *Adrianna Chang*, *Paarth Madan*
1232
-
1233
- * Add `#regroup` query method as a short-hand for `.unscope(:group).group(fields)`
1234
-
1235
- Example:
1236
-
1237
- ```ruby
1238
- Post.group(:title).regroup(:author)
1239
- # SELECT `posts`.`*` FROM `posts` GROUP BY `posts`.`author`
1240
- ```
1241
-
1242
- *Danielius Visockas*
1243
-
1244
- * PostgreSQL adapter method `enable_extension` now allows parameter to be `[schema_name.]<extension_name>`
1245
- if the extension must be installed on another schema.
1246
-
1247
- Example: `enable_extension('heroku_ext.hstore')`
1248
-
1249
- *Leonardo Luarte*
1250
-
1251
- * Add `:include` option to `add_index`.
1252
-
1253
- Add support for including non-key columns in indexes for PostgreSQL
1254
- with the `INCLUDE` parameter.
1255
-
1256
- ```ruby
1257
- add_index(:users, :email, include: [:id, :created_at])
1258
- ```
1259
-
1260
- will result in:
1261
-
1262
- ```sql
1263
- CREATE INDEX index_users_on_email USING btree (email) INCLUDE (id, created_at)
1264
- ```
1265
-
1266
- *Steve Abrams*
105
+ * Make Float distinguish between `float4` and `float8` in PostgreSQL.
1267
106
 
1268
- * `ActiveRecord::Relation`’s `#any?`, `#none?`, and `#one?` methods take an optional pattern
1269
- argument, more closely matching their `Enumerable` equivalents.
107
+ Fixes #52742
1270
108
 
1271
- *George Claghorn*
109
+ *Ryota Kitazawa*, *Takayuki Nagatomi*
1272
110
 
1273
- * Add `ActiveRecord::Base.normalizes` for declaring attribute normalizations.
111
+ * Fix an issue where `.left_outer_joins` used with multiple associations that have
112
+ the same child association but different parents does not join all parents.
1274
113
 
1275
- An attribute normalization is applied when the attribute is assigned or
1276
- updated, and the normalized value will be persisted to the database. The
1277
- normalization is also applied to the corresponding keyword argument of query
1278
- methods, allowing records to be queried using unnormalized values.
114
+ Previously, using `.left_outer_joins` with the same child association would only join one of the parents.
1279
115
 
1280
- For example:
116
+ Now it will correctly join both parents.
1281
117
 
1282
- ```ruby
1283
- class User < ActiveRecord::Base
1284
- normalizes :email, with: -> email { email.strip.downcase }
1285
- normalizes :phone, with: -> phone { phone.delete("^0-9").delete_prefix("1") }
1286
- end
1287
-
1288
- user = User.create(email: " CRUISE-CONTROL@EXAMPLE.COM\n")
1289
- user.email # => "cruise-control@example.com"
1290
-
1291
- user = User.find_by(email: "\tCRUISE-CONTROL@EXAMPLE.COM ")
1292
- user.email # => "cruise-control@example.com"
1293
- user.email_before_type_cast # => "cruise-control@example.com"
1294
-
1295
- User.where(email: "\tCRUISE-CONTROL@EXAMPLE.COM ").count # => 1
1296
- User.where(["email = ?", "\tCRUISE-CONTROL@EXAMPLE.COM "]).count # => 0
1297
-
1298
- User.exists?(email: "\tCRUISE-CONTROL@EXAMPLE.COM ") # => true
1299
- User.exists?(["email = ?", "\tCRUISE-CONTROL@EXAMPLE.COM "]) # => false
1300
-
1301
- User.normalize_value_for(:phone, "+1 (555) 867-5309") # => "5558675309"
1302
- ```
1303
-
1304
- *Jonathan Hefner*
1305
-
1306
- * Hide changes to before_committed! callback behaviour behind flag.
1307
-
1308
- In #46525, behavior around before_committed! callbacks was changed so that callbacks
1309
- would run on every enrolled record in a transaction, not just the first copy of a record.
1310
- This change in behavior is now controlled by a configuration option,
1311
- `config.active_record.before_committed_on_all_records`. It will be enabled by default on Rails 7.1.
1312
-
1313
- *Adrianna Chang*
1314
-
1315
- * The `namespaced_controller` Query Log tag now matches the `controller` format
1316
-
1317
- For example, a request processed by `NameSpaced::UsersController` will now log as:
1318
-
1319
- ```
1320
- :controller # "users"
1321
- :namespaced_controller # "name_spaced/users"
1322
- ```
1323
-
1324
- *Alex Ghiculescu*
1325
-
1326
- * Return only unique ids from ActiveRecord::Calculations#ids
1327
-
1328
- Updated ActiveRecord::Calculations#ids to only return the unique ids of the base model
1329
- when using eager_load, preload and includes.
1330
-
1331
- ```ruby
1332
- Post.find_by(id: 1).comments.count
1333
- # => 5
1334
- Post.includes(:comments).where(id: 1).pluck(:id)
1335
- # => [1, 1, 1, 1, 1]
1336
- Post.includes(:comments).where(id: 1).ids
1337
- # => [1]
1338
- ```
1339
-
1340
- *Joshua Young*
1341
-
1342
- * Stop using `LOWER()` for case-insensitive queries on `citext` columns
1343
-
1344
- Previously, `LOWER()` was added for e.g. uniqueness validations with
1345
- `case_sensitive: false`.
1346
- It wasn't mentioned in the documentation that the index without `LOWER()`
1347
- wouldn't be used in this case.
1348
-
1349
- *Phil Pirozhkov*
1350
-
1351
- * Extract `#sync_timezone_changes` method in AbstractMysqlAdapter to enable subclasses
1352
- to sync database timezone changes without overriding `#raw_execute`.
1353
-
1354
- *Adrianna Chang*, *Paarth Madan*
1355
-
1356
- * Do not write additional new lines when dumping sql migration versions
1357
-
1358
- This change updates the `insert_versions_sql` function so that the database insert string containing the current database migration versions does not end with two additional new lines.
1359
-
1360
- *Misha Schwartz*
118
+ Fixes #41498.
1361
119
 
1362
- * Fix `composed_of` value freezing and duplication.
120
+ *Garrett Blehm*
1363
121
 
1364
- Previously composite values exhibited two confusing behaviors:
122
+ * Ensure `ActiveRecord::Encryption.config` is always ready before access.
1365
123
 
1366
- - When reading a compositve value it'd _NOT_ be frozen, allowing it to get out of sync with its underlying database
1367
- columns.
1368
- - When writing a compositve value the argument would be frozen, potentially confusing the caller.
124
+ Previously, `ActiveRecord::Encryption` configuration was deferred until `ActiveRecord::Base`
125
+ was loaded. Therefore, accessing `ActiveRecord::Encryption.config` properties before
126
+ `ActiveRecord::Base` was loaded would give incorrect results.
1369
127
 
1370
- Currently, composite values instantiated based on database columns are frozen (addressing the first issue) and
1371
- assigned compositve values are duplicated and the duplicate is frozen (addressing the second issue).
128
+ `ActiveRecord::Encryption` now has its own loading hook so that its configuration is set as
129
+ soon as needed.
1372
130
 
1373
- *Greg Navis*
131
+ When `ActiveRecord::Base` is loaded, even lazily, it in turn triggers the loading of
132
+ `ActiveRecord::Encryption`, thus preserving the original behavior of having its config ready
133
+ before any use of `ActiveRecord::Base`.
1374
134
 
1375
- * Fix redundant updates to the column insensitivity cache
1376
-
1377
- Fixed redundant queries checking column capability for insensitive
1378
- comparison.
1379
-
1380
- *Phil Pirozhkov*
1381
-
1382
- * Allow disabling methods generated by `ActiveRecord.enum`.
1383
-
1384
- *Alfred Dominic*
1385
-
1386
- * Avoid validating `belongs_to` association if it has not changed.
1387
-
1388
- Previously, when updating a record, Active Record will perform an extra query to check for the presence of
1389
- `belongs_to` associations (if the presence is configured to be mandatory), even if that attribute hasn't changed.
1390
-
1391
- Currently, only `belongs_to`-related columns are checked for presence. It is possible to have orphaned records with
1392
- this approach. To avoid this problem, you need to use a foreign key.
1393
-
1394
- This behavior can be controlled by configuration:
1395
-
1396
- ```ruby
1397
- config.active_record.belongs_to_required_validates_foreign_key = false
1398
- ```
1399
-
1400
- and will be disabled by default with `config.load_defaults 7.1`.
1401
-
1402
- *fatkodima*
1403
-
1404
- * `has_one` and `belongs_to` associations now define a `reset_association` method
1405
- on the owner model (where `association` is the name of the association). This
1406
- method unloads the cached associate record, if any, and causes the next access
1407
- to query it from the database.
1408
-
1409
- *George Claghorn*
1410
-
1411
- * Allow per attribute setting of YAML permitted classes (safe load) and unsafe load.
1412
-
1413
- *Carlos Palhares*
1414
-
1415
- * Add a build persistence method
1416
-
1417
- Provides a wrapper for `new`, to provide feature parity with `create`s
1418
- ability to create multiple records from an array of hashes, using the
1419
- same notation as the `build` method on associations.
1420
-
1421
- *Sean Denny*
1422
-
1423
- * Raise on assignment to readonly attributes
1424
-
1425
- ```ruby
1426
- class Post < ActiveRecord::Base
1427
- attr_readonly :content
1428
- end
1429
- Post.create!(content: "cannot be updated")
1430
- post.content # "cannot be updated"
1431
- post.content = "something else" # => ActiveRecord::ReadonlyAttributeError
1432
- ```
1433
-
1434
- Previously, assignment would succeed but silently not write to the database.
1435
-
1436
- This behavior can be controlled by configuration:
1437
-
1438
- ```ruby
1439
- config.active_record.raise_on_assign_to_attr_readonly = true
1440
- ```
135
+ *Maxime Réty*
1441
136
 
1442
- and will be enabled by default with `config.load_defaults 7.1`.
137
+ * Add `TimeZoneConverter#==` method, so objects will be properly compared by
138
+ their type, scale, limit & precision.
1443
139
 
1444
- *Alex Ghiculescu*, *Hartley McGuire*
140
+ Address #52699.
1445
141
 
1446
- * Allow unscoping of preload and eager_load associations
142
+ *Ruy Rocha*
1447
143
 
1448
- Added the ability to unscope preload and eager_load associations just like
1449
- includes, joins, etc. See ActiveRecord::QueryMethods::VALID_UNSCOPING_VALUES
1450
- for the full list of supported unscopable scopes.
1451
144
 
1452
- ```ruby
1453
- query.unscope(:eager_load, :preload).group(:id).select(:id)
1454
- ```
145
+ ## Rails 7.2.1.2 (October 23, 2024) ##
1455
146
 
1456
- *David Morehouse*
147
+ * No changes.
1457
148
 
1458
- * Add automatic filtering of encrypted attributes on inspect
1459
149
 
1460
- This feature is enabled by default but can be disabled with
150
+ ## Rails 7.2.1.1 (October 15, 2024) ##
1461
151
 
1462
- ```ruby
1463
- config.active_record.encryption.add_to_filter_parameters = false
1464
- ```
152
+ * No changes.
1465
153
 
1466
- *Hartley McGuire*
1467
154
 
1468
- * Clear locking column on #dup
155
+ ## Rails 7.2.1 (August 22, 2024) ##
1469
156
 
1470
- This change fixes not to duplicate locking_column like id and timestamps.
157
+ * Fix detection for `enum` columns with parallelized tests and PostgreSQL.
1471
158
 
1472
- ```
1473
- car = Car.create!
1474
- car.touch
1475
- car.lock_version #=> 1
1476
- car.dup.lock_version #=> 0
1477
- ```
159
+ *Rafael Mendonça França*
1478
160
 
1479
- *Shouichi Kamiya*, *Seonggi Yang*, *Ryohei UEDA*
161
+ * Allow to eager load nested nil associations.
1480
162
 
1481
- * Invalidate transaction as early as possible
163
+ *fatkodima*
1482
164
 
1483
- After rescuing a `TransactionRollbackError` exception Rails invalidates transactions earlier in the flow
1484
- allowing the framework to skip issuing the `ROLLBACK` statement in more cases.
1485
- Only affects adapters that have `savepoint_errors_invalidate_transactions?` configured as `true`,
1486
- which at this point is only applicable to the `mysql2` adapter.
165
+ * Fix swallowing ignore order warning when batching using `BatchEnumerator`.
1487
166
 
1488
- *Nikita Vasilevsky*
167
+ *fatkodima*
1489
168
 
1490
- * Allow configuring columns list to be used in SQL queries issued by an `ActiveRecord::Base` object
169
+ * Fix memory bloat on the connection pool when using the Fiber `IsolatedExecutionState`.
1491
170
 
1492
- It is now possible to configure columns list that will be used to build an SQL query clauses when
1493
- updating, deleting or reloading an `ActiveRecord::Base` object
171
+ *Jean Boussier*
1494
172
 
1495
- ```ruby
1496
- class Developer < ActiveRecord::Base
1497
- query_constraints :company_id, :id
1498
- end
1499
- developer = Developer.first.update(name: "Bob")
1500
- # => UPDATE "developers" SET "name" = 'Bob' WHERE "developers"."company_id" = 1 AND "developers"."id" = 1
1501
- ```
173
+ * Restore inferred association class with the same modularized name.
1502
174
 
1503
- *Nikita Vasilevsky*
175
+ *Justin Ko*
1504
176
 
1505
- * Adds `validate` to foreign keys and check constraints in schema.rb
177
+ * Fix `ActiveRecord::Base.inspect` to properly explain how to load schema information.
1506
178
 
1507
- Previously, `schema.rb` would not record if `validate: false` had been used when adding a foreign key or check
1508
- constraint, so restoring a database from the schema could result in foreign keys or check constraints being
1509
- incorrectly validated.
179
+ *Jean Boussier*
1510
180
 
1511
- *Tommy Graves*
181
+ * Check invalid `enum` options for the new syntax.
1512
182
 
1513
- * Adapter `#execute` methods now accept an `allow_retry` option. When set to `true`, the SQL statement will be
1514
- retried, up to the database's configured `connection_retries` value, upon encountering connection-related errors.
183
+ The options using `_` prefix in the old syntax are invalid in the new syntax.
1515
184
 
1516
- *Adrianna Chang*
185
+ *Rafael Mendonça França*
186
+
187
+ * Fix `ActiveRecord::Encryption::EncryptedAttributeType#type` to return
188
+ actual cast type.
1517
189
 
1518
- * Only trigger `after_commit :destroy` callbacks when a database row is deleted.
190
+ *Vasiliy Ermolovich*
1519
191
 
1520
- This prevents `after_commit :destroy` callbacks from being triggered again
1521
- when `destroy` is called multiple times on the same record.
192
+ * Fix `create_table` with `:auto_increment` option for MySQL adapter.
1522
193
 
1523
- *Ben Sheldon*
194
+ *fatkodima*
1524
195
 
1525
- * Fix `ciphertext_for` for yet-to-be-encrypted values.
1526
196
 
1527
- Previously, `ciphertext_for` returned the cleartext of values that had not
1528
- yet been encrypted, such as with an unpersisted record:
197
+ ## Rails 7.2.0 (August 09, 2024) ##
1529
198
 
1530
- ```ruby
1531
- Post.encrypts :body
199
+ * Handle commas in Sqlite3 default function definitions.
1532
200
 
1533
- post = Post.create!(body: "Hello")
1534
- post.ciphertext_for(:body)
1535
- # => "{\"p\":\"abc..."
201
+ *Stephen Margheim*
1536
202
 
1537
- post.body = "World"
1538
- post.ciphertext_for(:body)
1539
- # => "World"
1540
- ```
203
+ * Fixes `validates_associated` raising an exception when configured with a
204
+ singular association and having `index_nested_attribute_errors` enabled.
1541
205
 
1542
- Now, `ciphertext_for` will always return the ciphertext of encrypted
1543
- attributes:
206
+ *Martin Spickermann*
1544
207
 
1545
- ```ruby
1546
- Post.encrypts :body
208
+ * The constant `ActiveRecord::ImmutableRelation` has been deprecated because
209
+ we want to reserve that name for a stronger sense of "immutable relation".
210
+ Please use `ActiveRecord::UnmodifiableRelation` instead.
1547
211
 
1548
- post = Post.create!(body: "Hello")
1549
- post.ciphertext_for(:body)
1550
- # => "{\"p\":\"abc..."
212
+ *Xavier Noria*
1551
213
 
1552
- post.body = "World"
1553
- post.ciphertext_for(:body)
1554
- # => "{\"p\":\"xyz..."
1555
- ```
214
+ * Add condensed `#inspect` for `ConnectionPool`, `AbstractAdapter`, and
215
+ `DatabaseConfig`.
1556
216
 
1557
- *Jonathan Hefner*
217
+ *Hartley McGuire*
1558
218
 
1559
- * Fix a bug where using groups and counts with long table names would return incorrect results.
219
+ * Fixed a memory performance issue in Active Record attribute methods definition.
1560
220
 
1561
- *Shota Toguchi*, *Yusaku Ono*
221
+ *Jean Boussier*
1562
222
 
1563
- * Fix encryption of column default values.
223
+ * Define the new Active Support notification event `start_transaction.active_record`.
1564
224
 
1565
- Previously, encrypted attributes that used column default values appeared to
1566
- be encrypted on create, but were not:
225
+ This event is fired when database transactions or savepoints start, and
226
+ complements `transaction.active_record`, which is emitted when they finish.
1567
227
 
1568
- ```ruby
1569
- Book.encrypts :name
228
+ The payload has the transaction (`:transaction`) and the connection (`:connection`).
1570
229
 
1571
- book = Book.create!
1572
- book.name
1573
- # => "<untitled>"
1574
- book.name_before_type_cast
1575
- # => "{\"p\":\"abc..."
1576
- book.reload.name_before_type_cast
1577
- # => "<untitled>"
1578
- ```
230
+ *Xavier Noria*
1579
231
 
1580
- Now, attributes with column default values are encrypted:
232
+ * Fix an issue where the IDs reader method did not return expected results
233
+ for preloaded associations in models using composite primary keys.
1581
234
 
1582
- ```ruby
1583
- Book.encrypts :name
235
+ *Jay Ang*
1584
236
 
1585
- book = Book.create!
1586
- book.name
1587
- # => "<untitled>"
1588
- book.name_before_type_cast
1589
- # => "{\"p\":\"abc..."
1590
- book.reload.name_before_type_cast
1591
- # => "{\"p\":\"abc..."
1592
- ```
237
+ * The payload of `sql.active_record` Active Support notifications now has the current transaction in the `:transaction` key.
1593
238
 
1594
- *Jonathan Hefner*
239
+ *Xavier Noria*
1595
240
 
1596
- * Deprecate delegation from `Base` to `connection_handler`.
241
+ * The payload of `transaction.active_record` Active Support notifications now has the transaction the event is related to in the `:transaction` key.
1597
242
 
1598
- Calling `Base.clear_all_connections!`, `Base.clear_active_connections!`, `Base.clear_reloadable_connections!` and `Base.flush_idle_connections!` is deprecated. Please call these methods on the connection handler directly. In future Rails versions, the delegation from `Base` to the `connection_handler` will be removed.
243
+ *Xavier Noria*
1599
244
 
1600
- *Eileen M. Uchitelle*
245
+ * Define `ActiveRecord::Transaction#uuid`, which returns a UUID for the database transaction. This may be helpful when tracing database activity. These UUIDs are generated only on demand.
1601
246
 
1602
- * Allow ActiveRecord::QueryMethods#reselect to receive hash values, similar to ActiveRecord::QueryMethods#select
247
+ *Xavier Noria*
1603
248
 
1604
- *Sampat Badhe*
249
+ * Fix inference of association model on nested models with the same demodularized name.
1605
250
 
1606
- * Validate options when managing columns and tables in migrations.
251
+ E.g. with the following setup:
1607
252
 
1608
- If an invalid option is passed to a migration method like `create_table` and `add_column`, an error will be raised
1609
- instead of the option being silently ignored. Validation of the options will only be applied for new migrations
1610
- that are created.
253
+ ```ruby
254
+ class Nested::Post < ApplicationRecord
255
+ has_one :post, through: :other
256
+ end
257
+ ```
1611
258
 
1612
- *Guo Xiang Tan*, *George Wambold*
259
+ Before, `#post` would infer the model as `Nested::Post`, but now it correctly infers `Post`.
1613
260
 
1614
- * Update query log tags to use the [SQLCommenter](https://open-telemetry.github.io/opentelemetry-sqlcommenter/) format by default. See [#46179](https://github.com/rails/rails/issues/46179)
261
+ *Joshua Young*
1615
262
 
1616
- To opt out of SQLCommenter-formatted query log tags, set `config.active_record.query_log_tags_format = :legacy`. By default, this is set to `:sqlcommenter`.
263
+ * PostgreSQL `Cidr#change?` detects the address prefix change.
1617
264
 
1618
- *Modulitos* and *Iheanyi*
265
+ *Taketo Takashima*
1619
266
 
1620
- * Allow any ERB in the database.yml when creating rake tasks.
267
+ * Change `BatchEnumerator#destroy_all` to return the total number of affected rows.
1621
268
 
1622
- Any ERB can be used in `database.yml` even if it accesses environment
1623
- configurations.
269
+ Previously, it always returned `nil`.
1624
270
 
1625
- Deprecates `config.active_record.suppress_multiple_database_warning`.
271
+ *fatkodima*
1626
272
 
1627
- *Eike Send*
273
+ * Support `touch_all` in batches.
1628
274
 
1629
- * Add table to error for duplicate column definitions.
275
+ ```ruby
276
+ Post.in_batches.touch_all
277
+ ```
1630
278
 
1631
- If a migration defines duplicate columns for a table, the error message
1632
- shows which table it concerns.
279
+ *fatkodima*
1633
280
 
1634
- *Petrik de Heus*
281
+ * Add support for `:if_not_exists` and `:force` options to `create_schema`.
1635
282
 
1636
- * Fix erroneous nil default precision on virtual datetime columns.
283
+ *fatkodima*
1637
284
 
1638
- Prior to this change, virtual datetime columns did not have the same
1639
- default precision as regular datetime columns, resulting in the following
1640
- being erroneously equivalent:
285
+ * Fix `index_errors` having incorrect index in association validation errors.
1641
286
 
1642
- t.virtual :name, type: datetime, as: "expression"
1643
- t.virtual :name, type: datetime, precision: nil, as: "expression"
287
+ *lulalala*
1644
288
 
1645
- This change fixes the default precision lookup, so virtual and regular
1646
- datetime column default precisions match.
289
+ * Add `index_errors: :nested_attributes_order` mode.
1647
290
 
1648
- *Sam Bostock*
291
+ This indexes the association validation errors based on the order received by nested attributes setter, and respects the `reject_if` configuration. This enables API to provide enough information to the frontend to map the validation errors back to their respective form fields.
1649
292
 
1650
- * Use connection from `#with_raw_connection` in `#quote_string`.
293
+ *lulalala*
1651
294
 
1652
- This ensures that the string quoting is wrapped in the reconnect and retry logic
1653
- that `#with_raw_connection` offers.
295
+ * Add `Rails.application.config.active_record.postgresql_adapter_decode_dates` to opt out of decoding dates automatically with the postgresql adapter. Defaults to true.
1654
296
 
1655
- *Adrianna Chang*
297
+ *Joé Dupuis*
1656
298
 
1657
- * Add `expires_at` option to `signed_id`.
299
+ * Association option `query_constraints` is deprecated in favor of `foreign_key`.
1658
300
 
1659
- *Shouichi Kamiya*
301
+ *Nikita Vasilevsky*
1660
302
 
1661
- * Allow applications to set retry deadline for query retries.
303
+ * Add `ENV["SKIP_TEST_DATABASE_TRUNCATE"]` flag to speed up multi-process test runs on large DBs when all tests run within default transaction.
1662
304
 
1663
- Building on the work done in #44576 and #44591, we extend the logic that automatically
1664
- reconnects database connections to take into account a timeout limit. We won't retry
1665
- a query if a given amount of time has elapsed since the query was first attempted. This
1666
- value defaults to nil, meaning that all retryable queries are retried regardless of time elapsed,
1667
- but this can be changed via the `retry_deadline` option in the database config.
305
+ This cuts ~10s from the test run of HEY when run by 24 processes against the 178 tables, since ~4,000 table truncates can then be skipped.
1668
306
 
1669
- *Adrianna Chang*
307
+ *DHH*
1670
308
 
1671
- * Fix a case where the query cache can return wrong values. See #46044
309
+ * Added support for recursive common table expressions.
1672
310
 
1673
- *Aaron Patterson*
311
+ ```ruby
312
+ Post.with_recursive(
313
+ post_and_replies: [
314
+ Post.where(id: 42),
315
+ Post.joins('JOIN post_and_replies ON posts.in_reply_to_id = post_and_replies.id'),
316
+ ]
317
+ )
318
+ ```
1674
319
 
1675
- * Support MySQL's ssl-mode option for MySQLDatabaseTasks.
320
+ Generates the following SQL:
1676
321
 
1677
- Verifying the identity of the database server requires setting the ssl-mode
1678
- option to VERIFY_CA or VERIFY_IDENTITY. This option was previously ignored
1679
- for MySQL database tasks like creating a database and dumping the structure.
322
+ ```sql
323
+ WITH RECURSIVE "post_and_replies" AS (
324
+ (SELECT "posts".* FROM "posts" WHERE "posts"."id" = 42)
325
+ UNION ALL
326
+ (SELECT "posts".* FROM "posts" JOIN post_and_replies ON posts.in_reply_to_id = post_and_replies.id)
327
+ )
328
+ SELECT "posts".* FROM "posts"
329
+ ```
1680
330
 
1681
- *Petrik de Heus*
331
+ *ClearlyClaire*
1682
332
 
1683
- * Move `ActiveRecord::InternalMetadata` to an independent object.
333
+ * `validate_constraint` can be called in a `change_table` block.
1684
334
 
1685
- `ActiveRecord::InternalMetadata` no longer inherits from `ActiveRecord::Base` and is now an independent object that should be instantiated with a `connection`. This class is private and should not be used by applications directly. If you want to interact with the schema migrations table, please access it on the connection directly, for example: `ActiveRecord::Base.connection.schema_migration`.
335
+ ex:
336
+ ```ruby
337
+ change_table :products do |t|
338
+ t.check_constraint "price > discounted_price", name: "price_check", validate: false
339
+ t.validate_check_constraint "price_check"
340
+ end
341
+ ```
1686
342
 
1687
- *Eileen M. Uchitelle*
343
+ *Cody Cutrer*
1688
344
 
1689
- * Deprecate quoting `ActiveSupport::Duration` as an integer
345
+ * `PostgreSQLAdapter` now decodes columns of type date to `Date` instead of string.
1690
346
 
1691
- Using ActiveSupport::Duration as an interpolated bind parameter in a SQL
1692
- string template is deprecated. To avoid this warning, you should explicitly
1693
- convert the duration to a more specific database type. For example, if you
1694
- want to use a duration as an integer number of seconds:
1695
- ```
1696
- Record.where("duration = ?", 1.hour.to_i)
1697
- ```
1698
- If you want to use a duration as an ISO 8601 string:
1699
- ```
1700
- Record.where("duration = ?", 1.hour.iso8601)
347
+ Ex:
348
+ ```ruby
349
+ ActiveRecord::Base.connection
350
+ .select_value("select '2024-01-01'::date").class #=> Date
1701
351
  ```
1702
352
 
1703
- *Aram Greenman*
353
+ *Joé Dupuis*
1704
354
 
1705
- * Allow `QueryMethods#in_order_of` to order by a string column name.
355
+ * Strict loading using `:n_plus_one_only` does not eagerly load child associations.
356
+
357
+ With this change, child associations are no longer eagerly loaded, to
358
+ match intended behavior and to prevent non-deterministic order issues caused
359
+ by calling methods like `first` or `last`. As `first` and `last` don't cause
360
+ an N+1 by themselves, calling child associations will no longer raise.
361
+ Fixes #49473.
362
+
363
+ Before:
1706
364
 
1707
365
  ```ruby
1708
- Post.in_order_of("id", [4,2,3,1]).to_a
1709
- Post.joins(:author).in_order_of("authors.name", ["Bob", "Anna", "John"]).to_a
366
+ person = Person.find(1)
367
+ person.strict_loading!(mode: :n_plus_one_only)
368
+ person.posts.first
369
+ # SELECT * FROM posts WHERE person_id = 1; -- non-deterministic order
370
+ person.posts.first.firm # raises ActiveRecord::StrictLoadingViolationError
1710
371
  ```
1711
372
 
1712
- *Igor Kasyanchuk*
1713
-
1714
- * Move `ActiveRecord::SchemaMigration` to an independent object.
373
+ After:
1715
374
 
1716
- `ActiveRecord::SchemaMigration` no longer inherits from `ActiveRecord::Base` and is now an independent object that should be instantiated with a `connection`. This class is private and should not be used by applications directly. If you want to interact with the schema migrations table, please access it on the connection directly, for example: `ActiveRecord::Base.connection.schema_migration`.
375
+ ```ruby
376
+ person = Person.find(1)
377
+ person.strict_loading!(mode: :n_plus_one_only)
378
+ person.posts.first # this is 1+1, not N+1
379
+ # SELECT * FROM posts WHERE person_id = 1 ORDER BY id LIMIT 1;
380
+ person.posts.first.firm # no longer raises
381
+ ```
1717
382
 
1718
- *Eileen M. Uchitelle*
383
+ *Reid Lynch*
1719
384
 
1720
- * Deprecate `all_connection_pools` and make `connection_pool_list` more explicit.
385
+ * Allow `Sqlite3Adapter` to use `sqlite3` gem version `2.x`.
1721
386
 
1722
- Following on #45924 `all_connection_pools` is now deprecated. `connection_pool_list` will either take an explicit role or applications can opt into the new behavior by passing `:all`.
387
+ *Mike Dalessio*
1723
388
 
1724
- *Eileen M. Uchitelle*
389
+ * Allow `ActiveRecord::Base#pluck` to accept hash values.
1725
390
 
1726
- * Fix connection handler methods to operate on all pools.
391
+ ```ruby
392
+ # Before
393
+ Post.joins(:comments).pluck("posts.id", "comments.id", "comments.body")
1727
394
 
1728
- `active_connections?`, `clear_active_connections!`, `clear_reloadable_connections!`, `clear_all_connections!`, and `flush_idle_connections!` now operate on all pools by default. Previously they would default to using the `current_role` or `:writing` role unless specified.
395
+ # After
396
+ Post.joins(:comments).pluck(posts: [:id], comments: [:id, :body])
397
+ ```
1729
398
 
1730
- *Eileen M. Uchitelle*
399
+ *fatkodima*
1731
400
 
401
+ * Raise an `ActiveRecord::ActiveRecordError` error when the MySQL database returns an invalid version string.
1732
402
 
1733
- * Allow ActiveRecord::QueryMethods#select to receive hash values.
403
+ *Kevin McPhillips*
1734
404
 
1735
- Currently, `select` might receive only raw sql and symbols to define columns and aliases to select.
405
+ * `ActiveRecord::Base.transaction` now yields an `ActiveRecord::Transaction` object.
1736
406
 
1737
- With this change we can provide `hash` as argument, for example:
407
+ This allows to register callbacks on it.
1738
408
 
1739
409
  ```ruby
1740
- Post.joins(:comments).select(posts: [:id, :title, :created_at], comments: [:id, :body, :author_id])
1741
- #=> "SELECT \"posts\".\"id\", \"posts\".\"title\", \"posts\".\"created_at\", \"comments\".\"id\", \"comments\".\"body\", \"comments\".\"author_id\"
1742
- # FROM \"posts\" INNER JOIN \"comments\" ON \"comments\".\"post_id\" = \"posts\".\"id\""
1743
-
1744
- Post.joins(:comments).select(posts: { id: :post_id, title: :post_title }, comments: { id: :comment_id, body: :comment_body })
1745
- #=> "SELECT posts.id as post_id, posts.title as post_title, comments.id as comment_id, comments.body as comment_body
1746
- # FROM \"posts\" INNER JOIN \"comments\" ON \"comments\".\"post_id\" = \"posts\".\"id\""
410
+ Article.transaction do |transaction|
411
+ article.update(published: true)
412
+ transaction.after_commit do
413
+ PublishNotificationMailer.with(article: article).deliver_later
414
+ end
415
+ end
1747
416
  ```
1748
- *Oleksandr Holubenko*, *Josef Šimánek*, *Jean Boussier*
1749
417
 
1750
- * Adapts virtual attributes on `ActiveRecord::Persistence#becomes`.
418
+ *Jean Boussier*
419
+
420
+ * Add `ActiveRecord::Base.current_transaction`.
1751
421
 
1752
- When source and target classes have a different set of attributes adapts
1753
- attributes such that the extra attributes from target are added.
422
+ Returns the current transaction, to allow registering callbacks on it.
1754
423
 
1755
424
  ```ruby
1756
- class Person < ApplicationRecord
425
+ Article.current_transaction.after_commit do
426
+ PublishNotificationMailer.with(article: article).deliver_later
1757
427
  end
428
+ ```
1758
429
 
1759
- class WebUser < Person
1760
- attribute :is_admin, :boolean
1761
- after_initialize :set_admin
430
+ *Jean Boussier*
431
+
432
+ * Add `ActiveRecord.after_all_transactions_commit` callback.
1762
433
 
1763
- def set_admin
1764
- write_attribute(:is_admin, email =~ /@ourcompany\.com$/)
434
+ Useful for code that may run either inside or outside a transaction and needs
435
+ to perform work after the state changes have been properly persisted.
436
+
437
+ ```ruby
438
+ def publish_article(article)
439
+ article.update(published: true)
440
+ ActiveRecord.after_all_transactions_commit do
441
+ PublishNotificationMailer.with(article: article).deliver_later
1765
442
  end
1766
443
  end
1767
-
1768
- person = Person.find_by(email: "email@ourcompany.com")
1769
- person.respond_to? :is_admin
1770
- # => false
1771
- person.becomes(WebUser).is_admin?
1772
- # => true
1773
444
  ```
1774
445
 
1775
- *Jacopo Beschi*, *Sampson Crowley*
446
+ In the above example, the block is either executed immediately if called outside
447
+ of a transaction, or called after the open transaction is committed.
448
+
449
+ If the transaction is rolled back, the block isn't called.
1776
450
 
1777
- * Fix `ActiveRecord::QueryMethods#in_order_of` to include `nil`s, to match the
1778
- behavior of `Enumerable#in_order_of`.
451
+ *Jean Boussier*
1779
452
 
1780
- For example, `Post.in_order_of(:title, [nil, "foo"])` will now include posts
1781
- with `nil` titles, the same as `Post.all.to_a.in_order_of(:title, [nil, "foo"])`.
453
+ * Add the ability to ignore counter cache columns until they are backfilled.
1782
454
 
1783
- *fatkodima*
455
+ Starting to use counter caches on existing large tables can be troublesome, because the column
456
+ values must be backfilled separately of the column addition (to not lock the table for too long)
457
+ and before the use of `:counter_cache` (otherwise methods like `size`/`any?`/etc, which use
458
+ counter caches internally, can produce incorrect results). People usually use database triggers
459
+ or callbacks on child associations while backfilling before introducing a counter cache
460
+ configuration to the association.
1784
461
 
1785
- * Optimize `add_timestamps` to use a single SQL statement.
462
+ Now, to safely backfill the column, while keeping the column updated with child records added/removed, use:
1786
463
 
1787
464
  ```ruby
1788
- add_timestamps :my_table
465
+ class Comment < ApplicationRecord
466
+ belongs_to :post, counter_cache: { active: false }
467
+ end
1789
468
  ```
1790
469
 
1791
- Now results in the following SQL:
470
+ While the counter cache is not "active", the methods like `size`/`any?`/etc will not use it,
471
+ but get the results directly from the database. After the counter cache column is backfilled, simply
472
+ remove the `{ active: false }` part from the counter cache definition, and it will now be used by the
473
+ mentioned methods.
1792
474
 
1793
- ```sql
1794
- ALTER TABLE "my_table" ADD COLUMN "created_at" datetime(6) NOT NULL, ADD COLUMN "updated_at" datetime(6) NOT NULL
1795
- ```
475
+ *fatkodima*
1796
476
 
1797
- *Iliana Hadzhiatanasova*
477
+ * Retry known idempotent SELECT queries on connection-related exceptions.
1798
478
 
1799
- * Add `drop_enum` migration command for PostgreSQL
479
+ SELECT queries we construct by walking the Arel tree and / or with known model attributes
480
+ are idempotent and can safely be retried in the case of a connection error. Previously,
481
+ adapters such as `TrilogyAdapter` would raise `ActiveRecord::ConnectionFailed: Trilogy::EOFError`
482
+ when encountering a connection error mid-request.
1800
483
 
1801
- This does the inverse of `create_enum`. Before dropping an enum, ensure you have
1802
- dropped columns that depend on it.
484
+ *Adrianna Chang*
485
+
486
+ * Allow association's `foreign_key` to be composite.
1803
487
 
1804
- *Alex Ghiculescu*
488
+ `query_constraints` option was the only way to configure a composite foreign key by passing an `Array`.
489
+ Now it's possible to pass an Array value as `foreign_key` to achieve the same behavior of an association.
490
+
491
+ *Nikita Vasilevsky*
1805
492
 
1806
- * Adds support for `if_exists` option when removing a check constraint.
493
+ * Allow association's `primary_key` to be composite.
1807
494
 
1808
- The `remove_check_constraint` method now accepts an `if_exists` option. If set
1809
- to true an error won't be raised if the check constraint doesn't exist.
495
+ Association's `primary_key` can be composite when derived from associated model `primary_key` or `query_constraints`.
496
+ Now it's possible to explicitly set it as composite on the association.
1810
497
 
1811
- *Margaret Parsa* and *Aditya Bhutani*
498
+ *Nikita Vasilevsky*
1812
499
 
1813
- * `find_or_create_by` now try to find a second time if it hits a unicity constraint.
500
+ * Add `config.active_record.permanent_connection_checkout` setting.
1814
501
 
1815
- `find_or_create_by` always has been inherently racy, either creating multiple
1816
- duplicate records or failing with `ActiveRecord::RecordNotUnique` depending on
1817
- whether a proper unicity constraint was set.
502
+ Controls whether `ActiveRecord::Base.connection` raises an error, emits a deprecation warning, or neither.
1818
503
 
1819
- `create_or_find_by` was introduced for this use case, however it's quite wasteful
1820
- when the record is expected to exist most of the time, as INSERT require to send
1821
- more data than SELECT and require more work from the database. Also on some
1822
- databases it can actually consume a primary key increment which is undesirable.
504
+ `ActiveRecord::Base.connection` checkouts a database connection from the pool and keeps it leased until the end of
505
+ the request or job. This behavior can be undesirable in environments that use many more threads or fibers than there
506
+ is available connections.
1823
507
 
1824
- So for case where most of the time the record is expected to exist, `find_or_create_by`
1825
- can be made race-condition free by re-trying the `find` if the `create` failed
1826
- with `ActiveRecord::RecordNotUnique`. This assumes that the table has the proper
1827
- unicity constraints, if not, `find_or_create_by` will still lead to duplicated records.
508
+ This configuration can be used to track down and eliminate code that calls `ActiveRecord::Base.connection` and
509
+ migrate it to use `ActiveRecord::Base.with_connection` instead.
1828
510
 
1829
- *Jean Boussier*, *Alex Kitchens*
511
+ The default behavior remains unchanged, and there is currently no plans to change the default.
1830
512
 
1831
- * Introduce a simpler constructor API for ActiveRecord database adapters.
513
+ *Jean Boussier*
1832
514
 
1833
- Previously the adapter had to know how to build a new raw connection to
1834
- support reconnect, but also expected to be passed an initial already-
1835
- established connection.
515
+ * Add dirties option to uncached.
1836
516
 
1837
- When manually creating an adapter instance, it will now accept a single
1838
- config hash, and only establish the real connection on demand.
517
+ This adds a `dirties` option to `ActiveRecord::Base.uncached` and
518
+ `ActiveRecord::ConnectionAdapters::ConnectionPool#uncached`.
1839
519
 
1840
- *Matthew Draper*
520
+ When set to `true` (the default), writes will clear all query caches belonging to the current thread.
521
+ When set to `false`, writes to the affected connection pool will not clear any query cache.
1841
522
 
1842
- * Avoid redundant `SELECT 1` connection-validation query during DB pool
1843
- checkout when possible.
523
+ This is needed by Solid Cache so that cache writes do not clear query caches.
1844
524
 
1845
- If the first query run during a request is known to be idempotent, it can be
1846
- used directly to validate the connection, saving a network round-trip.
525
+ *Donal McBreen*
1847
526
 
1848
- *Matthew Draper*
527
+ * Deprecate `ActiveRecord::Base.connection` in favor of `.lease_connection`.
1849
528
 
1850
- * Automatically reconnect broken database connections when safe, even
1851
- mid-request.
529
+ The method has been renamed as `lease_connection` to better reflect that the returned
530
+ connection will be held for the duration of the request or job.
1852
531
 
1853
- When an error occurs while attempting to run a known-idempotent query, and
1854
- not inside a transaction, it is safe to immediately reconnect to the
1855
- database server and try again, so this is now the default behavior.
532
+ This deprecation is a soft deprecation, no warnings will be issued and there is no
533
+ current plan to remove the method.
1856
534
 
1857
- This new default should always be safe -- to support that, it's consciously
1858
- conservative about which queries are considered idempotent -- but if
1859
- necessary it can be disabled by setting the `connection_retries` connection
1860
- option to `0`.
535
+ *Jean Boussier*
1861
536
 
1862
- *Matthew Draper*
537
+ * Deprecate `ActiveRecord::ConnectionAdapters::ConnectionPool#connection`.
1863
538
 
1864
- * Avoid removing a PostgreSQL extension when there are dependent objects.
539
+ The method has been renamed as `lease_connection` to better reflect that the returned
540
+ connection will be held for the duration of the request or job.
1865
541
 
1866
- Previously, removing an extension also implicitly removed dependent objects. Now, this will raise an error.
542
+ *Jean Boussier*
1867
543
 
1868
- You can force removing the extension:
544
+ * Expose a generic fixture accessor for fixture names that may conflict with Minitest.
1869
545
 
1870
546
  ```ruby
1871
- disable_extension :citext, force: :cascade
547
+ assert_equal "Ruby on Rails", web_sites(:rubyonrails).name
548
+ assert_equal "Ruby on Rails", fixture(:web_sites, :rubyonrails).name
1872
549
  ```
1873
550
 
1874
- Fixes #29091.
551
+ *Jean Boussier*
1875
552
 
1876
- *fatkodima*
553
+ * Using `Model.query_constraints` with a single non-primary-key column used to raise as expected, but with an
554
+ incorrect error message.
1877
555
 
1878
- * Allow nested functions as safe SQL string
556
+ This has been fixed to raise with a more appropriate error message.
1879
557
 
1880
- *Michael Siegfried*
558
+ *Joshua Young*
1881
559
 
1882
- * Allow `destroy_association_async_job=` to be configured with a class string instead of a constant.
560
+ * Fix `has_one` association autosave setting the foreign key attribute when it is unchanged.
1883
561
 
1884
- Defers an autoloading dependency between `ActiveRecord::Base` and `ActiveJob::Base`
1885
- and moves the configuration of `ActiveRecord::DestroyAssociationAsyncJob`
1886
- from ActiveJob to ActiveRecord.
562
+ This behavior is also inconsistent with autosaving `belongs_to` and can have unintended side effects like raising
563
+ an `ActiveRecord::ReadonlyAttributeError` when the foreign key attribute is marked as read-only.
1887
564
 
1888
- Deprecates `ActiveRecord::ActiveJobRequiredError` and now raises a `NameError`
1889
- if the job class is unloadable or an `ActiveRecord::ConfigurationError` if
1890
- `dependent: :destroy_async` is declared on an association but there is no job
1891
- class configured.
565
+ *Joshua Young*
1892
566
 
1893
- *Ben Sheldon*
567
+ * Remove deprecated behavior that would rollback a transaction block when exited using `return`, `break` or `throw`.
1894
568
 
1895
- * Fix `ActiveRecord::Store` to serialize as a regular Hash
569
+ *Rafael Mendonça França*
1896
570
 
1897
- Previously it would serialize as an `ActiveSupport::HashWithIndifferentAccess`
1898
- which is wasteful and cause problem with YAML safe_load.
571
+ * Deprecate `Rails.application.config.active_record.commit_transaction_on_non_local_return`.
1899
572
 
1900
- *Jean Boussier*
573
+ *Rafael Mendonça França*
1901
574
 
1902
- * Add `timestamptz` as a time zone aware type for PostgreSQL
575
+ * Remove deprecated support to pass `rewhere` to `ActiveRecord::Relation#merge`.
1903
576
 
1904
- This is required for correctly parsing `timestamp with time zone` values in your database.
577
+ *Rafael Mendonça França*
1905
578
 
1906
- If you don't want this, you can opt out by adding this initializer:
579
+ * Remove deprecated support to pass `deferrable: true` to `add_foreign_key`.
1907
580
 
1908
- ```ruby
1909
- ActiveRecord::Base.time_zone_aware_types -= [:timestamptz]
1910
- ```
581
+ *Rafael Mendonça França*
1911
582
 
1912
- *Alex Ghiculescu*
583
+ * Remove deprecated support to quote `ActiveSupport::Duration`.
1913
584
 
1914
- * Add new `ActiveRecord::Base.generates_token_for` API.
585
+ *Rafael Mendonça França*
1915
586
 
1916
- Currently, `signed_id` fulfills the role of generating tokens for e.g.
1917
- resetting a password. However, signed IDs cannot reflect record state, so
1918
- if a token is intended to be single-use, it must be tracked in a database at
1919
- least until it expires.
587
+ * Remove deprecated `#quote_bound_value`.
1920
588
 
1921
- With `generates_token_for`, a token can embed data from a record. When
1922
- using the token to fetch the record, the data from the token and the current
1923
- data from the record will be compared. If the two do not match, the token
1924
- will be treated as invalid, the same as if it had expired. For example:
589
+ *Rafael Mendonça França*
1925
590
 
1926
- ```ruby
1927
- class User < ActiveRecord::Base
1928
- has_secure_password
1929
-
1930
- generates_token_for :password_reset, expires_in: 15.minutes do
1931
- # A password's BCrypt salt changes when the password is updated.
1932
- # By embedding (part of) the salt in a token, the token will
1933
- # expire when the password is updated.
1934
- BCrypt::Password.new(password_digest).salt[-10..]
1935
- end
1936
- end
591
+ * Remove deprecated `ActiveRecord::ConnectionAdapters::ConnectionPool#connection_klass`.
1937
592
 
1938
- user = User.first
1939
- token = user.generate_token_for(:password_reset)
593
+ *Rafael Mendonça França*
1940
594
 
1941
- User.find_by_token_for(:password_reset, token) # => user
595
+ * Remove deprecated support to apply `#connection_pool_list`, `#active_connections?`, `#clear_active_connections!`,
596
+ `#clear_reloadable_connections!`, `#clear_all_connections!` and `#flush_idle_connections!` to the connections pools
597
+ for the current role when the `role` argument isn't provided.
1942
598
 
1943
- user.update!(password: "new password")
1944
- User.find_by_token_for(:password_reset, token) # => nil
1945
- ```
599
+ *Rafael Mendonça França*
1946
600
 
1947
- *Jonathan Hefner*
601
+ * Remove deprecated `#all_connection_pools`.
1948
602
 
1949
- * Optimize Active Record batching for whole table iterations.
603
+ *Rafael Mendonça França*
1950
604
 
1951
- Previously, `in_batches` got all the ids and constructed an `IN`-based query for each batch.
1952
- When iterating over the whole tables, this approach is not optimal as it loads unneeded ids and
1953
- `IN` queries with lots of items are slow.
605
+ * Remove deprecated `ActiveRecord::ConnectionAdapters::SchemaCache#data_sources`.
1954
606
 
1955
- Now, whole table iterations use range iteration (`id >= x AND id <= y`) by default which can make iteration
1956
- several times faster. E.g., tested on a PostgreSQL table with 10 million records: querying (`253s` vs `30s`),
1957
- updating (`288s` vs `124s`), deleting (`268s` vs `83s`).
607
+ *Rafael Mendonça França*
1958
608
 
1959
- Only whole table iterations use this style of iteration by default. You can disable this behavior by passing `use_ranges: false`.
1960
- If you iterate over the table and the only condition is, e.g., `archived_at: nil` (and only a tiny fraction
1961
- of the records are archived), it makes sense to opt in to this approach:
609
+ * Remove deprecated `ActiveRecord::ConnectionAdapters::SchemaCache.load_from`.
1962
610
 
1963
- ```ruby
1964
- Project.where(archived_at: nil).in_batches(use_ranges: true) do |relation|
1965
- # do something
1966
- end
1967
- ```
611
+ *Rafael Mendonça França*
1968
612
 
1969
- See #45414 for more details.
613
+ * Remove deprecated `#all_foreign_keys_valid?` from database adapters.
1970
614
 
1971
- *fatkodima*
615
+ *Rafael Mendonça França*
1972
616
 
1973
- * `.with` query method added. Construct common table expressions with ease and get `ActiveRecord::Relation` back.
617
+ * Remove deprecated support to passing coder and class as second argument to `serialize`.
1974
618
 
1975
- ```ruby
1976
- Post.with(posts_with_comments: Post.where("comments_count > ?", 0))
1977
- # => ActiveRecord::Relation
1978
- # WITH posts_with_comments AS (SELECT * FROM posts WHERE (comments_count > 0)) SELECT * FROM posts
1979
- ```
619
+ *Rafael Mendonça França*
1980
620
 
1981
- *Vlado Cingel*
621
+ * Remove deprecated support to `ActiveRecord::Base#read_attribute(:id)` to return the custom primary key value.
1982
622
 
1983
- * Don't establish a new connection if an identical pool exists already.
623
+ *Rafael Mendonça França*
1984
624
 
1985
- Previously, if `establish_connection` was called on a class that already had an established connection, the existing connection would be removed regardless of whether it was the same config. Now if a pool is found with the same values as the new connection, the existing connection will be returned instead of creating a new one.
625
+ * Remove deprecated `TestFixtures.fixture_path`.
1986
626
 
1987
- This has a slight change in behavior if application code is depending on a new connection being established regardless of whether it's identical to an existing connection. If the old behavior is desirable, applications should call `ActiveRecord::Base#remove_connection` before establishing a new one. Calling `establish_connection` with a different config works the same way as it did previously.
627
+ *Rafael Mendonça França*
1988
628
 
1989
- *Eileen M. Uchitelle*
629
+ * Remove deprecated behavior to support referring to a singular association by its plural name.
1990
630
 
1991
- * Update `db:prepare` task to load schema when an uninitialized database exists, and dump schema after migrations.
631
+ *Rafael Mendonça França*
1992
632
 
1993
- *Ben Sheldon*
633
+ * Deprecate `Rails.application.config.active_record.allow_deprecated_singular_associations_name`.
1994
634
 
1995
- * Fix supporting timezone awareness for `tsrange` and `tstzrange` array columns.
635
+ *Rafael Mendonça França*
1996
636
 
1997
- ```ruby
1998
- # In database migrations
1999
- add_column :shops, :open_hours, :tsrange, array: true
2000
- # In app config
2001
- ActiveRecord::Base.time_zone_aware_types += [:tsrange]
2002
- # In the code times are properly converted to app time zone
2003
- Shop.create!(open_hours: [Time.current..8.hour.from_now])
2004
- ```
637
+ * Remove deprecated support to passing `SchemaMigration` and `InternalMetadata` classes as arguments to
638
+ `ActiveRecord::MigrationContext`.
2005
639
 
2006
- *Wojciech Wnętrzak*
640
+ *Rafael Mendonça França*
2007
641
 
2008
- * Introduce strategy pattern for executing migrations.
642
+ * Remove deprecated `ActiveRecord::Migration.check_pending!` method.
2009
643
 
2010
- By default, migrations will use a strategy object that delegates the method
2011
- to the connection adapter. Consumers can implement custom strategy objects
2012
- to change how their migrations run.
644
+ *Rafael Mendonça França*
2013
645
 
2014
- *Adrianna Chang*
646
+ * Remove deprecated `ActiveRecord::LogSubscriber.runtime` method.
2015
647
 
2016
- * Add adapter option disallowing foreign keys
648
+ *Rafael Mendonça França*
2017
649
 
2018
- This adds a new option to be added to `database.yml` which enables skipping
2019
- foreign key constraints usage even if the underlying database supports them.
650
+ * Remove deprecated `ActiveRecord::LogSubscriber.runtime=` method.
2020
651
 
2021
- Usage:
2022
- ```yaml
2023
- development:
2024
- <<: *default
2025
- database: storage/development.sqlite3
2026
- foreign_keys: false
2027
- ```
652
+ *Rafael Mendonça França*
2028
653
 
2029
- *Paulo Barros*
654
+ * Remove deprecated `ActiveRecord::LogSubscriber.reset_runtime` method.
2030
655
 
2031
- * Add configurable deprecation warning for singular associations
656
+ *Rafael Mendonça França*
2032
657
 
2033
- This adds a deprecation warning when using the plural name of a singular associations in `where`.
2034
- It is possible to opt into the new more performant behavior with `config.active_record.allow_deprecated_singular_associations_name = false`
658
+ * Remove deprecated support to define `explain` in the connection adapter with 2 arguments.
2035
659
 
2036
- *Adam Hess*
660
+ *Rafael Mendonça França*
2037
661
 
2038
- * Run transactional callbacks on the freshest instance to save a given
2039
- record within a transaction.
662
+ * Remove deprecated `ActiveRecord::ActiveJobRequiredError`.
2040
663
 
2041
- When multiple Active Record instances change the same record within a
2042
- transaction, Rails runs `after_commit` or `after_rollback` callbacks for
2043
- only one of them. `config.active_record.run_commit_callbacks_on_first_saved_instances_in_transaction`
2044
- was added to specify how Rails chooses which instance receives the
2045
- callbacks. The framework defaults were changed to use the new logic.
664
+ *Rafael Mendonça França*
2046
665
 
2047
- When `config.active_record.run_commit_callbacks_on_first_saved_instances_in_transaction`
2048
- is `true`, transactional callbacks are run on the first instance to save,
2049
- even though its instance state may be stale.
666
+ * Remove deprecated `ActiveRecord::Base.clear_active_connections!`.
2050
667
 
2051
- When it is `false`, which is the new framework default starting with version
2052
- 7.1, transactional callbacks are run on the instances with the freshest
2053
- instance state. Those instances are chosen as follows:
668
+ *Rafael Mendonça França*
2054
669
 
2055
- - In general, run transactional callbacks on the last instance to save a
2056
- given record within the transaction.
2057
- - There are two exceptions:
2058
- - If the record is created within the transaction, then updated by
2059
- another instance, `after_create_commit` callbacks will be run on the
2060
- second instance. This is instead of the `after_update_commit`
2061
- callbacks that would naively be run based on that instance’s state.
2062
- - If the record is destroyed within the transaction, then
2063
- `after_destroy_commit` callbacks will be fired on the last destroyed
2064
- instance, even if a stale instance subsequently performed an update
2065
- (which will have affected 0 rows).
670
+ * Remove deprecated `ActiveRecord::Base.clear_reloadable_connections!`.
2066
671
 
2067
- *Cameron Bothner and Mitch Vollebregt*
672
+ *Rafael Mendonça França*
2068
673
 
2069
- * Enable strict strings mode for `SQLite3Adapter`.
674
+ * Remove deprecated `ActiveRecord::Base.clear_all_connections!`.
2070
675
 
2071
- Configures SQLite with a strict strings mode, which disables double-quoted string literals.
676
+ *Rafael Mendonça França*
2072
677
 
2073
- SQLite has some quirks around double-quoted string literals.
2074
- It first tries to consider double-quoted strings as identifier names, but if they don't exist
2075
- it then considers them as string literals. Because of this, typos can silently go unnoticed.
2076
- For example, it is possible to create an index for a non existing column.
2077
- See [SQLite documentation](https://www.sqlite.org/quirks.html#double_quoted_string_literals_are_accepted) for more details.
678
+ * Remove deprecated `ActiveRecord::Base.flush_idle_connections!`.
2078
679
 
2079
- If you don't want this behavior, you can disable it via:
680
+ *Rafael Mendonça França*
2080
681
 
2081
- ```ruby
2082
- # config/application.rb
2083
- config.active_record.sqlite3_adapter_strict_strings_by_default = false
2084
- ```
682
+ * Remove deprecated `name` argument from `ActiveRecord::Base.remove_connection`.
2085
683
 
2086
- Fixes #27782.
684
+ *Rafael Mendonça França*
2087
685
 
2088
- *fatkodima*, *Jean Boussier*
686
+ * Remove deprecated support to call `alias_attribute` with non-existent attribute names.
2089
687
 
2090
- * Resolve issue where a relation cache_version could be left stale.
688
+ *Rafael Mendonça França*
2091
689
 
2092
- Previously, when `reset` was called on a relation object it did not reset the cache_versions
2093
- ivar. This led to a confusing situation where despite having the correct data the relation
2094
- still reported a stale cache_version.
690
+ * Remove deprecated `Rails.application.config.active_record.suppress_multiple_database_warning`.
2095
691
 
2096
- Usage:
692
+ *Rafael Mendonça França*
2097
693
 
2098
- ```ruby
2099
- developers = Developer.all
2100
- developers.cache_version
694
+ * Add `ActiveRecord::Encryption::MessagePackMessageSerializer`.
2101
695
 
2102
- Developer.update_all(updated_at: Time.now.utc + 1.second)
696
+ Serialize data to the MessagePack format, for efficient storage in binary columns.
2103
697
 
2104
- developers.cache_version # Stale cache_version
2105
- developers.reset
2106
- developers.cache_version # Returns the current correct cache_version
2107
- ```
698
+ The binary encoding requires around 30% less space than the base64 encoding
699
+ used by the default serializer.
2108
700
 
2109
- Fixes #45341.
701
+ *Donal McBreen*
2110
702
 
2111
- *Austen Madden*
703
+ * Add support for encrypting binary columns.
2112
704
 
2113
- * Add support for exclusion constraints (PostgreSQL-only).
705
+ Ensure encryption and decryption pass `Type::Binary::Data` around for binary data.
2114
706
 
2115
- ```ruby
2116
- add_exclusion_constraint :invoices, "daterange(start_date, end_date) WITH &&", using: :gist, name: "invoices_date_overlap"
2117
- remove_exclusion_constraint :invoices, name: "invoices_date_overlap"
2118
- ```
707
+ Previously encrypting binary columns with the `ActiveRecord::Encryption::MessageSerializer`
708
+ incidentally worked for MySQL and SQLite, but not PostgreSQL.
2119
709
 
2120
- See PostgreSQL's [`CREATE TABLE ... EXCLUDE ...`](https://www.postgresql.org/docs/12/sql-createtable.html#SQL-CREATETABLE-EXCLUDE) documentation for more on exclusion constraints.
710
+ *Donal McBreen*
2121
711
 
2122
- *Alex Robbin*
712
+ * Deprecated `ENV["SCHEMA_CACHE"]` in favor of `schema_cache_path` in the database configuration.
2123
713
 
2124
- * `change_column_null` raises if a non-boolean argument is provided
714
+ *Rafael Mendonça França*
2125
715
 
2126
- Previously if you provided a non-boolean argument, `change_column_null` would
2127
- treat it as truthy and make your column nullable. This could be surprising, so now
2128
- the input must be either `true` or `false`.
716
+ * Add `ActiveRecord::Base.with_connection` as a shortcut for leasing a connection for a short duration.
2129
717
 
2130
- ```ruby
2131
- change_column_null :table, :column, true # good
2132
- change_column_null :table, :column, false # good
2133
- change_column_null :table, :column, from: true, to: false # raises (previously this made the column nullable)
2134
- ```
718
+ The leased connection is yielded, and for the duration of the block, any call to `ActiveRecord::Base.connection`
719
+ will yield that same connection.
2135
720
 
2136
- *Alex Ghiculescu*
721
+ This is useful to perform a few database operations without causing a connection to be leased for the
722
+ entire duration of the request or job.
2137
723
 
2138
- * Enforce limit on table names length.
724
+ *Jean Boussier*
2139
725
 
2140
- Fixes #45130.
726
+ * Deprecate `config.active_record.warn_on_records_fetched_greater_than` now that `sql.active_record`
727
+ notification includes `:row_count` field.
2141
728
 
2142
- *fatkodima*
729
+ *Jason Nochlin*
2143
730
 
2144
- * Adjust the minimum MariaDB version for check constraints support.
731
+ * The fix ensures that the association is joined using the appropriate join type
732
+ (either inner join or left outer join) based on the existing joins in the scope.
2145
733
 
2146
- *Eddie Lebow*
734
+ This prevents unintentional overrides of existing join types and ensures consistency in the generated SQL queries.
2147
735
 
2148
- * Fix Hstore deserialize regression.
736
+ Example:
2149
737
 
2150
- *edsharp*
2151
738
 
2152
- * Add validity for PostgreSQL indexes.
2153
739
 
2154
740
  ```ruby
2155
- connection.index_exists?(:users, :email, valid: true)
2156
- connection.indexes(:users).select(&:valid?)
741
+ # `associated` will use `LEFT JOIN` instead of using `JOIN`
742
+ Post.left_joins(:author).where.associated(:author)
2157
743
  ```
2158
744
 
2159
- *fatkodima*
745
+ *Saleh Alhaddad*
746
+
747
+ * Fix an issue where `ActiveRecord::Encryption` configurations are not ready before the loading
748
+ of Active Record models, when an application is eager loaded. As a result, encrypted attributes
749
+ could be misconfigured in some cases.
750
+
751
+ *Maxime Réty*
2160
752
 
2161
- * Fix eager loading for models without primary keys.
753
+ * Deprecate defining an `enum` with keyword arguments.
2162
754
 
2163
- *Anmol Chopra*, *Matt Lawrence*, and *Jonathan Hefner*
755
+ ```ruby
756
+ class Function > ApplicationRecord
757
+ # BAD
758
+ enum color: [:red, :blue],
759
+ type: [:instance, :class]
2164
760
 
2165
- * Avoid validating a unique field if it has not changed and is backed by a unique index.
761
+ # GOOD
762
+ enum :color, [:red, :blue]
763
+ enum :type, [:instance, :class]
764
+ end
765
+ ```
2166
766
 
2167
- Previously, when saving a record, Active Record will perform an extra query to check for the
2168
- uniqueness of each attribute having a `uniqueness` validation, even if that attribute hasn't changed.
2169
- If the database has the corresponding unique index, then this validation can never fail for persisted
2170
- records, and we could safely skip it.
767
+ *Hartley McGuire*
2171
768
 
2172
- *fatkodima*
769
+ * Add `config.active_record.validate_migration_timestamps` option for validating migration timestamps.
2173
770
 
2174
- * Stop setting `sql_auto_is_null`
771
+ When set, validates that the timestamp prefix for a migration is no more than a day ahead of
772
+ the timestamp associated with the current time. This is designed to prevent migrations prefixes
773
+ from being hand-edited to future timestamps, which impacts migration generation and other
774
+ migration commands.
2175
775
 
2176
- Since version 5.5 the default has been off, we no longer have to manually turn it off.
776
+ *Adrianna Chang*
2177
777
 
2178
- *Adam Hess*
778
+ * Properly synchronize `Mysql2Adapter#active?` and `TrilogyAdapter#active?`.
2179
779
 
2180
- * Fix `touch` to raise an error for readonly columns.
780
+ As well as `disconnect!` and `verify!`.
2181
781
 
2182
- *fatkodima*
782
+ This generally isn't a big problem as connections must not be shared between
783
+ threads, but is required when running transactional tests or system tests
784
+ and could lead to a SEGV.
2183
785
 
2184
- * Add ability to ignore tables by regexp for SQL schema dumps.
786
+ *Jean Boussier*
787
+
788
+ * Support `:source_location` tag option for query log tags.
2185
789
 
2186
790
  ```ruby
2187
- ActiveRecord::SchemaDumper.ignore_tables = [/^_/]
791
+ config.active_record.query_log_tags << :source_location
2188
792
  ```
2189
793
 
2190
- *fatkodima*
2191
-
2192
- * Avoid queries when performing calculations on contradictory relations.
794
+ Calculating the caller location is a costly operation and should be used primarily in development
795
+ (note, there is also a `config.active_record.verbose_query_logs` that serves the same purpose)
796
+ or occasionally on production for debugging purposes.
2193
797
 
2194
- Previously calculations would make a query even when passed a
2195
- contradiction, such as `User.where(id: []).count`. We no longer perform a
2196
- query in that scenario.
2197
-
2198
- This applies to the following calculations: `count`, `sum`, `average`,
2199
- `minimum` and `maximum`
798
+ *fatkodima*
2200
799
 
2201
- *Luan Vieira, John Hawthorn and Daniel Colson*
800
+ * Add an option to `ActiveRecord::Encryption::Encryptor` to disable compression.
2202
801
 
2203
- * Allow using aliased attributes with `insert_all`/`upsert_all`.
802
+ Allow compression to be disabled by setting `compress: false`
2204
803
 
2205
804
  ```ruby
2206
- class Book < ApplicationRecord
2207
- alias_attribute :title, :name
2208
- end
2209
-
2210
- Book.insert_all [{ title: "Remote", author_id: 1 }], returning: :title
805
+ class User
806
+ encrypts :name, encryptor: ActiveRecord::Encryption::Encryptor.new(compress: false)
807
+ end
2211
808
  ```
2212
809
 
2213
- *fatkodima*
810
+ *Donal McBreen*
2214
811
 
2215
- * Support encrypted attributes on columns with default db values.
812
+ * Deprecate passing strings to `ActiveRecord::Tasks::DatabaseTasks.cache_dump_filename`.
2216
813
 
2217
- This adds support for encrypted attributes defined on columns with default values.
2218
- It will encrypt those values at creation time. Before, it would raise an
2219
- error unless `config.active_record.encryption.support_unencrypted_data` was true.
814
+ A `ActiveRecord::DatabaseConfigurations::DatabaseConfig` object should be passed instead.
2220
815
 
2221
- *Jorge Manrubia* and *Dima Fatko*
816
+ *Rafael Mendonça França*
2222
817
 
2223
- * Allow overriding `reading_request?` in `DatabaseSelector::Resolver`
818
+ * Add `row_count` field to `sql.active_record` notification.
2224
819
 
2225
- The default implementation checks if a request is a `get?` or `head?`,
2226
- but you can now change it to anything you like. If the method returns true,
2227
- `Resolver#read` gets called meaning the request could be served by the
2228
- replica database.
820
+ This field returns the amount of rows returned by the query that emitted the notification.
2229
821
 
2230
- *Alex Ghiculescu*
822
+ This metric is useful in cases where one wants to detect queries with big result sets.
2231
823
 
2232
- * Remove `ActiveRecord.legacy_connection_handling`.
824
+ *Marvin Bitterlich*
2233
825
 
2234
- *Eileen M. Uchitelle*
826
+ * Consistently raise an `ArgumentError` when passing an invalid argument to a nested attributes association writer.
2235
827
 
2236
- * `rails db:schema:{dump,load}` now checks `ENV["SCHEMA_FORMAT"]` before config
828
+ Previously, this would only raise on collection associations and produce a generic error on singular associations.
2237
829
 
2238
- Since `rails db:structure:{dump,load}` was deprecated there wasn't a simple
2239
- way to dump a schema to both SQL and Ruby formats. You can now do this with
2240
- an environment variable. For example:
830
+ Now, it will raise on both collection and singular associations.
2241
831
 
2242
- ```
2243
- SCHEMA_FORMAT=sql rake db:schema:dump
2244
- ```
832
+ *Joshua Young*
2245
833
 
2246
- *Alex Ghiculescu*
834
+ * Fix single quote escapes on default generated MySQL columns.
2247
835
 
2248
- * Fixed MariaDB default function support.
836
+ MySQL 5.7.5+ supports generated columns, which can be used to create a column that is computed from an expression.
2249
837
 
2250
- Defaults would be written wrong in "db/schema.rb" and not work correctly
2251
- if using `db:schema:load`. Further more the function name would be
2252
- added as string content when saving new records.
838
+ Previously, the schema dump would output a string with double escapes for generated columns with single quotes in the default expression.
2253
839
 
2254
- *kaspernj*
840
+ This would result in issues when importing the schema on a fresh instance of a MySQL database.
2255
841
 
2256
- * Add `active_record.destroy_association_async_batch_size` configuration
842
+ Now, the string will not be escaped and will be valid Ruby upon importing of the schema.
2257
843
 
2258
- This allows applications to specify the maximum number of records that will
2259
- be destroyed in a single background job by the `dependent: :destroy_async`
2260
- association option. By default, the current behavior will remain the same:
2261
- when a parent record is destroyed, all dependent records will be destroyed
2262
- in a single background job. If the number of dependent records is greater
2263
- than this configuration, the records will be destroyed in multiple
2264
- background jobs.
844
+ *Yash Kapadia*
845
+
846
+ * Fix Migrations with versions older than 7.1 validating options given to
847
+ `add_reference` and `t.references`.
2265
848
 
2266
- *Nick Holden*
849
+ *Hartley McGuire*
2267
850
 
2268
- * Fix `remove_foreign_key` with `:if_exists` option when foreign key actually exists.
851
+ * Add `<role>_types` class method to `ActiveRecord::DelegatedType` so that the delegated types can be introspected.
2269
852
 
2270
- *fatkodima*
853
+ *JP Rosevear*
2271
854
 
2272
- * Remove `--no-comments` flag in structure dumps for PostgreSQL
855
+ * Make `schema_dump`, `query_cache`, `replica` and `database_tasks` configurable via `DATABASE_URL`.
2273
856
 
2274
- This broke some apps that used custom schema comments. If you don't want
2275
- comments in your structure dump, you can use:
857
+ This wouldn't always work previously because boolean values would be interpreted as strings.
2276
858
 
2277
- ```ruby
2278
- ActiveRecord::Tasks::DatabaseTasks.structure_dump_flags = ['--no-comments']
2279
- ```
859
+ e.g. `DATABASE_URL=postgres://localhost/foo?schema_dump=false` now properly disable dumping the schema
860
+ cache.
2280
861
 
2281
- *Alex Ghiculescu*
862
+ *Mike Coutermarsh*, *Jean Boussier*
2282
863
 
2283
- * Reduce the memory footprint of fixtures accessors.
864
+ * Introduce `ActiveRecord::Transactions::ClassMethods#set_callback`.
2284
865
 
2285
- Until now fixtures accessors were eagerly defined using `define_method`.
2286
- So the memory usage was directly dependent of the number of fixtures and
2287
- test suites.
866
+ It is identical to `ActiveSupport::Callbacks::ClassMethods#set_callback`
867
+ but with support for `after_commit` and `after_rollback` callback options.
2288
868
 
2289
- Instead fixtures accessors are now implemented with `method_missing`,
2290
- so they incur much less memory and CPU overhead.
869
+ *Joshua Young*
2291
870
 
2292
- *Jean Boussier*
871
+ * Make `ActiveRecord::Encryption::Encryptor` agnostic of the serialization format used for encrypted data.
2293
872
 
2294
- * Fix `config.active_record.destroy_association_async_job` configuration
873
+ Previously, the encryptor instance only allowed an encrypted value serialized as a `String` to be passed to the message serializer.
2295
874
 
2296
- `config.active_record.destroy_association_async_job` should allow
2297
- applications to specify the job that will be used to destroy associated
2298
- records in the background for `has_many` associations with the
2299
- `dependent: :destroy_async` option. Previously, that was ignored, which
2300
- meant the default `ActiveRecord::DestroyAssociationAsyncJob` always
2301
- destroyed records in the background.
875
+ Now, the encryptor lets the configured `message_serializer` decide which types of serialized encrypted values are supported. A custom serialiser is therefore allowed to serialize `ActiveRecord::Encryption::Message` objects using a type other than `String`.
2302
876
 
2303
- *Nick Holden*
877
+ The default `ActiveRecord::Encryption::MessageSerializer` already ensures that only `String` objects are passed for deserialization.
2304
878
 
2305
- * Fix `change_column_comment` to preserve column's AUTO_INCREMENT in the MySQL adapter
879
+ *Maxime Réty*
2306
880
 
2307
- *fatkodima*
881
+ * Fix `encrypted_attribute?` to take into account context properties passed to `encrypts`.
882
+
883
+ *Maxime Réty*
2308
884
 
2309
- * Fix quoting of `ActiveSupport::Duration` and `Rational` numbers in the MySQL adapter.
885
+ * The object returned by `explain` now responds to `pluck`, `first`,
886
+ `last`, `average`, `count`, `maximum`, `minimum`, and `sum`. Those
887
+ new methods run `EXPLAIN` on the corresponding queries:
2310
888
 
2311
- *Kevin McPhillips*
889
+ ```ruby
890
+ User.all.explain.count
891
+ # EXPLAIN SELECT COUNT(*) FROM `users`
892
+ # ...
2312
893
 
2313
- * Allow column name with COLLATE (e.g., title COLLATE "C") as safe SQL string
894
+ User.all.explain.maximum(:id)
895
+ # EXPLAIN SELECT MAX(`users`.`id`) FROM `users`
896
+ # ...
897
+ ```
2314
898
 
2315
- *Shugo Maeda*
899
+ *Petrik de Heus*
2316
900
 
2317
- * Permit underscores in the VERSION argument to database rake tasks.
901
+ * Fixes an issue where `validates_associated` `:on` option wasn't respected
902
+ when validating associated records.
2318
903
 
2319
- *Eddie Lebow*
904
+ *Austen Madden*, *Alex Ghiculescu*, *Rafał Brize*
2320
905
 
2321
- * Reversed the order of `INSERT` statements in `structure.sql` dumps
906
+ * Allow overriding SQLite defaults from `database.yml`.
2322
907
 
2323
- This should decrease the likelihood of merge conflicts. New migrations
2324
- will now be added at the top of the list.
908
+ Any PRAGMA configuration set under the `pragmas` key in the configuration
909
+ file takes precedence over Rails' defaults, and additional PRAGMAs can be
910
+ set as well.
2325
911
 
2326
- For existing apps, there will be a large diff the next time `structure.sql`
2327
- is generated.
912
+ ```yaml
913
+ database: storage/development.sqlite3
914
+ timeout: 5000
915
+ pragmas:
916
+ journal_mode: off
917
+ temp_store: memory
918
+ ```
2328
919
 
2329
- *Alex Ghiculescu*, *Matt Larraz*
920
+ *Stephen Margheim*
2330
921
 
2331
- * Fix PG.connect keyword arguments deprecation warning on ruby 2.7
922
+ * Remove warning message when running SQLite in production, but leave it unconfigured.
2332
923
 
2333
- Fixes #44307.
924
+ There are valid use cases for running SQLite in production. However, it must be done
925
+ with care, so instead of a warning most users won't see anyway, it's preferable to
926
+ leave the configuration commented out to force them to think about having the database
927
+ on a persistent volume etc.
2334
928
 
2335
- *Nikita Vasilevsky*
929
+ *Jacopo Beschi*, *Jean Boussier*
2336
930
 
2337
- * Fix dropping DB connections after serialization failures and deadlocks.
931
+ * Add support for generated columns to the SQLite3 adapter.
2338
932
 
2339
- Prior to 6.1.4, serialization failures and deadlocks caused rollbacks to be
2340
- issued for both real transactions and savepoints. This breaks MySQL which
2341
- disallows rollbacks of savepoints following a deadlock.
933
+ Generated columns (both stored and dynamic) are supported since version 3.31.0 of SQLite.
934
+ This adds support for those to the SQLite3 adapter.
2342
935
 
2343
- 6.1.4 removed these rollbacks, for both transactions and savepoints, causing
2344
- the DB connection to be left in an unknown state and thus discarded.
936
+ ```ruby
937
+ create_table :users do |t|
938
+ t.string :name
939
+ t.virtual :name_upper, type: :string, as: 'UPPER(name)'
940
+ t.virtual :name_lower, type: :string, as: 'LOWER(name)', stored: true
941
+ end
942
+ ```
2345
943
 
2346
- These rollbacks are now restored, except for savepoints on MySQL.
944
+ *Stephen Margheim*
2347
945
 
2348
- *Thomas Morgan*
946
+ * TrilogyAdapter: ignore `host` if `socket` parameter is set.
2349
947
 
2350
- * Make `ActiveRecord::ConnectionPool` Fiber-safe
948
+ This allows to configure a connection on a UNIX socket via `DATABASE_URL`:
2351
949
 
2352
- When `ActiveSupport::IsolatedExecutionState.isolation_level` is set to `:fiber`,
2353
- the connection pool now supports multiple Fibers from the same Thread checking
2354
- out connections from the pool.
950
+ ```
951
+ DATABASE_URL=trilogy://does-not-matter/my_db_production?socket=/var/run/mysql.sock
952
+ ```
2355
953
 
2356
- *Alex Matchneer*
954
+ *Jean Boussier*
2357
955
 
2358
- * Add `update_attribute!` to `ActiveRecord::Persistence`
956
+ * Make `assert_queries_count`, `assert_no_queries`, `assert_queries_match`, and
957
+ `assert_no_queries_match` assertions public.
2359
958
 
2360
- Similar to `update_attribute`, but raises `ActiveRecord::RecordNotSaved` when a `before_*` callback throws `:abort`.
959
+ To assert the expected number of queries are made, Rails internally uses `assert_queries_count` and
960
+ `assert_no_queries`. To assert that specific SQL queries are made, `assert_queries_match` and
961
+ `assert_no_queries_match` are used. These assertions can now be used in applications as well.
2361
962
 
2362
963
  ```ruby
2363
- class Topic < ActiveRecord::Base
2364
- before_save :check_title
964
+ class ArticleTest < ActiveSupport::TestCase
965
+ test "queries are made" do
966
+ assert_queries_count(1) { Article.first }
967
+ end
2365
968
 
2366
- def check_title
2367
- throw(:abort) if title == "abort"
969
+ test "creates a foreign key" do
970
+ assert_queries_match(/ADD FOREIGN KEY/i, include_schema: true) do
971
+ @connection.add_foreign_key(:comments, :posts)
972
+ end
2368
973
  end
2369
974
  end
2370
-
2371
- topic = Topic.create(title: "Test Title")
2372
- # #=> #<Topic title: "Test Title">
2373
- topic.update_attribute!(:title, "Another Title")
2374
- # #=> #<Topic title: "Another Title">
2375
- topic.update_attribute!(:title, "abort")
2376
- # raises ActiveRecord::RecordNotSaved
2377
975
  ```
2378
976
 
2379
- *Drew Tempelmeyer*
977
+ *Petrik de Heus*, *fatkodima*
2380
978
 
2381
- * Avoid loading every record in `ActiveRecord::Relation#pretty_print`
979
+ * Fix `has_secure_token` calls the setter method on initialize.
2382
980
 
2383
- ```ruby
2384
- # Before
2385
- pp Foo.all # Loads the whole table.
981
+ *Abeid Ahmed*
2386
982
 
2387
- # After
2388
- pp Foo.all # Shows 10 items and an ellipsis.
983
+ * When using a `DATABASE_URL`, allow for a configuration to map the protocol in the URL to a specific database
984
+ adapter. This allows decoupling the adapter the application chooses to use from the database connection details
985
+ set in the deployment environment.
986
+
987
+ ```ruby
988
+ # ENV['DATABASE_URL'] = "mysql://localhost/example_database"
989
+ config.active_record.protocol_adapters.mysql = "trilogy"
990
+ # will connect to MySQL using the trilogy adapter
2389
991
  ```
2390
992
 
2391
- *Ulysse Buonomo*
993
+ *Jean Boussier*, *Kevin McPhillips*
994
+
995
+ * In cases where MySQL returns `warning_count` greater than zero, but returns no warnings when
996
+ the `SHOW WARNINGS` query is executed, `ActiveRecord.db_warnings_action` proc will still be
997
+ called with a generic warning message rather than silently ignoring the warning(s).
2392
998
 
2393
- * Change `QueryMethods#in_order_of` to drop records not listed in values.
999
+ *Kevin McPhillips*
1000
+
1001
+ * `DatabaseConfigurations#configs_for` accepts a symbol in the `name` parameter.
1002
+
1003
+ *Andrew Novoselac*
2394
1004
 
2395
- `in_order_of` now filters down to the values provided, to match the behavior of the `Enumerable` version.
1005
+ * Fix `where(field: values)` queries when `field` is a serialized attribute
1006
+ (for example, when `field` uses `ActiveRecord::Base.serialize` or is a JSON
1007
+ column).
2396
1008
 
2397
- *Kevin Newton*
1009
+ *João Alves*
2398
1010
 
2399
- * Allow named expression indexes to be revertible.
1011
+ * Make the output of `ActiveRecord::Core#inspect` configurable.
2400
1012
 
2401
- Previously, the following code would raise an error in a reversible migration executed while rolling back, due to the index name not being used in the index removal.
1013
+ By default, calling `inspect` on a record will yield a formatted string including just the `id`.
2402
1014
 
2403
1015
  ```ruby
2404
- add_index(:settings, "(data->'property')", using: :gin, name: :index_settings_data_property)
1016
+ Post.first.inspect #=> "#<Post id: 1>"
2405
1017
  ```
2406
1018
 
2407
- Fixes #43331.
1019
+ The attributes to be included in the output of `inspect` can be configured with
1020
+ `ActiveRecord::Core#attributes_for_inspect`.
2408
1021
 
2409
- *Oliver Günther*
1022
+ ```ruby
1023
+ Post.attributes_for_inspect = [:id, :title]
1024
+ Post.first.inspect #=> "#<Post id: 1, title: "Hello, World!">"
1025
+ ```
2410
1026
 
2411
- * Fix incorrect argument in PostgreSQL structure dump tasks.
1027
+ With `attributes_for_inspect` set to `:all`, `inspect` will list all the record's attributes.
2412
1028
 
2413
- Updating the `--no-comment` argument added in Rails 7 to the correct `--no-comments` argument.
1029
+ ```ruby
1030
+ Post.attributes_for_inspect = :all
1031
+ Post.first.inspect #=> "#<Post id: 1, title: "Hello, World!", published_at: "2023-10-23 14:28:11 +0000">"
1032
+ ```
2414
1033
 
2415
- *Alex Dent*
1034
+ In `development` and `test` mode, `attributes_for_inspect` will be set to `:all` by default.
2416
1035
 
2417
- * Fix migration compatibility to create SQLite references/belongs_to column as integer when migration version is 6.0.
1036
+ You can also call `full_inspect` to get an inspection with all the attributes.
2418
1037
 
2419
- Reference/belongs_to in migrations with version 6.0 were creating columns as
2420
- bigint instead of integer for the SQLite Adapter.
1038
+ The attributes in `attribute_for_inspect` will also be used for `pretty_print`.
2421
1039
 
2422
- *Marcelo Lauxen*
1040
+ *Andrew Novoselac*
2423
1041
 
2424
- * Fix `QueryMethods#in_order_of` to handle empty order list.
1042
+ * Don't mark attributes as changed when reassigned to `Float::INFINITY` or
1043
+ `-Float::INFINITY`.
2425
1044
 
2426
- ```ruby
2427
- Post.in_order_of(:id, []).to_a
2428
- ```
1045
+ *Maicol Bentancor*
2429
1046
 
2430
- Also more explicitly set the column as secondary order, so that any other
2431
- value is still ordered.
1047
+ * Support the `RETURNING` clause for MariaDB.
2432
1048
 
2433
- *Jean Boussier*
1049
+ *fatkodima*, *Nikolay Kondratyev*
2434
1050
 
2435
- * Fix quoting of column aliases generated by calculation methods.
1051
+ * The SQLite3 adapter now implements the `supports_deferrable_constraints?` contract.
2436
1052
 
2437
- Since the alias is derived from the table name, we can't assume the result
2438
- is a valid identifier.
1053
+ Allows foreign keys to be deferred by adding the `:deferrable` key to the `foreign_key` options.
2439
1054
 
2440
1055
  ```ruby
2441
- class Test < ActiveRecord::Base
2442
- self.table_name = '1abc'
2443
- end
2444
- Test.group(:id).count
2445
- # syntax error at or near "1" (ActiveRecord::StatementInvalid)
2446
- # LINE 1: SELECT COUNT(*) AS count_all, "1abc"."id" AS 1abc_id FROM "1...
1056
+ add_reference :person, :alias, foreign_key: { deferrable: :deferred }
1057
+ add_reference :alias, :person, foreign_key: { deferrable: :deferred }
2447
1058
  ```
2448
1059
 
2449
- *Jean Boussier*
2450
-
2451
- * Add `authenticate_by` when using `has_secure_password`.
1060
+ *Stephen Margheim*
2452
1061
 
2453
- `authenticate_by` is intended to replace code like the following, which
2454
- returns early when a user with a matching email is not found:
1062
+ * Add the `set_constraints` helper to PostgreSQL connections.
2455
1063
 
2456
1064
  ```ruby
2457
- User.find_by(email: "...")&.authenticate("...")
1065
+ Post.create!(user_id: -1) # => ActiveRecord::InvalidForeignKey
1066
+
1067
+ Post.transaction do
1068
+ Post.connection.set_constraints(:deferred)
1069
+ p = Post.create!(user_id: -1)
1070
+ u = User.create!
1071
+ p.user = u
1072
+ p.save!
1073
+ end
2458
1074
  ```
2459
1075
 
2460
- Such code is vulnerable to timing-based enumeration attacks, wherein an
2461
- attacker can determine if a user account with a given email exists. After
2462
- confirming that an account exists, the attacker can try passwords associated
2463
- with that email address from other leaked databases, in case the user
2464
- re-used a password across multiple sites (a common practice). Additionally,
2465
- knowing an account email address allows the attacker to attempt a targeted
2466
- phishing ("spear phishing") attack.
1076
+ *Cody Cutrer*
1077
+
1078
+ * Include `ActiveModel::API` in `ActiveRecord::Base`.
1079
+
1080
+ *Sean Doyle*
1081
+
1082
+ * Ensure `#signed_id` outputs `url_safe` strings.
2467
1083
 
2468
- `authenticate_by` addresses the vulnerability by taking the same amount of
2469
- time regardless of whether a user with a matching email is found:
1084
+ *Jason Meller*
1085
+
1086
+ * Add `nulls_last` and working `desc.nulls_first` for MySQL.
1087
+
1088
+ *Tristan Fellows*
1089
+
1090
+ * Allow for more complex hash arguments for `order` which mimics `where` in `ActiveRecord::Relation`.
2470
1091
 
2471
1092
  ```ruby
2472
- User.authenticate_by(email: "...", password: "...")
1093
+ Topic.includes(:posts).order(posts: { created_at: :desc })
2473
1094
  ```
2474
1095
 
2475
- *Jonathan Hefner*
2476
-
1096
+ *Myles Boone*
2477
1097
 
2478
- Please check [7-0-stable](https://github.com/rails/rails/blob/7-0-stable/activerecord/CHANGELOG.md) for previous changes.
1098
+ Please check [7-1-stable](https://github.com/rails/rails/blob/7-1-stable/activerecord/CHANGELOG.md) for previous changes.