activerecord 6.1.7 → 7.0.8.1

Sign up to get free protection for your applications and to get access to all the features.
Files changed (251) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +1615 -1001
  3. data/README.rdoc +3 -3
  4. data/lib/active_record/aggregations.rb +1 -1
  5. data/lib/active_record/association_relation.rb +0 -10
  6. data/lib/active_record/associations/association.rb +33 -17
  7. data/lib/active_record/associations/association_scope.rb +1 -3
  8. data/lib/active_record/associations/belongs_to_association.rb +15 -4
  9. data/lib/active_record/associations/belongs_to_polymorphic_association.rb +10 -2
  10. data/lib/active_record/associations/builder/association.rb +8 -2
  11. data/lib/active_record/associations/builder/belongs_to.rb +19 -6
  12. data/lib/active_record/associations/builder/collection_association.rb +10 -3
  13. data/lib/active_record/associations/builder/has_many.rb +3 -2
  14. data/lib/active_record/associations/builder/has_one.rb +2 -1
  15. data/lib/active_record/associations/builder/singular_association.rb +2 -2
  16. data/lib/active_record/associations/collection_association.rb +20 -22
  17. data/lib/active_record/associations/collection_proxy.rb +15 -5
  18. data/lib/active_record/associations/disable_joins_association_scope.rb +59 -0
  19. data/lib/active_record/associations/has_many_association.rb +8 -5
  20. data/lib/active_record/associations/has_many_through_association.rb +2 -1
  21. data/lib/active_record/associations/has_one_association.rb +10 -7
  22. data/lib/active_record/associations/has_one_through_association.rb +1 -1
  23. data/lib/active_record/associations/join_dependency.rb +23 -15
  24. data/lib/active_record/associations/preloader/association.rb +186 -52
  25. data/lib/active_record/associations/preloader/batch.rb +48 -0
  26. data/lib/active_record/associations/preloader/branch.rb +147 -0
  27. data/lib/active_record/associations/preloader/through_association.rb +50 -14
  28. data/lib/active_record/associations/preloader.rb +39 -113
  29. data/lib/active_record/associations/singular_association.rb +8 -2
  30. data/lib/active_record/associations/through_association.rb +3 -3
  31. data/lib/active_record/associations.rb +138 -100
  32. data/lib/active_record/asynchronous_queries_tracker.rb +60 -0
  33. data/lib/active_record/attribute_assignment.rb +1 -1
  34. data/lib/active_record/attribute_methods/before_type_cast.rb +7 -2
  35. data/lib/active_record/attribute_methods/dirty.rb +49 -16
  36. data/lib/active_record/attribute_methods/primary_key.rb +2 -2
  37. data/lib/active_record/attribute_methods/query.rb +2 -2
  38. data/lib/active_record/attribute_methods/read.rb +8 -6
  39. data/lib/active_record/attribute_methods/serialization.rb +57 -19
  40. data/lib/active_record/attribute_methods/time_zone_conversion.rb +4 -3
  41. data/lib/active_record/attribute_methods/write.rb +7 -10
  42. data/lib/active_record/attribute_methods.rb +19 -22
  43. data/lib/active_record/attributes.rb +24 -35
  44. data/lib/active_record/autosave_association.rb +8 -23
  45. data/lib/active_record/base.rb +19 -1
  46. data/lib/active_record/callbacks.rb +14 -16
  47. data/lib/active_record/coders/yaml_column.rb +4 -8
  48. data/lib/active_record/connection_adapters/abstract/connection_handler.rb +292 -0
  49. data/lib/active_record/connection_adapters/abstract/connection_pool/queue.rb +209 -0
  50. data/lib/active_record/connection_adapters/abstract/connection_pool/reaper.rb +76 -0
  51. data/lib/active_record/connection_adapters/abstract/connection_pool.rb +47 -561
  52. data/lib/active_record/connection_adapters/abstract/database_limits.rb +0 -17
  53. data/lib/active_record/connection_adapters/abstract/database_statements.rb +46 -22
  54. data/lib/active_record/connection_adapters/abstract/query_cache.rb +24 -12
  55. data/lib/active_record/connection_adapters/abstract/quoting.rb +52 -73
  56. data/lib/active_record/connection_adapters/abstract/schema_creation.rb +4 -17
  57. data/lib/active_record/connection_adapters/abstract/schema_definitions.rb +52 -23
  58. data/lib/active_record/connection_adapters/abstract/schema_dumper.rb +14 -1
  59. data/lib/active_record/connection_adapters/abstract/schema_statements.rb +82 -25
  60. data/lib/active_record/connection_adapters/abstract/transaction.rb +15 -22
  61. data/lib/active_record/connection_adapters/abstract_adapter.rb +144 -82
  62. data/lib/active_record/connection_adapters/abstract_mysql_adapter.rb +115 -85
  63. data/lib/active_record/connection_adapters/column.rb +4 -0
  64. data/lib/active_record/connection_adapters/mysql/database_statements.rb +37 -25
  65. data/lib/active_record/connection_adapters/mysql/quoting.rb +50 -23
  66. data/lib/active_record/connection_adapters/mysql/schema_definitions.rb +4 -1
  67. data/lib/active_record/connection_adapters/mysql/schema_dumper.rb +7 -1
  68. data/lib/active_record/connection_adapters/mysql/schema_statements.rb +20 -1
  69. data/lib/active_record/connection_adapters/mysql2_adapter.rb +12 -6
  70. data/lib/active_record/connection_adapters/pool_config.rb +7 -7
  71. data/lib/active_record/connection_adapters/postgresql/column.rb +19 -1
  72. data/lib/active_record/connection_adapters/postgresql/database_statements.rb +20 -17
  73. data/lib/active_record/connection_adapters/postgresql/oid/array.rb +1 -1
  74. data/lib/active_record/connection_adapters/postgresql/oid/date.rb +8 -0
  75. data/lib/active_record/connection_adapters/postgresql/oid/date_time.rb +5 -0
  76. data/lib/active_record/connection_adapters/postgresql/oid/hstore.rb +53 -14
  77. data/lib/active_record/connection_adapters/postgresql/oid/range.rb +1 -1
  78. data/lib/active_record/connection_adapters/postgresql/oid/timestamp.rb +15 -0
  79. data/lib/active_record/connection_adapters/postgresql/oid/timestamp_with_time_zone.rb +30 -0
  80. data/lib/active_record/connection_adapters/postgresql/oid/type_map_initializer.rb +18 -6
  81. data/lib/active_record/connection_adapters/postgresql/oid.rb +2 -0
  82. data/lib/active_record/connection_adapters/postgresql/quoting.rb +82 -53
  83. data/lib/active_record/connection_adapters/postgresql/referential_integrity.rb +34 -0
  84. data/lib/active_record/connection_adapters/postgresql/schema_creation.rb +21 -1
  85. data/lib/active_record/connection_adapters/postgresql/schema_definitions.rb +22 -1
  86. data/lib/active_record/connection_adapters/postgresql/schema_dumper.rb +25 -0
  87. data/lib/active_record/connection_adapters/postgresql/schema_statements.rb +40 -21
  88. data/lib/active_record/connection_adapters/postgresql/utils.rb +9 -10
  89. data/lib/active_record/connection_adapters/postgresql_adapter.rb +207 -106
  90. data/lib/active_record/connection_adapters/schema_cache.rb +39 -38
  91. data/lib/active_record/connection_adapters/sqlite3/database_statements.rb +25 -19
  92. data/lib/active_record/connection_adapters/sqlite3/quoting.rb +33 -18
  93. data/lib/active_record/connection_adapters/sqlite3/schema_definitions.rb +6 -0
  94. data/lib/active_record/connection_adapters/sqlite3/schema_statements.rb +19 -17
  95. data/lib/active_record/connection_adapters/sqlite3_adapter.rb +98 -36
  96. data/lib/active_record/connection_adapters.rb +6 -5
  97. data/lib/active_record/connection_handling.rb +49 -55
  98. data/lib/active_record/core.rb +123 -141
  99. data/lib/active_record/database_configurations/connection_url_resolver.rb +2 -1
  100. data/lib/active_record/database_configurations/database_config.rb +12 -9
  101. data/lib/active_record/database_configurations/hash_config.rb +63 -5
  102. data/lib/active_record/database_configurations/url_config.rb +2 -2
  103. data/lib/active_record/database_configurations.rb +15 -32
  104. data/lib/active_record/delegated_type.rb +53 -12
  105. data/lib/active_record/destroy_association_async_job.rb +1 -1
  106. data/lib/active_record/disable_joins_association_relation.rb +39 -0
  107. data/lib/active_record/dynamic_matchers.rb +1 -1
  108. data/lib/active_record/encryption/cipher/aes256_gcm.rb +98 -0
  109. data/lib/active_record/encryption/cipher.rb +53 -0
  110. data/lib/active_record/encryption/config.rb +44 -0
  111. data/lib/active_record/encryption/configurable.rb +67 -0
  112. data/lib/active_record/encryption/context.rb +35 -0
  113. data/lib/active_record/encryption/contexts.rb +72 -0
  114. data/lib/active_record/encryption/derived_secret_key_provider.rb +12 -0
  115. data/lib/active_record/encryption/deterministic_key_provider.rb +14 -0
  116. data/lib/active_record/encryption/encryptable_record.rb +206 -0
  117. data/lib/active_record/encryption/encrypted_attribute_type.rb +140 -0
  118. data/lib/active_record/encryption/encrypted_fixtures.rb +38 -0
  119. data/lib/active_record/encryption/encrypting_only_encryptor.rb +12 -0
  120. data/lib/active_record/encryption/encryptor.rb +155 -0
  121. data/lib/active_record/encryption/envelope_encryption_key_provider.rb +55 -0
  122. data/lib/active_record/encryption/errors.rb +15 -0
  123. data/lib/active_record/encryption/extended_deterministic_queries.rb +160 -0
  124. data/lib/active_record/encryption/extended_deterministic_uniqueness_validator.rb +28 -0
  125. data/lib/active_record/encryption/key.rb +28 -0
  126. data/lib/active_record/encryption/key_generator.rb +42 -0
  127. data/lib/active_record/encryption/key_provider.rb +46 -0
  128. data/lib/active_record/encryption/message.rb +33 -0
  129. data/lib/active_record/encryption/message_serializer.rb +90 -0
  130. data/lib/active_record/encryption/null_encryptor.rb +21 -0
  131. data/lib/active_record/encryption/properties.rb +76 -0
  132. data/lib/active_record/encryption/read_only_null_encryptor.rb +24 -0
  133. data/lib/active_record/encryption/scheme.rb +99 -0
  134. data/lib/active_record/encryption.rb +55 -0
  135. data/lib/active_record/enum.rb +50 -43
  136. data/lib/active_record/errors.rb +67 -4
  137. data/lib/active_record/explain_registry.rb +11 -6
  138. data/lib/active_record/explain_subscriber.rb +1 -1
  139. data/lib/active_record/fixture_set/file.rb +15 -1
  140. data/lib/active_record/fixture_set/table_row.rb +41 -6
  141. data/lib/active_record/fixture_set/table_rows.rb +4 -4
  142. data/lib/active_record/fixtures.rb +20 -23
  143. data/lib/active_record/future_result.rb +139 -0
  144. data/lib/active_record/gem_version.rb +5 -5
  145. data/lib/active_record/inheritance.rb +55 -17
  146. data/lib/active_record/insert_all.rb +80 -14
  147. data/lib/active_record/integration.rb +4 -3
  148. data/lib/active_record/internal_metadata.rb +1 -5
  149. data/lib/active_record/legacy_yaml_adapter.rb +2 -39
  150. data/lib/active_record/locking/optimistic.rb +36 -21
  151. data/lib/active_record/locking/pessimistic.rb +10 -4
  152. data/lib/active_record/log_subscriber.rb +23 -7
  153. data/lib/active_record/middleware/database_selector/resolver.rb +6 -10
  154. data/lib/active_record/middleware/database_selector.rb +18 -6
  155. data/lib/active_record/middleware/shard_selector.rb +60 -0
  156. data/lib/active_record/migration/command_recorder.rb +8 -9
  157. data/lib/active_record/migration/compatibility.rb +93 -46
  158. data/lib/active_record/migration/join_table.rb +1 -1
  159. data/lib/active_record/migration.rb +167 -87
  160. data/lib/active_record/model_schema.rb +58 -59
  161. data/lib/active_record/nested_attributes.rb +13 -12
  162. data/lib/active_record/no_touching.rb +3 -3
  163. data/lib/active_record/null_relation.rb +2 -6
  164. data/lib/active_record/persistence.rb +231 -61
  165. data/lib/active_record/query_cache.rb +2 -2
  166. data/lib/active_record/query_logs.rb +149 -0
  167. data/lib/active_record/querying.rb +16 -6
  168. data/lib/active_record/railtie.rb +136 -22
  169. data/lib/active_record/railties/controller_runtime.rb +4 -5
  170. data/lib/active_record/railties/databases.rake +78 -136
  171. data/lib/active_record/readonly_attributes.rb +11 -0
  172. data/lib/active_record/reflection.rb +80 -49
  173. data/lib/active_record/relation/batches/batch_enumerator.rb +19 -5
  174. data/lib/active_record/relation/batches.rb +6 -6
  175. data/lib/active_record/relation/calculations.rb +92 -60
  176. data/lib/active_record/relation/delegation.rb +7 -7
  177. data/lib/active_record/relation/finder_methods.rb +31 -35
  178. data/lib/active_record/relation/merger.rb +20 -13
  179. data/lib/active_record/relation/predicate_builder/association_query_value.rb +20 -1
  180. data/lib/active_record/relation/predicate_builder.rb +1 -6
  181. data/lib/active_record/relation/query_attribute.rb +28 -11
  182. data/lib/active_record/relation/query_methods.rb +306 -68
  183. data/lib/active_record/relation/record_fetch_warning.rb +7 -9
  184. data/lib/active_record/relation/spawn_methods.rb +2 -2
  185. data/lib/active_record/relation/where_clause.rb +10 -19
  186. data/lib/active_record/relation.rb +189 -88
  187. data/lib/active_record/result.rb +23 -11
  188. data/lib/active_record/runtime_registry.rb +9 -13
  189. data/lib/active_record/sanitization.rb +17 -12
  190. data/lib/active_record/schema.rb +38 -23
  191. data/lib/active_record/schema_dumper.rb +29 -19
  192. data/lib/active_record/schema_migration.rb +4 -4
  193. data/lib/active_record/scoping/default.rb +60 -13
  194. data/lib/active_record/scoping/named.rb +3 -11
  195. data/lib/active_record/scoping.rb +64 -34
  196. data/lib/active_record/serialization.rb +6 -1
  197. data/lib/active_record/signed_id.rb +3 -3
  198. data/lib/active_record/store.rb +2 -2
  199. data/lib/active_record/suppressor.rb +11 -15
  200. data/lib/active_record/table_metadata.rb +6 -2
  201. data/lib/active_record/tasks/database_tasks.rb +127 -60
  202. data/lib/active_record/tasks/mysql_database_tasks.rb +1 -1
  203. data/lib/active_record/tasks/postgresql_database_tasks.rb +19 -13
  204. data/lib/active_record/test_databases.rb +1 -1
  205. data/lib/active_record/test_fixtures.rb +9 -6
  206. data/lib/active_record/timestamp.rb +3 -4
  207. data/lib/active_record/transactions.rb +12 -17
  208. data/lib/active_record/translation.rb +3 -3
  209. data/lib/active_record/type/adapter_specific_registry.rb +32 -7
  210. data/lib/active_record/type/hash_lookup_type_map.rb +34 -1
  211. data/lib/active_record/type/internal/timezone.rb +2 -2
  212. data/lib/active_record/type/serialized.rb +9 -5
  213. data/lib/active_record/type/type_map.rb +17 -20
  214. data/lib/active_record/type.rb +1 -2
  215. data/lib/active_record/validations/associated.rb +4 -4
  216. data/lib/active_record/validations/presence.rb +2 -2
  217. data/lib/active_record/validations/uniqueness.rb +4 -4
  218. data/lib/active_record/version.rb +1 -1
  219. data/lib/active_record.rb +225 -27
  220. data/lib/arel/attributes/attribute.rb +0 -8
  221. data/lib/arel/crud.rb +28 -22
  222. data/lib/arel/delete_manager.rb +18 -4
  223. data/lib/arel/filter_predications.rb +9 -0
  224. data/lib/arel/insert_manager.rb +2 -3
  225. data/lib/arel/nodes/and.rb +4 -0
  226. data/lib/arel/nodes/casted.rb +1 -1
  227. data/lib/arel/nodes/delete_statement.rb +12 -13
  228. data/lib/arel/nodes/filter.rb +10 -0
  229. data/lib/arel/nodes/function.rb +1 -0
  230. data/lib/arel/nodes/insert_statement.rb +2 -2
  231. data/lib/arel/nodes/select_core.rb +2 -2
  232. data/lib/arel/nodes/select_statement.rb +2 -2
  233. data/lib/arel/nodes/update_statement.rb +8 -3
  234. data/lib/arel/nodes.rb +1 -0
  235. data/lib/arel/predications.rb +11 -3
  236. data/lib/arel/select_manager.rb +10 -4
  237. data/lib/arel/table.rb +0 -1
  238. data/lib/arel/tree_manager.rb +0 -12
  239. data/lib/arel/update_manager.rb +18 -4
  240. data/lib/arel/visitors/dot.rb +80 -90
  241. data/lib/arel/visitors/mysql.rb +8 -2
  242. data/lib/arel/visitors/postgresql.rb +0 -10
  243. data/lib/arel/visitors/to_sql.rb +58 -2
  244. data/lib/arel.rb +2 -1
  245. data/lib/rails/generators/active_record/application_record/templates/application_record.rb.tt +1 -1
  246. data/lib/rails/generators/active_record/model/templates/abstract_base_class.rb.tt +1 -1
  247. data/lib/rails/generators/active_record/model/templates/model.rb.tt +1 -1
  248. data/lib/rails/generators/active_record/model/templates/module.rb.tt +2 -2
  249. data/lib/rails/generators/active_record/multi_db/multi_db_generator.rb +16 -0
  250. data/lib/rails/generators/active_record/multi_db/templates/multi_db.rb.tt +44 -0
  251. metadata +55 -11
data/CHANGELOG.md CHANGED
@@ -1,1767 +1,2381 @@
1
- ## Rails 6.1.7 (September 09, 2022) ##
1
+ ## Rails 7.0.8.1 (February 21, 2024) ##
2
2
 
3
- * Symbol is allowed by default for YAML columns
3
+ * No changes.
4
4
 
5
- *Étienne Barrié*
6
5
 
7
- * Fix `ActiveRecord::Store` to serialize as a regular Hash
6
+ ## Rails 7.0.8 (September 09, 2023) ##
8
7
 
9
- Previously it would serialize as an `ActiveSupport::HashWithIndifferentAccess`
10
- which is wasteful and cause problem with YAML safe_load.
8
+ * Fix `change_column` not setting `precision: 6` on `datetime` columns when
9
+ using 7.0+ Migrations and SQLite.
11
10
 
12
- *Jean Boussier*
11
+ *Hartley McGuire*
13
12
 
14
- * Fix PG.connect keyword arguments deprecation warning on ruby 2.7
13
+ * Fix unscope is not working in specific case
15
14
 
16
- Fixes #44307.
15
+ Before:
16
+ ```ruby
17
+ Post.where(id: 1...3).unscope(where: :id).to_sql # "SELECT `posts`.* FROM `posts` WHERE `posts`.`id` >= 1 AND `posts`.`id` < 3"
17
18
 
18
- *Nikita Vasilevsky*
19
+ ```
19
20
 
20
- ## Rails 6.1.6.1 (July 12, 2022) ##
21
+ After:
22
+ ```ruby
23
+ Post.where(id: 1...3).unscope(where: :id).to_sql # "SELECT `posts`.* FROM `posts`"
24
+ ```
21
25
 
22
- * Change ActiveRecord::Coders::YAMLColumn default to safe_load
26
+ Fixes #48094.
23
27
 
24
- This adds two new configuration options The configuration options are as
25
- follows:
26
-
27
- * `config.active_storage.use_yaml_unsafe_load`
28
-
29
- When set to true, this configuration option tells Rails to use the old
30
- "unsafe" YAML loading strategy, maintaining the existing behavior but leaving
31
- the possible escalation vulnerability in place. Setting this option to true
32
- is *not* recommended, but can aid in upgrading.
33
-
34
- * `config.active_record.yaml_column_permitted_classes`
35
-
36
- The "safe YAML" loading method does not allow all classes to be deserialized
37
- by default. This option allows you to specify classes deemed "safe" in your
38
- application. For example, if your application uses Symbol and Time in
39
- serialized data, you can add Symbol and Time to the allowed list as follows:
40
-
28
+ *Kazuya Hatanaka*
29
+
30
+ * Fix associations to a STI model including a `class_name` parameter
31
+
32
+ ```ruby
33
+ class Product < ApplicationRecord
34
+ has_many :requests, as: :requestable, class_name: "ProductRequest", dependent: :destroy
35
+ end
36
+
37
+ # STI tables
38
+ class Request < ApplicationRecord
39
+ belongs_to :requestable, polymorphic: true
40
+
41
+ validate :request_type, presence: true
42
+ end
43
+
44
+ class ProductRequest < Request
45
+ belongs_to :user
46
+ end
41
47
  ```
42
- config.active_record.yaml_column_permitted_classes = [Symbol, Date, Time]
48
+
49
+ Accessing such association would lead to:
50
+
51
+ ```
52
+ table_metadata.rb:22:in `has_column?': undefined method `key?' for nil:NilClass (NoMethodError)
43
53
  ```
44
54
 
45
- [CVE-2022-32224]
55
+ *Romain Filinto*
56
+
57
+ * Fix `change_table` setting datetime precision for 6.1 Migrations
58
+
59
+ *Hartley McGuire*
46
60
 
61
+ * Fix change_column setting datetime precision for 6.1 Migrations
47
62
 
48
- ## Rails 6.1.6 (May 09, 2022) ##
63
+ *Hartley McGuire*
64
+
65
+ ## Rails 7.0.7.2 (August 22, 2023) ##
49
66
 
50
67
  * No changes.
51
68
 
52
69
 
53
- ## Rails 6.1.5.1 (April 26, 2022) ##
70
+ ## Rails 7.0.7.1 (August 22, 2023) ##
54
71
 
55
72
  * No changes.
56
73
 
57
74
 
58
- ## Rails 6.1.5 (March 09, 2022) ##
75
+ ## Rails 7.0.7 (August 09, 2023) ##
59
76
 
60
- * Fix `ActiveRecord::ConnectionAdapters::SchemaCache#deep_deduplicate` for Ruby 2.6.
77
+ * Restores functionality to the missing method when using enums and fixes.
61
78
 
62
- Ruby 2.6 and 2.7 have slightly different implementations of the `String#-@` method.
63
- In Ruby 2.6, the receiver of the `String#-@` method is modified under certain circumstances.
64
- This was later identified as a bug (https://bugs.ruby-lang.org/issues/15926) and only
65
- fixed in Ruby 2.7.
79
+ *paulreece*
66
80
 
67
- Before the changes in this commit, the
68
- `ActiveRecord::ConnectionAdapters::SchemaCache#deep_deduplicate` method, which internally
69
- calls the `String#-@` method, could also modify an input string argument in Ruby 2.6 --
70
- changing a tainted, unfrozen string into a tainted, frozen string.
81
+ * Fix `StatementCache::Substitute` with serialized type.
71
82
 
72
- Fixes #43056
83
+ *ywenc*
73
84
 
74
- *Eric O'Hanlon*
85
+ * Fix `:db_runtime` on notification payload when application have multiple databases.
75
86
 
76
- * Fix migration compatibility to create SQLite references/belongs_to column as integer when
77
- migration version is 6.0.
87
+ *Eileen M. Uchitelle*
78
88
 
79
- `reference`/`belongs_to` in migrations with version 6.0 were creating columns as
80
- bigint instead of integer for the SQLite Adapter.
89
+ * Correctly dump check constraints for MySQL 8.0.16+.
81
90
 
82
- *Marcelo Lauxen*
91
+ *Steve Hill*
83
92
 
84
- * Fix dbconsole for 3-tier config.
93
+ * Fix `ActiveRecord::QueryMethods#in_order_of` to include `nil`s, to match the
94
+ behavior of `Enumerable#in_order_of`.
85
95
 
86
- *Eileen M. Uchitelle*
96
+ For example, `Post.in_order_of(:title, [nil, "foo"])` will now include posts
97
+ with `nil` titles, the same as `Post.all.to_a.in_order_of(:title, [nil, "foo"])`.
87
98
 
88
- * Better handle SQL queries with invalid encoding.
99
+ *fatkodima*
89
100
 
90
- ```ruby
91
- Post.create(name: "broken \xC8 UTF-8")
92
- ```
101
+ * Revert "Fix autosave associations with validations added on `:base` of the associated objects."
93
102
 
94
- Would cause all adapters to fail in a non controlled way in the code
95
- responsible to detect write queries.
103
+ This change intended to remove the :base attribute from the message,
104
+ but broke many assumptions which key these errors were stored.
96
105
 
97
- The query is now properly passed to the database connection, which might or might
98
- not be able to handle it, but will either succeed or failed in a more correct way.
106
+ *zzak*
107
+
108
+ * Fix `#previously_new_record?` to return true for destroyed records.
109
+
110
+ Before, if a record was created and then destroyed, `#previously_new_record?` would return true.
111
+ Now, any UPDATE or DELETE to a record is considered a change, and will result in `#previously_new_record?`
112
+ returning false.
113
+
114
+ *Adrianna Chang*
115
+
116
+ * Revert breaking changes to `has_one` relationship deleting the old record before the new one is validated.
117
+
118
+ *zzak*
119
+
120
+ * Fix support for Active Record instances being uses in queries.
121
+
122
+ As of `7.0.5`, query arguments were deep duped to avoid mutations impacting
123
+ the query cache, but this had the adverse effect to clearing the primary key when
124
+ the query argument contained an `ActiveRecord::Base` instance.
125
+
126
+ This broke the `noticed` gem.
99
127
 
100
128
  *Jean Boussier*
101
129
 
102
- * Ignore persisted in-memory records when merging target lists.
103
130
 
104
- *Kevin Sjöberg*
131
+ ## Rails 7.0.6 (June 29, 2023) ##
105
132
 
106
- * Fix regression bug that caused ignoring additional conditions for preloading
107
- `has_many` through relations.
133
+ * Fix autosave associations with validations added on `:base` of the associated objects.
108
134
 
109
- Fixes #43132
135
+ *fatkodima*
110
136
 
111
- *Alexander Pauly*
137
+ * Fix result with anonymous PostgreSQL columns of different type from json.
112
138
 
113
- * Fix `ActiveRecord::InternalMetadata` to not be broken by
114
- `config.active_record.record_timestamps = false`
139
+ *Oleksandr Avoiants*
115
140
 
116
- Since the model always create the timestamp columns, it has to set them, otherwise it breaks
117
- various DB management tasks.
141
+ * Preserve timestamp when setting an `ActiveSupport::TimeWithZone` value to `timestamptz` attribute.
118
142
 
119
- Fixes #42983
143
+ *fatkodima*
144
+
145
+ * Fix assignment into an `has_one` relationship deleting the old record before the new one is validated.
120
146
 
121
147
  *Jean Boussier*
122
148
 
123
- * Fix duplicate active record objects on `inverse_of`.
149
+ * Fix where on association with has_one/has_many polymorphic relations.
150
+
151
+ Before:
152
+ ```ruby
153
+ Treasure.where(price_estimates: PriceEstimate.all)
154
+ #=> SELECT (...) WHERE "treasures"."id" IN (SELECT "price_estimates"."estimate_of_id" FROM "price_estimates")
155
+ ```
156
+
157
+ Later:
158
+ ```ruby
159
+ Treasure.where(price_estimates: PriceEstimate.all)
160
+ #=> SELECT (...) WHERE "treasures"."id" IN (SELECT "price_estimates"."estimate_of_id" FROM "price_estimates" WHERE "price_estimates"."estimate_of_type" = 'Treasure')
161
+ ```
162
+
163
+ *Lázaro Nixon*
164
+
165
+ * Fix decrementing counter caches on optimistically locked record deletion
166
+
167
+ *fatkodima*
168
+
169
+ * Ensure binary-destined values have binary encoding during type cast.
170
+
171
+ *Matthew Draper*
172
+
173
+ * Preserve existing column default functions when altering table in SQLite.
124
174
 
125
- *Justin Carvalho*
175
+ *fatkodima*
176
+
177
+ * Remove table alias added when using `where.missing` or `where.associated`.
178
+
179
+ *fatkodima*
180
+
181
+ * Fix `Enumerable#in_order_of` to only flatten first level to preserve nesting.
182
+
183
+ *Miha Rekar*
184
+
185
+
186
+ ## Rails 7.0.5.1 (June 26, 2023) ##
187
+
188
+ * No changes.
189
+
190
+ ## Rails 7.0.5 (May 24, 2023) ##
191
+
192
+ * Type cast `#attribute_changed?` `:from` and `:to` options.
126
193
 
127
- * Fix duplicate objects stored in has many association after save.
194
+ *Andrew Novoselac*
128
195
 
129
- Fixes #42549.
196
+ * Fix `index_exists?` when column is an array.
197
+
198
+ *Eileen M. Uchitelle*
199
+
200
+ * Handle `Date` objects for PostgreSQL `timestamptz` columns.
130
201
 
131
202
  *Alex Ghiculescu*
132
203
 
133
- * Fix performance regression in `CollectionAssocation#build`.
204
+ * Fix collation for changing column to non-string.
205
+
206
+ *Hartley McGuire*
207
+
208
+ * Map through subtype in `PostgreSQL::OID::Array`.
209
+
210
+ *Jonathan Hefner*
211
+
212
+ * Store correct environment in `internal_metadata` when run rails `db:prepare`.
213
+
214
+ *fatkodima*
215
+
216
+ * Make sure `ActiveRecord::Relation#sum` works with objects that implement `#coerce` without deprecation.
134
217
 
135
218
  *Alex Ghiculescu*
136
219
 
137
- * Fix retrieving default value for text column for MariaDB.
220
+ * Fix retrieving foreign keys referencing tables named like keywords in PostgreSQL and MySQL.
138
221
 
139
222
  *fatkodima*
140
223
 
224
+ * Support UUIDs in Disable Joins.
141
225
 
142
- ## Rails 6.1.4.7 (March 08, 2022) ##
226
+ *Samuel Cochran*
143
227
 
144
- * No changes.
228
+ * Fix Active Record's explain for queries starting with comments.
145
229
 
230
+ *fatkodima*
146
231
 
147
- ## Rails 6.1.4.6 (February 11, 2022) ##
232
+ * Fix incorrectly preloading through association records when middle association has been loaded.
148
233
 
149
- * No changes.
234
+ *Joshua Young*
150
235
 
236
+ * Fix where.missing and where.associated for parent/child associations.
151
237
 
152
- ## Rails 6.1.4.5 (February 11, 2022) ##
238
+ *fatkodima*
153
239
 
154
- * No changes.
240
+ * Fix Enumerable#in_order_of to preserve duplicates.
155
241
 
242
+ *fatkodima*
156
243
 
157
- ## Rails 6.1.4.4 (December 15, 2021) ##
244
+ * Fix autoincrement on primary key for mysql.
158
245
 
159
- * No changes.
246
+ *Eileen M. Uchitelle*
160
247
 
248
+ * Restore ability to redefine column in `create_table` for Rails 5.2 migrations.
161
249
 
162
- ## Rails 6.1.4.3 (December 14, 2021) ##
250
+ *fatkodima*
163
251
 
164
- * No changes.
252
+ * Fix schema cache dumping of virtual columns.
253
+
254
+ *fatkodima*
255
+
256
+ * Fix Active Record grouped calculations on joined tables on column present in both tables.
257
+
258
+ *fatkodima*
259
+
260
+ * Fix mutation detection for serialized attributes backed by binary columns.
261
+
262
+ *Jean Boussier*
263
+
264
+ * Fix a bug where using groups and counts with long table names would return incorrect results.
265
+
266
+ *Shota Toguchi*, *Yusaku Ono*
267
+
268
+ * Fix erroneous nil default precision on virtual datetime columns.
269
+
270
+ Prior to this change, virtual datetime columns did not have the same
271
+ default precision as regular datetime columns, resulting in the following
272
+ being erroneously equivalent:
273
+
274
+ t.virtual :name, type: datetime, as: "expression"
275
+ t.virtual :name, type: datetime, precision: nil, as: "expression"
165
276
 
277
+ This change fixes the default precision lookup, so virtual and regular
278
+ datetime column default precisions match.
166
279
 
167
- ## Rails 6.1.4.2 (December 14, 2021) ##
280
+ *Sam Bostock*
281
+
282
+ * Fix a case where the query cache can return wrong values. See #46044
283
+
284
+ *Aaron Patterson*
285
+
286
+
287
+ ## Rails 7.0.4.3 (March 13, 2023) ##
168
288
 
169
289
  * No changes.
170
290
 
171
291
 
172
- ## Rails 6.1.4.1 (August 19, 2021) ##
292
+ ## Rails 7.0.4.2 (January 24, 2023) ##
173
293
 
174
294
  * No changes.
175
295
 
176
296
 
177
- ## Rails 6.1.4 (June 24, 2021) ##
297
+ ## Rails 7.0.4.1 (January 17, 2023) ##
178
298
 
179
- * Do not try to rollback transactions that failed due to a `ActiveRecord::TransactionRollbackError`.
299
+ * Make sanitize_as_sql_comment more strict
180
300
 
181
- *Jamie McCarthy*
301
+ Though this method was likely never meant to take user input, it was
302
+ attempting sanitization. That sanitization could be bypassed with
303
+ carefully crafted input.
182
304
 
183
- * Raise an error if `pool_config` is `nil` in `set_pool_config`.
305
+ This commit makes the sanitization more robust by replacing any
306
+ occurrences of "/*" or "*/" with "/ *" or "* /". It also performs a
307
+ first pass to remove one surrounding comment to avoid compatibility
308
+ issues for users relying on the existing removal.
184
309
 
185
- *Eileen M. Uchitelle*
310
+ This also clarifies in the documentation of annotate that it should not
311
+ be provided user input.
186
312
 
187
- * Fix compatibility with `psych >= 4`.
313
+ [CVE-2023-22794]
188
314
 
189
- Starting in Psych 4.0.0 `YAML.load` behaves like `YAML.safe_load`. To preserve compatibility
190
- Active Record's schema cache loader and `YAMLColumn` now uses `YAML.unsafe_load` if available.
315
+ * Added integer width check to PostgreSQL::Quoting
316
+
317
+ Given a value outside the range for a 64bit signed integer type
318
+ PostgreSQL will treat the column type as numeric. Comparing
319
+ integer values against numeric values can result in a slow
320
+ sequential scan.
321
+
322
+ This behavior is configurable via
323
+ ActiveRecord::Base.raise_int_wider_than_64bit which defaults to true.
324
+
325
+ [CVE-2022-44566]
326
+
327
+
328
+ ## Rails 7.0.4 (September 09, 2022) ##
329
+
330
+ * Symbol is allowed by default for YAML columns
331
+
332
+ *Étienne Barrié*
333
+
334
+ * Fix `ActiveRecord::Store` to serialize as a regular Hash
335
+
336
+ Previously it would serialize as an `ActiveSupport::HashWithIndifferentAccess`
337
+ which is wasteful and cause problem with YAML safe_load.
191
338
 
192
339
  *Jean Boussier*
193
340
 
194
- * Support using replicas when using `rails dbconsole`.
341
+ * Add `timestamptz` as a time zone aware type for PostgreSQL
195
342
 
196
- *Christopher Thornton*
343
+ This is required for correctly parsing `timestamp with time zone` values in your database.
197
344
 
198
- * Restore connection pools after transactional tests.
345
+ If you don't want this, you can opt out by adding this initializer:
199
346
 
200
- *Eugene Kenny*
347
+ ```ruby
348
+ ActiveRecord::Base.time_zone_aware_types -= [:timestamptz]
349
+ ```
201
350
 
202
- * Change `upsert_all` to fails cleanly for MySQL when `:unique_by` is used.
351
+ *Alex Ghiculescu*
203
352
 
204
- *Bastian Bartmann*
353
+ * Fix supporting timezone awareness for `tsrange` and `tstzrange` array columns.
205
354
 
206
- * Fix user-defined `self.default_scope` to respect table alias.
355
+ ```ruby
356
+ # In database migrations
357
+ add_column :shops, :open_hours, :tsrange, array: true
358
+ # In app config
359
+ ActiveRecord::Base.time_zone_aware_types += [:tsrange]
360
+ # In the code times are properly converted to app time zone
361
+ Shop.create!(open_hours: [Time.current..8.hour.from_now])
362
+ ```
207
363
 
208
- *Ryuta Kamizono*
364
+ *Wojciech Wnętrzak*
209
365
 
210
- * Clear `@cache_keys` cache after `update_all`, `delete_all`, `destroy_all`.
366
+ * Resolve issue where a relation cache_version could be left stale.
211
367
 
212
- *Ryuta Kamizono*
368
+ Previously, when `reset` was called on a relation object it did not reset the cache_versions
369
+ ivar. This led to a confusing situation where despite having the correct data the relation
370
+ still reported a stale cache_version.
213
371
 
214
- * Changed Arel predications `contains` and `overlaps` to use
215
- `quoted_node` so that PostgreSQL arrays are quoted properly.
372
+ Usage:
216
373
 
217
- *Bradley Priest*
374
+ ```ruby
375
+ developers = Developer.all
376
+ developers.cache_version
218
377
 
219
- * Fix `merge` when the `where` clauses have string contents.
378
+ Developer.update_all(updated_at: Time.now.utc + 1.second)
220
379
 
221
- *Ryuta Kamizono*
380
+ developers.cache_version # Stale cache_version
381
+ developers.reset
382
+ developers.cache_version # Returns the current correct cache_version
383
+ ```
222
384
 
223
- * Fix rollback of parent destruction with nested `dependent: :destroy`.
385
+ Fixes #45341.
224
386
 
225
- *Jacopo Beschi*
387
+ *Austen Madden*
226
388
 
227
- * Fix binds logging for `"WHERE ... IN ..."` statements.
389
+ * Fix `load_async` when called on an association proxy.
228
390
 
229
- *Ricardo Díaz*
391
+ Calling `load_async` directly an association would schedule
392
+ a query but never use it.
230
393
 
231
- * Handle `false` in relation strict loading checks.
394
+ ```ruby
395
+ comments = post.comments.load_async # schedule a query
396
+ comments.to_a # perform an entirely new sync query
397
+ ```
232
398
 
233
- Previously when a model had strict loading set to true and then had a
234
- relation set `strict_loading` to false the false wasn't considered when
235
- deciding whether to raise/warn about strict loading.
399
+ Now it does use the async query, however note that it doesn't
400
+ cause the association to be loaded.
401
+
402
+ *Jean Boussier*
236
403
 
404
+ * Fix eager loading for models without primary keys.
405
+
406
+ *Anmol Chopra*, *Matt Lawrence*, and *Jonathan Hefner*
407
+
408
+ * `rails db:schema:{dump,load}` now checks `ENV["SCHEMA_FORMAT"]` before config
409
+
410
+ Since `rails db:structure:{dump,load}` was deprecated there wasn't a simple
411
+ way to dump a schema to both SQL and Ruby formats. You can now do this with
412
+ an environment variable. For example:
413
+
414
+ ```
415
+ SCHEMA_FORMAT=sql rake db:schema:dump
237
416
  ```
238
- class Dog < ActiveRecord::Base
239
- self.strict_loading_by_default = true
240
417
 
241
- has_many :treats, strict_loading: false
242
- end
418
+ *Alex Ghiculescu*
419
+
420
+ * Fix Hstore deserialize regression.
421
+
422
+ *edsharp*
423
+
424
+
425
+ ## Rails 7.0.3.1 (July 12, 2022) ##
426
+
427
+ * Change ActiveRecord::Coders::YAMLColumn default to safe_load
428
+
429
+ This adds two new configuration options The configuration options are as
430
+ follows:
431
+
432
+ * `config.active_record.use_yaml_unsafe_load`
433
+
434
+ When set to true, this configuration option tells Rails to use the old
435
+ "unsafe" YAML loading strategy, maintaining the existing behavior but leaving
436
+ the possible escalation vulnerability in place. Setting this option to true
437
+ is *not* recommended, but can aid in upgrading.
438
+
439
+ * `config.active_record.yaml_column_permitted_classes`
440
+
441
+ The "safe YAML" loading method does not allow all classes to be deserialized
442
+ by default. This option allows you to specify classes deemed "safe" in your
443
+ application. For example, if your application uses Symbol and Time in
444
+ serialized data, you can add Symbol and Time to the allowed list as follows:
445
+
446
+ ```
447
+ config.active_record.yaml_column_permitted_classes = [Symbol, Date, Time]
243
448
  ```
244
449
 
245
- In the example, `dog.treats` would still raise even though
246
- `strict_loading` was set to false. This is a bug affecting more than
247
- Active Storage which is why I made this PR superseding #41461. We need
248
- to fix this for all applications since the behavior is a little
249
- surprising. I took the test from #41461 and the code suggestion from #41453
250
- with some additions.
450
+ [CVE-2022-32224]
251
451
 
252
- *Eileen M. Uchitelle*, *Radamés Roriz*
253
452
 
254
- * Fix numericality validator without precision.
453
+ ## Rails 7.0.3 (May 09, 2022) ##
255
454
 
256
- *Ryuta Kamizono*
455
+ * Some internal housekeeping on reloads could break custom `respond_to?`
456
+ methods in class objects that referenced reloadable constants. See
457
+ [#44125](https://github.com/rails/rails/issues/44125) for details.
257
458
 
258
- * Fix aggregate attribute on Enum types.
459
+ *Xavier Noria*
259
460
 
260
- *Ryuta Kamizono*
461
+ * Fixed MariaDB default function support.
261
462
 
262
- * Fix `CREATE INDEX` statement generation for PostgreSQL.
463
+ Defaults would be written wrong in "db/schema.rb" and not work correctly
464
+ if using `db:schema:load`. Further more the function name would be
465
+ added as string content when saving new records.
263
466
 
264
- *eltongo*
467
+ *kaspernj*
265
468
 
266
- * Fix where clause on enum attribute when providing array of strings.
469
+ * Fix `remove_foreign_key` with `:if_exists` option when foreign key actually exists.
267
470
 
268
- *Ryuta Kamizono*
471
+ *fatkodima*
269
472
 
270
- * Fix `unprepared_statement` to work it when nesting.
473
+ * Remove `--no-comments` flag in structure dumps for PostgreSQL
271
474
 
272
- *Ryuta Kamizono*
475
+ This broke some apps that used custom schema comments. If you don't want
476
+ comments in your structure dump, you can use:
477
+
478
+ ```ruby
479
+ ActiveRecord::Tasks::DatabaseTasks.structure_dump_flags = ['--no-comments']
480
+ ```
481
+
482
+ *Alex Ghiculescu*
483
+
484
+ * Use the model name as a prefix when filtering encrypted attributes from logs.
485
+
486
+ For example, when encrypting `Person#name` it will add `person.name` as a filter
487
+ parameter, instead of just `name`. This prevents unintended filtering of parameters
488
+ with a matching name in other models.
273
489
 
490
+ *Jorge Manrubia*
274
491
 
275
- ## Rails 6.1.3.2 (May 05, 2021) ##
492
+ * Fix quoting of `ActiveSupport::Duration` and `Rational` numbers in the MySQL adapter.
493
+
494
+ *Kevin McPhillips*
495
+
496
+ * Fix `change_column_comment` to preserve column's AUTO_INCREMENT in the MySQL adapter
497
+
498
+ *fatkodima*
499
+
500
+ ## Rails 7.0.2.4 (April 26, 2022) ##
501
+
502
+ * No changes.
503
+
504
+
505
+ ## Rails 7.0.2.3 (March 08, 2022) ##
506
+
507
+ * No changes.
508
+
509
+
510
+ ## Rails 7.0.2.2 (February 11, 2022) ##
276
511
 
277
512
  * No changes.
278
513
 
279
514
 
280
- ## Rails 6.1.3.1 (March 26, 2021) ##
515
+ ## Rails 7.0.2.1 (February 11, 2022) ##
281
516
 
282
517
  * No changes.
283
518
 
284
519
 
285
- ## Rails 6.1.3 (February 17, 2021) ##
520
+ ## Rails 7.0.2 (February 08, 2022) ##
521
+
522
+ * Fix `PG.connect` keyword arguments deprecation warning on ruby 2.7.
523
+
524
+ *Nikita Vasilevsky*
525
+
526
+ * Fix the ability to exclude encryption params from being autofiltered.
286
527
 
287
- * Fix the MySQL adapter to always set the right collation and charset
288
- to the connection session.
528
+ *Mark Gangl*
529
+
530
+ * Dump the precision for datetime columns following the new defaults.
289
531
 
290
532
  *Rafael Mendonça França*
291
533
 
292
- * Fix MySQL adapter handling of time objects when prepared statements
293
- are enabled.
534
+ * Make sure encrypted attributes are not being filtered twice.
535
+
536
+ *Nikita Vasilevsky*
537
+
538
+ * Dump the database schema containing the current Rails version.
539
+
540
+ Since https://github.com/rails/rails/pull/42297, Rails now generate datetime columns
541
+ with a default precision of 6. This means that users upgrading to Rails 7.0 from 6.1,
542
+ when loading the database schema, would get the new precision value, which would not match
543
+ the production schema.
544
+
545
+ To avoid this the schema dumper will generate the new format which will include the Rails
546
+ version and will look like this:
547
+
548
+ ```
549
+ ActiveRecord::Schema[7.0].define
550
+ ```
551
+
552
+ When upgrading from Rails 6.1 to Rails 7.0, you can run the `rails app:update` task that will
553
+ set the current schema version to 6.1.
294
554
 
295
555
  *Rafael Mendonça França*
296
556
 
297
- * Fix scoping in enum fields using conditions that would generate
298
- an `IN` clause.
557
+ * Fix parsing expression for PostgreSQL generated column.
299
558
 
300
- *Ryuta Kamizono*
559
+ *fatkodima*
301
560
 
302
- * Skip optimised #exist? query when #include? is called on a relation
303
- with a having clause
561
+ * Fix `Mysql2::Error: Commands out of sync; you can't run this command now`
562
+ when bulk-inserting fixtures that exceed `max_allowed_packet` configuration.
304
563
 
305
- Relations that have aliased select values AND a having clause that
306
- references an aliased select value would generate an error when
307
- #include? was called, due to an optimisation that would generate
308
- call #exists? on the relation instead, which effectively alters
309
- the select values of the query (and thus removes the aliased select
310
- values), but leaves the having clause intact. Because the having
311
- clause is then referencing an aliased column that is no longer
312
- present in the simplified query, an ActiveRecord::InvalidStatement
313
- error was raised.
564
+ *Nikita Vasilevsky*
565
+
566
+ * Fix error when saving an association with a relation named `record`.
567
+
568
+ *Dorian Marié*
569
+
570
+ * Fix `MySQL::SchemaDumper` behavior about datetime precision value.
571
+
572
+ *y0t4*
314
573
 
315
- An sample query affected by this problem:
574
+ * Improve associated with no reflection error.
575
+
576
+ *Nikolai*
577
+
578
+ * Fix PG.connect keyword arguments deprecation warning on ruby 2.7.
579
+
580
+ Fixes #44307.
581
+
582
+ *Nikita Vasilevsky*
583
+
584
+ * Fix passing options to `check_constraint` from `change_table`.
585
+
586
+ *Frederick Cheung*
587
+
588
+
589
+ ## Rails 7.0.1 (January 06, 2022) ##
590
+
591
+
592
+ * Change `QueryMethods#in_order_of` to drop records not listed in values.
593
+
594
+ `in_order_of` now filters down to the values provided, to match the behavior of the `Enumerable` version.
595
+
596
+ *Kevin Newton*
597
+
598
+ * Allow named expression indexes to be revertible.
599
+
600
+ 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.
316
601
 
317
602
  ```ruby
318
- Author.select('COUNT(*) as total_posts', 'authors.*')
319
- .joins(:posts)
320
- .group(:id)
321
- .having('total_posts > 2')
322
- .include?(Author.first)
603
+ add_index(:settings, "(data->'property')", using: :gin, name: :index_settings_data_property)
323
604
  ```
324
605
 
325
- This change adds an addition check to the condition that skips the
326
- simplified #exists? query, which simply checks for the presence of
327
- a having clause.
606
+ Fixes #43331.
328
607
 
329
- Fixes #41417
608
+ *Oliver Günther*
330
609
 
331
- *Michael Smart*
610
+ * Better error messages when association name is invalid in the argument of `ActiveRecord::QueryMethods::WhereChain#missing`.
332
611
 
333
- * Increment postgres prepared statement counter before making a prepared statement, so if the statement is aborted
334
- without Rails knowledge (e.g., if app gets kill -9d during long-running query or due to Rack::Timeout), app won't end
335
- up in perpetual crash state for being inconsistent with Postgres.
612
+ *ykpythemind*
336
613
 
337
- *wbharding*, *Martin Tepper*
614
+ * Fix ordered migrations for single db in multi db environment.
338
615
 
616
+ *Himanshu*
339
617
 
340
- ## Rails 6.1.2.1 (February 10, 2021) ##
618
+ * Extract `on update CURRENT_TIMESTAMP` for mysql2 adapter.
341
619
 
342
- * Fix possible DoS vector in PostgreSQL money type
620
+ *Kazuhiro Masuda*
343
621
 
344
- Carefully crafted input can cause a DoS via the regular expressions used
345
- for validating the money format in the PostgreSQL adapter. This patch
346
- fixes the regexp.
622
+ * Fix incorrect argument in PostgreSQL structure dump tasks.
347
623
 
348
- Thanks to @dee-see from Hackerone for this patch!
624
+ Updating the `--no-comment` argument added in Rails 7 to the correct `--no-comments` argument.
349
625
 
350
- [CVE-2021-22880]
626
+ *Alex Dent*
351
627
 
352
- *Aaron Patterson*
628
+ * Fix schema dumping column default SQL values for sqlite3.
629
+
630
+ *fatkodima*
631
+
632
+ * Correctly parse complex check constraint expressions for PostgreSQL.
633
+
634
+ *fatkodima*
635
+
636
+ * Fix `timestamptz` attributes on PostgreSQL handle blank inputs.
637
+
638
+ *Alex Ghiculescu*
639
+
640
+ * Fix migration compatibility to create SQLite references/belongs_to column as integer when migration version is 6.0.
641
+
642
+ Reference/belongs_to in migrations with version 6.0 were creating columns as
643
+ bigint instead of integer for the SQLite Adapter.
644
+
645
+ *Marcelo Lauxen*
646
+
647
+ * Fix joining through a polymorphic association.
648
+
649
+ *Alexandre Ruban*
650
+
651
+ * Fix `QueryMethods#in_order_of` to handle empty order list.
353
652
 
653
+ ```ruby
654
+ Post.in_order_of(:id, []).to_a
655
+ ```
656
+
657
+ Also more explicitly set the column as secondary order, so that any other
658
+ value is still ordered.
354
659
 
355
- ## Rails 6.1.2 (February 09, 2021) ##
660
+ *Jean Boussier*
356
661
 
357
- * Fix timestamp type for sqlite3.
662
+ * Fix `rails dbconsole` for 3-tier config.
358
663
 
359
664
  *Eileen M. Uchitelle*
360
665
 
361
- * Make destroy async transactional.
666
+ * Fix quoting of column aliases generated by calculation methods.
362
667
 
363
- An active record rollback could occur while enqueuing a job. In this
364
- case the job would enqueue even though the database deletion
365
- rolledback putting things in a funky state.
668
+ Since the alias is derived from the table name, we can't assume the result
669
+ is a valid identifier.
366
670
 
367
- Now the jobs are only enqueued until after the db transaction has been committed.
671
+ ```ruby
672
+ class Test < ActiveRecord::Base
673
+ self.table_name = '1abc'
674
+ end
675
+ Test.group(:id).count
676
+ # syntax error at or near "1" (ActiveRecord::StatementInvalid)
677
+ # LINE 1: SELECT COUNT(*) AS count_all, "1abc"."id" AS 1abc_id FROM "1...
678
+ ```
368
679
 
369
- *Cory Gwin*
680
+ *Jean Boussier*
370
681
 
371
- * Fix malformed packet error in MySQL statement for connection configuration.
372
682
 
373
- *robinroestenburg*
683
+ ## Rails 7.0.0 (December 15, 2021) ##
374
684
 
375
- * Connection specification now passes the "url" key as a configuration for the
376
- adapter if the "url" protocol is "jdbc", "http", or "https". Previously only
377
- urls with the "jdbc" prefix were passed to the Active Record Adapter, others
378
- are assumed to be adapter specification urls.
685
+ * Better handle SQL queries with invalid encoding.
379
686
 
380
- Fixes #41137.
687
+ ```ruby
688
+ Post.create(name: "broken \xC8 UTF-8")
689
+ ```
381
690
 
382
- *Jonathan Bracy*
691
+ Would cause all adapters to fail in a non controlled way in the code
692
+ responsible to detect write queries.
693
+
694
+ The query is now properly passed to the database connection, which might or might
695
+ not be able to handle it, but will either succeed or failed in a more correct way.
696
+
697
+ *Jean Boussier*
383
698
 
384
- * Fix granular connection swapping when there are multiple abstract classes.
699
+ * Move database and shard selection config options to a generator.
700
+
701
+ Rather than generating the config options in `production.rb` when applications are created, applications can now run a generator to create an initializer and uncomment / update options as needed. All multi-db configuration can be implemented in this initializer.
385
702
 
386
703
  *Eileen M. Uchitelle*
387
704
 
388
- * Fix `find_by` with custom primary key for belongs_to association.
389
705
 
390
- *Ryuta Kamizono*
706
+ ## Rails 7.0.0.rc3 (December 14, 2021) ##
707
+
708
+ * No changes.
709
+
710
+
711
+ ## Rails 7.0.0.rc2 (December 14, 2021) ##
712
+
713
+ * No changes.
714
+
715
+
716
+ ## Rails 7.0.0.rc1 (December 06, 2021) ##
717
+
718
+ * Remove deprecated `ActiveRecord::DatabaseConfigurations::DatabaseConfig#spec_name`.
719
+
720
+ *Rafael Mendonça França*
721
+
722
+ * Remove deprecated `ActiveRecord::Connection#in_clause_length`.
723
+
724
+ *Rafael Mendonça França*
725
+
726
+ * Remove deprecated `ActiveRecord::Connection#allowed_index_name_length`.
727
+
728
+ *Rafael Mendonça França*
729
+
730
+ * Remove deprecated `ActiveRecord::Base#remove_connection`.
391
731
 
392
- * Add support for `rails console --sandbox` for multiple database applications.
732
+ *Rafael Mendonça França*
393
733
 
394
- *alpaca-tc*
734
+ * Load STI Models in fixtures
395
735
 
396
- * Fix `where` on polymorphic association with empty array.
736
+ Data from Fixtures now loads based on the specific class for models with
737
+ Single Table Inheritance. This affects enums defined in subclasses, previously
738
+ the value of these fields was not parsed and remained `nil`
397
739
 
398
- *Ryuta Kamizono*
740
+ *Andres Howard*
399
741
 
400
- * Fix preventing writes for `ApplicationRecord`.
742
+ * `#authenticate` returns false when the password is blank instead of raising an error.
401
743
 
402
- *Eileen M. Uchitelle*
744
+ *Muhammad Muhammad Ibrahim*
403
745
 
746
+ * Fix `ActiveRecord::QueryMethods#in_order_of` behavior for integer enums.
404
747
 
405
- ## Rails 6.1.1 (January 07, 2021) ##
748
+ `ActiveRecord::QueryMethods#in_order_of` didn't work as expected for enums stored as integers in the database when passing an array of strings or symbols as the order argument. This unexpected behavior occurred because the string or symbol values were not casted to match the integers in the database.
406
749
 
407
- * Fix fixtures loading when strict loading is enabled for the association.
750
+ The following example now works as expected:
408
751
 
409
- *Alex Ghiculescu*
752
+ ```ruby
753
+ class Book < ApplicationRecord
754
+ enum status: [:proposed, :written, :published]
755
+ end
410
756
 
411
- * Fix `where` with custom primary key for belongs_to association.
757
+ Book.in_order_of(:status, %w[written published proposed])
758
+ ```
412
759
 
413
- *Ryuta Kamizono*
760
+ *Alexandre Ruban*
414
761
 
415
- * Fix `where` with aliased associations.
762
+ * Ignore persisted in-memory records when merging target lists.
416
763
 
417
- *Ryuta Kamizono*
764
+ *Kevin Sjöberg*
418
765
 
419
- * Fix `composed_of` with symbol mapping.
766
+ * Add a new option `:update_only` to `upsert_all` to configure the list of columns to update in case of conflict.
420
767
 
421
- *Ryuta Kamizono*
768
+ Before, you could only customize the update SQL sentence via `:on_duplicate`. There is now a new option `:update_only` that lets you provide a list of columns to update in case of conflict:
422
769
 
423
- * Don't skip money's type cast for pluck and calculations.
770
+ ```ruby
771
+ Commodity.upsert_all(
772
+ [
773
+ { id: 2, name: "Copper", price: 4.84 },
774
+ { id: 4, name: "Gold", price: 1380.87 },
775
+ { id: 6, name: "Aluminium", price: 0.35 }
776
+ ],
777
+ update_only: [:price] # Only prices will be updated
778
+ )
779
+ ```
424
780
 
425
- *Ryuta Kamizono*
781
+ *Jorge Manrubia*
426
782
 
427
- * Fix `where` on polymorphic association with non Active Record object.
783
+ * Remove deprecated `ActiveRecord::Result#map!` and `ActiveRecord::Result#collect!`.
428
784
 
429
- *Ryuta Kamizono*
785
+ *Rafael Mendonça França*
430
786
 
431
- * Make sure `db:prepare` works even the schema file doesn't exist.
787
+ * Remove deprecated `ActiveRecord::Base.configurations.to_h`.
432
788
 
433
789
  *Rafael Mendonça França*
434
790
 
435
- * Fix complicated `has_many :through` with nested where condition.
791
+ * Remove deprecated `ActiveRecord::Base.configurations.default_hash`.
436
792
 
437
- *Ryuta Kamizono*
793
+ *Rafael Mendonça França*
438
794
 
439
- * Handle STI models for `has_many dependent: :destroy_async`.
795
+ * Remove deprecated `ActiveRecord::Base.arel_attribute`.
440
796
 
441
- *Muhammad Usman*
797
+ *Rafael Mendonça França*
442
798
 
443
- * Restore possibility of passing `false` to :polymorphic option of `belongs_to`.
799
+ * Remove deprecated `ActiveRecord::Base.connection_config`.
444
800
 
445
- Previously, passing `false` would trigger the option validation logic
446
- to throw an error saying :polymorphic would not be a valid option.
801
+ *Rafael Mendonça França*
447
802
 
448
- *glaszig*
803
+ * Filter attributes in SQL logs
449
804
 
450
- * Allow adding nonnamed expression indexes to be revertible.
805
+ Previously, SQL queries in logs containing `ActiveRecord::Base.filter_attributes` were not filtered.
451
806
 
452
- Fixes #40732.
807
+ Now, the filter attributes will be masked `[FILTERED]` in the logs when `prepared_statement` is enabled.
453
808
 
454
- Previously, the following code would raise an error, when executed while rolling back,
455
- and the index name should be specified explicitly. Now, the index name is inferred
456
- automatically.
809
+ ```
810
+ # Before:
811
+ Foo Load (0.2ms) SELECT "foos".* FROM "foos" WHERE "foos"."passw" = ? LIMIT ? [["passw", "hello"], ["LIMIT", 1]]
457
812
 
458
- ```ruby
459
- add_index(:items, "to_tsvector('english', description)")
813
+ # After:
814
+ Foo Load (0.5ms) SELECT "foos".* FROM "foos" WHERE "foos"."passw" = ? LIMIT ? [["passw", "[FILTERED]"], ["LIMIT", 1]]
460
815
  ```
461
816
 
462
- *fatkodima*
817
+ *Aishwarya Subramanian*
463
818
 
819
+ * Remove deprecated `Tasks::DatabaseTasks.spec`.
464
820
 
465
- ## Rails 6.1.0 (December 09, 2020) ##
821
+ *Rafael Mendonça França*
466
822
 
467
- * Only warn about negative enums if a positive form that would cause conflicts exists.
823
+ * Remove deprecated `Tasks::DatabaseTasks.current_config`.
468
824
 
469
- Fixes #39065.
825
+ *Rafael Mendonça França*
470
826
 
471
- *Alex Ghiculescu*
827
+ * Deprecate `Tasks::DatabaseTasks.schema_file_type`.
472
828
 
473
- * Change `attribute_for_inspect` to take `filter_attributes` in consideration.
829
+ *Rafael Mendonça França*
830
+
831
+ * Remove deprecated `Tasks::DatabaseTasks.dump_filename`.
474
832
 
475
833
  *Rafael Mendonça França*
476
834
 
477
- * Fix odd behavior of inverse_of with multiple belongs_to to same class.
835
+ * Remove deprecated `Tasks::DatabaseTasks.schema_file`.
836
+
837
+ *Rafael Mendonça França*
478
838
 
479
- Fixes #35204.
839
+ * Remove deprecated `environment` and `name` arguments from `Tasks::DatabaseTasks.schema_up_to_date?`.
480
840
 
481
- *Tomoyuki Kai*
841
+ *Rafael Mendonça França*
482
842
 
483
- * Build predicate conditions with objects that delegate `#id` and primary key:
843
+ * Merging conditions on the same column no longer maintain both conditions,
844
+ and will be consistently replaced by the latter condition.
484
845
 
485
846
  ```ruby
486
- class AdminAuthor
487
- delegate_missing_to :@author
847
+ # Rails 6.1 (IN clause is replaced by merger side equality condition)
848
+ Author.where(id: [david.id, mary.id]).merge(Author.where(id: bob)) # => [bob]
849
+ # Rails 6.1 (both conflict conditions exists, deprecated)
850
+ Author.where(id: david.id..mary.id).merge(Author.where(id: bob)) # => []
851
+ # Rails 6.1 with rewhere to migrate to Rails 7.0's behavior
852
+ Author.where(id: david.id..mary.id).merge(Author.where(id: bob), rewhere: true) # => [bob]
853
+ # Rails 7.0 (same behavior with IN clause, mergee side condition is consistently replaced)
854
+ Author.where(id: [david.id, mary.id]).merge(Author.where(id: bob)) # => [bob]
855
+ Author.where(id: david.id..mary.id).merge(Author.where(id: bob)) # => [bob]
488
856
 
489
- def initialize(author)
490
- @author = author
491
- end
492
- end
857
+ *Rafael Mendonça França*
493
858
 
494
- Post.where(author: AdminAuthor.new(author))
495
- ```
859
+ * Remove deprecated support to `Model.reorder(nil).first` to search using non-deterministic order.
496
860
 
497
- *Sean Doyle*
861
+ *Rafael Mendonça França*
498
862
 
499
- * Add `connected_to_many` API.
863
+ * Remove deprecated rake tasks:
500
864
 
501
- This API allows applications to connect to multiple databases at once without switching all of them or implementing a deeply nested stack.
865
+ * `db:schema:load_if_ruby`
866
+ * `db:structure:dump`
867
+ * `db:structure:load`
868
+ * `db:structure:load_if_sql`
869
+ * `db:structure:dump:#{name}`
870
+ * `db:structure:load:#{name}`
871
+ * `db:test:load_structure`
872
+ * `db:test:load_structure:#{name}`
502
873
 
503
- Before:
874
+ *Rafael Mendonça França*
504
875
 
505
- AnimalsRecord.connected_to(role: :reading) do
506
- MealsRecord.connected_to(role: :reading) do
507
- Dog.first # read from animals replica
508
- Dinner.first # read from meals replica
509
- Person.first # read from primary writer
510
- end
511
- end
876
+ * Remove deprecated `DatabaseConfig#config` method.
512
877
 
513
- After:
878
+ *Rafael Mendonça França*
514
879
 
515
- ActiveRecord::Base.connected_to_many([AnimalsRecord, MealsRecord], role: :reading) do
516
- Dog.first # read from animals replica
517
- Dinner.first # read from meals replica
518
- Person.first # read from primary writer
519
- end
880
+ * Rollback transactions when the block returns earlier than expected.
520
881
 
521
- *Eileen M. Uchitelle*, *John Crepezzi*
882
+ Before this change, when a transaction block returned early, the transaction would be committed.
883
+
884
+ The problem is that timeouts triggered inside the transaction block was also making the incomplete transaction
885
+ to be committed, so in order to avoid this mistake, the transaction block is rolled back.
522
886
 
523
- * Add option to raise or log for `ActiveRecord::StrictLoadingViolationError`.
887
+ *Rafael Mendonça França*
524
888
 
525
- Some applications may not want to raise an error in production if using `strict_loading`. This would allow an application to set strict loading to log for the production environment while still raising in development and test environments.
889
+ * Add middleware for automatic shard swapping.
526
890
 
527
- Set `config.active_record.action_on_strict_loading_violation` to `:log` errors instead of raising.
891
+ Provides a basic middleware to perform automatic shard swapping. Applications will provide a resolver which will determine for an individual request which shard should be used. Example:
528
892
 
529
- *Eileen M. Uchitelle*
893
+ ```ruby
894
+ config.active_record.shard_resolver = ->(request) {
895
+ subdomain = request.subdomain
896
+ tenant = Tenant.find_by_subdomain!(subdomain)
897
+ tenant.shard
898
+ }
899
+ ```
530
900
 
531
- * Allow the inverse of a `has_one` association that was previously autosaved to be loaded.
901
+ See guides for more details.
532
902
 
533
- Fixes #34255.
903
+ *Eileen M. Uchitelle*, *John Crepezzi*
534
904
 
535
- *Steven Weber*
905
+ * Remove deprecated support to pass a column to `type_cast`.
536
906
 
537
- * Optimise the length of index names for polymorphic references by using the reference name rather than the type and id column names.
907
+ *Rafael Mendonça França*
538
908
 
539
- Because the default behaviour when adding an index with multiple columns is to use all column names in the index name, this could frequently lead to overly long index names for polymorphic references which would fail the migration if it exceeded the database limit.
909
+ * Remove deprecated support to type cast to database values `ActiveRecord::Base` objects.
540
910
 
541
- This change reduces the chance of that happening by using the reference name, e.g. `index_my_table_on_my_reference`.
911
+ *Rafael Mendonça França*
542
912
 
543
- Fixes #38655.
913
+ * Remove deprecated support to quote `ActiveRecord::Base` objects.
544
914
 
545
- *Luke Redpath*
915
+ *Rafael Mendonça França*
546
916
 
547
- * MySQL: Uniqueness validator now respects default database collation,
548
- no longer enforce case sensitive comparison by default.
917
+ * Remove deprecacated support to resolve connection using `"primary"` as connection specification name.
549
918
 
550
- *Ryuta Kamizono*
919
+ *Rafael Mendonça França*
551
920
 
552
- * Remove deprecated methods from `ActiveRecord::ConnectionAdapters::DatabaseLimits`.
921
+ * Remove deprecation warning when using `:interval` column is used in PostgreSQL database.
553
922
 
554
- `column_name_length`
555
- `table_name_length`
556
- `columns_per_table`
557
- `indexes_per_table`
558
- `columns_per_multicolumn_index`
559
- `sql_query_length`
560
- `joins_per_query`
923
+ Now, interval columns will return `ActiveSupport::Duration` objects instead of strings.
561
924
 
562
- *Rafael Mendonça França*
925
+ To keep the old behavior, you can add this line to your model:
563
926
 
564
- * Remove deprecated `ActiveRecord::ConnectionAdapters::AbstractAdapter#supports_multi_insert?`.
927
+ ```ruby
928
+ attribute :column, :string
929
+ ```
565
930
 
566
931
  *Rafael Mendonça França*
567
932
 
568
- * Remove deprecated `ActiveRecord::ConnectionAdapters::AbstractAdapter#supports_foreign_keys_in_create?`.
933
+ * Remove deprecated support to YAML load `ActiveRecord::Base` instance in the Rails 4.2 and 4.1 formats.
569
934
 
570
935
  *Rafael Mendonça França*
571
936
 
572
- * Remove deprecated `ActiveRecord::ConnectionAdapters::PostgreSQLAdapter#supports_ranges?`.
937
+ * Remove deprecated option `:spec_name` in the `configs_for` method.
573
938
 
574
939
  *Rafael Mendonça França*
575
940
 
576
- * Remove deprecated `ActiveRecord::Base#update_attributes` and `ActiveRecord::Base#update_attributes!`.
941
+ * Remove deprecated `ActiveRecord::Base.allow_unsafe_raw_sql`.
577
942
 
578
943
  *Rafael Mendonça França*
579
944
 
580
- * Remove deprecated `migrations_path` argument in `ActiveRecord::ConnectionAdapter::SchemaStatements#assume_migrated_upto_version`.
945
+ * Fix regression bug that caused ignoring additional conditions for preloading has_many-through relations.
581
946
 
582
- *Rafael Mendonça França*
947
+ Fixes #43132
583
948
 
584
- * Remove deprecated `config.active_record.sqlite3.represent_boolean_as_integer`.
949
+ *Alexander Pauly*
585
950
 
586
- *Rafael Mendonça França*
951
+ * Fix `has_many` inversing recursion on models with recursive associations.
587
952
 
588
- * `relation.create` does no longer leak scope to class level querying methods
589
- in initialization block and callbacks.
953
+ *Gannon McGibbon*
590
954
 
591
- Before:
955
+ * Add `accepts_nested_attributes_for` support for `delegated_type`
592
956
 
593
- User.where(name: "John").create do |john|
594
- User.find_by(name: "David") # => nil
595
- end
957
+ ```ruby
958
+ class Entry < ApplicationRecord
959
+ delegated_type :entryable, types: %w[ Message Comment ]
960
+ accepts_nested_attributes_for :entryable
961
+ end
596
962
 
597
- After:
963
+ entry = Entry.create(entryable_type: 'Message', entryable_attributes: { content: 'Hello world' })
964
+ # => #<Entry:0x00>
965
+ # id: 1
966
+ # entryable_id: 1,
967
+ # entryable_type: 'Message'
968
+ # ...>
969
+
970
+ entry.entryable
971
+ # => #<Message:0x01>
972
+ # id: 1
973
+ # content: 'Hello world'
974
+ # ...>
975
+ ```
598
976
 
599
- User.where(name: "John").create do |john|
600
- User.find_by(name: "David") # => #<User name: "David", ...>
601
- end
977
+ Previously it would raise an error:
602
978
 
603
- *Ryuta Kamizono*
979
+ ```ruby
980
+ Entry.create(entryable_type: 'Message', entryable_attributes: { content: 'Hello world' })
981
+ # ArgumentError: Cannot build association `entryable'. Are you trying to build a polymorphic one-to-one association?
982
+ ```
604
983
 
605
- * Named scope chain does no longer leak scope to class level querying methods.
984
+ *Sjors Baltus*
606
985
 
607
- class User < ActiveRecord::Base
608
- scope :david, -> { User.where(name: "David") }
609
- end
986
+ * Use subquery for DELETE with GROUP_BY and HAVING clauses.
610
987
 
611
- Before:
988
+ Prior to this change, deletes with GROUP_BY and HAVING were returning an error.
612
989
 
613
- User.where(name: "John").david
614
- # SELECT * FROM users WHERE name = 'John' AND name = 'David'
990
+ After this change, GROUP_BY and HAVING are valid clauses in DELETE queries, generating the following query:
615
991
 
616
- After:
992
+ ```sql
993
+ DELETE FROM "posts" WHERE "posts"."id" IN (
994
+ SELECT "posts"."id" FROM "posts" INNER JOIN "comments" ON "comments"."post_id" = "posts"."id" GROUP BY "posts"."id" HAVING (count(comments.id) >= 2))
995
+ ) [["flagged", "t"]]
996
+ ```
617
997
 
618
- User.where(name: "John").david
619
- # SELECT * FROM users WHERE name = 'David'
998
+ *Ignacio Chiazzo Cardarello*
620
999
 
621
- *Ryuta Kamizono*
1000
+ * Use subquery for UPDATE with GROUP_BY and HAVING clauses.
622
1001
 
623
- * Remove deprecated methods from `ActiveRecord::DatabaseConfigurations`.
1002
+ Prior to this change, updates with GROUP_BY and HAVING were being ignored, generating a SQL like this:
624
1003
 
625
- `fetch`
626
- `each`
627
- `first`
628
- `values`
629
- `[]=`
1004
+ ```sql
1005
+ UPDATE "posts" SET "flagged" = ? WHERE "posts"."id" IN (
1006
+ SELECT "posts"."id" FROM "posts" INNER JOIN "comments" ON "comments"."post_id" = "posts"."id"
1007
+ ) [["flagged", "t"]]
1008
+ ```
630
1009
 
631
- *Rafael Mendonça França*
1010
+ After this change, GROUP_BY and HAVING clauses are used as a subquery in updates, like this:
632
1011
 
633
- * `where.not` now generates NAND predicates instead of NOR.
1012
+ ```sql
1013
+ UPDATE "posts" SET "flagged" = ? WHERE "posts"."id" IN (
1014
+ SELECT "posts"."id" FROM "posts" INNER JOIN "comments" ON "comments"."post_id" = "posts"."id"
1015
+ GROUP BY posts.id HAVING (count(comments.id) >= 2)
1016
+ ) [["flagged", "t"]]
1017
+ ```
634
1018
 
635
- Before:
1019
+ *Ignacio Chiazzo Cardarello*
636
1020
 
637
- User.where.not(name: "Jon", role: "admin")
638
- # SELECT * FROM users WHERE name != 'Jon' AND role != 'admin'
1021
+ * Add support for setting the filename of the schema or structure dump in the database config.
639
1022
 
640
- After:
1023
+ Applications may now set their the filename or path of the schema / structure dump file in their database configuration.
641
1024
 
642
- User.where.not(name: "Jon", role: "admin")
643
- # SELECT * FROM users WHERE NOT (name == 'Jon' AND role == 'admin')
1025
+ ```yaml
1026
+ production:
1027
+ primary:
1028
+ database: my_db
1029
+ schema_dump: my_schema_dump_filename.rb
1030
+ animals:
1031
+ database: animals_db
1032
+ schema_dump: false
1033
+ ```
644
1034
 
645
- *Rafael Mendonça França*
1035
+ The filename set in `schema_dump` will be used by the application. If set to `false` the schema will not be dumped. The database tasks are responsible for adding the database directory to the filename. If a full path is provided, the Rails tasks will use that instead of `ActiveRecord::DatabaseTasks.db_dir`.
646
1036
 
647
- * Remove deprecated `ActiveRecord::Result#to_hash` method.
1037
+ *Eileen M. Uchitelle*, *Ryan Kerr*
648
1038
 
649
- *Rafael Mendonça França*
1039
+ * Add `ActiveRecord::Base.prohibit_shard_swapping` to prevent attempts to change the shard within a block.
650
1040
 
651
- * Deprecate `ActiveRecord::Base.allow_unsafe_raw_sql`.
1041
+ *John Crepezzi*, *Eileen M. Uchitelle*
652
1042
 
653
- *Rafael Mendonça França*
1043
+ * Filter unchanged attributes with default function from insert query when `partial_inserts` is disabled.
654
1044
 
655
- * Remove deprecated support for using unsafe raw SQL in `ActiveRecord::Relation` methods.
1045
+ *Akshay Birajdar*, *Jacopo Beschi*
656
1046
 
657
- *Rafael Mendonça França*
1047
+ * Add support for FILTER clause (SQL:2003) to Arel.
658
1048
 
659
- * Allow users to silence the "Rails couldn't infer whether you are using multiple databases..."
660
- message using `config.active_record.suppress_multiple_database_warning`.
1049
+ Currently supported by PostgreSQL 9.4+ and SQLite 3.30+.
661
1050
 
662
- *Omri Gabay*
1051
+ *Andrey Novikov*
663
1052
 
664
- * Connections can be granularly switched for abstract classes when `connected_to` is called.
1053
+ * Automatically set timestamps on record creation during bulk insert/upsert
665
1054
 
666
- This change allows `connected_to` to switch a `role` and/or `shard` for a single abstract class instead of all classes globally. Applications that want to use the new feature need to set `config.active_record.legacy_connection_handling` to `false` in their application configuration.
1055
+ Prior to this change, only updates during an upsert operation (e.g. `upsert_all`) would touch timestamps (`updated_{at,on}`). Now, record creations also touch timestamp columns (`{created,updated}_{at,on}`).
667
1056
 
668
- Example usage:
1057
+ This behaviour is controlled by the `<model>.record_timestamps` config, matching the behaviour of `create`, `update`, etc. It can also be overridden by using the `record_timestamps:` keyword argument.
669
1058
 
670
- Given an application we have a `User` model that inherits from `ApplicationRecord` and a `Dog` model that inherits from `AnimalsRecord`. `AnimalsRecord` and `ApplicationRecord` have writing and reading connections as well as shard `default`, `one`, and `two`.
1059
+ Note that this means `upsert_all` on models with `record_timestamps = false` will no longer touch `updated_{at,on}` automatically.
671
1060
 
672
- ```ruby
673
- ActiveRecord::Base.connected_to(role: :reading) do
674
- User.first # reads from default replica
675
- Dog.first # reads from default replica
1061
+ *Sam Bostock*
676
1062
 
677
- AnimalsRecord.connected_to(role: :writing, shard: :one) do
678
- User.first # reads from default replica
679
- Dog.first # reads from shard one primary
680
- end
1063
+ * Don't require `role` when passing `shard` to `connected_to`.
681
1064
 
682
- User.first # reads from default replica
683
- Dog.first # reads from default replica
1065
+ `connected_to` can now be called with a `shard` only. Note that `role` is still inherited if `connected_to` calls are nested.
684
1066
 
685
- ApplicationRecord.connected_to(role: :writing, shard: :two) do
686
- User.first # reads from shard two primary
687
- Dog.first # reads from default replica
688
- end
1067
+ *Eileen M. Uchitelle*
1068
+
1069
+ * Add option to lazily load the schema cache on the connection.
1070
+
1071
+ Previously, the only way to load the schema cache in Active Record was through the Railtie on boot. This option provides the ability to load the schema cache on the connection after it's been established. Loading the cache lazily on the connection can be beneficial for Rails applications that use multiple databases because it will load the cache at the time the connection is established. Currently Railties doesn't have access to the connections before boot.
1072
+
1073
+ To use the cache, set `config.active_record.lazily_load_schema_cache = true` in your application configuration. In addition a `schema_cache_path` should be set in your database configuration if you don't want to use the default "db/schema_cache.yml" path.
1074
+
1075
+ *Eileen M. Uchitelle*
1076
+
1077
+ * Allow automatic `inverse_of` detection for associations with scopes.
1078
+
1079
+ Automatic `inverse_of` detection now works for associations with scopes. For
1080
+ example, the `comments` association here now automatically detects
1081
+ `inverse_of: :post`, so we don't need to pass that option:
1082
+
1083
+ ```ruby
1084
+ class Post < ActiveRecord::Base
1085
+ has_many :comments, -> { visible }
1086
+ end
1087
+
1088
+ class Comment < ActiveRecord::Base
1089
+ belongs_to :post
689
1090
  end
690
1091
  ```
691
1092
 
692
- *Eileen M. Uchitelle*, *John Crepezzi*
1093
+ Note that the automatic detection still won't work if the inverse
1094
+ association has a scope. In this example a scope on the `post` association
1095
+ would still prevent Rails from finding the inverse for the `comments`
1096
+ association.
1097
+
1098
+ This will be the default for new apps in Rails 7. To opt in:
1099
+
1100
+ ```ruby
1101
+ config.active_record.automatic_scope_inversing = true
1102
+ ```
1103
+
1104
+ *Daniel Colson*, *Chris Bloom*
1105
+
1106
+ * Accept optional transaction args to `ActiveRecord::Locking::Pessimistic#with_lock`
693
1107
 
694
- * Allow double-dash comment syntax when querying read-only databases
1108
+ `#with_lock` now accepts transaction options like `requires_new:`,
1109
+ `isolation:`, and `joinable:`
695
1110
 
696
- *James Adam*
1111
+ *John Mileham*
697
1112
 
698
- * Add `values_at` method.
1113
+ * Adds support for deferrable foreign key constraints in PostgreSQL.
699
1114
 
700
- Returns an array containing the values associated with the given methods.
1115
+ By default, foreign key constraints in PostgreSQL are checked after each statement. This works for most use cases,
1116
+ but becomes a major limitation when creating related records before the parent record is inserted into the database.
1117
+ One example of this is looking up / creating a person via one or more unique alias.
701
1118
 
702
1119
  ```ruby
703
- topic = Topic.first
704
- topic.values_at(:title, :author_name)
705
- # => ["Budget", "Jason"]
1120
+ Person.transaction do
1121
+ alias = Alias
1122
+ .create_with(user_id: SecureRandom.uuid)
1123
+ .create_or_find_by(name: "DHH")
1124
+
1125
+ person = Person
1126
+ .create_with(name: "David Heinemeier Hansson")
1127
+ .create_or_find_by(id: alias.user_id)
1128
+ end
706
1129
  ```
707
1130
 
708
- Similar to `Hash#values_at` but on an Active Record instance.
1131
+ Using the default behavior, the transaction would fail when executing the first `INSERT` statement.
709
1132
 
710
- *Guillaume Briday*
1133
+ By passing the `:deferrable` option to the `add_foreign_key` statement in migrations, it's possible to defer this
1134
+ check.
711
1135
 
712
- * Fix `read_attribute_before_type_cast` to consider attribute aliases.
1136
+ ```ruby
1137
+ add_foreign_key :aliases, :person, deferrable: true
1138
+ ```
713
1139
 
714
- *Marcelo Lauxen*
1140
+ Passing `deferrable: true` doesn't change the default behavior, but allows manually deferring the check using
1141
+ `SET CONSTRAINTS ALL DEFERRED` within a transaction. This will cause the foreign keys to be checked after the
1142
+ transaction.
715
1143
 
716
- * Support passing record to uniqueness validator `:conditions` callable:
1144
+ It's also possible to adjust the default behavior from an immediate check (after the statement), to a deferred check
1145
+ (after the transaction):
717
1146
 
718
1147
  ```ruby
719
- class Article < ApplicationRecord
720
- validates_uniqueness_of :title, conditions: ->(article) {
721
- published_at = article.published_at
722
- where(published_at: published_at.beginning_of_year..published_at.end_of_year)
723
- }
724
- end
1148
+ add_foreign_key :aliases, :person, deferrable: :deferred
725
1149
  ```
726
1150
 
727
- *Eliot Sykes*
1151
+ *Benedikt Deicke*
1152
+
1153
+ * Allow configuring Postgres password through the socket URL.
1154
+
1155
+ For example:
1156
+ ```ruby
1157
+ ActiveRecord::DatabaseConfigurations::UrlConfig.new(
1158
+ :production, :production, 'postgres:///?user=user&password=secret&dbname=app', {}
1159
+ ).configuration_hash
1160
+ ```
728
1161
 
729
- * `BatchEnumerator#update_all` and `BatchEnumerator#delete_all` now return the
730
- total number of rows affected, just like their non-batched counterparts.
1162
+ will now return,
731
1163
 
732
1164
  ```ruby
733
- Person.in_batches.update_all("first_name = 'Eugene'") # => 42
734
- Person.in_batches.delete_all # => 42
1165
+ { :user=>"user", :password=>"secret", :dbname=>"app", :adapter=>"postgresql" }
735
1166
  ```
736
1167
 
737
- Fixes #40287.
1168
+ *Abeid Ahmed*
738
1169
 
739
- *Eugene Kenny*
1170
+ * PostgreSQL: support custom enum types
740
1171
 
741
- * Add support for PostgreSQL `interval` data type with conversion to
742
- `ActiveSupport::Duration` when loading records from database and
743
- serialization to ISO 8601 formatted duration string on save.
744
- Add support to define a column in migrations and get it in a schema dump.
745
- Optional column precision is supported.
1172
+ In migrations, use `create_enum` to add a new enum type, and `t.enum` to add a column.
746
1173
 
747
- To use this in 6.1, you need to place the next string to your model file:
1174
+ ```ruby
1175
+ def up
1176
+ create_enum :mood, ["happy", "sad"]
748
1177
 
749
- attribute :duration, :interval
1178
+ change_table :cats do |t|
1179
+ t.enum :current_mood, enum_type: "mood", default: "happy", null: false
1180
+ end
1181
+ end
1182
+ ```
750
1183
 
751
- To keep old behavior until 7.0 is released:
1184
+ Enums will be presented correctly in `schema.rb`. Note that this is only supported by
1185
+ the PostgreSQL adapter.
752
1186
 
753
- attribute :duration, :string
1187
+ *Alex Ghiculescu*
754
1188
 
755
- Example:
1189
+ * Avoid COMMENT statements in PostgreSQL structure dumps
756
1190
 
757
- create_table :events do |t|
758
- t.string :name
759
- t.interval :duration
760
- end
1191
+ COMMENT statements are now omitted from the output of `db:structure:dump` when using PostgreSQL >= 11.
1192
+ This allows loading the dump without a pgsql superuser account.
761
1193
 
762
- class Event < ApplicationRecord
763
- attribute :duration, :interval
764
- end
1194
+ Fixes #36816, #43107.
765
1195
 
766
- Event.create!(name: 'Rock Fest', duration: 2.days)
767
- Event.last.duration # => 2 days
768
- Event.last.duration.iso8601 # => "P2D"
769
- Event.new(duration: 'P1DT12H3S').duration # => 1 day, 12 hours, and 3 seconds
770
- Event.new(duration: '1 day') # Unknown value will be ignored and NULL will be written to database
1196
+ *Janosch Müller*
771
1197
 
772
- *Andrey Novikov*
1198
+ * Add support for generated columns in PostgreSQL adapter
773
1199
 
774
- * Allow associations supporting the `dependent:` key to take `dependent: :destroy_async`.
1200
+ Generated columns are supported since version 12.0 of PostgreSQL. This adds
1201
+ support of those to the PostgreSQL adapter.
775
1202
 
776
1203
  ```ruby
777
- class Account < ActiveRecord::Base
778
- belongs_to :supplier, dependent: :destroy_async
1204
+ create_table :users do |t|
1205
+ t.string :name
1206
+ t.virtual :name_upcased, type: :string, as: 'upper(name)', stored: true
779
1207
  end
780
1208
  ```
781
1209
 
782
- `:destroy_async` will enqueue a job to destroy associated records in the background.
1210
+ *Michał Begejowicz*
783
1211
 
784
- *DHH*, *George Claghorn*, *Cory Gwin*, *Rafael Mendonça França*, *Adrianna Chang*
785
1212
 
786
- * Add `SKIP_TEST_DATABASE` environment variable to disable modifying the test database when `rails db:create` and `rails db:drop` are called.
1213
+ ## Rails 7.0.0.alpha2 (September 15, 2021) ##
787
1214
 
788
- *Jason Schweier*
1215
+ * No changes.
789
1216
 
790
- * `connects_to` can only be called on `ActiveRecord::Base` or abstract classes.
791
1217
 
792
- Ensure that `connects_to` can only be called from `ActiveRecord::Base` or abstract classes. This protects the application from opening duplicate or too many connections.
1218
+ ## Rails 7.0.0.alpha1 (September 15, 2021) ##
793
1219
 
794
- *Eileen M. Uchitelle*, *John Crepezzi*
1220
+ * Remove warning when overwriting existing scopes
795
1221
 
796
- * All connection adapters `execute` now raises `ActiveRecord::ConnectionNotEstablished` rather than
797
- `ActiveRecord::StatementInvalid` when they encounter a connection error.
1222
+ Removes the following unnecessary warning message that appeared when overwriting existing scopes
798
1223
 
799
- *Jean Boussier*
1224
+ ```
1225
+ Creating scope :my_scope_name. Overwriting existing method "MyClass.my_scope_name" when overwriting existing scopes
1226
+ ```
800
1227
 
801
- * `Mysql2Adapter#quote_string` now raises `ActiveRecord::ConnectionNotEstablished` rather than
802
- `ActiveRecord::StatementInvalid` when it can't connect to the MySQL server.
1228
+ *Weston Ganger*
803
1229
 
804
- *Jean Boussier*
1230
+ * Use full precision for `updated_at` in `insert_all`/`upsert_all`
805
1231
 
806
- * Add support for check constraints that are `NOT VALID` via `validate: false` (PostgreSQL-only).
1232
+ `CURRENT_TIMESTAMP` provides differing precision depending on the database,
1233
+ and not all databases support explicitly specifying additional precision.
807
1234
 
808
- *Alex Robbin*
1235
+ Instead, we delegate to the new `connection.high_precision_current_timestamp`
1236
+ for the SQL to produce a high precision timestamp on the current database.
809
1237
 
810
- * Ensure the default configuration is considered primary or first for an environment
1238
+ Fixes #42992
811
1239
 
812
- If a multiple database application provides a configuration named primary, that will be treated as default. In applications that do not have a primary entry, the default database configuration will be the first configuration for an environment.
1240
+ *Sam Bostock*
813
1241
 
814
- *Eileen M. Uchitelle*
1242
+ * Add ssl support for postgresql database tasks
815
1243
 
816
- * Allow `where` references association names as joined table name aliases.
1244
+ Add `PGSSLMODE`, `PGSSLCERT`, `PGSSLKEY` and `PGSSLROOTCERT` to pg_env from database config
1245
+ when running postgresql database tasks.
817
1246
 
818
- ```ruby
819
- class Comment < ActiveRecord::Base
820
- enum label: [:default, :child]
821
- has_many :children, class_name: "Comment", foreign_key: :parent_id
822
- end
1247
+ ```yaml
1248
+ # config/database.yml
823
1249
 
824
- # ... FROM comments LEFT OUTER JOIN comments children ON ... WHERE children.label = 1
825
- Comment.includes(:children).where("children.label": "child")
1250
+ production:
1251
+ sslmode: verify-full
1252
+ sslcert: client.crt
1253
+ sslkey: client.key
1254
+ sslrootcert: ca.crt
826
1255
  ```
827
1256
 
828
- *Ryuta Kamizono*
1257
+ Environment variables
829
1258
 
830
- * Support storing demodulized class name for polymorphic type.
1259
+ ```
1260
+ PGSSLMODE=verify-full
1261
+ PGSSLCERT=client.crt
1262
+ PGSSLKEY=client.key
1263
+ PGSSLROOTCERT=ca.crt
1264
+ ```
831
1265
 
832
- Before Rails 6.1, storing demodulized class name is supported only for STI type
833
- by `store_full_sti_class` class attribute.
1266
+ Fixes #42994
834
1267
 
835
- Now `store_full_class_name` class attribute can handle both STI and polymorphic types.
1268
+ *Michael Bayucot*
836
1269
 
837
- *Ryuta Kamizono*
1270
+ * Avoid scoping update callbacks in `ActiveRecord::Relation#update!`.
838
1271
 
839
- * Deprecate `rails db:structure:{load, dump}` tasks and extend
840
- `rails db:schema:{load, dump}` tasks to work with either `:ruby` or `:sql` format,
841
- depending on `config.active_record.schema_format` configuration value.
1272
+ Making it consistent with how scoping is applied only to the query in `ActiveRecord::Relation#update`
1273
+ and not also to the callbacks from the update itself.
842
1274
 
843
- *fatkodima*
1275
+ *Dylan Thacker-Smith*
844
1276
 
845
- * Respect the `select` values for eager loading.
1277
+ * Fix 2 cases that inferred polymorphic class from the association's `foreign_type`
1278
+ using `String#constantize` instead of the model's `polymorphic_class_for`.
846
1279
 
847
- ```ruby
848
- post = Post.select("UPPER(title) AS title").first
849
- post.title # => "WELCOME TO THE WEBLOG"
850
- post.body # => ActiveModel::MissingAttributeError
1280
+ When updating a polymorphic association, the old `foreign_type` was not inferred correctly when:
1281
+ 1. `touch`ing the previously associated record
1282
+ 2. updating the previously associated record's `counter_cache`
851
1283
 
852
- # Rails 6.0 (ignore the `select` values)
853
- post = Post.select("UPPER(title) AS title").eager_load(:comments).first
854
- post.title # => "Welcome to the weblog"
855
- post.body # => "Such a lovely day"
1284
+ *Jimmy Bourassa*
856
1285
 
857
- # Rails 6.1 (respect the `select` values)
858
- post = Post.select("UPPER(title) AS title").eager_load(:comments).first
859
- post.title # => "WELCOME TO THE WEBLOG"
860
- post.body # => ActiveModel::MissingAttributeError
861
- ```
1286
+ * Add config option for ignoring tables when dumping the schema cache.
862
1287
 
863
- *Ryuta Kamizono*
1288
+ Applications can now be configured to ignore certain tables when dumping the schema cache.
864
1289
 
865
- * Allow attribute's default to be configured but keeping its own type.
1290
+ The configuration option can table an array of tables:
866
1291
 
867
1292
  ```ruby
868
- class Post < ActiveRecord::Base
869
- attribute :written_at, default: -> { Time.now.utc }
870
- end
1293
+ config.active_record.schema_cache_ignored_tables = ["ignored_table", "another_ignored_table"]
1294
+ ```
871
1295
 
872
- # Rails 6.0
873
- Post.type_for_attribute(:written_at) # => #<Type::Value ... precision: nil, ...>
1296
+ Or a regex:
874
1297
 
875
- # Rails 6.1
876
- Post.type_for_attribute(:written_at) # => #<Type::DateTime ... precision: 6, ...>
1298
+ ```ruby
1299
+ config.active_record.schema_cache_ignored_tables = [/^_/]
877
1300
  ```
878
1301
 
879
- *Ryuta Kamizono*
1302
+ *Eileen M. Uchitelle*
880
1303
 
881
- * Allow default to be configured for Enum.
1304
+ * Make schema cache methods return consistent results.
882
1305
 
883
- ```ruby
884
- class Book < ActiveRecord::Base
885
- enum status: [:proposed, :written, :published], _default: :published
886
- end
1306
+ Previously the schema cache methods `primary_keys`, `columns`, `columns_hash`, and `indexes`
1307
+ would behave differently than one another when a table didn't exist and differently across
1308
+ database adapters. This change unifies the behavior so each method behaves the same regardless
1309
+ of adapter.
887
1310
 
888
- Book.new.status # => "published"
889
- ```
1311
+ The behavior now is:
890
1312
 
891
- *Ryuta Kamizono*
1313
+ `columns`: (unchanged) raises a db error if the table does not exist.
1314
+ `columns_hash`: (unchanged) raises a db error if the table does not exist.
1315
+ `primary_keys`: (unchanged) returns `nil` if the table does not exist.
1316
+ `indexes`: (changed for mysql2) returns `[]` if the table does not exist.
892
1317
 
893
- * Deprecate YAML loading from legacy format older than Rails 5.0.
1318
+ *Eileen M. Uchitelle*
894
1319
 
895
- *Ryuta Kamizono*
1320
+ * Reestablish connection to previous database after after running `db:schema:load:name`
896
1321
 
897
- * Added the setting `ActiveRecord::Base.immutable_strings_by_default`, which
898
- allows you to specify that all string columns should be frozen unless
899
- otherwise specified. This will reduce memory pressure for applications which
900
- do not generally mutate string properties of Active Record objects.
1322
+ After running `db:schema:load:name` the previous connection is restored.
901
1323
 
902
- *Sean Griffin*, *Ryuta Kamizono*
1324
+ *Jacopo Beschi*
903
1325
 
904
- * Deprecate `map!` and `collect!` on `ActiveRecord::Result`.
1326
+ * Add database config option `database_tasks`
905
1327
 
906
- *Ryuta Kamizono*
1328
+ If you would like to connect to an external database without any database
1329
+ management tasks such as schema management, migrations, seeds, etc. you can set
1330
+ the per database config option `database_tasks: false`
907
1331
 
908
- * Support `relation.and` for intersection as Set theory.
1332
+ ```yaml
1333
+ # config/database.yml
909
1334
 
910
- ```ruby
911
- david_and_mary = Author.where(id: [david, mary])
912
- mary_and_bob = Author.where(id: [mary, bob])
1335
+ production:
1336
+ primary:
1337
+ database: my_database
1338
+ adapter: mysql2
1339
+ animals:
1340
+ database: my_animals_database
1341
+ adapter: mysql2
1342
+ database_tasks: false
1343
+ ```
913
1344
 
914
- david_and_mary.merge(mary_and_bob) # => [mary, bob]
1345
+ *Weston Ganger*
915
1346
 
916
- david_and_mary.and(mary_and_bob) # => [mary]
917
- david_and_mary.or(mary_and_bob) # => [david, mary, bob]
918
- ```
1347
+ * Fix `ActiveRecord::InternalMetadata` to not be broken by `config.active_record.record_timestamps = false`
919
1348
 
920
- *Ryuta Kamizono*
1349
+ Since the model always create the timestamp columns, it has to set them, otherwise it breaks
1350
+ various DB management tasks.
921
1351
 
922
- * Merging conditions on the same column no longer maintain both conditions,
923
- and will be consistently replaced by the latter condition in Rails 7.0.
924
- To migrate to Rails 7.0's behavior, use `relation.merge(other, rewhere: true)`.
1352
+ Fixes #42983
1353
+
1354
+ * Add `ActiveRecord::QueryLogs`.
1355
+
1356
+ Configurable tags can be automatically added to all SQL queries generated by Active Record.
925
1357
 
926
1358
  ```ruby
927
- # Rails 6.1 (IN clause is replaced by merger side equality condition)
928
- Author.where(id: [david.id, mary.id]).merge(Author.where(id: bob)) # => [bob]
1359
+ # config/application.rb
1360
+ module MyApp
1361
+ class Application < Rails::Application
1362
+ config.active_record.query_log_tags_enabled = true
1363
+ end
1364
+ end
1365
+ ```
929
1366
 
930
- # Rails 6.1 (both conflict conditions exists, deprecated)
931
- Author.where(id: david.id..mary.id).merge(Author.where(id: bob)) # => []
1367
+ By default the application, controller and action details are added to the query tags:
932
1368
 
933
- # Rails 6.1 with rewhere to migrate to Rails 7.0's behavior
934
- Author.where(id: david.id..mary.id).merge(Author.where(id: bob), rewhere: true) # => [bob]
1369
+ ```ruby
1370
+ class BooksController < ApplicationController
1371
+ def index
1372
+ @books = Book.all
1373
+ end
1374
+ end
1375
+ ```
935
1376
 
936
- # Rails 7.0 (same behavior with IN clause, mergee side condition is consistently replaced)
937
- Author.where(id: [david.id, mary.id]).merge(Author.where(id: bob)) # => [bob]
938
- Author.where(id: david.id..mary.id).merge(Author.where(id: bob)) # => [bob]
1377
+ ```ruby
1378
+ GET /books
1379
+ # SELECT * FROM books /*application:MyApp;controller:books;action:index*/
939
1380
  ```
940
1381
 
941
- *Ryuta Kamizono*
1382
+ Custom tags containing static values and Procs can be defined in the application configuration:
942
1383
 
943
- * Do not mark Postgresql MAC address and UUID attributes as changed when the assigned value only varies by case.
1384
+ ```ruby
1385
+ config.active_record.query_log_tags = [
1386
+ :application,
1387
+ :controller,
1388
+ :action,
1389
+ {
1390
+ custom_static: "foo",
1391
+ custom_dynamic: -> { Time.now }
1392
+ }
1393
+ ]
1394
+ ```
944
1395
 
945
- *Peter Fry*
1396
+ *Keeran Raj Hawoldar*, *Eileen M. Uchitelle*, *Kasper Timm Hansen*
946
1397
 
947
- * Resolve issue with insert_all unique_by option when used with expression index.
1398
+ * Added support for multiple databases to `rails db:setup` and `rails db:reset`.
948
1399
 
949
- When the `:unique_by` option of `ActiveRecord::Persistence.insert_all` and
950
- `ActiveRecord::Persistence.upsert_all` was used with the name of an expression index, an error
951
- was raised. Adding a guard around the formatting behavior for the `:unique_by` corrects this.
1400
+ *Ryan Hall*
952
1401
 
953
- Usage:
1402
+ * Add `ActiveRecord::Relation#structurally_compatible?`.
1403
+
1404
+ Adds a query method by which a user can tell if the relation that they're
1405
+ about to use for `#or` or `#and` is structurally compatible with the
1406
+ receiver.
1407
+
1408
+ *Kevin Newton*
1409
+
1410
+ * Add `ActiveRecord::QueryMethods#in_order_of`.
1411
+
1412
+ This allows you to specify an explicit order that you'd like records
1413
+ returned in based on a SQL expression. By default, this will be accomplished
1414
+ using a case statement, as in:
954
1415
 
955
1416
  ```ruby
956
- create_table :books, id: :integer, force: true do |t|
957
- t.column :name, :string
958
- t.index "lower(name)", unique: true
959
- end
1417
+ Post.in_order_of(:id, [3, 5, 1])
1418
+ ```
960
1419
 
961
- Book.insert_all [{ name: "MyTest" }], unique_by: :index_books_on_lower_name
1420
+ will generate the SQL:
1421
+
1422
+ ```sql
1423
+ SELECT "posts".* FROM "posts" ORDER BY CASE "posts"."id" WHEN 3 THEN 1 WHEN 5 THEN 2 WHEN 1 THEN 3 ELSE 4 END ASC
962
1424
  ```
963
1425
 
964
- Fixes #39516.
1426
+ However, because this functionality is built into MySQL in the form of the
1427
+ `FIELD` function, that connection adapter will generate the following SQL
1428
+ instead:
965
1429
 
966
- *Austen Madden*
1430
+ ```sql
1431
+ SELECT "posts".* FROM "posts" ORDER BY FIELD("posts"."id", 1, 5, 3) DESC
1432
+ ```
967
1433
 
968
- * Add basic support for CHECK constraints to database migrations.
1434
+ *Kevin Newton*
969
1435
 
970
- Usage:
1436
+ * Fix `eager_loading?` when ordering with `Symbol`.
1437
+
1438
+ `eager_loading?` is triggered correctly when using `order` with symbols.
971
1439
 
972
1440
  ```ruby
973
- add_check_constraint :products, "price > 0", name: "price_check"
974
- remove_check_constraint :products, name: "price_check"
1441
+ scope = Post.includes(:comments).order(:"comments.label")
1442
+ => true
975
1443
  ```
976
1444
 
977
- *fatkodima*
1445
+ *Jacopo Beschi*
978
1446
 
979
- * Add `ActiveRecord::Base.strict_loading_by_default` and `ActiveRecord::Base.strict_loading_by_default=`
980
- to enable/disable strict_loading mode by default for a model. The configuration's value is
981
- inheritable by subclasses, but they can override that value and it will not impact parent class.
1447
+ * Two change tracking methods are added for `belongs_to` associations.
982
1448
 
983
- Usage:
1449
+ The `association_changed?` method (assuming an association named `:association`) returns true
1450
+ if a different associated object has been assigned and the foreign key will be updated in the
1451
+ next save.
984
1452
 
985
- ```ruby
986
- class Developer < ApplicationRecord
987
- self.strict_loading_by_default = true
1453
+ The `association_previously_changed?` method returns true if the previous save updated the
1454
+ association to reference a different associated object.
988
1455
 
989
- has_many :projects
990
- end
1456
+ *George Claghorn*
991
1457
 
992
- dev = Developer.first
993
- dev.projects.first
994
- # => ActiveRecord::StrictLoadingViolationError Exception: Developer is marked as strict_loading and Project cannot be lazily loaded.
995
- ```
1458
+ * Add option to disable schema dump per-database.
996
1459
 
997
- *bogdanvlviv*
1460
+ Dumping the schema is on by default for all databases in an application. To turn it off for a
1461
+ specific database, use the `schema_dump` option:
998
1462
 
999
- * Deprecate passing an Active Record object to `quote`/`type_cast` directly.
1463
+ ```yaml
1464
+ # config/database.yml
1000
1465
 
1001
- *Ryuta Kamizono*
1466
+ production:
1467
+ schema_dump: false
1468
+ ```
1002
1469
 
1003
- * Default engine `ENGINE=InnoDB` is no longer dumped to make schema more agnostic.
1470
+ *Luis Vasconcellos*, *Eileen M. Uchitelle*
1004
1471
 
1005
- Before:
1472
+ * Fix `eager_loading?` when ordering with `Hash` syntax.
1473
+
1474
+ `eager_loading?` is triggered correctly when using `order` with hash syntax
1475
+ on an outer table.
1006
1476
 
1007
1477
  ```ruby
1008
- create_table "accounts", options: "ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci", force: :cascade do |t|
1009
- end
1478
+ Post.includes(:comments).order({ "comments.label": :ASC }).eager_loading?
1479
+ # => true
1010
1480
  ```
1011
1481
 
1012
- After:
1482
+ *Jacopo Beschi*
1483
+
1484
+ * Move the forcing of clear text encoding to the `ActiveRecord::Encryption::Encryptor`.
1485
+
1486
+ Fixes #42699.
1487
+
1488
+ *J Smith*
1489
+
1490
+ * `partial_inserts` is now disabled by default in new apps.
1491
+
1492
+ This will be the default for new apps in Rails 7. To opt in:
1013
1493
 
1014
1494
  ```ruby
1015
- create_table "accounts", charset: "utf8mb4", collation: "utf8mb4_0900_ai_ci", force: :cascade do |t|
1016
- end
1495
+ config.active_record.partial_inserts = true
1017
1496
  ```
1018
1497
 
1019
- *Ryuta Kamizono*
1498
+ If a migration removes the default value of a column, this option
1499
+ would cause old processes to no longer be able to create new records.
1020
1500
 
1021
- * Added delegated type as an alternative to single-table inheritance for representing class hierarchies.
1022
- See ActiveRecord::DelegatedType for the full description.
1501
+ If you need to remove a column, you should first use `ignored_columns`
1502
+ to stop using it.
1023
1503
 
1024
- *DHH*
1504
+ *Jean Boussier*
1025
1505
 
1026
- * Deprecate aggregations with group by duplicated fields.
1506
+ * Rails can now verify foreign keys after loading fixtures in tests.
1027
1507
 
1028
- To migrate to Rails 7.0's behavior, use `uniq!(:group)` to deduplicate group fields.
1508
+ This will be the default for new apps in Rails 7. To opt in:
1029
1509
 
1030
1510
  ```ruby
1031
- accounts = Account.group(:firm_id)
1032
-
1033
- # duplicated group fields, deprecated.
1034
- accounts.merge(accounts.where.not(credit_limit: nil)).sum(:credit_limit)
1035
- # => {
1036
- # [1, 1] => 50,
1037
- # [2, 2] => 60
1038
- # }
1039
-
1040
- # use `uniq!(:group)` to deduplicate group fields.
1041
- accounts.merge(accounts.where.not(credit_limit: nil)).uniq!(:group).sum(:credit_limit)
1042
- # => {
1043
- # 1 => 50,
1044
- # 2 => 60
1045
- # }
1511
+ config.active_record.verify_foreign_keys_for_fixtures = true
1046
1512
  ```
1047
1513
 
1048
- *Ryuta Kamizono*
1514
+ Tests will not run if there is a foreign key constraint violation in your fixture data.
1049
1515
 
1050
- * Deprecate duplicated query annotations.
1516
+ The feature is supported by SQLite and PostgreSQL, other adapters can also add support for it.
1051
1517
 
1052
- To migrate to Rails 7.0's behavior, use `uniq!(:annotate)` to deduplicate query annotations.
1518
+ *Alex Ghiculescu*
1053
1519
 
1054
- ```ruby
1055
- accounts = Account.where(id: [1, 2]).annotate("david and mary")
1520
+ * Clear cached `has_one` association after setting `belongs_to` association to `nil`.
1056
1521
 
1057
- # duplicated annotations, deprecated.
1058
- accounts.merge(accounts.rewhere(id: 3))
1059
- # SELECT accounts.* FROM accounts WHERE accounts.id = 3 /* david and mary */ /* david and mary */
1522
+ After setting a `belongs_to` relation to `nil` and updating an unrelated attribute on the owner,
1523
+ the owner should still return `nil` on the `has_one` relation.
1060
1524
 
1061
- # use `uniq!(:annotate)` to deduplicate annotations.
1062
- accounts.merge(accounts.rewhere(id: 3)).uniq!(:annotate)
1063
- # SELECT accounts.* FROM accounts WHERE accounts.id = 3 /* david and mary */
1064
- ```
1525
+ Fixes #42597.
1065
1526
 
1066
- *Ryuta Kamizono*
1527
+ *Michiel de Mare*
1067
1528
 
1068
- * Resolve conflict between counter cache and optimistic locking.
1529
+ * OpenSSL constants are now used for Digest computations.
1069
1530
 
1070
- Bump an Active Record instance's lock version after updating its counter
1071
- cache. This avoids raising an unnecessary `ActiveRecord::StaleObjectError`
1072
- upon subsequent transactions by maintaining parity with the corresponding
1073
- database record's `lock_version` column.
1531
+ *Dirkjan Bussink*
1074
1532
 
1075
- Fixes #16449.
1533
+ * Adds support for `if_not_exists` to `add_foreign_key` and `if_exists` to `remove_foreign_key`.
1076
1534
 
1077
- *Aaron Lipman*
1535
+ Applications can set their migrations to ignore exceptions raised when adding a foreign key
1536
+ that already exists or when removing a foreign key that does not exist.
1537
+
1538
+ Example Usage:
1078
1539
 
1079
- * Support merging option `:rewhere` to allow mergee side condition to be replaced exactly.
1540
+ ```ruby
1541
+ class AddAuthorsForeignKeyToArticles < ActiveRecord::Migration[7.0]
1542
+ def change
1543
+ add_foreign_key :articles, :authors, if_not_exists: true
1544
+ end
1545
+ end
1546
+ ```
1080
1547
 
1081
1548
  ```ruby
1082
- david_and_mary = Author.where(id: david.id..mary.id)
1549
+ class RemoveAuthorsForeignKeyFromArticles < ActiveRecord::Migration[7.0]
1550
+ def change
1551
+ remove_foreign_key :articles, :authors, if_exists: true
1552
+ end
1553
+ end
1554
+ ```
1083
1555
 
1084
- # both conflict conditions exists
1085
- david_and_mary.merge(Author.where(id: bob)) # => []
1556
+ *Roberto Miranda*
1086
1557
 
1087
- # mergee side condition is replaced by rewhere
1088
- david_and_mary.merge(Author.rewhere(id: bob)) # => [bob]
1558
+ * Prevent polluting ENV during postgresql structure dump/load.
1089
1559
 
1090
- # mergee side condition is replaced by rewhere option
1091
- david_and_mary.merge(Author.where(id: bob), rewhere: true) # => [bob]
1092
- ```
1560
+ Some configuration parameters were provided to pg_dump / psql via
1561
+ environment variables which persisted beyond the command being run, and may
1562
+ have caused subsequent commands and connections to fail. Tasks running
1563
+ across multiple postgresql databases like `rails db:test:prepare` may have
1564
+ been affected.
1093
1565
 
1094
- *Ryuta Kamizono*
1566
+ *Samuel Cochran*
1095
1567
 
1096
- * Add support for finding records based on signed ids, which are tamper-proof, verified ids that can be
1097
- set to expire and scoped with a purpose. This is particularly useful for things like password reset
1098
- or email verification, where you want the bearer of the signed id to be able to interact with the
1099
- underlying record, but usually only within a certain time period.
1568
+ * Set precision 6 by default for `datetime` columns.
1100
1569
 
1101
- ```ruby
1102
- signed_id = User.first.signed_id expires_in: 15.minutes, purpose: :password_reset
1570
+ By default, datetime columns will have microseconds precision instead of seconds precision.
1103
1571
 
1104
- User.find_signed signed_id # => nil, since the purpose does not match
1572
+ *Roberto Miranda*
1105
1573
 
1106
- travel 16.minutes
1107
- User.find_signed signed_id, purpose: :password_reset # => nil, since the signed id has expired
1574
+ * Allow preloading of associations with instance dependent scopes.
1108
1575
 
1109
- travel_back
1110
- User.find_signed signed_id, purpose: :password_reset # => User.first
1576
+ *John Hawthorn*, *John Crepezzi*, *Adam Hess*, *Eileen M. Uchitelle*, *Dinah Shi*
1111
1577
 
1112
- User.find_signed! "bad data" # => ActiveSupport::MessageVerifier::InvalidSignature
1113
- ```
1578
+ * Do not try to rollback transactions that failed due to a `ActiveRecord::TransactionRollbackError`.
1114
1579
 
1115
- *DHH*
1580
+ *Jamie McCarthy*
1116
1581
 
1117
- * Support `ALGORITHM = INSTANT` DDL option for index operations on MySQL.
1582
+ * Active Record Encryption will now encode values as UTF-8 when using deterministic
1583
+ encryption. The encoding is part of the encrypted payload, so different encodings for
1584
+ different values result in different ciphertexts. This can break unique constraints and
1585
+ queries.
1118
1586
 
1119
- *Ryuta Kamizono*
1587
+ The new behavior is configurable via `active_record.encryption.forced_encoding_for_deterministic_encryption`
1588
+ that is `Encoding::UTF_8` by default. It can be disabled by setting it to `nil`.
1120
1589
 
1121
- * Fix index creation to preserve index comment in bulk change table on MySQL.
1590
+ *Jorge Manrubia*
1122
1591
 
1123
- *Ryuta Kamizono*
1592
+ * The MySQL adapter now cast numbers and booleans bind parameters to string for safety reasons.
1124
1593
 
1125
- * Allow `unscope` to be aware of table name qualified values.
1594
+ When comparing a string and a number in a query, MySQL converts the string to a number. So for
1595
+ instance `"foo" = 0`, will implicitly cast `"foo"` to `0` and will evaluate to `TRUE` which can
1596
+ lead to security vulnerabilities.
1126
1597
 
1127
- It is possible to unscope only the column in the specified table.
1598
+ Active Record already protect against that vulnerability when it knows the type of the column
1599
+ being compared, however until now it was still vulnerable when using bind parameters:
1128
1600
 
1129
1601
  ```ruby
1130
- posts = Post.joins(:comments).group(:"posts.hidden")
1131
- posts = posts.where("posts.hidden": false, "comments.hidden": false)
1132
-
1133
- posts.count
1134
- # => { false => 10 }
1602
+ User.where("login_token = ?", 0).first
1603
+ ```
1135
1604
 
1136
- # unscope both hidden columns
1137
- posts.unscope(where: :hidden).count
1138
- # => { false => 11, true => 1 }
1605
+ Would perform:
1139
1606
 
1140
- # unscope only comments.hidden column
1141
- posts.unscope(where: :"comments.hidden").count
1142
- # => { false => 11 }
1607
+ ```sql
1608
+ SELECT * FROM `users` WHERE `login_token` = 0 LIMIT 1;
1143
1609
  ```
1144
1610
 
1145
- *Ryuta Kamizono*, *Slava Korolev*
1611
+ Now it will perform:
1146
1612
 
1147
- * Fix `rewhere` to truly overwrite collided where clause by new where clause.
1613
+ ```sql
1614
+ SELECT * FROM `users` WHERE `login_token` = '0' LIMIT 1;
1615
+ ```
1148
1616
 
1149
- ```ruby
1150
- steve = Person.find_by(name: "Steve")
1151
- david = Author.find_by(name: "David")
1617
+ *Jean Boussier*
1152
1618
 
1153
- relation = Essay.where(writer: steve)
1619
+ * Fixture configurations (`_fixture`) are now strictly validated.
1154
1620
 
1155
- # Before
1156
- relation.rewhere(writer: david).to_a # => []
1621
+ If an error will be raised if that entry contains unknown keys while previously it
1622
+ would silently have no effects.
1157
1623
 
1158
- # After
1159
- relation.rewhere(writer: david).to_a # => [david]
1160
- ```
1624
+ *Jean Boussier*
1161
1625
 
1162
- *Ryuta Kamizono*
1626
+ * Add `ActiveRecord::Base.update!` that works like `ActiveRecord::Base.update` but raises exceptions.
1163
1627
 
1164
- * Inspect time attributes with subsec and time zone offset.
1628
+ This allows for the same behavior as the instance method `#update!` at a class level.
1165
1629
 
1166
1630
  ```ruby
1167
- p Knot.create
1168
- => #<Knot id: 1, created_at: "2016-05-05 01:29:47.116928000 +0000">
1631
+ Person.update!(:all, state: "confirmed")
1169
1632
  ```
1170
1633
 
1171
- *akinomaeni*, *Jonathan Hefner*
1634
+ *Dorian Marié*
1172
1635
 
1173
- * Deprecate passing a column to `type_cast`.
1636
+ * Add `ActiveRecord::Base#attributes_for_database`.
1174
1637
 
1175
- *Ryuta Kamizono*
1638
+ Returns attributes with values for assignment to the database.
1176
1639
 
1177
- * Deprecate `in_clause_length` and `allowed_index_name_length` in `DatabaseLimits`.
1640
+ *Chris Salzberg*
1178
1641
 
1179
- *Ryuta Kamizono*
1642
+ * Use an empty query to check if the PostgreSQL connection is still active.
1180
1643
 
1181
- * Support bulk insert/upsert on relation to preserve scope values.
1644
+ An empty query is faster than `SELECT 1`.
1182
1645
 
1183
- *Josef Šimánek*, *Ryuta Kamizono*
1646
+ *Heinrich Lee Yu*
1184
1647
 
1185
- * Preserve column comment value on changing column name on MySQL.
1648
+ * Add `ActiveRecord::Base#previously_persisted?`.
1186
1649
 
1187
- *Islam Taha*
1650
+ Returns `true` if the object has been previously persisted but now it has been deleted.
1188
1651
 
1189
- * Add support for `if_exists` option for removing an index.
1652
+ * Deprecate `partial_writes` in favor of `partial_inserts` and `partial_updates`.
1190
1653
 
1191
- The `remove_index` method can take an `if_exists` option. If this is set to true an error won't be raised if the index doesn't exist.
1654
+ This allows to have a different behavior on update and create.
1192
1655
 
1193
- *Eileen M. Uchitelle*
1656
+ *Jean Boussier*
1194
1657
 
1195
- * Remove ibm_db, informix, mssql, oracle, and oracle12 Arel visitors which are not used in the code base.
1658
+ * Fix compatibility with `psych >= 4`.
1196
1659
 
1197
- *Ryuta Kamizono*
1660
+ Starting in Psych 4.0.0 `YAML.load` behaves like `YAML.safe_load`. To preserve compatibility,
1661
+ Active Record's schema cache loader and `YAMLColumn` now uses `YAML.unsafe_load` if available.
1198
1662
 
1199
- * Prevent `build_association` from `touching` a parent record if the record isn't persisted for `has_one` associations.
1663
+ *Jean Boussier*
1200
1664
 
1201
- Fixes #38219.
1665
+ * `ActiveRecord::Base.logger` is now a `class_attribute`.
1202
1666
 
1203
- *Josh Brody*
1667
+ This means it can no longer be accessed directly through `@@logger`, and that setting `logger =`
1668
+ on a subclass won't change the parent's logger.
1204
1669
 
1205
- * Add support for `if_not_exists` option for adding index.
1670
+ *Jean Boussier*
1206
1671
 
1207
- The `add_index` method respects `if_not_exists` option. If it is set to true
1208
- index won't be added.
1672
+ * Add `.asc.nulls_first` for all databases. Unfortunately MySQL still doesn't like `nulls_last`.
1209
1673
 
1210
- Usage:
1674
+ *Keenan Brock*
1211
1675
 
1212
- ```ruby
1213
- add_index :users, :account_id, if_not_exists: true
1214
- ```
1676
+ * Improve performance of `one?` and `many?` by limiting the generated count query to 2 results.
1677
+
1678
+ *Gonzalo Riestra*
1679
+
1680
+ * Don't check type when using `if_not_exists` on `add_column`.
1681
+
1682
+ Previously, if a migration called `add_column` with the `if_not_exists` option set to true
1683
+ the `column_exists?` check would look for a column with the same name and type as the migration.
1215
1684
 
1216
- The `if_not_exists` option passed to `create_table` also gets propagated to indexes
1217
- created within that migration so that if table and its indexes exist then there is no
1218
- attempt to create them again.
1685
+ Recently it was discovered that the type passed to the migration is not always the same type
1686
+ as the column after migration. For example a column set to `:mediumblob` in the migration will
1687
+ be casted to `binary` when calling `column.type`. Since there is no straightforward way to cast
1688
+ the type to the database type without running the migration, we opted to drop the type check from
1689
+ `add_column`. This means that migrations adding a duplicate column with a different type will no
1690
+ longer raise an error.
1219
1691
 
1220
- *Prathamesh Sonpatki*
1692
+ *Eileen M. Uchitelle*
1693
+
1694
+ * Log a warning message when running SQLite in production.
1221
1695
 
1222
- * Add `ActiveRecord::Base#previously_new_record?` to show if a record was new before the last save.
1696
+ Using SQLite in production ENV is generally discouraged. SQLite is also the default adapter
1697
+ in a new Rails application.
1698
+ For the above reasons log a warning message when running SQLite in production.
1223
1699
 
1224
- *Tom Ward*
1700
+ The warning can be disabled by setting `config.active_record.sqlite3_production_warning=false`.
1225
1701
 
1226
- * Support descending order for `find_each`, `find_in_batches`, and `in_batches`.
1702
+ *Jacopo Beschi*
1227
1703
 
1228
- Batch processing methods allow you to work with the records in batches, greatly reducing memory consumption, but records are always batched from oldest id to newest.
1704
+ * Add option to disable joins for `has_one` associations.
1229
1705
 
1230
- This change allows reversing the order, batching from newest to oldest. This is useful when you need to process newer batches of records first.
1706
+ In a multiple database application, associations can't join across
1707
+ databases. When set, this option instructs Rails to generate 2 or
1708
+ more queries rather than generating joins for `has_one` associations.
1231
1709
 
1232
- Pass `order: :desc` to yield batches in descending order. The default remains `order: :asc`.
1710
+ Set the option on a has one through association:
1233
1711
 
1234
1712
  ```ruby
1235
- Person.find_each(order: :desc) do |person|
1236
- person.party_all_night!
1713
+ class Person
1714
+ has_one :dog
1715
+ has_one :veterinarian, through: :dog, disable_joins: true
1237
1716
  end
1238
1717
  ```
1239
1718
 
1240
- *Alexey Vasiliev*
1719
+ Then instead of generating join SQL, two queries are used for `@person.veterinarian`:
1720
+
1721
+ ```
1722
+ SELECT "dogs"."id" FROM "dogs" WHERE "dogs"."person_id" = ? [["person_id", 1]]
1723
+ SELECT "veterinarians".* FROM "veterinarians" WHERE "veterinarians"."dog_id" = ? [["dog_id", 1]]
1724
+ ```
1241
1725
 
1242
- * Fix `insert_all` with enum values.
1726
+ *Sarah Vessels*, *Eileen M. Uchitelle*
1243
1727
 
1244
- Fixes #38716.
1728
+ * `Arel::Visitors::Dot` now renders a complete set of properties when visiting
1729
+ `Arel::Nodes::SelectCore`, `SelectStatement`, `InsertStatement`, `UpdateStatement`, and
1730
+ `DeleteStatement`, which fixes #42026. Previously, some properties were omitted.
1245
1731
 
1246
- *Joel Blum*
1732
+ *Mike Dalessio*
1247
1733
 
1248
- * Add support for `db:rollback:name` for multiple database applications.
1734
+ * `Arel::Visitors::Dot` now supports `Arel::Nodes::Bin`, `Case`, `CurrentRow`, `Distinct`,
1735
+ `DistinctOn`, `Else`, `Except`, `InfixOperation`, `Intersect`, `Lock`, `NotRegexp`, `Quoted`,
1736
+ `Regexp`, `UnaryOperation`, `Union`, `UnionAll`, `When`, and `With`. Previously, these node
1737
+ types caused an exception to be raised by `Arel::Visitors::Dot#accept`.
1249
1738
 
1250
- Multiple database applications will now raise if `db:rollback` is call and recommend using the `db:rollback:[NAME]` to rollback migrations.
1739
+ *Mike Dalessio*
1251
1740
 
1252
- *Eileen M. Uchitelle*
1741
+ * Optimize `remove_columns` to use a single SQL statement.
1253
1742
 
1254
- * `Relation#pick` now uses already loaded results instead of making another query.
1743
+ ```ruby
1744
+ remove_columns :my_table, :col_one, :col_two
1745
+ ```
1255
1746
 
1256
- *Eugene Kenny*
1747
+ Now results in the following SQL:
1257
1748
 
1258
- * Deprecate using `return`, `break` or `throw` to exit a transaction block after writes.
1749
+ ```sql
1750
+ ALTER TABLE "my_table" DROP COLUMN "col_one", DROP COLUMN "col_two"
1751
+ ```
1259
1752
 
1260
- *Dylan Thacker-Smith*
1753
+ *Jon Dufresne*
1261
1754
 
1262
- * Dump the schema or structure of a database when calling `db:migrate:name`.
1755
+ * Ensure `has_one` autosave association callbacks get called once.
1263
1756
 
1264
- In previous versions of Rails, `rails db:migrate` would dump the schema of the database. In Rails 6, that holds true (`rails db:migrate` dumps all databases' schemas), but `rails db:migrate:name` does not share that behavior.
1757
+ Change the `has_one` autosave callback to be non cyclic as well.
1758
+ By doing this the autosave callback are made more consistent for
1759
+ all 3 cases: `has_many`, `has_one`, and `belongs_to`.
1265
1760
 
1266
- Going forward, calls to `rails db:migrate:name` will dump the schema (or structure) of the database being migrated.
1761
+ *Petrik de Heus*
1267
1762
 
1268
- *Kyle Thompson*
1763
+ * Add option to disable joins for associations.
1269
1764
 
1270
- * Reset the `ActiveRecord::Base` connection after `rails db:migrate:name`.
1765
+ In a multiple database application, associations can't join across
1766
+ databases. When set, this option instructs Rails to generate 2 or
1767
+ more queries rather than generating joins for associations.
1271
1768
 
1272
- When `rails db:migrate` has finished, it ensures the `ActiveRecord::Base` connection is reset to its original configuration. Going forward, `rails db:migrate:name` will have the same behavior.
1769
+ Set the option on a has many through association:
1273
1770
 
1274
- *Kyle Thompson*
1771
+ ```ruby
1772
+ class Dog
1773
+ has_many :treats, through: :humans, disable_joins: true
1774
+ has_many :humans
1775
+ end
1776
+ ```
1275
1777
 
1276
- * Disallow calling `connected_to` on subclasses of `ActiveRecord::Base`.
1778
+ Then instead of generating join SQL, two queries are used for `@dog.treats`:
1277
1779
 
1278
- Behavior has not changed here but the previous API could be misleading to people who thought it would switch connections for only that class. `connected_to` switches the context from which we are getting connections, not the connections themselves.
1780
+ ```
1781
+ SELECT "humans"."id" FROM "humans" WHERE "humans"."dog_id" = ? [["dog_id", 1]]
1782
+ SELECT "treats".* FROM "treats" WHERE "treats"."human_id" IN (?, ?, ?) [["human_id", 1], ["human_id", 2], ["human_id", 3]]
1783
+ ```
1279
1784
 
1280
- *Eileen M. Uchitelle*, *John Crepezzi*
1785
+ *Eileen M. Uchitelle*, *Aaron Patterson*, *Lee Quarella*
1281
1786
 
1282
- * Add support for horizontal sharding to `connects_to` and `connected_to`.
1787
+ * Add setting for enumerating column names in SELECT statements.
1283
1788
 
1284
- Applications can now connect to multiple shards and switch between their shards in an application. Note that the shard swapping is still a manual process as this change does not include an API for automatic shard swapping.
1789
+ Adding a column to a PostgreSQL database, for example, while the application is running can
1790
+ change the result of wildcard `SELECT *` queries, which invalidates the result
1791
+ of cached prepared statements and raises a `PreparedStatementCacheExpired` error.
1285
1792
 
1286
- Usage:
1793
+ When enabled, Active Record will avoid wildcards and always include column names
1794
+ in `SELECT` queries, which will return consistent results and avoid prepared
1795
+ statement errors.
1287
1796
 
1288
- Given the following configuration:
1797
+ Before:
1289
1798
 
1290
- ```yaml
1291
- # config/database.yml
1292
- production:
1293
- primary:
1294
- database: my_database
1295
- primary_shard_one:
1296
- database: my_database_shard_one
1799
+ ```ruby
1800
+ Book.limit(5)
1801
+ # SELECT * FROM books LIMIT 5
1297
1802
  ```
1298
1803
 
1299
- Connect to multiple shards:
1804
+ After:
1300
1805
 
1301
1806
  ```ruby
1302
- class ApplicationRecord < ActiveRecord::Base
1303
- self.abstract_class = true
1807
+ # config/application.rb
1808
+ module MyApp
1809
+ class Application < Rails::Application
1810
+ config.active_record.enumerate_columns_in_select_statements = true
1811
+ end
1812
+ end
1304
1813
 
1305
- connects_to shards: {
1306
- default: { writing: :primary },
1307
- shard_one: { writing: :primary_shard_one }
1308
- }
1814
+ # or, configure per-model
1815
+ class Book < ApplicationRecord
1816
+ self.enumerate_columns_in_select_statements = true
1817
+ end
1309
1818
  ```
1310
1819
 
1311
- Swap between shards in your controller / model code:
1312
-
1313
1820
  ```ruby
1314
- ActiveRecord::Base.connected_to(shard: :shard_one) do
1315
- # Read from shard one
1316
- end
1821
+ Book.limit(5)
1822
+ # SELECT id, author_id, name, format, status, language, etc FROM books LIMIT 5
1317
1823
  ```
1318
1824
 
1319
- The horizontal sharding API also supports read replicas. See guides for more details.
1825
+ *Matt Duszynski*
1320
1826
 
1321
- *Eileen M. Uchitelle*, *John Crepezzi*
1827
+ * Allow passing SQL as `on_duplicate` value to `#upsert_all` to make it possible to use raw SQL to update columns on conflict:
1322
1828
 
1323
- * Deprecate `spec_name` in favor of `name` on database configurations.
1829
+ ```ruby
1830
+ Book.upsert_all(
1831
+ [{ id: 1, status: 1 }, { id: 2, status: 1 }],
1832
+ on_duplicate: Arel.sql("status = GREATEST(books.status, EXCLUDED.status)")
1833
+ )
1834
+ ```
1324
1835
 
1325
- The accessors for `spec_name` on `configs_for` and `DatabaseConfig` are deprecated. Please use `name` instead.
1836
+ *Vladimir Dementyev*
1326
1837
 
1327
- Deprecated behavior:
1838
+ * Allow passing SQL as `returning` statement to `#upsert_all`:
1328
1839
 
1329
1840
  ```ruby
1330
- db_config = ActiveRecord::Base.configurations.configs_for(env_name: "development", spec_name: "primary")
1331
- db_config.spec_name
1841
+ Article.insert_all(
1842
+ [
1843
+ { title: "Article 1", slug: "article-1", published: false },
1844
+ { title: "Article 2", slug: "article-2", published: false }
1845
+ ],
1846
+ returning: Arel.sql("id, (xmax = '0') as inserted, name as new_name")
1847
+ )
1332
1848
  ```
1333
1849
 
1334
- New behavior:
1850
+ *Vladimir Dementyev*
1335
1851
 
1336
- ```ruby
1337
- db_config = ActiveRecord::Base.configurations.configs_for(env_name: "development", name: "primary")
1338
- db_config.name
1339
- ```
1852
+ * Deprecate `legacy_connection_handling`.
1340
1853
 
1341
1854
  *Eileen M. Uchitelle*
1342
1855
 
1343
- * Add additional database-specific rake tasks for multi-database users.
1856
+ * Add attribute encryption support.
1344
1857
 
1345
- Previously, `rails db:create`, `rails db:drop`, and `rails db:migrate` were the only rails tasks that could operate on a single
1346
- database. For example:
1858
+ Encrypted attributes are declared at the model level. These
1859
+ are regular Active Record attributes backed by a column with
1860
+ the same name. The system will transparently encrypt these
1861
+ attributes before saving them into the database and will
1862
+ decrypt them when retrieving their values.
1347
1863
 
1348
- ```
1349
- rails db:create
1350
- rails db:create:primary
1351
- rails db:create:animals
1352
- rails db:drop
1353
- rails db:drop:primary
1354
- rails db:drop:animals
1355
- rails db:migrate
1356
- rails db:migrate:primary
1357
- rails db:migrate:animals
1864
+
1865
+ ```ruby
1866
+ class Person < ApplicationRecord
1867
+ encrypts :name
1868
+ encrypts :email_address, deterministic: true
1869
+ end
1358
1870
  ```
1359
1871
 
1360
- With these changes, `rails db:schema:dump`, `rails db:schema:load`, `rails db:structure:dump`, `rails db:structure:load` and
1361
- `rails db:test:prepare` can additionally operate on a single database. For example:
1872
+ You can learn more in the [Active Record Encryption
1873
+ guide](https://edgeguides.rubyonrails.org/active_record_encryption.html).
1362
1874
 
1363
- ```
1364
- rails db:schema:dump
1365
- rails db:schema:dump:primary
1366
- rails db:schema:dump:animals
1367
- rails db:schema:load
1368
- rails db:schema:load:primary
1369
- rails db:schema:load:animals
1370
- rails db:structure:dump
1371
- rails db:structure:dump:primary
1372
- rails db:structure:dump:animals
1373
- rails db:structure:load
1374
- rails db:structure:load:primary
1375
- rails db:structure:load:animals
1376
- rails db:test:prepare
1377
- rails db:test:prepare:primary
1378
- rails db:test:prepare:animals
1379
- ```
1875
+ *Jorge Manrubia*
1380
1876
 
1381
- *Kyle Thompson*
1877
+ * Changed Arel predications `contains` and `overlaps` to use
1878
+ `quoted_node` so that PostgreSQL arrays are quoted properly.
1382
1879
 
1383
- * Add support for `strict_loading` mode on association declarations.
1880
+ *Bradley Priest*
1384
1881
 
1385
- Raise an error if attempting to load a record from an association that has been marked as `strict_loading` unless it was explicitly eager loaded.
1882
+ * Add mode argument to record level `strict_loading!`.
1386
1883
 
1387
- Usage:
1884
+ This argument can be used when enabling strict loading for a single record
1885
+ to specify that we only want to raise on n plus one queries.
1388
1886
 
1389
1887
  ```ruby
1390
- class Developer < ApplicationRecord
1391
- has_many :projects, strict_loading: true
1392
- end
1888
+ developer.strict_loading!(mode: :n_plus_one_only)
1393
1889
 
1394
- dev = Developer.first
1395
- dev.projects.first
1396
- # => ActiveRecord::StrictLoadingViolationError: The projects association is marked as strict_loading and cannot be lazily loaded.
1890
+ developer.projects.to_a # Does not raise
1891
+ developer.projects.first.client # Raises StrictLoadingViolationError
1397
1892
  ```
1398
1893
 
1399
- *Kevin Deisz*
1894
+ Previously, enabling strict loading would cause any lazily loaded
1895
+ association to raise an error. Using `n_plus_one_only` mode allows us to
1896
+ lazily load belongs_to, has_many, and other associations that are fetched
1897
+ through a single query.
1400
1898
 
1401
- * Add support for `strict_loading` mode to prevent lazy loading of records.
1899
+ *Dinah Shi*
1402
1900
 
1403
- Raise an error if a parent record is marked as `strict_loading` and attempts to lazily load its associations. This is useful for finding places you may want to preload an association and avoid additional queries.
1901
+ * Fix Float::INFINITY assignment to datetime column with postgresql adapter.
1404
1902
 
1405
- Usage:
1903
+ Before:
1406
1904
 
1407
1905
  ```ruby
1408
- dev = Developer.strict_loading.first
1409
- dev.audit_logs.to_a
1410
- # => ActiveRecord::StrictLoadingViolationError: Developer is marked as strict_loading and AuditLog cannot be lazily loaded.
1411
- ```
1906
+ # With this config
1907
+ ActiveRecord::Base.time_zone_aware_attributes = true
1412
1908
 
1413
- *Eileen M. Uchitelle*, *Aaron Patterson*
1909
+ # and the following schema:
1910
+ create_table "postgresql_infinities" do |t|
1911
+ t.datetime "datetime"
1912
+ end
1414
1913
 
1415
- * Add support for PostgreSQL 11+ partitioned indexes when using `upsert_all`.
1914
+ # This test fails
1915
+ record = PostgresqlInfinity.create!(datetime: Float::INFINITY)
1916
+ assert_equal Float::INFINITY, record.datetime # record.datetime gets nil
1917
+ ```
1416
1918
 
1417
- *Sebastián Palma*
1919
+ After this commit, `record.datetime` gets `Float::INFINITY` as expected.
1418
1920
 
1419
- * Adds support for `if_not_exists` to `add_column` and `if_exists` to `remove_column`.
1921
+ *Shunichi Ikegami*
1420
1922
 
1421
- Applications can set their migrations to ignore exceptions raised when adding a column that already exists or when removing a column that does not exist.
1923
+ * Type cast enum values by the original attribute type.
1422
1924
 
1423
- Example Usage:
1925
+ The notable thing about this change is that unknown labels will no longer match 0 on MySQL.
1424
1926
 
1425
1927
  ```ruby
1426
- class AddColumnTitle < ActiveRecord::Migration[6.1]
1427
- def change
1428
- add_column :posts, :title, :string, if_not_exists: true
1429
- end
1928
+ class Book < ActiveRecord::Base
1929
+ enum :status, { proposed: 0, written: 1, published: 2 }
1430
1930
  end
1431
1931
  ```
1432
1932
 
1933
+ Before:
1934
+
1433
1935
  ```ruby
1434
- class RemoveColumnTitle < ActiveRecord::Migration[6.1]
1435
- def change
1436
- remove_column :posts, :title, if_exists: true
1437
- end
1438
- end
1936
+ # SELECT `books`.* FROM `books` WHERE `books`.`status` = 'prohibited' LIMIT 1
1937
+ Book.find_by(status: :prohibited)
1938
+ # => #<Book id: 1, status: "proposed", ...> (for mysql2 adapter)
1939
+ # => ActiveRecord::StatementInvalid: PG::InvalidTextRepresentation: ERROR: invalid input syntax for type integer: "prohibited" (for postgresql adapter)
1940
+ # => nil (for sqlite3 adapter)
1439
1941
  ```
1440
1942
 
1441
- *Eileen M. Uchitelle*
1442
-
1443
- * Regexp-escape table name for MS SQL Server.
1444
-
1445
- Add `Regexp.escape` to one method in ActiveRecord, so that table names with regular expression characters in them work as expected. Since MS SQL Server uses "[" and "]" to quote table and column names, and those characters are regular expression characters, methods like `pluck` and `select` fail in certain cases when used with the MS SQL Server adapter.
1446
-
1447
- *Larry Reid*
1448
-
1449
- * Store advisory locks on their own named connection.
1943
+ After:
1450
1944
 
1451
- Previously advisory locks were taken out against a connection when a migration started. This works fine in single database applications but doesn't work well when migrations need to open new connections which results in the lock getting dropped.
1945
+ ```ruby
1946
+ # SELECT `books`.* FROM `books` WHERE `books`.`status` IS NULL LIMIT 1
1947
+ Book.find_by(status: :prohibited)
1948
+ # => nil (for all adapters)
1949
+ ```
1452
1950
 
1453
- In order to fix this we are storing the advisory lock on a new connection with the connection specification name `AdvisoryLockBase`. The caveat is that we need to maintain at least 2 connections to a database while migrations are running in order to do this.
1951
+ *Ryuta Kamizono*
1454
1952
 
1455
- *Eileen M. Uchitelle*, *John Crepezzi*
1953
+ * Fixtures for `has_many :through` associations now load timestamps on join tables.
1456
1954
 
1457
- * Allow schema cache path to be defined in the database configuration file.
1955
+ Given this fixture:
1458
1956
 
1459
- For example:
1957
+ ```yml
1958
+ ### monkeys.yml
1959
+ george:
1960
+ name: George the Monkey
1961
+ fruits: apple
1460
1962
 
1461
- ```yaml
1462
- development:
1463
- adapter: postgresql
1464
- database: blog_development
1465
- pool: 5
1466
- schema_cache_path: tmp/schema/main.yml
1963
+ ### fruits.yml
1964
+ apple:
1965
+ name: apple
1467
1966
  ```
1468
1967
 
1469
- *Katrina Owen*
1470
-
1471
- * Deprecate `#remove_connection` in favor of `#remove_connection_pool` when called on the handler.
1968
+ If the join table (`fruit_monkeys`) contains `created_at` or `updated_at` columns,
1969
+ these will now be populated when loading the fixture. Previously, fixture loading
1970
+ would crash if these columns were required, and leave them as null otherwise.
1472
1971
 
1473
- `#remove_connection` is deprecated in order to support returning a `DatabaseConfig` object instead of a `Hash`. Use `#remove_connection_pool`, `#remove_connection` will be removed in Rails 7.0.
1474
-
1475
- *Eileen M. Uchitelle*, *John Crepezzi*
1476
-
1477
- * Deprecate `#default_hash` and it's alias `#[]` on database configurations.
1972
+ *Alex Ghiculescu*
1478
1973
 
1479
- Applications should use `configs_for`. `#default_hash` and `#[]` will be removed in Rails 7.0.
1974
+ * Allow applications to configure the thread pool for async queries.
1480
1975
 
1481
- *Eileen M. Uchitelle*, *John Crepezzi*
1976
+ Some applications may want one thread pool per database whereas others want to use
1977
+ a single global thread pool for all queries. By default, Rails will set `async_query_executor`
1978
+ to `nil` which will not initialize any executor. If `load_async` is called and no executor
1979
+ has been configured, the query will be executed in the foreground.
1482
1980
 
1483
- * Add scale support to `ActiveRecord::Validations::NumericalityValidator`.
1981
+ To create one thread pool for all database connections to use applications can set
1982
+ `config.active_record.async_query_executor` to `:global_thread_pool` and optionally define
1983
+ `config.active_record.global_executor_concurrency`. This defaults to 4. For applications that want
1984
+ to have a thread pool for each database connection, `config.active_record.async_query_executor` can
1985
+ be set to `:multi_thread_pool`. The configuration for each thread pool is set in the database
1986
+ configuration.
1484
1987
 
1485
- *Gannon McGibbon*
1988
+ *Eileen M. Uchitelle*
1486
1989
 
1487
- * Find orphans by looking for missing relations through chaining `where.missing`:
1990
+ * Allow new syntax for `enum` to avoid leading `_` from reserved options.
1488
1991
 
1489
1992
  Before:
1490
1993
 
1491
1994
  ```ruby
1492
- Post.left_joins(:author).where(authors: { id: nil })
1995
+ class Book < ActiveRecord::Base
1996
+ enum status: [ :proposed, :written ], _prefix: true, _scopes: false
1997
+ enum cover: [ :hard, :soft ], _suffix: true, _default: :hard
1998
+ end
1493
1999
  ```
1494
2000
 
1495
2001
  After:
1496
2002
 
1497
2003
  ```ruby
1498
- Post.where.missing(:author)
2004
+ class Book < ActiveRecord::Base
2005
+ enum :status, [ :proposed, :written ], prefix: true, scopes: false
2006
+ enum :cover, [ :hard, :soft ], suffix: true, default: :hard
2007
+ end
1499
2008
  ```
1500
2009
 
1501
- *Tom Rossi*
1502
-
1503
- * Ensure `:reading` connections always raise if a write is attempted.
1504
-
1505
- Now Rails will raise an `ActiveRecord::ReadOnlyError` if any connection on the reading handler attempts to make a write. If your reading role needs to write you should name the role something other than `:reading`.
1506
-
1507
- *Eileen M. Uchitelle*
1508
-
1509
- * Deprecate `"primary"` as the `connection_specification_name` for `ActiveRecord::Base`.
1510
-
1511
- `"primary"` has been deprecated as the `connection_specification_name` for `ActiveRecord::Base` in favor of using `"ActiveRecord::Base"`. This change affects calls to `ActiveRecord::Base.connection_handler.retrieve_connection` and `ActiveRecord::Base.connection_handler.remove_connection`. If you're calling these methods with `"primary"`, please switch to `"ActiveRecord::Base"`.
2010
+ *Ryuta Kamizono*
1512
2011
 
1513
- *Eileen M. Uchitelle*, *John Crepezzi*
2012
+ * Add `ActiveRecord::Relation#load_async`.
1514
2013
 
1515
- * Add `ActiveRecord::Validations::NumericalityValidator` with
1516
- support for casting floats using a database columns' precision value.
2014
+ This method schedules the query to be performed asynchronously from a thread pool.
1517
2015
 
1518
- *Gannon McGibbon*
2016
+ If the result is accessed before a background thread had the opportunity to perform
2017
+ the query, it will be performed in the foreground.
1519
2018
 
1520
- * Enforce fresh ETag header after a collection's contents change by adding
1521
- ActiveRecord::Relation#cache_key_with_version. This method will be used by
1522
- ActionController::ConditionalGet to ensure that when collection cache versioning
1523
- is enabled, requests using ConditionalGet don't return the same ETag header
1524
- after a collection is modified.
2019
+ This is useful for queries that can be performed long enough before their result will be
2020
+ needed, or for controllers which need to perform several independent queries.
1525
2021
 
1526
- Fixes #38078.
2022
+ ```ruby
2023
+ def index
2024
+ @categories = Category.some_complex_scope.load_async
2025
+ @posts = Post.some_complex_scope.load_async
2026
+ end
2027
+ ```
1527
2028
 
1528
- *Aaron Lipman*
2029
+ Active Record logs will also include timing info for the duration of how long
2030
+ the main thread had to wait to access the result. This timing is useful to know
2031
+ whether or not it's worth to load the query asynchronously.
1529
2032
 
1530
- * Skip test database when running `db:create` or `db:drop` in development
1531
- with `DATABASE_URL` set.
2033
+ ```
2034
+ DEBUG -- : Category Load (62.1ms) SELECT * FROM `categories` LIMIT 50
2035
+ DEBUG -- : ASYNC Post Load (64ms) (db time 126.1ms) SELECT * FROM `posts` LIMIT 100
2036
+ ```
1532
2037
 
1533
- *Brian Buchalter*
2038
+ The duration in the first set of parens is how long the main thread was blocked
2039
+ waiting for the results, and the second set of parens with "db time" is how long
2040
+ the entire query took to execute.
1534
2041
 
1535
- * Don't allow mutations on the database configurations hash.
2042
+ *Jean Boussier*
1536
2043
 
1537
- Freeze the configurations hash to disallow directly changing it. If applications need to change the hash, for example to create databases for parallelization, they should use the `DatabaseConfig` object directly.
2044
+ * Implemented `ActiveRecord::Relation#excluding` method.
1538
2045
 
1539
- Before:
2046
+ This method excludes the specified record (or collection of records) from
2047
+ the resulting relation:
1540
2048
 
1541
2049
  ```ruby
1542
- @db_config = ActiveRecord::Base.configurations.configs_for(env_name: "test", spec_name: "primary")
1543
- @db_config.configuration_hash.merge!(idle_timeout: "0.02")
2050
+ Post.excluding(post)
2051
+ Post.excluding(post_one, post_two)
1544
2052
  ```
1545
2053
 
1546
- After:
2054
+ Also works on associations:
1547
2055
 
1548
2056
  ```ruby
1549
- @db_config = ActiveRecord::Base.configurations.configs_for(env_name: "test", spec_name: "primary")
1550
- config = @db_config.configuration_hash.merge(idle_timeout: "0.02")
1551
- db_config = ActiveRecord::DatabaseConfigurations::HashConfig.new(@db_config.env_name, @db_config.spec_name, config)
2057
+ post.comments.excluding(comment)
2058
+ post.comments.excluding(comment_one, comment_two)
1552
2059
  ```
1553
2060
 
1554
- *Eileen M. Uchitelle*, *John Crepezzi*
1555
-
1556
- * Remove `:connection_id` from the `sql.active_record` notification.
2061
+ This is short-hand for `Post.where.not(id: post.id)` (for a single record)
2062
+ and `Post.where.not(id: [post_one.id, post_two.id])` (for a collection).
1557
2063
 
1558
- *Aaron Patterson*, *Rafael Mendonça França*
2064
+ *Glen Crawford*
1559
2065
 
1560
- * The `:name` key will no longer be returned as part of `DatabaseConfig#configuration_hash`. Please use `DatabaseConfig#owner_name` instead.
2066
+ * Skip optimised #exist? query when #include? is called on a relation
2067
+ with a having clause.
1561
2068
 
1562
- *Eileen M. Uchitelle*, *John Crepezzi*
2069
+ Relations that have aliased select values AND a having clause that
2070
+ references an aliased select value would generate an error when
2071
+ #include? was called, due to an optimisation that would generate
2072
+ call #exists? on the relation instead, which effectively alters
2073
+ the select values of the query (and thus removes the aliased select
2074
+ values), but leaves the having clause intact. Because the having
2075
+ clause is then referencing an aliased column that is no longer
2076
+ present in the simplified query, an ActiveRecord::InvalidStatement
2077
+ error was raised.
1563
2078
 
1564
- * ActiveRecord's `belongs_to_required_by_default` flag can now be set per model.
2079
+ A sample query affected by this problem:
1565
2080
 
1566
- You can now opt-out/opt-in specific models from having their associations required
1567
- by default.
2081
+ ```ruby
2082
+ Author.select('COUNT(*) as total_posts', 'authors.*')
2083
+ .joins(:posts)
2084
+ .group(:id)
2085
+ .having('total_posts > 2')
2086
+ .include?(Author.first)
2087
+ ```
1568
2088
 
1569
- This change is meant to ease the process of migrating all your models to have
1570
- their association required.
2089
+ This change adds an addition check to the condition that skips the
2090
+ simplified #exists? query, which simply checks for the presence of
2091
+ a having clause.
1571
2092
 
1572
- *Edouard Chin*
2093
+ Fixes #41417.
1573
2094
 
1574
- * The `connection_config` method has been deprecated, please use `connection_db_config` instead which will return a `DatabaseConfigurations::DatabaseConfig` instead of a `Hash`.
2095
+ *Michael Smart*
1575
2096
 
1576
- *Eileen M. Uchitelle*, *John Crepezzi*
2097
+ * Increment postgres prepared statement counter before making a prepared statement, so if the statement is aborted
2098
+ without Rails knowledge (e.g., if app gets killed during long-running query or due to Rack::Timeout), app won't end
2099
+ up in perpetual crash state for being inconsistent with PostgreSQL.
1577
2100
 
1578
- * Retain explicit selections on the base model after applying `includes` and `joins`.
2101
+ *wbharding*, *Martin Tepper*
1579
2102
 
1580
- Resolves #34889.
2103
+ * Add ability to apply `scoping` to `all_queries`.
1581
2104
 
1582
- *Patrick Rebsch*
2105
+ Some applications may want to use the `scoping` method but previously it only
2106
+ worked on certain types of queries. This change allows the `scoping` method to apply
2107
+ to all queries for a model in a block.
1583
2108
 
1584
- * The `database` kwarg is deprecated without replacement because it can't be used for sharding and creates an issue if it's used during a request. Applications that need to create new connections should use `connects_to` instead.
2109
+ ```ruby
2110
+ Post.where(blog_id: post.blog_id).scoping(all_queries: true) do
2111
+ post.update(title: "a post title") # adds `posts.blog_id = 1` to the query
2112
+ end
2113
+ ```
1585
2114
 
1586
- *Eileen M. Uchitelle*, *John Crepezzi*
2115
+ *Eileen M. Uchitelle*
1587
2116
 
1588
- * Allow attributes to be fetched from Arel node groupings.
2117
+ * `ActiveRecord::Calculations.calculate` called with `:average`
2118
+ (aliased as `ActiveRecord::Calculations.average`) will now use column-based
2119
+ type casting. This means that floating-point number columns will now be
2120
+ aggregated as `Float` and decimal columns will be aggregated as `BigDecimal`.
1589
2121
 
1590
- *Jeff Emminger*, *Gannon McGibbon*
2122
+ Integers are handled as a special case returning `BigDecimal` always
2123
+ (this was the case before already).
1591
2124
 
1592
- * A database URL can now contain a querystring value that contains an equal sign. This is needed to support passing PostgreSQL `options`.
2125
+ ```ruby
2126
+ # With the following schema:
2127
+ create_table "measurements" do |t|
2128
+ t.float "temperature"
2129
+ end
1593
2130
 
1594
- *Joshua Flanagan*
2131
+ # Before:
2132
+ Measurement.average(:temperature).class
2133
+ # => BigDecimal
1595
2134
 
1596
- * Calling methods like `establish_connection` with a `Hash` which is invalid (eg: no `adapter`) will now raise an error the same way as connections defined in `config/database.yml`.
2135
+ # After:
2136
+ Measurement.average(:temperature).class
2137
+ # => Float
2138
+ ```
1597
2139
 
1598
- *John Crepezzi*
2140
+ Before this change, Rails just called `to_d` on average aggregates from the
2141
+ database adapter. This is not the case anymore. If you relied on that kind
2142
+ of magic, you now need to register your own `ActiveRecord::Type`
2143
+ (see `ActiveRecord::Attributes::ClassMethods` for documentation).
1599
2144
 
1600
- * Specifying `implicit_order_column` now subsorts the records by primary key if available to ensure deterministic results.
2145
+ *Josua Schmid*
1601
2146
 
1602
- *Paweł Urbanek*
2147
+ * PostgreSQL: introduce `ActiveRecord::ConnectionAdapters::PostgreSQLAdapter.datetime_type`.
1603
2148
 
1604
- * `where(attr => [])` now loads an empty result without making a query.
2149
+ This setting controls what native type Active Record should use when you call `datetime` in
2150
+ a migration or schema. It takes a symbol which must correspond to one of the configured
2151
+ `NATIVE_DATABASE_TYPES`. The default is `:timestamp`, meaning `t.datetime` in a migration
2152
+ will create a "timestamp without time zone" column. To use "timestamp with time zone",
2153
+ change this to `:timestamptz` in an initializer.
1605
2154
 
1606
- *John Hawthorn*
2155
+ You should run `bin/rails db:migrate` to rebuild your schema.rb if you change this.
1607
2156
 
1608
- * Fixed the performance regression for `primary_keys` introduced MySQL 8.0.
2157
+ *Alex Ghiculescu*
1609
2158
 
1610
- *Hiroyuki Ishii*
2159
+ * PostgreSQL: handle `timestamp with time zone` columns correctly in `schema.rb`.
1611
2160
 
1612
- * Add support for `belongs_to` to `has_many` inversing.
2161
+ Previously they dumped as `t.datetime :column_name`, now they dump as `t.timestamptz :column_name`,
2162
+ and are created as `timestamptz` columns when the schema is loaded.
1613
2163
 
1614
- *Gannon McGibbon*
2164
+ *Alex Ghiculescu*
1615
2165
 
1616
- * Allow length configuration for `has_secure_token` method. The minimum length
1617
- is set at 24 characters.
2166
+ * Removing trailing whitespace when matching columns in
2167
+ `ActiveRecord::Sanitization.disallow_raw_sql!`.
1618
2168
 
1619
- Before:
2169
+ *Gannon McGibbon*, *Adrian Hirt*
1620
2170
 
1621
- ```ruby
1622
- has_secure_token :auth_token
1623
- ```
2171
+ * Expose a way for applications to set a `primary_abstract_class`.
1624
2172
 
1625
- After:
2173
+ Multiple database applications that use a primary abstract class that is not
2174
+ named `ApplicationRecord` can now set a specific class to be the `primary_abstract_class`.
1626
2175
 
1627
2176
  ```ruby
1628
- has_secure_token :default_token # 24 characters
1629
- has_secure_token :auth_token, length: 36 # 36 characters
1630
- has_secure_token :invalid_token, length: 12 # => ActiveRecord::SecureToken::MinimumLengthError
2177
+ class PrimaryApplicationRecord
2178
+ self.primary_abstract_class
2179
+ end
1631
2180
  ```
1632
2181
 
1633
- *Bernardo de Araujo*
1634
-
1635
- * Deprecate `DatabaseConfigurations#to_h`. These connection hashes are still available via `ActiveRecord::Base.configurations.configs_for`.
2182
+ When an application boots it automatically connects to the primary or first database in the
2183
+ database configuration file. In a multiple database application that then call `connects_to`
2184
+ needs to know that the default connection is the same as the `ApplicationRecord` connection.
2185
+ However, some applications have a differently named `ApplicationRecord`. This prevents Active
2186
+ Record from opening duplicate connections to the same database.
1636
2187
 
1637
- *Eileen Uchitelle*, *John Crepezzi*
2188
+ *Eileen M. Uchitelle*, *John Crepezzi*
1638
2189
 
1639
- * Add `DatabaseConfig#configuration_hash` to return database configuration hashes with symbol keys, and use all symbol-key configuration hashes internally. Deprecate `DatabaseConfig#config` which returns a String-keyed `Hash` with the same values.
2190
+ * Support hash config for `structure_dump_flags` and `structure_load_flags` flags.
2191
+ Now that Active Record supports multiple databases configuration,
2192
+ we need a way to pass specific flags for dump/load databases since
2193
+ the options are not the same for different adapters.
2194
+ We can use in the original way:
1640
2195
 
1641
- *John Crepezzi*, *Eileen Uchitelle*
2196
+ ```ruby
2197
+ ActiveRecord::Tasks::DatabaseTasks.structure_dump_flags = ['--no-defaults', '--skip-add-drop-table']
2198
+ # or
2199
+ ActiveRecord::Tasks::DatabaseTasks.structure_dump_flags = '--no-defaults --skip-add-drop-table'
2200
+ ```
1642
2201
 
1643
- * Allow column names to be passed to `remove_index` positionally along with other options.
2202
+ And also use it passing a hash, with one or more keys, where the key
2203
+ is the adapter
1644
2204
 
1645
- Passing other options can be necessary to make `remove_index` correctly reversible.
2205
+ ```ruby
2206
+ ActiveRecord::Tasks::DatabaseTasks.structure_dump_flags = {
2207
+ mysql2: ['--no-defaults', '--skip-add-drop-table'],
2208
+ postgres: '--no-tablespaces'
2209
+ }
2210
+ ```
1646
2211
 
1647
- Before:
2212
+ *Gustavo Gonzalez*
1648
2213
 
1649
- add_index :reports, :report_id # => works
1650
- add_index :reports, :report_id, unique: true # => works
1651
- remove_index :reports, :report_id # => works
1652
- remove_index :reports, :report_id, unique: true # => ArgumentError
2214
+ * Connection specification now passes the "url" key as a configuration for the
2215
+ adapter if the "url" protocol is "jdbc", "http", or "https". Previously only
2216
+ urls with the "jdbc" prefix were passed to the Active Record Adapter, others
2217
+ are assumed to be adapter specification urls.
1653
2218
 
1654
- After:
2219
+ Fixes #41137.
1655
2220
 
1656
- remove_index :reports, :report_id, unique: true # => works
2221
+ *Jonathan Bracy*
1657
2222
 
1658
- *Eugene Kenny*
2223
+ * Allow to opt-out of `strict_loading` mode on a per-record base.
1659
2224
 
1660
- * Allow bulk `ALTER` statements to drop and recreate indexes with the same name.
2225
+ This is useful when strict loading is enabled application wide or on a
2226
+ model level.
1661
2227
 
1662
- *Eugene Kenny*
2228
+ ```ruby
2229
+ class User < ApplicationRecord
2230
+ has_many :bookmarks
2231
+ has_many :articles, strict_loading: true
2232
+ end
1663
2233
 
1664
- * `insert`, `insert_all`, `upsert`, and `upsert_all` now clear the query cache.
2234
+ user = User.first
2235
+ user.articles # => ActiveRecord::StrictLoadingViolationError
2236
+ user.bookmarks # => #<ActiveRecord::Associations::CollectionProxy>
1665
2237
 
1666
- *Eugene Kenny*
2238
+ user.strict_loading!(true) # => true
2239
+ user.bookmarks # => ActiveRecord::StrictLoadingViolationError
1667
2240
 
1668
- * Call `while_preventing_writes` directly from `connected_to`.
2241
+ user.strict_loading!(false) # => false
2242
+ user.bookmarks # => #<ActiveRecord::Associations::CollectionProxy>
2243
+ user.articles.strict_loading!(false) # => #<ActiveRecord::Associations::CollectionProxy>
2244
+ ```
1669
2245
 
1670
- In some cases application authors want to use the database switching middleware and make explicit calls with `connected_to`. It's possible for an app to turn off writes and not turn them back on by the time we call `connected_to(role: :writing)`.
2246
+ *Ayrton De Craene*
1671
2247
 
1672
- This change allows apps to fix this by assuming if a role is writing we want to allow writes, except in the case it's explicitly turned off.
2248
+ * Add `FinderMethods#sole` and `#find_sole_by` to find and assert the
2249
+ presence of exactly one record.
1673
2250
 
1674
- *Eileen M. Uchitelle*
2251
+ Used when you need a single row, but also want to assert that there aren't
2252
+ multiple rows matching the condition; especially for when database
2253
+ constraints aren't enough or are impractical.
1675
2254
 
1676
- * Improve detection of ActiveRecord::StatementTimeout with mysql2 adapter in the edge case when the query is terminated during filesort.
2255
+ ```ruby
2256
+ Product.where(["price = %?", price]).sole
2257
+ # => ActiveRecord::RecordNotFound (if no Product with given price)
2258
+ # => #<Product ...> (if one Product with given price)
2259
+ # => ActiveRecord::SoleRecordExceeded (if more than one Product with given price)
1677
2260
 
1678
- *Kir Shatrov*
2261
+ user.api_keys.find_sole_by(key: key)
2262
+ # as above
2263
+ ```
1679
2264
 
1680
- * Stop trying to read yaml file fixtures when loading Active Record fixtures.
2265
+ *Asherah Connor*
1681
2266
 
1682
- *Gannon McGibbon*
2267
+ * Makes `ActiveRecord::AttributeMethods::Query` respect the getter overrides defined in the model.
1683
2268
 
1684
- * Deprecate `.reorder(nil)` with `.first` / `.first!` taking non-deterministic result.
2269
+ Before:
1685
2270
 
1686
- To continue taking non-deterministic result, use `.take` / `.take!` instead.
2271
+ ```ruby
2272
+ class User
2273
+ def admin
2274
+ false # Overriding the getter to always return false
2275
+ end
2276
+ end
1687
2277
 
1688
- *Ryuta Kamizono*
2278
+ user = User.first
2279
+ user.update(admin: true)
1689
2280
 
1690
- * Preserve user supplied joins order as much as possible.
2281
+ user.admin # false (as expected, due to the getter overwrite)
2282
+ user.admin? # true (not expected, returned the DB column value)
2283
+ ```
1691
2284
 
1692
- Fixes #36761, #34328, #24281, #12953.
2285
+ After this commit, `user.admin?` above returns false, as expected.
1693
2286
 
1694
- *Ryuta Kamizono*
2287
+ Fixes #40771.
1695
2288
 
1696
- * Allow `matches_regex` and `does_not_match_regexp` on the MySQL Arel visitor.
2289
+ *Felipe*
1697
2290
 
1698
- *James Pearson*
2291
+ * Allow delegated_type to be specified primary_key and foreign_key.
1699
2292
 
1700
- * Allow specifying fixtures to be ignored by setting `ignore` in YAML file's '_fixture' section.
2293
+ Since delegated_type assumes that the foreign_key ends with `_id`,
2294
+ `singular_id` defined by it does not work when the foreign_key does
2295
+ not end with `id`. This change fixes it by taking into account
2296
+ `primary_key` and `foreign_key` in the options.
1701
2297
 
1702
- *Tongfei Gao*
2298
+ *Ryota Egusa*
1703
2299
 
1704
- * Make the DATABASE_URL env variable only affect the primary connection. Add new env variables for multiple databases.
2300
+ * Expose an `invert_where` method that will invert all scope conditions.
1705
2301
 
1706
- *John Crepezzi*, *Eileen Uchitelle*
2302
+ ```ruby
2303
+ class User
2304
+ scope :active, -> { where(accepted: true, locked: false) }
2305
+ end
1707
2306
 
1708
- * Add a warning for enum elements with 'not_' prefix.
2307
+ User.active
2308
+ # ... WHERE `accepted` = 1 AND `locked` = 0
1709
2309
 
1710
- class Foo
1711
- enum status: [:sent, :not_sent]
1712
- end
2310
+ User.active.invert_where
2311
+ # ... WHERE NOT (`accepted` = 1 AND `locked` = 0)
2312
+ ```
1713
2313
 
1714
- *Edu Depetris*
2314
+ *Kevin Deisz*
1715
2315
 
1716
- * Make currency symbols optional for money column type in PostgreSQL.
2316
+ * Restore possibility of passing `false` to :polymorphic option of `belongs_to`.
1717
2317
 
1718
- *Joel Schneider*
2318
+ Previously, passing `false` would trigger the option validation logic
2319
+ to throw an error saying :polymorphic would not be a valid option.
1719
2320
 
1720
- * Add support for beginless ranges, introduced in Ruby 2.7.
2321
+ *glaszig*
1721
2322
 
1722
- *Josh Goodall*
2323
+ * Remove deprecated `database` kwarg from `connected_to`.
1723
2324
 
1724
- * Add `database_exists?` method to connection adapters to check if a database exists.
2325
+ *Eileen M. Uchitelle*, *John Crepezzi*
1725
2326
 
1726
- *Guilherme Mansur*
2327
+ * Allow adding nonnamed expression indexes to be revertible.
1727
2328
 
1728
- * Loading the schema for a model that has no `table_name` raises a `TableNotSpecified` error.
2329
+ Previously, the following code would raise an error, when executed while rolling back,
2330
+ and the index name should be specified explicitly. Now, the index name is inferred
2331
+ automatically.
1729
2332
 
1730
- *Guilherme Mansur*, *Eugene Kenny*
2333
+ ```ruby
2334
+ add_index(:items, "to_tsvector('english', description)")
2335
+ ```
1731
2336
 
1732
- * PostgreSQL: Fix GROUP BY with ORDER BY virtual count attribute.
2337
+ Fixes #40732.
1733
2338
 
1734
- Fixes #36022.
2339
+ *fatkodima*
1735
2340
 
1736
- *Ryuta Kamizono*
2341
+ * Only warn about negative enums if a positive form that would cause conflicts exists.
1737
2342
 
1738
- * Make ActiveRecord `ConnectionPool.connections` method thread-safe.
2343
+ Fixes #39065.
1739
2344
 
1740
- Fixes #36465.
2345
+ *Alex Ghiculescu*
1741
2346
 
1742
- *Jeff Doering*
2347
+ * Add option to run `default_scope` on all queries.
1743
2348
 
1744
- * Add support for multiple databases to `rails db:abort_if_pending_migrations`.
2349
+ Previously, a `default_scope` would only run on select or insert queries. In some cases, like non-Rails tenant sharding solutions, it may be desirable to run `default_scope` on all queries in order to ensure queries are including a foreign key for the shard (i.e. `blog_id`).
1745
2350
 
1746
- *Mark Lee*
2351
+ Now applications can add an option to run on all queries including select, insert, delete, and update by adding an `all_queries` option to the default scope definition.
1747
2352
 
1748
- * Fix sqlite3 collation parsing when using decimal columns.
2353
+ ```ruby
2354
+ class Article < ApplicationRecord
2355
+ default_scope -> { where(blog_id: Current.blog.id) }, all_queries: true
2356
+ end
2357
+ ```
1749
2358
 
1750
- *Martin R. Schuster*
2359
+ *Eileen M. Uchitelle*
1751
2360
 
1752
- * Fix invalid schema when primary key column has a comment.
2361
+ * Add `where.associated` to check for the presence of an association.
1753
2362
 
1754
- Fixes #29966.
2363
+ ```ruby
2364
+ # Before:
2365
+ account.users.joins(:contact).where.not(contact_id: nil)
1755
2366
 
1756
- *Guilherme Goettems Schneider*
2367
+ # After:
2368
+ account.users.where.associated(:contact)
2369
+ ```
1757
2370
 
1758
- * Fix table comment also being applied to the primary key column.
2371
+ Also mirrors `where.missing`.
1759
2372
 
1760
- *Guilherme Goettems Schneider*
2373
+ *Kasper Timm Hansen*
1761
2374
 
1762
- * Allow generated `create_table` migrations to include or skip timestamps.
2375
+ * Allow constructors (`build_association` and `create_association`) on
2376
+ `has_one :through` associations.
1763
2377
 
1764
- *Michael Duchemin*
2378
+ *Santiago Perez Perret*
1765
2379
 
1766
2380
 
1767
- Please check [6-0-stable](https://github.com/rails/rails/blob/6-0-stable/activerecord/CHANGELOG.md) for previous changes.
2381
+ Please check [6-1-stable](https://github.com/rails/rails/blob/6-1-stable/activerecord/CHANGELOG.md) for previous changes.