activerecord 6.0.4.4 → 6.1.0.rc1
Sign up to get free protection for your applications and to get access to all the features.
Potentially problematic release.
This version of activerecord might be problematic. Click here for more details.
- checksums.yaml +4 -4
- data/CHANGELOG.md +764 -863
- data/MIT-LICENSE +1 -1
- data/README.rdoc +3 -3
- data/lib/active_record/aggregations.rb +1 -1
- data/lib/active_record/association_relation.rb +22 -14
- data/lib/active_record/associations/alias_tracker.rb +19 -15
- data/lib/active_record/associations/association.rb +39 -27
- data/lib/active_record/associations/association_scope.rb +11 -15
- data/lib/active_record/associations/belongs_to_association.rb +15 -5
- data/lib/active_record/associations/belongs_to_polymorphic_association.rb +1 -1
- data/lib/active_record/associations/builder/association.rb +9 -3
- data/lib/active_record/associations/builder/belongs_to.rb +10 -7
- data/lib/active_record/associations/builder/collection_association.rb +5 -4
- data/lib/active_record/associations/builder/has_and_belongs_to_many.rb +0 -1
- data/lib/active_record/associations/builder/has_many.rb +6 -2
- data/lib/active_record/associations/builder/has_one.rb +11 -14
- data/lib/active_record/associations/builder/singular_association.rb +1 -1
- data/lib/active_record/associations/collection_association.rb +19 -13
- data/lib/active_record/associations/collection_proxy.rb +12 -5
- data/lib/active_record/associations/foreign_association.rb +13 -0
- data/lib/active_record/associations/has_many_association.rb +24 -2
- data/lib/active_record/associations/has_many_through_association.rb +10 -4
- data/lib/active_record/associations/has_one_association.rb +15 -1
- data/lib/active_record/associations/join_dependency/join_association.rb +29 -14
- data/lib/active_record/associations/join_dependency/join_part.rb +1 -1
- data/lib/active_record/associations/join_dependency.rb +63 -49
- data/lib/active_record/associations/preloader/association.rb +13 -5
- data/lib/active_record/associations/preloader/through_association.rb +1 -1
- data/lib/active_record/associations/preloader.rb +5 -3
- data/lib/active_record/associations/singular_association.rb +1 -1
- data/lib/active_record/associations.rb +114 -11
- data/lib/active_record/attribute_assignment.rb +10 -8
- data/lib/active_record/attribute_methods/before_type_cast.rb +13 -9
- data/lib/active_record/attribute_methods/dirty.rb +1 -11
- data/lib/active_record/attribute_methods/primary_key.rb +6 -2
- data/lib/active_record/attribute_methods/query.rb +3 -6
- data/lib/active_record/attribute_methods/read.rb +8 -11
- data/lib/active_record/attribute_methods/serialization.rb +4 -4
- data/lib/active_record/attribute_methods/time_zone_conversion.rb +12 -13
- data/lib/active_record/attribute_methods/write.rb +12 -20
- data/lib/active_record/attribute_methods.rb +52 -48
- data/lib/active_record/attributes.rb +27 -7
- data/lib/active_record/autosave_association.rb +47 -30
- data/lib/active_record/base.rb +2 -14
- data/lib/active_record/callbacks.rb +32 -22
- data/lib/active_record/coders/yaml_column.rb +1 -1
- data/lib/active_record/connection_adapters/abstract/connection_pool.rb +180 -134
- data/lib/active_record/connection_adapters/abstract/database_limits.rb +2 -44
- data/lib/active_record/connection_adapters/abstract/database_statements.rb +65 -22
- data/lib/active_record/connection_adapters/abstract/query_cache.rb +2 -7
- data/lib/active_record/connection_adapters/abstract/quoting.rb +34 -34
- data/lib/active_record/connection_adapters/abstract/savepoints.rb +3 -3
- data/lib/active_record/connection_adapters/abstract/schema_creation.rb +153 -116
- data/lib/active_record/connection_adapters/abstract/schema_definitions.rb +110 -30
- data/lib/active_record/connection_adapters/abstract/schema_dumper.rb +3 -3
- data/lib/active_record/connection_adapters/abstract/schema_statements.rb +224 -85
- data/lib/active_record/connection_adapters/abstract/transaction.rb +66 -24
- data/lib/active_record/connection_adapters/abstract_adapter.rb +31 -70
- data/lib/active_record/connection_adapters/abstract_mysql_adapter.rb +123 -87
- data/lib/active_record/connection_adapters/column.rb +15 -1
- data/lib/active_record/connection_adapters/deduplicable.rb +29 -0
- data/lib/active_record/connection_adapters/legacy_pool_manager.rb +31 -0
- data/lib/active_record/connection_adapters/mysql/database_statements.rb +22 -24
- data/lib/active_record/connection_adapters/mysql/explain_pretty_printer.rb +1 -1
- data/lib/active_record/connection_adapters/mysql/quoting.rb +1 -1
- data/lib/active_record/connection_adapters/mysql/schema_creation.rb +33 -6
- data/lib/active_record/connection_adapters/mysql/schema_definitions.rb +8 -0
- data/lib/active_record/connection_adapters/mysql/schema_dumper.rb +1 -1
- data/lib/active_record/connection_adapters/mysql/schema_statements.rb +3 -3
- data/lib/active_record/connection_adapters/mysql/type_metadata.rb +10 -1
- data/lib/active_record/connection_adapters/mysql2_adapter.rb +31 -12
- data/lib/active_record/connection_adapters/pool_config.rb +63 -0
- data/lib/active_record/connection_adapters/pool_manager.rb +43 -0
- data/lib/active_record/connection_adapters/postgresql/column.rb +24 -1
- data/lib/active_record/connection_adapters/postgresql/database_statements.rb +12 -53
- data/lib/active_record/connection_adapters/postgresql/oid/cidr.rb +3 -5
- data/lib/active_record/connection_adapters/postgresql/oid/date.rb +2 -2
- data/lib/active_record/connection_adapters/postgresql/oid/date_time.rb +2 -10
- data/lib/active_record/connection_adapters/postgresql/oid/interval.rb +49 -0
- data/lib/active_record/connection_adapters/postgresql/oid/legacy_point.rb +2 -2
- data/lib/active_record/connection_adapters/postgresql/oid/macaddr.rb +25 -0
- data/lib/active_record/connection_adapters/postgresql/oid/money.rb +2 -2
- data/lib/active_record/connection_adapters/postgresql/oid/point.rb +2 -2
- data/lib/active_record/connection_adapters/postgresql/oid/uuid.rb +11 -1
- data/lib/active_record/connection_adapters/postgresql/oid.rb +2 -0
- data/lib/active_record/connection_adapters/postgresql/quoting.rb +4 -4
- data/lib/active_record/connection_adapters/postgresql/referential_integrity.rb +1 -1
- data/lib/active_record/connection_adapters/postgresql/schema_creation.rb +5 -1
- data/lib/active_record/connection_adapters/postgresql/schema_statements.rb +61 -29
- data/lib/active_record/connection_adapters/postgresql/type_metadata.rb +8 -0
- data/lib/active_record/connection_adapters/postgresql_adapter.rb +72 -55
- data/lib/active_record/connection_adapters/schema_cache.rb +98 -15
- data/lib/active_record/connection_adapters/sql_type_metadata.rb +10 -0
- data/lib/active_record/connection_adapters/sqlite3/database_statements.rb +30 -5
- data/lib/active_record/connection_adapters/sqlite3/quoting.rb +1 -1
- data/lib/active_record/connection_adapters/sqlite3/schema_creation.rb +5 -1
- data/lib/active_record/connection_adapters/sqlite3/schema_statements.rb +36 -3
- data/lib/active_record/connection_adapters/sqlite3_adapter.rb +48 -50
- data/lib/active_record/connection_adapters.rb +50 -0
- data/lib/active_record/connection_handling.rb +210 -71
- data/lib/active_record/core.rb +215 -49
- data/lib/active_record/database_configurations/connection_url_resolver.rb +98 -0
- data/lib/active_record/database_configurations/database_config.rb +52 -9
- data/lib/active_record/database_configurations/hash_config.rb +54 -8
- data/lib/active_record/database_configurations/url_config.rb +15 -40
- data/lib/active_record/database_configurations.rb +124 -85
- data/lib/active_record/delegated_type.rb +209 -0
- data/lib/active_record/destroy_association_async_job.rb +36 -0
- data/lib/active_record/enum.rb +33 -23
- data/lib/active_record/errors.rb +47 -12
- data/lib/active_record/explain.rb +9 -4
- data/lib/active_record/explain_subscriber.rb +1 -1
- data/lib/active_record/fixture_set/file.rb +10 -17
- data/lib/active_record/fixture_set/model_metadata.rb +1 -2
- data/lib/active_record/fixture_set/render_context.rb +1 -1
- data/lib/active_record/fixture_set/table_row.rb +2 -2
- data/lib/active_record/fixtures.rb +54 -8
- data/lib/active_record/gem_version.rb +3 -3
- data/lib/active_record/inheritance.rb +40 -18
- data/lib/active_record/insert_all.rb +32 -5
- data/lib/active_record/integration.rb +3 -5
- data/lib/active_record/internal_metadata.rb +15 -4
- data/lib/active_record/legacy_yaml_adapter.rb +7 -3
- data/lib/active_record/locking/optimistic.rb +13 -16
- data/lib/active_record/locking/pessimistic.rb +6 -2
- data/lib/active_record/log_subscriber.rb +26 -8
- data/lib/active_record/middleware/database_selector/resolver/session.rb +3 -0
- data/lib/active_record/middleware/database_selector/resolver.rb +5 -0
- data/lib/active_record/middleware/database_selector.rb +4 -1
- data/lib/active_record/migration/command_recorder.rb +47 -27
- data/lib/active_record/migration/compatibility.rb +67 -17
- data/lib/active_record/migration.rb +113 -83
- data/lib/active_record/model_schema.rb +88 -42
- data/lib/active_record/nested_attributes.rb +2 -3
- data/lib/active_record/no_touching.rb +1 -1
- data/lib/active_record/persistence.rb +50 -45
- data/lib/active_record/query_cache.rb +15 -5
- data/lib/active_record/querying.rb +11 -6
- data/lib/active_record/railtie.rb +64 -44
- data/lib/active_record/railties/databases.rake +253 -98
- data/lib/active_record/readonly_attributes.rb +4 -0
- data/lib/active_record/reflection.rb +59 -44
- data/lib/active_record/relation/batches/batch_enumerator.rb +25 -9
- data/lib/active_record/relation/batches.rb +38 -31
- data/lib/active_record/relation/calculations.rb +100 -43
- data/lib/active_record/relation/finder_methods.rb +44 -14
- data/lib/active_record/relation/from_clause.rb +1 -1
- data/lib/active_record/relation/merger.rb +20 -23
- data/lib/active_record/relation/predicate_builder/array_handler.rb +8 -9
- data/lib/active_record/relation/predicate_builder/association_query_value.rb +2 -2
- data/lib/active_record/relation/predicate_builder/polymorphic_array_value.rb +3 -3
- data/lib/active_record/relation/predicate_builder/relation_handler.rb +1 -1
- data/lib/active_record/relation/predicate_builder.rb +57 -33
- data/lib/active_record/relation/query_methods.rb +319 -196
- data/lib/active_record/relation/record_fetch_warning.rb +3 -3
- data/lib/active_record/relation/spawn_methods.rb +6 -5
- data/lib/active_record/relation/where_clause.rb +104 -57
- data/lib/active_record/relation.rb +90 -64
- data/lib/active_record/result.rb +41 -33
- data/lib/active_record/runtime_registry.rb +2 -2
- data/lib/active_record/sanitization.rb +6 -17
- data/lib/active_record/schema_dumper.rb +34 -4
- data/lib/active_record/schema_migration.rb +0 -4
- data/lib/active_record/scoping/named.rb +1 -17
- data/lib/active_record/secure_token.rb +16 -8
- data/lib/active_record/serialization.rb +5 -3
- data/lib/active_record/signed_id.rb +116 -0
- data/lib/active_record/statement_cache.rb +20 -4
- data/lib/active_record/store.rb +2 -2
- data/lib/active_record/suppressor.rb +2 -2
- data/lib/active_record/table_metadata.rb +36 -52
- data/lib/active_record/tasks/database_tasks.rb +139 -113
- data/lib/active_record/tasks/mysql_database_tasks.rb +34 -35
- data/lib/active_record/tasks/postgresql_database_tasks.rb +24 -26
- data/lib/active_record/tasks/sqlite_database_tasks.rb +13 -9
- data/lib/active_record/test_databases.rb +5 -4
- data/lib/active_record/test_fixtures.rb +36 -33
- data/lib/active_record/timestamp.rb +4 -6
- data/lib/active_record/touch_later.rb +21 -21
- data/lib/active_record/transactions.rb +15 -64
- data/lib/active_record/type/serialized.rb +6 -2
- data/lib/active_record/type.rb +8 -1
- data/lib/active_record/type_caster/connection.rb +0 -1
- data/lib/active_record/type_caster/map.rb +8 -5
- data/lib/active_record/validations/associated.rb +1 -1
- data/lib/active_record/validations/numericality.rb +35 -0
- data/lib/active_record/validations/uniqueness.rb +24 -4
- data/lib/active_record/validations.rb +1 -0
- data/lib/active_record.rb +7 -14
- data/lib/arel/attributes/attribute.rb +4 -0
- data/lib/arel/collectors/bind.rb +5 -0
- data/lib/arel/collectors/composite.rb +8 -0
- data/lib/arel/collectors/sql_string.rb +7 -0
- data/lib/arel/collectors/substitute_binds.rb +7 -0
- data/lib/arel/nodes/binary.rb +82 -8
- data/lib/arel/nodes/bind_param.rb +8 -0
- data/lib/arel/nodes/casted.rb +21 -9
- data/lib/arel/nodes/equality.rb +6 -9
- data/lib/arel/nodes/grouping.rb +3 -0
- data/lib/arel/nodes/homogeneous_in.rb +72 -0
- data/lib/arel/nodes/in.rb +8 -1
- data/lib/arel/nodes/infix_operation.rb +13 -1
- data/lib/arel/nodes/join_source.rb +1 -1
- data/lib/arel/nodes/node.rb +7 -6
- data/lib/arel/nodes/ordering.rb +27 -0
- data/lib/arel/nodes/sql_literal.rb +3 -0
- data/lib/arel/nodes/table_alias.rb +7 -3
- data/lib/arel/nodes/unary.rb +0 -1
- data/lib/arel/nodes.rb +3 -1
- data/lib/arel/predications.rb +12 -18
- data/lib/arel/select_manager.rb +1 -2
- data/lib/arel/table.rb +13 -5
- data/lib/arel/visitors/dot.rb +14 -2
- data/lib/arel/visitors/mysql.rb +11 -1
- data/lib/arel/visitors/postgresql.rb +15 -4
- data/lib/arel/visitors/to_sql.rb +89 -78
- data/lib/arel/visitors.rb +0 -7
- data/lib/arel.rb +5 -13
- data/lib/rails/generators/active_record/migration/migration_generator.rb +1 -0
- data/lib/rails/generators/active_record/migration/templates/create_table_migration.rb.tt +2 -0
- data/lib/rails/generators/active_record/migration/templates/migration.rb.tt +3 -3
- data/lib/rails/generators/active_record/migration.rb +6 -1
- data/lib/rails/generators/active_record/model/model_generator.rb +39 -2
- data/lib/rails/generators/active_record/model/templates/abstract_base_class.rb.tt +7 -0
- metadata +27 -28
- data/lib/active_record/advisory_lock_base.rb +0 -18
- data/lib/active_record/attribute_decorators.rb +0 -88
- data/lib/active_record/connection_adapters/connection_specification.rb +0 -296
- data/lib/active_record/connection_adapters/determine_if_preparable_visitor.rb +0 -29
- data/lib/active_record/define_callbacks.rb +0 -22
- data/lib/active_record/railties/collection_cache_association_loading.rb +0 -34
- data/lib/active_record/relation/predicate_builder/base_handler.rb +0 -18
- data/lib/active_record/relation/where_clause_factory.rb +0 -33
- data/lib/arel/attributes.rb +0 -22
- data/lib/arel/visitors/depth_first.rb +0 -203
- data/lib/arel/visitors/ibm_db.rb +0 -34
- data/lib/arel/visitors/informix.rb +0 -62
- data/lib/arel/visitors/mssql.rb +0 -156
- data/lib/arel/visitors/oracle.rb +0 -158
- data/lib/arel/visitors/oracle12.rb +0 -65
- data/lib/arel/visitors/where_sql.rb +0 -22
data/CHANGELOG.md
CHANGED
@@ -1,30 +1,36 @@
|
|
1
|
-
## Rails 6.0.
|
1
|
+
## Rails 6.1.0.rc1 (November 02, 2020) ##
|
2
2
|
|
3
|
-
*
|
3
|
+
* Add `connected_to_many` API.
|
4
4
|
|
5
|
+
This API allows applications to connect to multiple databases at once without switching all of them or implementing a deeply nested stack.
|
5
6
|
|
6
|
-
|
7
|
-
|
8
|
-
* No changes.
|
9
|
-
|
10
|
-
|
11
|
-
## Rails 6.0.4.2 (December 14, 2021) ##
|
12
|
-
|
13
|
-
* No changes.
|
7
|
+
Before:
|
14
8
|
|
9
|
+
AnimalsRecord.connected_to(role: :reading) do
|
10
|
+
MealsRecord.connected_to(role: :reading) do
|
11
|
+
Dog.first # read from animals replica
|
12
|
+
Dinner.first # read from meals replica
|
13
|
+
Person.first # read from primary writer
|
14
|
+
end
|
15
|
+
end
|
15
16
|
|
16
|
-
|
17
|
+
After:
|
17
18
|
|
18
|
-
|
19
|
+
ActiveRecord::Base.connected_to_many([AnimalsRecord, MealsRecord], role: :reading) do
|
20
|
+
Dog.first # read from animals replica
|
21
|
+
Dinner.first # read from meals replica
|
22
|
+
Person.first # read from primary writer
|
23
|
+
end
|
19
24
|
|
25
|
+
*Eileen M. Uchitelle*, *John Crepezzi*
|
20
26
|
|
21
|
-
|
27
|
+
* Add option to raise or log for `ActiveRecord::StrictLoadingViolationError`.
|
22
28
|
|
23
|
-
|
29
|
+
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.
|
24
30
|
|
25
|
-
|
31
|
+
Set `config.active_record.action_on_strict_loading_violation` to `:log` errors instead of raising.
|
26
32
|
|
27
|
-
*
|
33
|
+
*Eileen M. Uchitelle*
|
28
34
|
|
29
35
|
* Allow the inverse of a `has_one` association that was previously autosaved to be loaded.
|
30
36
|
|
@@ -32,1339 +38,1234 @@
|
|
32
38
|
|
33
39
|
*Steven Weber*
|
34
40
|
|
35
|
-
*
|
36
|
-
|
37
|
-
Fixes #36453.
|
38
|
-
|
39
|
-
*Ryuta Kamizono*
|
40
|
-
|
41
|
-
* Type cast extra select for eager loading.
|
42
|
-
|
43
|
-
*Ryuta Kamizono*
|
44
|
-
|
45
|
-
* Prevent collection associations from being autosaved multiple times.
|
46
|
-
|
47
|
-
Fixes #39173.
|
41
|
+
* Optimise the length of index names for polymorphic references by using the reference name rather than the type and id column names.
|
48
42
|
|
49
|
-
|
50
|
-
|
51
|
-
* Resolve issue with insert_all unique_by option when used with expression index.
|
43
|
+
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.
|
52
44
|
|
53
|
-
|
54
|
-
`ActiveRecord::Persistence.upsert_all` was used with the name of an expression index, an error
|
55
|
-
was raised. Adding a guard around the formatting behavior for the `:unique_by` corrects this.
|
45
|
+
This change reduces the chance of that happening by using the reference name, e.g. `index_my_table_on_my_reference`.
|
56
46
|
|
57
|
-
|
47
|
+
Fixes #38655.
|
58
48
|
|
59
|
-
|
60
|
-
create_table :books, id: :integer, force: true do |t|
|
61
|
-
t.column :name, :string
|
62
|
-
t.index "lower(name)", unique: true
|
63
|
-
end
|
64
|
-
|
65
|
-
Book.insert_all [{ name: "MyTest" }], unique_by: :index_books_on_lower_name
|
66
|
-
```
|
67
|
-
|
68
|
-
Fixes #39516.
|
69
|
-
|
70
|
-
*Austen Madden*
|
49
|
+
*Luke Redpath*
|
71
50
|
|
72
|
-
*
|
51
|
+
* MySQL: Uniqueness validator now respects default database collation,
|
52
|
+
no longer enforce case sensitive comparison by default.
|
73
53
|
|
74
54
|
*Ryuta Kamizono*
|
75
55
|
|
76
|
-
*
|
56
|
+
* Remove deprecated methods from `ActiveRecord::ConnectionAdapters::DatabaseLimits`.
|
77
57
|
|
78
|
-
|
58
|
+
`column_name_length`
|
59
|
+
`table_name_length`
|
60
|
+
`columns_per_table`
|
61
|
+
`indexes_per_table`
|
62
|
+
`columns_per_multicolumn_index`
|
63
|
+
`sql_query_length`
|
64
|
+
`joins_per_query`
|
79
65
|
|
80
|
-
*
|
81
|
-
|
82
|
-
Bump an Active Record instance's lock version after updating its counter
|
83
|
-
cache. This avoids raising an unnecessary `ActiveRecord::StaleObjectError`
|
84
|
-
upon subsequent transactions by maintaining parity with the corresponding
|
85
|
-
database record's `lock_version` column.
|
66
|
+
*Rafael Mendonça França*
|
86
67
|
|
87
|
-
|
68
|
+
* Remove deprecated `ActiveRecord::ConnectionAdapters::AbstractAdapter#supports_multi_insert?`.
|
88
69
|
|
89
|
-
*
|
70
|
+
*Rafael Mendonça França*
|
90
71
|
|
91
|
-
*
|
72
|
+
* Remove deprecated `ActiveRecord::ConnectionAdapters::AbstractAdapter#supports_foreign_keys_in_create?`.
|
92
73
|
|
93
|
-
*
|
74
|
+
*Rafael Mendonça França*
|
94
75
|
|
95
|
-
*
|
76
|
+
* Remove deprecated `ActiveRecord::ConnectionAdapters::PostgreSQLAdapter#supports_ranges?`.
|
96
77
|
|
97
|
-
*
|
78
|
+
*Rafael Mendonça França*
|
98
79
|
|
99
|
-
*
|
80
|
+
* Remove deprecated `ActiveRecord::Base#update_attributes` and `ActiveRecord::Base#update_attributes!`.
|
100
81
|
|
101
|
-
*
|
82
|
+
*Rafael Mendonça França*
|
102
83
|
|
103
|
-
*
|
84
|
+
* Remove deprecated `migrations_path` argument in `ActiveRecord::ConnectionAdapter::SchemaStatements#assume_migrated_upto_version`.
|
104
85
|
|
105
|
-
*
|
86
|
+
*Rafael Mendonça França*
|
106
87
|
|
107
|
-
*
|
88
|
+
* Remove deprecated `config.active_record.sqlite3.represent_boolean_as_integer`.
|
108
89
|
|
109
|
-
*
|
90
|
+
*Rafael Mendonça França*
|
110
91
|
|
111
|
-
*
|
92
|
+
* `relation.create` does no longer leak scope to class level querying methods
|
93
|
+
in initialization block and callbacks.
|
112
94
|
|
113
|
-
|
95
|
+
Before:
|
114
96
|
|
115
|
-
|
116
|
-
|
97
|
+
User.where(name: "John").create do |john|
|
98
|
+
User.find_by(name: "David") # => nil
|
99
|
+
end
|
117
100
|
|
118
|
-
|
101
|
+
After:
|
119
102
|
|
120
|
-
|
103
|
+
User.where(name: "John").create do |john|
|
104
|
+
User.find_by(name: "David") # => #<User name: "David", ...>
|
105
|
+
end
|
121
106
|
|
122
107
|
*Ryuta Kamizono*
|
123
108
|
|
124
|
-
*
|
125
|
-
|
126
|
-
*Bogdan Gusiev*
|
127
|
-
|
128
|
-
|
129
|
-
## Rails 6.0.3.7 (May 05, 2021) ##
|
130
|
-
|
131
|
-
* No changes.
|
132
|
-
|
133
|
-
|
134
|
-
## Rails 6.0.3.6 (March 26, 2021) ##
|
135
|
-
|
136
|
-
* No changes.
|
137
|
-
|
138
|
-
|
139
|
-
## Rails 6.0.3.5 (February 10, 2021) ##
|
140
|
-
|
141
|
-
* Fix possible DoS vector in PostgreSQL money type
|
142
|
-
|
143
|
-
Carefully crafted input can cause a DoS via the regular expressions used
|
144
|
-
for validating the money format in the PostgreSQL adapter. This patch
|
145
|
-
fixes the regexp.
|
109
|
+
* Named scope chain does no longer leak scope to class level querying methods.
|
146
110
|
|
147
|
-
|
148
|
-
|
149
|
-
|
150
|
-
|
151
|
-
*Aaron Patterson*
|
111
|
+
class class User < ActiveRecord::Base
|
112
|
+
scope :david, -> { User.where(name: "David") }
|
113
|
+
end
|
152
114
|
|
115
|
+
Before:
|
153
116
|
|
154
|
-
|
117
|
+
User.where(name: "John").david
|
118
|
+
# SELECT * FROM users WHERE name = 'John' AND name = 'David'
|
155
119
|
|
156
|
-
|
120
|
+
After:
|
157
121
|
|
122
|
+
User.where(name: "John").david
|
123
|
+
# SELECT * FROM users WHERE name = 'David'
|
158
124
|
|
159
|
-
|
125
|
+
*Ryuta Kamizono*
|
160
126
|
|
161
|
-
*
|
127
|
+
* Remove deprecated methods from `ActiveRecord::DatabaseConfigurations`.
|
162
128
|
|
129
|
+
`fetch`
|
130
|
+
`each`
|
131
|
+
`first`
|
132
|
+
`values`
|
133
|
+
`[]=`
|
163
134
|
|
164
|
-
|
135
|
+
*Rafael Mendonça França*
|
165
136
|
|
166
|
-
*
|
137
|
+
* `where.not` now generates NAND predicates instead of NOR.
|
167
138
|
|
139
|
+
Before:
|
168
140
|
|
169
|
-
|
141
|
+
User.where.not(name: "Jon", role: "admin")
|
142
|
+
# SELECT * FROM users WHERE name != 'Jon' AND role != 'admin'
|
170
143
|
|
171
|
-
|
144
|
+
After:
|
172
145
|
|
146
|
+
User.where.not(name: "Jon", role: "admin")
|
147
|
+
# SELECT * FROM users WHERE NOT (name == 'Jon' AND role == 'admin')
|
173
148
|
|
174
|
-
|
149
|
+
*Rafael Mendonça França*
|
175
150
|
|
176
|
-
*
|
151
|
+
* Remove deprecated `ActiveRecord::Result#to_hash` method.
|
177
152
|
|
178
|
-
|
153
|
+
*Rafael Mendonça França*
|
179
154
|
|
180
|
-
|
155
|
+
* Deprecate `ActiveRecord::Base.allow_unsafe_raw_sql`.
|
181
156
|
|
182
|
-
*
|
157
|
+
*Rafael Mendonça França*
|
183
158
|
|
184
|
-
|
159
|
+
* Remove deprecated support for using unsafe raw SQL in `ActiveRecord::Relation` methods.
|
185
160
|
|
186
|
-
*
|
161
|
+
*Rafael Mendonça França*
|
187
162
|
|
188
|
-
|
163
|
+
* Allow users to silence the "Rails couldn't infer whether you are using multiple databases..."
|
164
|
+
message using `config.active_record.suppress_multiple_database_warning`.
|
189
165
|
|
190
|
-
*
|
166
|
+
*Omri Gabay*
|
191
167
|
|
192
|
-
|
168
|
+
* Connections can be granularly switched for abstract classes when `connected_to` is called.
|
193
169
|
|
194
|
-
|
170
|
+
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.
|
195
171
|
|
196
|
-
|
172
|
+
Example usage:
|
197
173
|
|
198
|
-
|
174
|
+
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`.
|
199
175
|
|
200
|
-
|
176
|
+
```ruby
|
177
|
+
ActiveRecord::Base.connected_to(role: :reading) do
|
178
|
+
User.first # reads from default replica
|
179
|
+
Dog.first # reads from default replica
|
201
180
|
|
202
|
-
|
181
|
+
AnimalsRecord.connected_to(role: :writing, shard: :one) do
|
182
|
+
User.first # reads from default replica
|
183
|
+
Dog.first # reads from shard one primary
|
184
|
+
end
|
203
185
|
|
204
|
-
|
186
|
+
User.first # reads from default replica
|
187
|
+
Dog.first # reads from default replica
|
205
188
|
|
206
|
-
|
189
|
+
ApplicationRecord.connected_to(role: :writing, shard: :two) do
|
190
|
+
User.first # reads from shard two primary
|
191
|
+
Dog.first # reads from default replica
|
192
|
+
end
|
193
|
+
end
|
194
|
+
```
|
207
195
|
|
208
196
|
*Eileen M. Uchitelle*, *John Crepezzi*
|
209
197
|
|
210
|
-
*
|
198
|
+
* Allow double-dash comment syntax when querying read-only databases
|
211
199
|
|
212
|
-
|
213
|
-
|
214
|
-
*Eileen M. Uchitelle*
|
215
|
-
|
216
|
-
* Enforce fresh ETag header after a collection's contents change by adding
|
217
|
-
ActiveRecord::Relation#cache_key_with_version. This method will be used by
|
218
|
-
ActionController::ConditionalGet to ensure that when collection cache versioning
|
219
|
-
is enabled, requests using ConditionalGet don't return the same ETag header
|
220
|
-
after a collection is modified. Fixes #38078.
|
221
|
-
|
222
|
-
*Aaron Lipman*
|
200
|
+
*James Adam*
|
223
201
|
|
224
|
-
*
|
202
|
+
* Add `values_at` method.
|
225
203
|
|
226
|
-
|
204
|
+
Returns an array containing the values associated with the given methods.
|
227
205
|
|
228
|
-
|
229
|
-
|
230
|
-
|
231
|
-
|
232
|
-
|
233
|
-
|
234
|
-
|
235
|
-
## Rails 6.0.2.2 (March 19, 2020) ##
|
236
|
-
|
237
|
-
* No changes.
|
238
|
-
|
239
|
-
|
240
|
-
## Rails 6.0.2.1 (December 18, 2019) ##
|
241
|
-
|
242
|
-
* No changes.
|
243
|
-
|
244
|
-
|
245
|
-
## Rails 6.0.2 (December 13, 2019) ##
|
246
|
-
|
247
|
-
* Share the same connection pool for primary and replica databases in the
|
248
|
-
transactional tests for the same database.
|
249
|
-
|
250
|
-
*Edouard Chin*
|
251
|
-
|
252
|
-
* Fix the preloader when one record is fetched using `after_initialize`
|
253
|
-
but not the entire collection.
|
254
|
-
|
255
|
-
*Bradley Price*
|
256
|
-
|
257
|
-
* Fix collection callbacks not terminating when `:abort` is thrown.
|
206
|
+
```ruby
|
207
|
+
topic = Topic.first
|
208
|
+
topic.values_at(:title, :author_name)
|
209
|
+
# => ["Budget", "Jason"]
|
210
|
+
```
|
258
211
|
|
259
|
-
|
212
|
+
Similar to `Hash#values_at` but on an Active Record instance.
|
260
213
|
|
261
|
-
*
|
214
|
+
*Guillaume Briday*
|
262
215
|
|
263
|
-
|
264
|
-
doing a relation query like `where.not(relation: { ... })`
|
265
|
-
wouldn't be properly deprecated and `where.not` would work as
|
266
|
-
NAND instead.
|
216
|
+
* Fix `read_attribute_before_type_cast` to consider attribute aliases.
|
267
217
|
|
268
|
-
*
|
218
|
+
*Marcelo Lauxen*
|
269
219
|
|
270
|
-
*
|
271
|
-
to the previous database.
|
220
|
+
* Support passing record to uniqueness validator `:conditions` callable:
|
272
221
|
|
273
|
-
|
274
|
-
|
275
|
-
|
276
|
-
|
277
|
-
|
278
|
-
|
279
|
-
|
280
|
-
|
222
|
+
```ruby
|
223
|
+
class Article < ApplicationRecord
|
224
|
+
validates_uniqueness_of :title, conditions: ->(article) {
|
225
|
+
published_at = article.published_at
|
226
|
+
where(published_at: published_at.beginning_of_year..published_at.end_of_year)
|
227
|
+
}
|
228
|
+
end
|
229
|
+
```
|
281
230
|
|
282
|
-
*
|
231
|
+
*Eliot Sykes*
|
283
232
|
|
233
|
+
* `BatchEnumerator#update_all` and `BatchEnumerator#delete_all` now return the
|
234
|
+
total number of rows affected, just like their non-batched counterparts.
|
284
235
|
|
285
|
-
|
236
|
+
```ruby
|
237
|
+
Person.in_batches.update_all("first_name = 'Eugene'") # => 42
|
238
|
+
Person.in_batches.delete_all # => 42
|
239
|
+
```
|
286
240
|
|
287
|
-
|
241
|
+
Fixes #40287.
|
288
242
|
|
289
|
-
|
243
|
+
*Eugene Kenny*
|
290
244
|
|
291
|
-
*
|
245
|
+
* Add support for PostgreSQL `interval` data type with conversion to
|
246
|
+
`ActiveSupport::Duration` when loading records from database and
|
247
|
+
serialization to ISO 8601 formatted duration string on save.
|
248
|
+
Add support to define a column in migrations and get it in a schema dump.
|
249
|
+
Optional column precision is supported.
|
292
250
|
|
293
|
-
|
251
|
+
To use this in 6.1, you need to place the next string to your model file:
|
294
252
|
|
295
|
-
|
253
|
+
attribute :duration, :interval
|
296
254
|
|
297
|
-
|
255
|
+
To keep old behavior until 6.2 is released:
|
298
256
|
|
299
|
-
|
300
|
-
context is used.
|
257
|
+
attribute :duration, :string
|
301
258
|
|
302
|
-
|
259
|
+
Example:
|
303
260
|
|
304
|
-
|
305
|
-
|
261
|
+
create_table :events do |t|
|
262
|
+
t.string :name
|
263
|
+
t.interval :duration
|
264
|
+
end
|
306
265
|
|
307
|
-
|
266
|
+
class Event < ApplicationRecord
|
267
|
+
attribute :duration, :interval
|
268
|
+
end
|
308
269
|
|
309
|
-
|
310
|
-
|
270
|
+
Event.create!(name: 'Rock Fest', duration: 2.days)
|
271
|
+
Event.last.duration # => 2 days
|
272
|
+
Event.last.duration.iso8601 # => "P2D"
|
273
|
+
Event.new(duration: 'P1DT12H3S').duration # => 1 day, 12 hours, and 3 seconds
|
274
|
+
Event.new(duration: '1 day') # Unknown value will be ignored and NULL will be written to database
|
311
275
|
|
312
|
-
|
276
|
+
*Andrey Novikov*
|
313
277
|
|
314
|
-
*
|
278
|
+
* Allow associations supporting the `dependent:` key to take `dependent: :destroy_async`.
|
315
279
|
|
316
|
-
|
280
|
+
```ruby
|
281
|
+
class Account < ActiveRecord::Base
|
282
|
+
belongs_to :supplier, dependent: :destroy_async
|
283
|
+
end
|
284
|
+
```
|
317
285
|
|
318
|
-
|
286
|
+
`:destroy_async` will enqueue a job to destroy associated records in the background.
|
319
287
|
|
320
|
-
*
|
288
|
+
*DHH*, *George Claghorn*, *Cory Gwin*, *Rafael Mendonça França*, *Adrianna Chang*
|
321
289
|
|
322
|
-
*
|
290
|
+
* Add `SKIP_TEST_DATABASE` environment variable to disable modifying the test database when `rails db:create` and `rails db:drop` are called.
|
323
291
|
|
324
|
-
*
|
292
|
+
*Jason Schweier*
|
325
293
|
|
326
|
-
*
|
327
|
-
fixes that idle connections in forked processes wouldn't be reaped.
|
294
|
+
* `connects_to` can only be called on `ActiveRecord::Base` or abstract classes.
|
328
295
|
|
329
|
-
|
296
|
+
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.
|
330
297
|
|
331
|
-
*
|
332
|
-
when `ActiveRecord::Relation#reset` or `ActiveRecord::Relation#reload`
|
333
|
-
is called.
|
298
|
+
*Eileen M. Uchitelle*, *John Crepezzi*
|
334
299
|
|
335
|
-
|
300
|
+
* All connection adapters `execute` now raises `ActiveRecord::ConnectionNotEstablished` rather than
|
301
|
+
`ActiveRecord::StatementInvalid` when they encounter a connection error.
|
336
302
|
|
337
|
-
*
|
303
|
+
*Jean Boussier*
|
338
304
|
|
339
|
-
|
305
|
+
* `Mysql2Adapter#quote_string` now raises `ActiveRecord::ConnectionNotEstablished` rather than
|
306
|
+
`ActiveRecord::StatementInvalid` when it can't connect to the MySQL server.
|
340
307
|
|
341
|
-
*
|
308
|
+
*Jean Boussier*
|
342
309
|
|
343
|
-
|
310
|
+
* Add support for check constraints that are `NOT VALID` via `validate: false` (PostgreSQL-only).
|
344
311
|
|
345
|
-
*
|
312
|
+
*Alex Robbin*
|
346
313
|
|
347
|
-
|
314
|
+
* Ensure the default configuration is considered primary or first for an environment
|
348
315
|
|
349
|
-
|
316
|
+
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.
|
350
317
|
|
351
318
|
*Eileen M. Uchitelle*
|
352
319
|
|
353
|
-
*
|
354
|
-
|
355
|
-
*Kir Shatrov*
|
320
|
+
* Allow `where` references association names as joined table name aliases.
|
356
321
|
|
322
|
+
```ruby
|
323
|
+
class Comment < ActiveRecord::Base
|
324
|
+
enum label: [:default, :child]
|
325
|
+
has_many :children, class_name: "Comment", foreign_key: :parent_id
|
326
|
+
end
|
357
327
|
|
358
|
-
|
359
|
-
|
360
|
-
|
361
|
-
|
362
|
-
Fixes #36761, #34328, #24281, #12953.
|
328
|
+
# ... FROM comments LEFT OUTER JOIN comments children ON ... WHERE children.label = 1
|
329
|
+
Comment.includes(:children).where("children.label": "child")
|
330
|
+
```
|
363
331
|
|
364
332
|
*Ryuta Kamizono*
|
365
333
|
|
366
|
-
*
|
367
|
-
|
368
|
-
*John Crepezzi*, *Eileen Uchitelle*
|
334
|
+
* Support storing demodulized class name for polymorphic type.
|
369
335
|
|
370
|
-
|
336
|
+
Before Rails 6.1, storing demodulized class name is supported only for STI type
|
337
|
+
by `store_full_sti_class` class attribute.
|
371
338
|
|
372
|
-
|
373
|
-
enum status: [:sent, :not_sent]
|
374
|
-
end
|
339
|
+
Now `store_full_class_name` class attribute can handle both STI and polymorphic types.
|
375
340
|
|
376
|
-
*
|
377
|
-
|
378
|
-
* Make currency symbols optional for money column type in PostgreSQL
|
379
|
-
|
380
|
-
*Joel Schneider*
|
381
|
-
|
382
|
-
|
383
|
-
## Rails 6.0.0.rc2 (July 22, 2019) ##
|
341
|
+
*Ryuta Kamizono*
|
384
342
|
|
385
|
-
*
|
343
|
+
* Deprecate `rails db:structure:{load, dump}` tasks and extend
|
344
|
+
`rails db:schema:{load, dump}` tasks to work with either `:ruby` or `:sql` format,
|
345
|
+
depending on `config.active_record.schema_format` configuration value.
|
386
346
|
|
387
|
-
*
|
347
|
+
*fatkodima*
|
388
348
|
|
389
|
-
*
|
349
|
+
* Respect the `select` values for eager loading.
|
390
350
|
|
391
|
-
|
351
|
+
```ruby
|
352
|
+
post = Post.select("UPPER(title) AS title").first
|
353
|
+
post.title # => "WELCOME TO THE WEBLOG"
|
354
|
+
post.body # => ActiveModel::MissingAttributeError
|
355
|
+
|
356
|
+
# Rails 6.0 (ignore the `select` values)
|
357
|
+
post = Post.select("UPPER(title) AS title").eager_load(:comments).first
|
358
|
+
post.title # => "Welcome to the weblog"
|
359
|
+
post.body # => "Such a lovely day"
|
360
|
+
|
361
|
+
# Rails 6.1 (respect the `select` values)
|
362
|
+
post = Post.select("UPPER(title) AS title").eager_load(:comments).first
|
363
|
+
post.title # => "WELCOME TO THE WEBLOG"
|
364
|
+
post.body # => ActiveModel::MissingAttributeError
|
365
|
+
```
|
392
366
|
|
393
367
|
*Ryuta Kamizono*
|
394
368
|
|
395
|
-
*
|
396
|
-
|
397
|
-
Fixes #36465.
|
398
|
-
|
399
|
-
*Jeff Doering*
|
369
|
+
* Allow attribute's default to be configured but keeping its own type.
|
400
370
|
|
401
|
-
|
371
|
+
```ruby
|
372
|
+
class Post < ActiveRecord::Base
|
373
|
+
attribute :written_at, default: -> { Time.now.utc }
|
374
|
+
end
|
402
375
|
|
403
|
-
|
376
|
+
# Rails 6.0
|
377
|
+
Post.type_for_attribute(:written_at) # => #<Type::Value ... precision: nil, ...>
|
404
378
|
|
405
|
-
|
379
|
+
# Rails 6.1
|
380
|
+
Post.type_for_attribute(:written_at) # => #<Type::DateTime ... precision: 6, ...>
|
381
|
+
```
|
406
382
|
|
407
|
-
|
383
|
+
*Ryuta Kamizono*
|
408
384
|
|
409
|
-
|
385
|
+
* Allow default to be configured for Enum.
|
410
386
|
|
411
|
-
|
387
|
+
```ruby
|
388
|
+
class Book < ActiveRecord::Base
|
389
|
+
enum status: [:proposed, :written, :published], _default: :published
|
390
|
+
end
|
412
391
|
|
413
|
-
|
392
|
+
Book.new.status # => "published"
|
393
|
+
```
|
414
394
|
|
415
|
-
*
|
395
|
+
*Ryuta Kamizono*
|
416
396
|
|
417
|
-
|
397
|
+
* Deprecate YAML loading from legacy format older than Rails 5.0.
|
418
398
|
|
419
399
|
*Ryuta Kamizono*
|
420
400
|
|
401
|
+
* Added the setting `ActiveRecord::Base.immutable_strings_by_default`, which
|
402
|
+
allows you to specify that all string columns should be frozen unless
|
403
|
+
otherwise specified. This will reduce memory pressure for applications which
|
404
|
+
do not generally mutate string properties of Active Record objects.
|
421
405
|
|
422
|
-
|
406
|
+
*Sean Griffin*, *Ryuta Kamizono*
|
423
407
|
|
424
|
-
*
|
408
|
+
* Deprecate `map!` and `collect!` on `ActiveRecord::Result`.
|
425
409
|
|
426
|
-
*
|
410
|
+
*Ryuta Kamizono*
|
427
411
|
|
428
|
-
*
|
412
|
+
* Support `relation.and` for intersection as Set theory.
|
429
413
|
|
430
414
|
```ruby
|
431
|
-
|
432
|
-
|
433
|
-
```
|
415
|
+
david_and_mary = Author.where(id: [david, mary])
|
416
|
+
mary_and_bob = Author.where(id: [mary, bob])
|
434
417
|
|
435
|
-
|
418
|
+
david_and_mary.merge(mary_and_bob) # => [mary, bob]
|
436
419
|
|
437
|
-
|
438
|
-
|
439
|
-
|
440
|
-
nor = all.reject { |e|
|
441
|
-
e.estimate_of_type == sapphire.class.polymorphic_name
|
442
|
-
}.reject { |e|
|
443
|
-
e.estimate_of_id == sapphire.id
|
444
|
-
}
|
445
|
-
assert_equal [cars(:honda)], nor
|
446
|
-
|
447
|
-
without_sapphire = PriceEstimate.where.not(
|
448
|
-
estimate_of_type: sapphire.class.polymorphic_name, estimate_of_id: sapphire.id
|
449
|
-
)
|
450
|
-
assert_equal nor, without_sapphire.map(&:estimate_of)
|
420
|
+
david_and_mary.and(mary_and_bob) # => [mary]
|
421
|
+
david_and_mary.or(mary_and_bob) # => [david, mary, bob]
|
451
422
|
```
|
452
423
|
|
453
|
-
|
454
|
-
|
455
|
-
```ruby
|
456
|
-
sapphire = treasures(:sapphire)
|
424
|
+
*Ryuta Kamizono*
|
457
425
|
|
458
|
-
|
459
|
-
|
426
|
+
* Merging conditions on the same column no longer maintain both conditions,
|
427
|
+
and will be consistently replaced by the latter condition in Rails 6.2.
|
428
|
+
To migrate to Rails 6.2's behavior, use `relation.merge(other, rewhere: true)`.
|
460
429
|
|
461
|
-
|
462
|
-
|
463
|
-
)
|
464
|
-
assert_equal nand, without_sapphire.map(&:estimate_of)
|
465
|
-
```
|
430
|
+
```ruby
|
431
|
+
# Rails 6.1 (IN clause is replaced by merger side equality condition)
|
432
|
+
Author.where(id: [david.id, mary.id]).merge(Author.where(id: bob)) # => [bob]
|
466
433
|
|
467
|
-
|
434
|
+
# Rails 6.1 (both conflict conditions exists, deprecated)
|
435
|
+
Author.where(id: david.id..mary.id).merge(Author.where(id: bob)) # => []
|
468
436
|
|
469
|
-
|
437
|
+
# Rails 6.1 with rewhere to migrate to Rails 6.2's behavior
|
438
|
+
Author.where(id: david.id..mary.id).merge(Author.where(id: bob), rewhere: true) # => [bob]
|
470
439
|
|
471
|
-
|
440
|
+
# Rails 6.2 (same behavior with IN clause, mergee side condition is consistently replaced)
|
441
|
+
Author.where(id: [david.id, mary.id]).merge(Author.where(id: bob)) # => [bob]
|
442
|
+
Author.where(id: david.id..mary.id).merge(Author.where(id: bob)) # => [bob]
|
443
|
+
```
|
472
444
|
|
473
445
|
*Ryuta Kamizono*
|
474
446
|
|
475
|
-
*
|
476
|
-
the versioned entries in `ActiveSupport::Cache`. This also means that
|
477
|
-
`ActiveRecord::Relation#cache_key` will now return a stable key that does not
|
478
|
-
include the max timestamp or count any more.
|
447
|
+
* Do not mark Postgresql MAC address and UUID attributes as changed when the assigned value only varies by case.
|
479
448
|
|
480
|
-
|
481
|
-
cache keys with timestamps until you set `ActiveRecord::Base.collection_cache_versioning = true`.
|
482
|
-
That's the setting for all new apps on Rails 6.0+
|
449
|
+
*Peter Fry*
|
483
450
|
|
484
|
-
|
451
|
+
* Resolve issue with insert_all unique_by option when used with expression index.
|
485
452
|
|
486
|
-
|
453
|
+
When the `:unique_by` option of `ActiveRecord::Persistence.insert_all` and
|
454
|
+
`ActiveRecord::Persistence.upsert_all` was used with the name of an expression index, an error
|
455
|
+
was raised. Adding a guard around the formatting behavior for the `:unique_by` corrects this.
|
487
456
|
|
488
|
-
|
457
|
+
Usage:
|
489
458
|
|
490
|
-
|
459
|
+
```ruby
|
460
|
+
create_table :books, id: :integer, force: true do |t|
|
461
|
+
t.column :name, :string
|
462
|
+
t.index "lower(name)", unique: true
|
463
|
+
end
|
491
464
|
|
492
|
-
|
493
|
-
|
465
|
+
Book.insert_all [{ name: "MyTest" }], unique_by: :index_books_on_lower_name
|
466
|
+
```
|
494
467
|
|
495
|
-
|
468
|
+
Fixes #39516.
|
496
469
|
|
497
|
-
*
|
470
|
+
*Austen Madden*
|
498
471
|
|
499
|
-
|
472
|
+
* Add basic support for CHECK constraints to database migrations.
|
500
473
|
|
501
|
-
|
474
|
+
Usage:
|
502
475
|
|
503
|
-
|
476
|
+
```ruby
|
477
|
+
add_check_constraint :products, "price > 0", name: "price_check"
|
478
|
+
remove_check_constraint :products, name: "price_check"
|
479
|
+
```
|
504
480
|
|
505
|
-
|
506
|
-
associations, the callback for a `has_many` association was run while
|
507
|
-
another instance of the same callback on the same association hadn't
|
508
|
-
finished running. When control returned to the first instance of the
|
509
|
-
callback, the instance variable had changed, and subsequent associated
|
510
|
-
records weren't saved correctly. Specifically, the ID field for the
|
511
|
-
`belongs_to` corresponding to the `has_many` was `nil`.
|
481
|
+
*fatkodima*
|
512
482
|
|
513
|
-
|
483
|
+
* Add `ActiveRecord::Base.strict_loading_by_default` and `ActiveRecord::Base.strict_loading_by_default=`
|
484
|
+
to enable/disable strict_loading mode by default for a model. The configuration's value is
|
485
|
+
inheritable by subclasses, but they can override that value and it will not impact parent class.
|
514
486
|
|
515
|
-
|
487
|
+
Usage:
|
516
488
|
|
517
|
-
|
489
|
+
```ruby
|
490
|
+
class Developer < ApplicationRecord
|
491
|
+
self.strict_loading_by_default = true
|
518
492
|
|
519
|
-
|
493
|
+
has_many :projects
|
494
|
+
end
|
520
495
|
|
521
|
-
|
522
|
-
|
523
|
-
|
524
|
-
add_column :items, :attr3, :integer, limit: 10 # => ActiveRecordError
|
525
|
-
add_column :items, :attr4, :datetime, precision: 10 # => ActiveRecordError
|
496
|
+
dev = Developer.first
|
497
|
+
dev.projects.first
|
498
|
+
# => ActiveRecord::StrictLoadingViolationError Exception: Developer is marked as strict_loading and Project cannot be lazily loaded.
|
526
499
|
```
|
527
500
|
|
528
|
-
|
501
|
+
*bogdanvlviv*
|
529
502
|
|
530
|
-
|
531
|
-
add_column :items, :attr1, :binary, size: 10 # => ArgumentError
|
532
|
-
add_column :items, :attr2, :decimal, scale: 10 # => ArgumentError
|
533
|
-
add_column :items, :attr3, :integer, limit: 10 # => ArgumentError
|
534
|
-
add_column :items, :attr4, :datetime, precision: 10 # => ArgumentError
|
535
|
-
```
|
503
|
+
* Deprecate passing an Active Record object to `quote`/`type_cast` directly.
|
536
504
|
|
537
505
|
*Ryuta Kamizono*
|
538
506
|
|
539
|
-
*
|
540
|
-
whether preloaded / eager loaded or not, with the exception of `unscoped`.
|
507
|
+
* Default engine `ENGINE=InnoDB` is no longer dumped to make schema more agnostic.
|
541
508
|
|
542
509
|
Before:
|
543
510
|
|
544
511
|
```ruby
|
545
|
-
|
546
|
-
Comment.find(1).post # => nil
|
547
|
-
Comment.preload(:post).find(1).post # => #<Post id: 1, ...>
|
548
|
-
Comment.eager_load(:post).find(1).post # => #<Post id: 1, ...>
|
512
|
+
create_table "accounts", options: "ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci", force: :cascade do |t|
|
549
513
|
end
|
550
514
|
```
|
551
515
|
|
552
516
|
After:
|
553
517
|
|
554
518
|
```ruby
|
555
|
-
|
556
|
-
Comment.find(1).post # => #<Post id: 1, ...>
|
557
|
-
Comment.preload(:post).find(1).post # => #<Post id: 1, ...>
|
558
|
-
Comment.eager_load(:post).find(1).post # => #<Post id: 1, ...>
|
519
|
+
create_table "accounts", charset: "utf8mb4", collation: "utf8mb4_0900_ai_ci", force: :cascade do |t|
|
559
520
|
end
|
560
521
|
```
|
561
522
|
|
562
|
-
Fixes #34638, #35398.
|
563
|
-
|
564
523
|
*Ryuta Kamizono*
|
565
524
|
|
566
|
-
*
|
567
|
-
|
568
|
-
Runs `db:migrate` if the database exists or `db:setup` if it doesn't.
|
569
|
-
|
570
|
-
*Roberto Miranda*
|
571
|
-
|
572
|
-
* Add `after_save_commit` callback as shortcut for `after_commit :hook, on: [ :create, :update ]`.
|
525
|
+
* Added delegated type as an alternative to single-table inheritance for representing class hierarchies.
|
526
|
+
See ActiveRecord::DelegatedType for the full description.
|
573
527
|
|
574
528
|
*DHH*
|
575
529
|
|
576
|
-
*
|
577
|
-
`before_add` and `after_add` callbacks for `has_many :through` associations.
|
530
|
+
* Deprecate aggregations with group by duplicated fields.
|
578
531
|
|
579
|
-
|
532
|
+
To migrate to Rails 6.2's behavior, use `uniq!(:group)` to deduplicate group fields.
|
580
533
|
|
581
|
-
|
582
|
-
|
583
|
-
|
584
|
-
|
585
|
-
|
586
|
-
|
587
|
-
# =>
|
588
|
-
|
589
|
-
|
590
|
-
|
591
|
-
|
592
|
-
|
593
|
-
|
594
|
-
|
595
|
-
|
596
|
-
|
597
|
-
Post.where(id: 123).annotate("this is a comment").to_sql
|
598
|
-
# SELECT "posts".* FROM "posts" WHERE "posts"."id" = 123 /* this is a comment */
|
534
|
+
```ruby
|
535
|
+
accounts = Account.group(:firm_id)
|
536
|
+
|
537
|
+
# duplicated group fields, deprecated.
|
538
|
+
accounts.merge(accounts.where.not(credit_limit: nil)).sum(:credit_limit)
|
539
|
+
# => {
|
540
|
+
# [1, 1] => 50,
|
541
|
+
# [2, 2] => 60
|
542
|
+
# }
|
543
|
+
|
544
|
+
# use `uniq!(:group)` to deduplicate group fields.
|
545
|
+
accounts.merge(accounts.where.not(credit_limit: nil)).uniq!(:group).sum(:credit_limit)
|
546
|
+
# => {
|
547
|
+
# 1 => 50,
|
548
|
+
# 2 => 60
|
549
|
+
# }
|
599
550
|
```
|
600
551
|
|
601
|
-
This can be useful in instrumentation or other analysis of issued queries.
|
602
|
-
|
603
|
-
*Matt Yoho*
|
604
|
-
|
605
|
-
* Support Optimizer Hints.
|
606
|
-
|
607
|
-
In most databases, a way to control the optimizer is by using optimizer hints,
|
608
|
-
which can be specified within individual statements.
|
609
|
-
|
610
|
-
Example (for MySQL):
|
611
|
-
|
612
|
-
Topic.optimizer_hints("MAX_EXECUTION_TIME(50000)", "NO_INDEX_MERGE(topics)")
|
613
|
-
# SELECT /*+ MAX_EXECUTION_TIME(50000) NO_INDEX_MERGE(topics) */ `topics`.* FROM `topics`
|
614
|
-
|
615
|
-
Example (for PostgreSQL with pg_hint_plan):
|
616
|
-
|
617
|
-
Topic.optimizer_hints("SeqScan(topics)", "Parallel(topics 8)")
|
618
|
-
# SELECT /*+ SeqScan(topics) Parallel(topics 8) */ "topics".* FROM "topics"
|
619
|
-
|
620
|
-
See also:
|
621
|
-
|
622
|
-
* https://dev.mysql.com/doc/refman/8.0/en/optimizer-hints.html
|
623
|
-
* https://pghintplan.osdn.jp/pg_hint_plan.html
|
624
|
-
* https://docs.oracle.com/en/database/oracle/oracle-database/12.2/tgsql/influencing-the-optimizer.html
|
625
|
-
* https://docs.microsoft.com/en-us/sql/t-sql/queries/hints-transact-sql-query?view=sql-server-2017
|
626
|
-
* https://www.ibm.com/support/knowledgecenter/en/SSEPGG_11.1.0/com.ibm.db2.luw.admin.perf.doc/doc/c0070117.html
|
627
|
-
|
628
552
|
*Ryuta Kamizono*
|
629
553
|
|
630
|
-
*
|
554
|
+
* Deprecate duplicated query annotations.
|
631
555
|
|
632
|
-
|
633
|
-
|
634
|
-
```
|
635
|
-
class Post < ActiveRecord::Base
|
636
|
-
attribute :user_defined_text, :text
|
637
|
-
end
|
638
|
-
|
639
|
-
Post.new(user_defined_text: "false").user_defined_text? # => true
|
640
|
-
```
|
556
|
+
To migrate to Rails 6.2's behavior, use `uniq!(:annotate)` to deduplicate query annotations.
|
641
557
|
|
642
|
-
|
643
|
-
|
644
|
-
* Quote empty ranges like other empty enumerables.
|
645
|
-
|
646
|
-
*Patrick Rebsch*
|
647
|
-
|
648
|
-
* Add `insert_all`/`insert_all!`/`upsert_all` methods to `ActiveRecord::Persistence`,
|
649
|
-
allowing bulk inserts akin to the bulk updates provided by `update_all` and
|
650
|
-
bulk deletes by `delete_all`.
|
651
|
-
|
652
|
-
Supports skipping or upserting duplicates through the `ON CONFLICT` syntax
|
653
|
-
for PostgreSQL (9.5+) and SQLite (3.24+) and `ON DUPLICATE KEY UPDATE` syntax
|
654
|
-
for MySQL.
|
655
|
-
|
656
|
-
*Bob Lail*
|
657
|
-
|
658
|
-
* Add `rails db:seed:replant` that truncates tables of each database
|
659
|
-
for current environment and loads the seeds.
|
660
|
-
|
661
|
-
*bogdanvlviv*, *DHH*
|
662
|
-
|
663
|
-
* Add `ActiveRecord::Base.connection.truncate` for SQLite3 adapter.
|
664
|
-
|
665
|
-
*bogdanvlviv*
|
558
|
+
```ruby
|
559
|
+
accounts = Account.where(id: [1, 2]).annotate("david and mary")
|
666
560
|
|
667
|
-
|
561
|
+
# duplicated annotations, deprecated.
|
562
|
+
accounts.merge(accounts.rewhere(id: 3))
|
563
|
+
# SELECT accounts.* FROM accounts WHERE accounts.id = 3 /* david and mary */ /* david and mary */
|
668
564
|
|
669
|
-
|
670
|
-
|
671
|
-
|
565
|
+
# use `uniq!(:annotate)` to deduplicate annotations.
|
566
|
+
accounts.merge(accounts.rewhere(id: 3)).uniq!(:annotate)
|
567
|
+
# SELECT accounts.* FROM accounts WHERE accounts.id = 3 /* david and mary */
|
568
|
+
```
|
672
569
|
|
673
570
|
*Ryuta Kamizono*
|
674
571
|
|
675
|
-
*
|
572
|
+
* Resolve conflict between counter cache and optimistic locking.
|
573
|
+
|
574
|
+
Bump an Active Record instance's lock version after updating its counter
|
575
|
+
cache. This avoids raising an unnecessary `ActiveRecord::StaleObjectError`
|
576
|
+
upon subsequent transactions by maintaining parity with the corresponding
|
577
|
+
database record's `lock_version` column.
|
676
578
|
|
677
|
-
Fixes #
|
579
|
+
Fixes #16449.
|
678
580
|
|
679
|
-
*
|
581
|
+
*Aaron Lipman*
|
680
582
|
|
681
|
-
*
|
583
|
+
* Support merging option `:rewhere` to allow mergee side condition to be replaced exactly.
|
682
584
|
|
683
|
-
|
585
|
+
```ruby
|
586
|
+
david_and_mary = Author.where(id: david.id..mary.id)
|
684
587
|
|
685
|
-
|
686
|
-
|
687
|
-
end
|
588
|
+
# both conflict conditions exists
|
589
|
+
david_and_mary.merge(Author.where(id: bob)) # => []
|
688
590
|
|
689
|
-
|
690
|
-
|
691
|
-
Post.not_trashed # => where.not(status: :trashed)
|
591
|
+
# mergee side condition is replaced by rewhere
|
592
|
+
david_and_mary.merge(Author.rewhere(id: bob)) # => [bob]
|
692
593
|
|
693
|
-
|
594
|
+
# mergee side condition is replaced by rewhere option
|
595
|
+
david_and_mary.merge(Author.where(id: bob), rewhere: true) # => [bob]
|
596
|
+
```
|
694
597
|
|
695
|
-
*
|
598
|
+
*Ryuta Kamizono*
|
696
599
|
|
697
|
-
|
600
|
+
* Add support for finding records based on signed ids, which are tamper-proof, verified ids that can be
|
601
|
+
set to expire and scoped with a purpose. This is particularly useful for things like password reset
|
602
|
+
or email verification, where you want the bearer of the signed id to be able to interact with the
|
603
|
+
underlying record, but usually only within a certain time period.
|
698
604
|
|
699
|
-
|
605
|
+
```ruby
|
606
|
+
signed_id = User.first.signed_id expires_in: 15.minutes, purpose: :password_reset
|
700
607
|
|
608
|
+
User.find_signed signed_id # => nil, since the purpose does not match
|
701
609
|
|
702
|
-
|
610
|
+
travel 16.minutes
|
611
|
+
User.find_signed signed_id, purpose: :password_reset # => nil, since the signed id has expired
|
703
612
|
|
704
|
-
|
613
|
+
travel_back
|
614
|
+
User.find_signed signed_id, purpose: :password_reset # => User.first
|
705
615
|
|
616
|
+
User.find_signed! "bad data" # => ActiveSupport::MessageVerifier::InvalidSignature
|
617
|
+
```
|
706
618
|
|
707
|
-
|
619
|
+
*DHH*
|
708
620
|
|
709
|
-
*
|
621
|
+
* Support `ALGORITHM = INSTANT` DDL option for index operations on MySQL.
|
710
622
|
|
711
623
|
*Ryuta Kamizono*
|
712
624
|
|
713
|
-
*
|
625
|
+
* Fix index creation to preserve index comment in bulk change table on MySQL.
|
714
626
|
|
715
627
|
*Ryuta Kamizono*
|
716
628
|
|
717
|
-
*
|
629
|
+
* Allow `unscope` to be aware of table name qualified values.
|
718
630
|
|
719
|
-
|
631
|
+
It is possible to unscope only the column in the specified table.
|
720
632
|
|
721
|
-
|
633
|
+
```ruby
|
634
|
+
posts = Post.joins(:comments).group(:"posts.hidden")
|
635
|
+
posts = posts.where("posts.hidden": false, "comments.hidden": false)
|
722
636
|
|
723
|
-
|
724
|
-
|
637
|
+
posts.count
|
638
|
+
# => { false => 10 }
|
725
639
|
|
726
|
-
|
640
|
+
# unscope both hidden columns
|
641
|
+
posts.unscope(where: :hidden).count
|
642
|
+
# => { false => 11, true => 1 }
|
727
643
|
|
728
|
-
|
729
|
-
|
644
|
+
# unscope only comments.hidden column
|
645
|
+
posts.unscope(where: :"comments.hidden").count
|
646
|
+
# => { false => 11 }
|
647
|
+
```
|
730
648
|
|
731
|
-
|
732
|
-
david.posts.destroy_by(id: [1, 2, 3])
|
649
|
+
*Ryuta Kamizono*, *Slava Korolev*
|
733
650
|
|
734
|
-
|
735
|
-
`delete_all` on the matched records.
|
651
|
+
* Fix `rewhere` to truly overwrite collided where clause by new where clause.
|
736
652
|
|
737
|
-
|
653
|
+
```ruby
|
654
|
+
steve = Person.find_by(name: "Steve")
|
655
|
+
david = Author.find_by(name: "David")
|
738
656
|
|
739
|
-
|
740
|
-
Person.delete_by(name: 'David', rating: 4)
|
657
|
+
relation = Essay.where(writer: steve)
|
741
658
|
|
742
|
-
|
743
|
-
|
659
|
+
# Before
|
660
|
+
relation.rewhere(writer: david).to_a # => []
|
744
661
|
|
745
|
-
|
662
|
+
# After
|
663
|
+
relation.rewhere(writer: david).to_a # => [david]
|
664
|
+
```
|
746
665
|
|
747
|
-
*
|
666
|
+
*Ryuta Kamizono*
|
748
667
|
|
749
|
-
|
668
|
+
* Inspect time attributes with subsec.
|
750
669
|
|
751
|
-
|
670
|
+
```ruby
|
671
|
+
p Knot.create
|
672
|
+
=> #<Knot id: 1, created_at: "2016-05-05 01:29:47.116928000">
|
673
|
+
```
|
752
674
|
|
753
|
-
*
|
675
|
+
*akinomaeni*
|
676
|
+
|
677
|
+
* Deprecate passing a column to `type_cast`.
|
754
678
|
|
755
679
|
*Ryuta Kamizono*
|
756
680
|
|
757
|
-
* Deprecate
|
758
|
-
regarded as leaked. Use `klass.unscoped` to avoid the leaking scope.
|
681
|
+
* Deprecate `in_clause_length` and `allowed_index_name_length` in `DatabaseLimits`.
|
759
682
|
|
760
683
|
*Ryuta Kamizono*
|
761
684
|
|
762
|
-
*
|
763
|
-
|
764
|
-
Adds a middleware and configuration options that can be used in your
|
765
|
-
application to automatically switch between the writing and reading
|
766
|
-
database connections.
|
685
|
+
* Support bulk insert/upsert on relation to preserve scope values.
|
767
686
|
|
768
|
-
|
769
|
-
a write in the last 2 seconds, otherwise they will read from the primary.
|
770
|
-
Non-get requests will always write to the primary. The middleware accepts
|
771
|
-
an argument for a Resolver class and an Operations class where you are able
|
772
|
-
to change how the auto-switcher works to be most beneficial for your
|
773
|
-
application.
|
687
|
+
*Josef Šimánek*, *Ryuta Kamizono*
|
774
688
|
|
775
|
-
|
776
|
-
configuration options:
|
689
|
+
* Preserve column comment value on changing column name on MySQL.
|
777
690
|
|
778
|
-
|
779
|
-
config.active_record.database_selector = { delay: 2.seconds }
|
780
|
-
config.active_record.database_resolver = ActiveRecord::Middleware::DatabaseSelector::Resolver
|
781
|
-
config.active_record.database_resolver_context = ActiveRecord::Middleware::DatabaseSelector::Resolver::Session
|
782
|
-
```
|
691
|
+
*Islam Taha*
|
783
692
|
|
784
|
-
|
785
|
-
configuration options:
|
693
|
+
* Add support for `if_exists` option for removing an index.
|
786
694
|
|
787
|
-
|
788
|
-
config.active_record.database_selector = { delay: 10.seconds }
|
789
|
-
config.active_record.database_resolver = MyResolver
|
790
|
-
config.active_record.database_resolver_context = MyResolver::MyCookies
|
791
|
-
```
|
695
|
+
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.
|
792
696
|
|
793
697
|
*Eileen M. Uchitelle*
|
794
698
|
|
795
|
-
*
|
699
|
+
* Remove ibm_db, informix, mssql, oracle, and oracle12 Arel visitors which are not used in the code base.
|
796
700
|
|
797
701
|
*Ryuta Kamizono*
|
798
702
|
|
799
|
-
*
|
703
|
+
* Prevent `build_association` from `touching` a parent record if the record isn't persisted for `has_one` associations.
|
800
704
|
|
801
|
-
|
705
|
+
Fixes #38219.
|
802
706
|
|
707
|
+
*Josh Brody*
|
803
708
|
|
804
|
-
|
709
|
+
* Add support for `if_not_exists` option for adding index.
|
805
710
|
|
806
|
-
|
711
|
+
The `add_index` method respects `if_not_exists` option. If it is set to true
|
712
|
+
index won't be added.
|
807
713
|
|
808
|
-
|
714
|
+
Usage:
|
809
715
|
|
810
|
-
|
716
|
+
```ruby
|
717
|
+
add_index :users, :account_id, if_not_exists: true
|
718
|
+
```
|
811
719
|
|
812
|
-
|
720
|
+
The `if_not_exists` option passed to `create_table` also gets propagated to indexes
|
721
|
+
created within that migration so that if table and its indexes exist then there is no
|
722
|
+
attempt to create them again.
|
813
723
|
|
814
|
-
*
|
724
|
+
*Prathamesh Sonpatki*
|
815
725
|
|
816
|
-
|
726
|
+
* Add `ActiveRecord::Base#previously_new_record?` to show if a record was new before the last save.
|
817
727
|
|
818
|
-
*
|
728
|
+
*Tom Ward*
|
819
729
|
|
820
|
-
|
730
|
+
* Support descending order for `find_each`, `find_in_batches`, and `in_batches`.
|
821
731
|
|
822
|
-
|
732
|
+
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.
|
823
733
|
|
824
|
-
|
734
|
+
This change allows reversing the order, batching from newest to oldest. This is useful when you need to process newer batches of records first.
|
825
735
|
|
826
|
-
|
736
|
+
Pass `order: :desc` to yield batches in descending order. The default remains `order: :asc`.
|
827
737
|
|
828
|
-
|
738
|
+
```ruby
|
739
|
+
Person.find_each(order: :desc) do |person|
|
740
|
+
person.party_all_night!
|
741
|
+
end
|
742
|
+
```
|
829
743
|
|
830
|
-
*
|
744
|
+
*Alexey Vasiliev*
|
831
745
|
|
832
|
-
|
746
|
+
* Fix `insert_all` with enum values.
|
833
747
|
|
834
|
-
|
748
|
+
Fixes #38716.
|
835
749
|
|
836
|
-
*
|
750
|
+
*Joel Blum*
|
837
751
|
|
838
|
-
*
|
752
|
+
* Add support for `db:rollback:name` for multiple database applications.
|
839
753
|
|
840
|
-
|
754
|
+
Multiple database applications will now raise if `db:rollback` is call and recommend using the `db:rollback:[NAME]` to rollback migrations.
|
841
755
|
|
842
|
-
*
|
756
|
+
*Eileen M. Uchitelle*
|
843
757
|
|
844
|
-
|
758
|
+
* `Relation#pick` now uses already loaded results instead of making another query.
|
845
759
|
|
846
|
-
*
|
760
|
+
*Eugene Kenny*
|
847
761
|
|
848
|
-
|
762
|
+
* Deprecate using `return`, `break` or `throw` to exit a transaction block after writes.
|
849
763
|
|
850
|
-
*
|
764
|
+
*Dylan Thacker-Smith*
|
851
765
|
|
852
|
-
|
766
|
+
* Dump the schema or structure of a database when calling `db:migrate:name`.
|
853
767
|
|
854
|
-
|
768
|
+
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.
|
855
769
|
|
856
|
-
|
770
|
+
Going forward, calls to `rails db:migrate:name` will dump the schema (or structure) of the database being migrated.
|
857
771
|
|
858
|
-
*
|
772
|
+
*Kyle Thompson*
|
859
773
|
|
860
|
-
|
774
|
+
* Reset the `ActiveRecord::Base` connection after `rails db:migrate:name`.
|
861
775
|
|
862
|
-
|
776
|
+
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.
|
863
777
|
|
864
|
-
*
|
778
|
+
*Kyle Thompson*
|
865
779
|
|
866
|
-
|
780
|
+
* Disallow calling `connected_to` on subclasses of `ActiveRecord::Base`.
|
867
781
|
|
868
|
-
|
782
|
+
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.
|
869
783
|
|
870
|
-
*
|
784
|
+
*Eileen M. Uchitelle*, *John Crepezzi*
|
871
785
|
|
872
|
-
*
|
786
|
+
* Add support for horizontal sharding to `connects_to` and `connected_to`.
|
873
787
|
|
874
|
-
|
788
|
+
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.
|
875
789
|
|
876
|
-
|
790
|
+
Usage:
|
877
791
|
|
878
|
-
|
879
|
-
format for InnoDB tables. The default setting is `DYNAMIC`.
|
880
|
-
The row format is required for indexing on `varchar(255)` with `utf8mb4` columns.
|
792
|
+
Given the following configuration:
|
881
793
|
|
882
|
-
|
794
|
+
```yaml
|
795
|
+
# config/database.yml
|
796
|
+
production:
|
797
|
+
primary:
|
798
|
+
database: my_database
|
799
|
+
primary_shard_one:
|
800
|
+
database: my_database_shard_one
|
801
|
+
```
|
883
802
|
|
884
|
-
|
803
|
+
Connect to multiple shards:
|
885
804
|
|
886
|
-
|
805
|
+
```ruby
|
806
|
+
class ApplicationRecord < ActiveRecord::Base
|
807
|
+
self.abstract_class = true
|
887
808
|
|
888
|
-
|
809
|
+
connects_to shards: {
|
810
|
+
default: { writing: :primary },
|
811
|
+
shard_one: { writing: :primary_shard_one }
|
812
|
+
}
|
813
|
+
```
|
889
814
|
|
890
|
-
|
815
|
+
Swap between shards in your controller / model code:
|
891
816
|
|
892
|
-
|
817
|
+
```ruby
|
818
|
+
ActiveRecord::Base.connected_to(shard: :shard_one) do
|
819
|
+
# Read from shard one
|
820
|
+
end
|
821
|
+
```
|
893
822
|
|
894
|
-
|
823
|
+
The horizontal sharding API also supports read replicas. See guides for more details.
|
895
824
|
|
896
|
-
*
|
825
|
+
*Eileen M. Uchitelle*, *John Crepezzi*
|
897
826
|
|
898
|
-
|
827
|
+
* Deprecate `spec_name` in favor of `name` on database configurations.
|
899
828
|
|
900
|
-
|
829
|
+
The accessors for `spec_name` on `configs_for` and `DatabaseConfig` are deprecated. Please use `name` instead.
|
901
830
|
|
902
|
-
|
903
|
-
you're building out multiple databases and want to make sure you're not sending
|
904
|
-
writes when you want a read.
|
831
|
+
Deprecated behavior:
|
905
832
|
|
906
|
-
|
907
|
-
|
908
|
-
|
833
|
+
```ruby
|
834
|
+
db_config = ActiveRecord::Base.configs_for(env_name: "development", spec_name: "primary")
|
835
|
+
db_config.spec_name
|
836
|
+
```
|
909
837
|
|
910
|
-
|
911
|
-
read-only queries without opening a second connection. One purpose of this is to
|
912
|
-
catch accidental writes, not all writes.
|
838
|
+
New behavior:
|
913
839
|
|
914
|
-
|
840
|
+
```ruby
|
841
|
+
db_config = ActiveRecord::Base.configs_for(env_name: "development", name: "primary")
|
842
|
+
db_config.name
|
843
|
+
```
|
915
844
|
|
916
|
-
*
|
845
|
+
*Eileen M. Uchitelle*
|
917
846
|
|
918
|
-
|
847
|
+
* Add additional database-specific rake tasks for multi-database users.
|
919
848
|
|
920
|
-
|
849
|
+
Previously, `rails db:create`, `rails db:drop`, and `rails db:migrate` were the only rails tasks that could operate on a single
|
850
|
+
database. For example:
|
921
851
|
|
922
|
-
|
852
|
+
```
|
853
|
+
rails db:create
|
854
|
+
rails db:create:primary
|
855
|
+
rails db:create:animals
|
856
|
+
rails db:drop
|
857
|
+
rails db:drop:primary
|
858
|
+
rails db:drop:animals
|
859
|
+
rails db:migrate
|
860
|
+
rails db:migrate:primary
|
861
|
+
rails db:migrate:animals
|
862
|
+
```
|
923
863
|
|
924
|
-
|
864
|
+
With these changes, `rails db:schema:dump`, `rails db:schema:load`, `rails db:structure:dump`, `rails db:structure:load` and
|
865
|
+
`rails db:test:prepare` can additionally operate on a single database. For example:
|
925
866
|
|
926
|
-
|
867
|
+
```
|
868
|
+
rails db:schema:dump
|
869
|
+
rails db:schema:dump:primary
|
870
|
+
rails db:schema:dump:animals
|
871
|
+
rails db:schema:load
|
872
|
+
rails db:schema:load:primary
|
873
|
+
rails db:schema:load:animals
|
874
|
+
rails db:structure:dump
|
875
|
+
rails db:structure:dump:primary
|
876
|
+
rails db:structure:dump:animals
|
877
|
+
rails db:structure:load
|
878
|
+
rails db:structure:load:primary
|
879
|
+
rails db:structure:load:animals
|
880
|
+
rails db:test:prepare
|
881
|
+
rails db:test:prepare:primary
|
882
|
+
rails db:test:prepare:animals
|
883
|
+
```
|
927
884
|
|
928
|
-
|
929
|
-
was passing for SQLite and MySQL, but failed for PostgreSQL:
|
885
|
+
*Kyle Thompson*
|
930
886
|
|
931
|
-
|
932
|
-
class DeveloperName < ActiveRecord::Type::String
|
933
|
-
def deserialize(value)
|
934
|
-
"Developer: #{value}"
|
935
|
-
end
|
936
|
-
end
|
887
|
+
* Add support for `strict_loading` mode on association declarations.
|
937
888
|
|
938
|
-
|
939
|
-
self.table_name = "developers"
|
889
|
+
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.
|
940
890
|
|
941
|
-
|
891
|
+
Usage:
|
942
892
|
|
943
|
-
|
893
|
+
```ruby
|
894
|
+
class Developer < ApplicationRecord
|
895
|
+
has_many :projects, strict_loading: true
|
944
896
|
end
|
945
897
|
|
946
|
-
|
947
|
-
|
948
|
-
|
949
|
-
loaded_developer = AttributedDeveloper.where(id: developer.id).select("*").first
|
950
|
-
puts loaded_developer.name # should be "Developer: name" but it's just "name"
|
898
|
+
dev = Developer.first
|
899
|
+
dev.projects.first
|
900
|
+
# => ActiveRecord::StrictLoadingViolationError: The projects association is marked as strict_loading and cannot be lazily loaded.
|
951
901
|
```
|
952
902
|
|
953
|
-
*
|
954
|
-
|
955
|
-
* Make the implicit order column configurable.
|
956
|
-
|
957
|
-
When calling ordered finder methods such as `first` or `last` without an
|
958
|
-
explicit order clause, ActiveRecord sorts records by primary key. This can
|
959
|
-
result in unpredictable and surprising behaviour when the primary key is
|
960
|
-
not an auto-incrementing integer, for example when it's a UUID. This change
|
961
|
-
makes it possible to override the column used for implicit ordering such
|
962
|
-
that `first` and `last` will return more predictable results.
|
963
|
-
|
964
|
-
Example:
|
965
|
-
|
966
|
-
class Project < ActiveRecord::Base
|
967
|
-
self.implicit_order_column = "created_at"
|
968
|
-
end
|
903
|
+
*Kevin Deisz*
|
969
904
|
|
970
|
-
|
905
|
+
* Add support for `strict_loading` mode to prevent lazy loading of records.
|
971
906
|
|
972
|
-
|
907
|
+
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.
|
973
908
|
|
974
|
-
|
909
|
+
Usage:
|
975
910
|
|
976
|
-
|
911
|
+
```ruby
|
912
|
+
dev = Developer.strict_loading.first
|
913
|
+
dev.audit_logs.to_a
|
914
|
+
# => ActiveRecord::StrictLoadingViolationError: Developer is marked as strict_loading and AuditLog cannot be lazily loaded.
|
915
|
+
```
|
977
916
|
|
978
|
-
*
|
917
|
+
*Eileen M. Uchitelle*, *Aaron Patterson*
|
979
918
|
|
980
|
-
*
|
919
|
+
* Add support for PostgreSQL 11+ partitioned indexes when using `upsert_all`.
|
981
920
|
|
982
|
-
|
921
|
+
*Sebastián Palma*
|
983
922
|
|
984
|
-
|
923
|
+
* Adds support for `if_not_exists` to `add_column` and `if_exists` to `remove_column`.
|
985
924
|
|
986
|
-
|
925
|
+
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.
|
987
926
|
|
988
|
-
Example:
|
927
|
+
Example Usage:
|
989
928
|
|
990
|
-
```
|
991
|
-
class
|
992
|
-
def
|
993
|
-
|
929
|
+
```ruby
|
930
|
+
class AddColumnTitle < ActiveRecord::Migration[6.1]
|
931
|
+
def change
|
932
|
+
add_column :posts, :title, :string, if_not_exists: true
|
994
933
|
end
|
995
934
|
end
|
996
935
|
```
|
997
936
|
|
998
|
-
|
937
|
+
```ruby
|
938
|
+
class RemoveColumnTitle < ActiveRecord::Migration[6.1]
|
939
|
+
def change
|
940
|
+
remove_column :posts, :title, if_exists: true
|
941
|
+
end
|
942
|
+
end
|
943
|
+
```
|
999
944
|
|
1000
|
-
*
|
945
|
+
*Eileen M. Uchitelle*
|
1001
946
|
|
1002
|
-
|
947
|
+
* Regexp-escape table name for MS SQL Server.
|
1003
948
|
|
1004
|
-
|
1005
|
-
t.string :title
|
1006
|
-
end
|
949
|
+
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.
|
1007
950
|
|
1008
|
-
|
951
|
+
*Larry Reid*
|
1009
952
|
|
1010
|
-
|
1011
|
-
...
|
1012
|
-
)
|
953
|
+
* Store advisory locks on their own named connection.
|
1013
954
|
|
1014
|
-
|
1015
|
-
exception whereas `if_not_exists: true` does nothing.
|
955
|
+
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.
|
1016
956
|
|
1017
|
-
|
957
|
+
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.
|
1018
958
|
|
1019
|
-
*
|
959
|
+
*Eileen M. Uchitelle*, *John Crepezzi*
|
1020
960
|
|
1021
|
-
|
961
|
+
* Allow schema cache path to be defined in the database configuration file.
|
1022
962
|
|
1023
|
-
|
963
|
+
For example:
|
1024
964
|
|
1025
|
-
|
965
|
+
```yaml
|
966
|
+
development:
|
967
|
+
adapter: postgresql
|
968
|
+
database: blog_development
|
969
|
+
pool: 5
|
970
|
+
schema_cache_path: tmp/schema/main.yml
|
971
|
+
```
|
1026
972
|
|
1027
|
-
*
|
1028
|
-
if the attribute does not exist.
|
973
|
+
*Katrina Owen*
|
1029
974
|
|
1030
|
-
|
975
|
+
* Deprecate `#remove_connection` in favor of `#remove_connection_pool` when called on the handler.
|
1031
976
|
|
1032
|
-
|
977
|
+
`#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 6.2.
|
1033
978
|
|
1034
|
-
|
1035
|
-
User.connected_to(database: { writing: "postgres://foo" }) do
|
1036
|
-
User.create!(name: "Gannon")
|
1037
|
-
end
|
979
|
+
*Eileen M. Uchitelle*, *John Crepezzi*
|
1038
980
|
|
1039
|
-
|
1040
|
-
User.connected_to(database: { reading: config }) do
|
1041
|
-
User.count
|
1042
|
-
end
|
1043
|
-
````
|
981
|
+
* Deprecate `#default_hash` and it's alias `#[]` on database configurations.
|
1044
982
|
|
1045
|
-
|
983
|
+
Applications should use `configs_for`. `#default_hash` and `#[]` will be removed in 6.2.
|
1046
984
|
|
1047
|
-
*
|
985
|
+
*Eileen M. Uchitelle*, *John Crepezzi*
|
1048
986
|
|
1049
|
-
|
987
|
+
* Add scale support to `ActiveRecord::Validations::NumericalityValidator`.
|
1050
988
|
|
1051
|
-
|
989
|
+
*Gannon McGibbon*
|
1052
990
|
|
1053
|
-
|
991
|
+
* Find orphans by looking for missing relations through chaining `where.missing`:
|
1054
992
|
|
1055
|
-
|
993
|
+
Before:
|
1056
994
|
|
1057
|
-
|
1058
|
-
|
995
|
+
```ruby
|
996
|
+
Post.left_joins(:author).where(authors: { id: nil })
|
997
|
+
```
|
1059
998
|
|
1060
|
-
|
999
|
+
After:
|
1061
1000
|
|
1062
|
-
|
1001
|
+
```ruby
|
1002
|
+
Post.where.missing(:author)
|
1003
|
+
```
|
1063
1004
|
|
1064
|
-
*
|
1005
|
+
*Tom Rossi*
|
1065
1006
|
|
1066
|
-
|
1007
|
+
* Ensure `:reading` connections always raise if a write is attempted.
|
1067
1008
|
|
1068
|
-
|
1009
|
+
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`.
|
1069
1010
|
|
1070
|
-
*
|
1011
|
+
*Eileen M. Uchitelle*
|
1071
1012
|
|
1072
|
-
|
1013
|
+
* Deprecate `"primary"` as the `connection_specification_name` for `ActiveRecord::Base`.
|
1073
1014
|
|
1074
|
-
|
1075
|
-
class AnimalsModel < ApplicationRecord
|
1076
|
-
self.abstract_class = true
|
1015
|
+
`"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"`.
|
1077
1016
|
|
1078
|
-
|
1079
|
-
end
|
1017
|
+
*Eileen M. Uchitelle*, *John Crepezzi*
|
1080
1018
|
|
1081
|
-
|
1082
|
-
|
1083
|
-
end
|
1084
|
-
```
|
1019
|
+
* Add `ActiveRecord::Validations::NumericalityValidator` with
|
1020
|
+
support for casting floats using a database columns' precision value.
|
1085
1021
|
|
1086
|
-
|
1087
|
-
a database that the model didn't connect to. Connecting to the database in this block is
|
1088
|
-
useful when you have another defined connection, for example `slow_replica` that you don't
|
1089
|
-
want to connect to by default but need in the console, or a specific code block.
|
1022
|
+
*Gannon McGibbon*
|
1090
1023
|
|
1091
|
-
|
1092
|
-
ActiveRecord::
|
1093
|
-
|
1094
|
-
|
1095
|
-
|
1096
|
-
```
|
1024
|
+
* Enforce fresh ETag header after a collection's contents change by adding
|
1025
|
+
ActiveRecord::Relation#cache_key_with_version. This method will be used by
|
1026
|
+
ActionController::ConditionalGet to ensure that when collection cache versioning
|
1027
|
+
is enabled, requests using ConditionalGet don't return the same ETag header
|
1028
|
+
after a collection is modified.
|
1097
1029
|
|
1098
|
-
|
1099
|
-
ActiveRecord::Base.connected_to(database: :slow_replica) do
|
1100
|
-
SlowReplicaModel.first # if the db config has a slow_replica configuration this will be used to do the lookup, otherwise this will throw an exception
|
1101
|
-
end
|
1102
|
-
```
|
1030
|
+
Fixes #38078.
|
1103
1031
|
|
1104
|
-
*
|
1032
|
+
*Aaron Lipman*
|
1105
1033
|
|
1106
|
-
*
|
1034
|
+
* Skip test database when running `db:create` or `db:drop` in development
|
1035
|
+
with `DATABASE_URL` set.
|
1107
1036
|
|
1108
|
-
|
1109
|
-
commit checks that only valid definition values are provided, those can
|
1110
|
-
be a Hash, an array of Symbols or an array of Strings. Otherwise it
|
1111
|
-
raises an `ArgumentError`.
|
1037
|
+
*Brian Buchalter*
|
1112
1038
|
|
1113
|
-
|
1039
|
+
* Don't allow mutations on the database configurations hash.
|
1114
1040
|
|
1115
|
-
|
1041
|
+
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.
|
1116
1042
|
|
1117
|
-
|
1043
|
+
Before:
|
1118
1044
|
|
1045
|
+
```ruby
|
1046
|
+
@db_config = ActiveRecord::Base.configurations.configs_for(env_name: "test", spec_name: "primary")
|
1047
|
+
@db_config.configuration_hash.merge!(idle_timeout: "0.02")
|
1119
1048
|
```
|
1120
|
-
class Post < ActiveRecord::Base
|
1121
|
-
has_one :category
|
1122
|
-
belongs_to :author
|
1123
|
-
has_many :comments
|
1124
|
-
end
|
1125
1049
|
|
1126
|
-
|
1127
|
-
|
1128
|
-
|
1129
|
-
|
1050
|
+
After:
|
1051
|
+
|
1052
|
+
```ruby
|
1053
|
+
@db_config = ActiveRecord::Base.configurations.configs_for(env_name: "test", spec_name: "primary")
|
1054
|
+
config = @db_config.configuration_hash.merge(idle_timeout: "0.02")
|
1055
|
+
db_config = ActiveRecord::DatabaseConfigurations::HashConfig.new(@db_config.env_name, @db_config.spec_name, config)
|
1130
1056
|
```
|
1131
1057
|
|
1132
|
-
*
|
1058
|
+
*Eileen M. Uchitelle*, *John Crepezzi*
|
1133
1059
|
|
1134
|
-
*
|
1135
|
-
With this change you can create indexes while adding new
|
1136
|
-
columns into the existing tables.
|
1060
|
+
* Remove `:connection_id` from the `sql.active_record` notification.
|
1137
1061
|
|
1138
|
-
|
1062
|
+
*Aaron Patterson*, *Rafael Mendonça França*
|
1139
1063
|
|
1140
|
-
|
1141
|
-
t.string :country_code, index: true
|
1142
|
-
end
|
1064
|
+
* The `:name` key will no longer be returned as part of `DatabaseConfig#configuration_hash`. Please use `DatabaseConfig#owner_name` instead.
|
1143
1065
|
|
1144
|
-
*
|
1066
|
+
*Eileen M. Uchitelle*, *John Crepezzi*
|
1145
1067
|
|
1146
|
-
*
|
1068
|
+
* ActiveRecord's `belongs_to_required_by_default` flag can now be set per model.
|
1147
1069
|
|
1148
|
-
|
1149
|
-
|
1070
|
+
You can now opt-out/opt-in specific models from having their associations required
|
1071
|
+
by default.
|
1150
1072
|
|
1151
|
-
|
1073
|
+
This change is meant to ease the process of migrating all your models to have
|
1074
|
+
their association required.
|
1152
1075
|
|
1153
|
-
*
|
1076
|
+
*Edouard Chin*
|
1154
1077
|
|
1155
|
-
|
1078
|
+
* The `connection_config` method has been deprecated, please use `connection_db_config` instead which will return a `DatabaseConfigurations::DatabaseConfig` instead of a `Hash`.
|
1156
1079
|
|
1157
|
-
*
|
1080
|
+
*Eileen M. Uchitelle*, *John Crepezzi*
|
1158
1081
|
|
1159
|
-
|
1082
|
+
* Retain explicit selections on the base model after applying `includes` and `joins`.
|
1160
1083
|
|
1161
|
-
|
1084
|
+
Resolves #34889.
|
1162
1085
|
|
1163
|
-
|
1086
|
+
*Patrick Rebsch*
|
1164
1087
|
|
1165
|
-
|
1088
|
+
* 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.
|
1166
1089
|
|
1167
|
-
*
|
1090
|
+
*Eileen M. Uchitelle*, *John Crepezzi*
|
1168
1091
|
|
1169
|
-
|
1092
|
+
* Allow attributes to be fetched from Arel node groupings.
|
1170
1093
|
|
1171
|
-
*
|
1094
|
+
*Jeff Emminger*, *Gannon McGibbon*
|
1172
1095
|
|
1173
|
-
|
1174
|
-
create_table :users do |t|
|
1175
|
-
t.string :email
|
1176
|
-
end
|
1096
|
+
* A database URL can now contain a querystring value that contains an equal sign. This is needed to support passing PostgreSQL `options`.
|
1177
1097
|
|
1178
|
-
|
1179
|
-
```
|
1098
|
+
*Joshua Flanagan*
|
1180
1099
|
|
1181
|
-
|
1100
|
+
* 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`.
|
1182
1101
|
|
1183
|
-
*
|
1102
|
+
*John Crepezzi*
|
1184
1103
|
|
1185
|
-
|
1104
|
+
* Specifying `implicit_order_column` now subsorts the records by primary key if available to ensure deterministic results.
|
1186
1105
|
|
1187
|
-
*
|
1106
|
+
*Paweł Urbanek*
|
1188
1107
|
|
1189
|
-
*
|
1108
|
+
* `where(attr => [])` now loads an empty result without making a query.
|
1190
1109
|
|
1191
|
-
*
|
1110
|
+
*John Hawthorn*
|
1192
1111
|
|
1193
|
-
*
|
1112
|
+
* Fixed the performance regression for `primary_keys` introduced MySQL 8.0.
|
1194
1113
|
|
1195
|
-
|
1196
|
-
The previous default 3-Byte encoding character set `utf8` is not enough to support them.
|
1114
|
+
*Hiroyuki Ishii*
|
1197
1115
|
|
1198
|
-
|
1116
|
+
* Add support for `belongs_to` to `has_many` inversing.
|
1199
1117
|
|
1200
|
-
*
|
1118
|
+
*Gannon McGibbon*
|
1201
1119
|
|
1202
|
-
|
1120
|
+
* Allow length configuration for `has_secure_token` method. The minimum length
|
1121
|
+
is set at 24 characters.
|
1203
1122
|
|
1204
|
-
|
1205
|
-
sensitive values of database columns when calling `#inspect`.
|
1206
|
-
We also added `ActiveRecord::Base::filter_attributes`/`=` in order to
|
1207
|
-
specify sensitive attributes to specific model.
|
1123
|
+
Before:
|
1208
1124
|
|
1125
|
+
```ruby
|
1126
|
+
has_secure_token :auth_token
|
1209
1127
|
```
|
1210
|
-
|
1211
|
-
|
1212
|
-
|
1213
|
-
|
1128
|
+
|
1129
|
+
After:
|
1130
|
+
|
1131
|
+
```ruby
|
1132
|
+
has_secure_token :default_token # 24 characters
|
1133
|
+
has_secure_token :auth_token, length: 36 # 36 characters
|
1134
|
+
has_secure_token :invalid_token, length: 12 # => ActiveRecord::SecureToken::MinimumLengthError
|
1214
1135
|
```
|
1215
1136
|
|
1216
|
-
*
|
1137
|
+
*Bernardo de Araujo*
|
1217
1138
|
|
1218
|
-
* Deprecate `
|
1219
|
-
`indexes_per_table`, `columns_per_multicolumn_index`, `sql_query_length`,
|
1220
|
-
and `joins_per_query` methods in `DatabaseLimits`.
|
1139
|
+
* Deprecate `DatabaseConfigurations#to_h`. These connection hashes are still available via `ActiveRecord::Base.configurations.configs_for`.
|
1221
1140
|
|
1222
|
-
*
|
1141
|
+
*Eileen Uchitelle*, *John Crepezzi*
|
1223
1142
|
|
1224
|
-
* `
|
1143
|
+
* 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.
|
1225
1144
|
|
1226
|
-
|
1227
|
-
is an inflexible data model. In order to improve multiple-database
|
1228
|
-
handling in Rails, we've changed this to return an object. Some methods
|
1229
|
-
are provided to make the object behave hash-like in order to ease the
|
1230
|
-
transition process. Since most applications don't manipulate the hash
|
1231
|
-
we've decided to add backwards-compatible functionality that will throw
|
1232
|
-
a deprecation warning if used, however calling `ActiveRecord::Base.configurations`
|
1233
|
-
will use the new version internally and externally.
|
1145
|
+
*John Crepezzi*, *Eileen Uchitelle*
|
1234
1146
|
|
1235
|
-
|
1147
|
+
* Allow column names to be passed to `remove_index` positionally along with other options.
|
1236
1148
|
|
1237
|
-
|
1238
|
-
development:
|
1239
|
-
adapter: sqlite3
|
1240
|
-
database: db/development.sqlite3
|
1241
|
-
```
|
1149
|
+
Passing other options can be necessary to make `remove_index` correctly reversible.
|
1242
1150
|
|
1243
|
-
|
1151
|
+
Before:
|
1244
1152
|
|
1245
|
-
|
1246
|
-
|
1247
|
-
|
1153
|
+
add_index :reports, :report_id # => works
|
1154
|
+
add_index :reports, :report_id, unique: true # => works
|
1155
|
+
remove_index :reports, :report_id # => works
|
1156
|
+
remove_index :reports, :report_id, unique: true # => ArgumentError
|
1157
|
+
|
1158
|
+
After:
|
1248
1159
|
|
1249
|
-
|
1160
|
+
remove_index :reports, :report_id, unique: true # => works
|
1250
1161
|
|
1251
|
-
|
1252
|
-
#<ActiveRecord::DatabaseConfigurations:0x00007fd1acbdf800 @configurations=[
|
1253
|
-
#<ActiveRecord::DatabaseConfigurations::HashConfig:0x00007fd1acbded10 @env_name="development",
|
1254
|
-
@spec_name="primary", @config={"adapter"=>"sqlite3", "database"=>"db/development.sqlite3"}>
|
1255
|
-
]
|
1256
|
-
```
|
1162
|
+
*Eugene Kenny*
|
1257
1163
|
|
1258
|
-
|
1259
|
-
calling hash methods on the `configurations` hash directly, a new method `configs_for` has
|
1260
|
-
been provided that allows you to select the correct configuration. `env_name` and
|
1261
|
-
`spec_name` arguments are optional. For example, these return an array of
|
1262
|
-
database config objects for the requested environment and a single database config object
|
1263
|
-
will be returned for the requested environment and specification name respectively.
|
1164
|
+
* Allow bulk `ALTER` statements to drop and recreate indexes with the same name.
|
1264
1165
|
|
1265
|
-
|
1266
|
-
ActiveRecord::Base.configurations.configs_for(env_name: "development")
|
1267
|
-
ActiveRecord::Base.configurations.configs_for(env_name: "development", spec_name: "primary")
|
1268
|
-
```
|
1166
|
+
*Eugene Kenny*
|
1269
1167
|
|
1270
|
-
|
1168
|
+
* `insert`, `insert_all`, `upsert`, and `upsert_all` now clear the query cache.
|
1271
1169
|
|
1272
|
-
*
|
1170
|
+
*Eugene Kenny*
|
1273
1171
|
|
1274
|
-
|
1275
|
-
production:
|
1276
|
-
adapter: postgresql
|
1277
|
-
advisory_locks: false
|
1278
|
-
```
|
1172
|
+
* Call `while_preventing_writes` directly from `connected_to`.
|
1279
1173
|
|
1280
|
-
|
1174
|
+
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)`.
|
1281
1175
|
|
1282
|
-
|
1176
|
+
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.
|
1283
1177
|
|
1284
|
-
*
|
1178
|
+
*Eileen M. Uchitelle*
|
1285
1179
|
|
1286
|
-
*
|
1180
|
+
* Improve detection of ActiveRecord::StatementTimeout with mysql2 adapter in the edge case when the query is terminated during filesort.
|
1287
1181
|
|
1288
|
-
|
1182
|
+
*Kir Shatrov*
|
1289
1183
|
|
1290
|
-
|
1184
|
+
* Stop trying to read yaml file fixtures when loading Active Record fixtures.
|
1291
1185
|
|
1292
|
-
*
|
1186
|
+
*Gannon McGibbon*
|
1293
1187
|
|
1294
|
-
*
|
1295
|
-
seed load in environments without Rails and custom DB configuration
|
1188
|
+
* Deprecate `.reorder(nil)` with `.first` / `.first!` taking non-deterministic result.
|
1296
1189
|
|
1297
|
-
|
1190
|
+
To continue taking non-deterministic result, use `.take` / `.take!` instead.
|
1298
1191
|
|
1299
|
-
*
|
1192
|
+
*Ryuta Kamizono*
|
1300
1193
|
|
1301
|
-
|
1194
|
+
* Preserve user supplied joins order as much as possible.
|
1302
1195
|
|
1303
|
-
|
1196
|
+
Fixes #36761, #34328, #24281, #12953.
|
1304
1197
|
|
1305
1198
|
*Ryuta Kamizono*
|
1306
1199
|
|
1307
|
-
*
|
1200
|
+
* Allow `matches_regex` and `does_not_match_regexp` on the MySQL Arel visitor.
|
1201
|
+
|
1202
|
+
*James Pearson*
|
1308
1203
|
|
1309
|
-
|
1204
|
+
* Allow specifying fixtures to be ignored by setting `ignore` in YAML file's '_fixture' section.
|
1310
1205
|
|
1311
|
-
*
|
1206
|
+
*Tongfei Gao*
|
1207
|
+
|
1208
|
+
* Make the DATABASE_URL env variable only affect the primary connection. Add new env variables for multiple databases.
|
1312
1209
|
|
1313
|
-
*
|
1210
|
+
*John Crepezzi*, *Eileen Uchitelle*
|
1314
1211
|
|
1315
|
-
|
1212
|
+
* Add a warning for enum elements with 'not_' prefix.
|
1316
1213
|
|
1317
|
-
|
1214
|
+
class Foo
|
1215
|
+
enum status: [:sent, :not_sent]
|
1216
|
+
end
|
1318
1217
|
|
1319
|
-
|
1218
|
+
*Edu Depetris*
|
1320
1219
|
|
1321
|
-
|
1220
|
+
* Make currency symbols optional for money column type in PostgreSQL.
|
1322
1221
|
|
1323
|
-
*
|
1222
|
+
*Joel Schneider*
|
1324
1223
|
|
1325
|
-
|
1224
|
+
* Add support for beginless ranges, introduced in Ruby 2.7.
|
1326
1225
|
|
1327
|
-
*
|
1328
|
-
use loaded association ids if present.
|
1226
|
+
*Josh Goodall*
|
1329
1227
|
|
1330
|
-
|
1228
|
+
* Add `database_exists?` method to connection adapters to check if a database exists.
|
1331
1229
|
|
1332
|
-
*
|
1230
|
+
*Guilherme Mansur*
|
1333
1231
|
|
1334
|
-
|
1232
|
+
* Loading the schema for a model that has no `table_name` raises a `TableNotSpecified` error.
|
1335
1233
|
|
1336
|
-
*
|
1234
|
+
*Guilherme Mansur*, *Eugene Kenny*
|
1337
1235
|
|
1338
|
-
|
1236
|
+
* PostgreSQL: Fix GROUP BY with ORDER BY virtual count attribute.
|
1339
1237
|
|
1340
|
-
|
1238
|
+
Fixes #36022.
|
1239
|
+
|
1240
|
+
*Ryuta Kamizono*
|
1241
|
+
|
1242
|
+
* Make ActiveRecord `ConnectionPool.connections` method thread-safe.
|
1341
1243
|
|
1342
|
-
|
1244
|
+
Fixes #36465.
|
1343
1245
|
|
1344
|
-
*
|
1246
|
+
*Jeff Doering*
|
1345
1247
|
|
1346
|
-
|
1248
|
+
* Add support for multiple databases to `rails db:abort_if_pending_migrations`.
|
1347
1249
|
|
1348
|
-
*
|
1250
|
+
*Mark Lee*
|
1349
1251
|
|
1350
|
-
|
1252
|
+
* Fix sqlite3 collation parsing when using decimal columns.
|
1351
1253
|
|
1352
|
-
*
|
1254
|
+
*Martin R. Schuster*
|
1353
1255
|
|
1354
|
-
|
1256
|
+
* Fix invalid schema when primary key column has a comment.
|
1355
1257
|
|
1356
|
-
|
1258
|
+
Fixes #29966.
|
1357
1259
|
|
1358
|
-
*
|
1260
|
+
*Guilherme Goettems Schneider*
|
1359
1261
|
|
1360
|
-
*
|
1361
|
-
`ActiveRecord::Base.find_or_create_by`/`!` by leaning on unique constraints in the database.
|
1262
|
+
* Fix table comment also being applied to the primary key column.
|
1362
1263
|
|
1363
|
-
*
|
1264
|
+
*Guilherme Goettems Schneider*
|
1364
1265
|
|
1365
|
-
*
|
1266
|
+
* Allow generated `create_table` migrations to include or skip timestamps.
|
1366
1267
|
|
1367
|
-
*
|
1268
|
+
*Michael Duchemin*
|
1368
1269
|
|
1369
1270
|
|
1370
|
-
Please check [
|
1271
|
+
Please check [6-0-stable](https://github.com/rails/rails/blob/6-0-stable/activerecord/CHANGELOG.md) for previous changes.
|