activerecord 5.2.6 → 6.0.0

data/CHANGELOG.md

@@ -1,1026 +1,1013 @@
-## Rails 5.2.6 (May 05, 2021) ##
+## Rails 6.0.0 (August 16, 2019) ##
 
-*   No changes.
+*   Preserve user supplied joins order as much as possible.
 
+    Fixes #36761, #34328, #24281, #12953.
 
-## Rails 5.2.5 (March 26, 2021) ##
+    *Ryuta Kamizono*
 
-*   No changes.
+*   Make the DATABASE_URL env variable only affect the primary connection. Add new env variables for multiple databases.
 
+    *John Crepezzi*, *Eileen Uchitelle*
 
-## Rails 5.2.4.6 (May 05, 2021) ##
+*   Add a warning for enum elements with 'not_' prefix.
 
-*   No changes.
+        class Foo
+          enum status: [:sent, :not_sent]
+        end
 
+    *Edu Depetris*
 
-## Rails 5.2.4.5 (February 10, 2021) ##
+*   Make currency symbols optional for money column type in PostgreSQL
 
-*   Fix possible DoS vector in PostgreSQL money type
+    *Joel Schneider*
 
-    Carefully crafted input can cause a DoS via the regular expressions used
-    for validating the money format in the PostgreSQL adapter.  This patch
-    fixes the regexp.
 
-    Thanks to @dee-see from Hackerone for this patch!
+## Rails 6.0.0.rc2 (July 22, 2019) ##
 
-    [CVE-2021-22880]
+*   Add database_exists? method to connection adapters to check if a database exists.
 
-    *Aaron Patterson*
+    *Guilherme Mansur*
 
+*   PostgreSQL: Fix GROUP BY with ORDER BY virtual count attribute.
 
-## Rails 5.2.4.4 (September 09, 2020) ##
+    Fixes #36022.
 
-*   No changes.
+    *Ryuta Kamizono*
 
+*   Make ActiveRecord `ConnectionPool.connections` method thread-safe.
 
-## Rails 5.2.4.3 (May 18, 2020) ##
+    Fixes #36465.
 
-*   No changes.
+    *Jeff Doering*
 
-## Rails 5.2.4.2 (March 19, 2020) ##
+*   Fix sqlite3 collation parsing when using decimal columns.
 
-*   No changes.
+    *Martin R. Schuster*
 
+*   Fix invalid schema when primary key column has a comment.
 
-## Rails 5.2.4.1 (December 18, 2019) ##
+    Fixes #29966.
 
-*   No changes.
+    *Guilherme Goettems Schneider*
 
+*   Fix table comment also being applied to the primary key column.
 
-## Rails 5.2.4 (November 27, 2019) ##
+    *Guilherme Goettems Schneider*
 
-*   Fix circular `autosave: true` causes invalid records to be saved.
+*   Fix merging left_joins to maintain its own `join_type` context.
 
-    Prior to the fix, when there was a circular series of `autosave: true`
-    associations, the callback for a `has_many` association was run while
-    another instance of the same callback on the same association hadn't
-    finished running. When control returned to the first instance of the
-    callback, the instance variable had changed, and subsequent associated
-    records weren't saved correctly. Specifically, the ID field for the
-    `belongs_to` corresponding to the `has_many` was `nil`.
-
-    Fixes #28080.
-
-    *Larry Reid*
-
-*   PostgreSQL: Fix GROUP BY with ORDER BY virtual count attribute.
-
-    Fixes #36022.
+    Fixes #36103.
 
     *Ryuta Kamizono*
 
-*   Fix sqlite3 collation parsing when using decimal columns.
-
-    *Martin R. Schuster*
-
-*   Make ActiveRecord `ConnectionPool.connections` method thread-safe.
 
-    Fixes #36465.
+## Rails 6.0.0.rc1 (April 24, 2019) ##
 
-    *Jeff Doering*
+*   Add `touch` option to `has_one` association.
 
-*   Assign all attributes before calling `build` to ensure the child record is visible in
-    `before_add` and `after_add` callbacks for `has_many :through` associations.
+    *Abhay Nikam*
 
-    Fixes #33249.
+*   Deprecate `where.not` working as NOR and will be changed to NAND in Rails 6.1.
 
-    *Ryan H. Kerr*
+    ```ruby
+    all = [treasures(:diamond), treasures(:sapphire), cars(:honda), treasures(:sapphire)]
+    assert_equal all, PriceEstimate.all.map(&:estimate_of)
+    ```
 
+    In Rails 6.0:
 
-## Rails 5.2.3 (March 27, 2019) ##
+    ```ruby
+    sapphire = treasures(:sapphire)
+
+    nor = all.reject { |e|
+      e.estimate_of_type == sapphire.class.polymorphic_name
+    }.reject { |e|
+      e.estimate_of_id == sapphire.id
+    }
+    assert_equal [cars(:honda)], nor
+
+    without_sapphire = PriceEstimate.where.not(
+      estimate_of_type: sapphire.class.polymorphic_name, estimate_of_id: sapphire.id
+    )
+    assert_equal nor, without_sapphire.map(&:estimate_of)
+    ```
 
-*   Fix different `count` calculation when using `size` with manual `select` with DISTINCT.
+    In Rails 6.1:
 
-    Fixes #35214.
+    ```ruby
+    sapphire = treasures(:sapphire)
 
-    *Juani Villarejo*
+    nand = all - [sapphire]
+    assert_equal [treasures(:diamond), cars(:honda)], nand
 
-*   Fix prepared statements caching to be enabled even when query caching is enabled.
+    without_sapphire = PriceEstimate.where.not(
+      estimate_of_type: sapphire.class.polymorphic_name, estimate_of_id: sapphire.id
+    )
+    assert_equal nand, without_sapphire.map(&:estimate_of)
+    ```
 
     *Ryuta Kamizono*
 
-*   Don't allow `where` with invalid value matches to nil values.
+*   Fix dirty tracking after rollback.
 
-    Fixes #33624.
+    Fixes #15018, #30167, #33868.
 
     *Ryuta Kamizono*
 
-*   Restore an ability that class level `update` without giving ids.
+*   Add `ActiveRecord::Relation#cache_version` to support recyclable cache keys via
+    the versioned entries in `ActiveSupport::Cache`. This also means that
+    `ActiveRecord::Relation#cache_key` will now return a stable key that does not
+    include the max timestamp or count any more.
 
-    Fixes #34743.
+    NOTE: This feature is turned off by default, and `cache_key` will still return
+    cache keys with timestamps until you set `ActiveRecord::Base.collection_cache_versioning = true`.
+    That's the setting for all new apps on Rails 6.0+
 
-    *Ryuta Kamizono*
+    *Lachlan Sylvester*
 
-*   Fix join table column quoting with SQLite.
+*   Fix dirty tracking for `touch` to track saved changes.
 
-    *Gannon McGibbon*
+    Fixes #33429.
 
-*   Ensure that `delete_all` on collection proxy returns affected count.
+    *Ryuta Kamzono*
 
-    *Ryuta Kamizono*
+*   `change_column_comment` and `change_table_comment` are invertible only if
+    `to` and `from` options are specified.
 
-*   Reset scope after delete on collection association to clear stale offsets of removed records.
+    *Yoshiyuki Kinjo*
 
-    *Gannon McGibbon*
+*   Don't call commit/rollback callbacks when a record isn't saved.
 
+    Fixes #29747.
 
-## Rails 5.2.2.1 (March 11, 2019) ##
+    *Ryuta Kamizono*
 
-*   No changes.
+*   Fix circular `autosave: true` causes invalid records to be saved.
 
+    Prior to the fix, when there was a circular series of `autosave: true`
+    associations, the callback for a `has_many` association was run while
+    another instance of the same callback on the same association hadn't
+    finished running. When control returned to the first instance of the
+    callback, the instance variable had changed, and subsequent associated
+    records weren't saved correctly. Specifically, the ID field for the
+    `belongs_to` corresponding to the `has_many` was `nil`.
 
-## Rails 5.2.2 (December 04, 2018) ##
+    Fixes #28080.
 
-*   Do not ignore the scoping with query methods in the scope block.
+    *Larry Reid*
 
-    *Ryuta Kamizono*
+*   Raise `ArgumentError` for invalid `:limit` and `:precision` like as other options.
 
-*   Allow aliased attributes to be used in `#update_columns` and `#update`.
+    Before:
 
-    *Gannon McGibbon*
+    ```ruby
+    add_column :items, :attr1, :binary,   size: 10      # => ArgumentError
+    add_column :items, :attr2, :decimal,  scale: 10     # => ArgumentError
+    add_column :items, :attr3, :integer,  limit: 10     # => ActiveRecordError
+    add_column :items, :attr4, :datetime, precision: 10 # => ActiveRecordError
+    ```
 
-*   Allow spaces in postgres table names.
+    After:
 
-    Fixes issue where "user post" is misinterpreted as "\"user\".\"post\"" when quoting table names with the postgres
-    adapter.
+    ```ruby
+    add_column :items, :attr1, :binary,   size: 10      # => ArgumentError
+    add_column :items, :attr2, :decimal,  scale: 10     # => ArgumentError
+    add_column :items, :attr3, :integer,  limit: 10     # => ArgumentError
+    add_column :items, :attr4, :datetime, precision: 10 # => ArgumentError
+    ```
 
-    *Gannon McGibbon*
+    *Ryuta Kamizono*
 
-*   Cached columns_hash fields should be excluded from ResultSet#column_types
+*   Association loading isn't to be affected by scoping consistently
+    whether preloaded / eager loaded or not, with the exception of `unscoped`.
 
-    PR #34528 addresses the inconsistent behaviour when attribute is defined for an ignored column. The following test
-    was passing for SQLite and MySQL, but failed for PostgreSQL:
+    Before:
 
     ```ruby
-    class DeveloperName < ActiveRecord::Type::String
-      def deserialize(value)
-        "Developer: #{value}"
-      end
+    Post.where("1=0").scoping do
+      Comment.find(1).post                   # => nil
+      Comment.preload(:post).find(1).post    # => #<Post id: 1, ...>
+      Comment.eager_load(:post).find(1).post # => #<Post id: 1, ...>
     end
+    ```
 
-    class AttributedDeveloper < ActiveRecord::Base
-      self.table_name = "developers"
-
-      attribute :name, DeveloperName.new
+    After:
 
-      self.ignored_columns += ["name"]
+    ```ruby
+    Post.where("1=0").scoping do
+      Comment.find(1).post                   # => #<Post id: 1, ...>
+      Comment.preload(:post).find(1).post    # => #<Post id: 1, ...>
+      Comment.eager_load(:post).find(1).post # => #<Post id: 1, ...>
     end
-
-    developer = AttributedDeveloper.create
-    developer.update_column :name, "name"
-
-    loaded_developer = AttributedDeveloper.where(id: developer.id).select("*").first
-    puts loaded_developer.name # should be "Developer: name" but it's just "name"
     ```
 
-    *Dmitry Tsepelev*
-
-*   Values of enum are frozen, raising an error when attempting to modify them.
-
-    *Emmanuel Byrd*
-
-*   `update_columns` now correctly raises `ActiveModel::MissingAttributeError`
-    if the attribute does not exist.
-
-    *Sean Griffin*
-
-*   Do not use prepared statement in queries that have a large number of binds.
+    Fixes #34638, #35398.
 
     *Ryuta Kamizono*
 
-*   Fix query cache to load before first request.
+*   Add `rails db:prepare` to migrate or setup a database.
 
-    *Eileen M. Uchitelle*
+    Runs `db:migrate` if the database exists or `db:setup` if it doesn't.
 
-*   Fix collection cache key with limit and custom select to avoid ambiguous timestamp column error.
+    *Roberto Miranda*
 
-    Fixes #33056.
+*   Add `after_save_commit` callback as shortcut for `after_commit :hook, on: [ :create, :update ]`.
 
-    *Federico Martinez*
+    *DHH*
 
-*   Fix duplicated record creation when using nested attributes with `create_with`.
+*   Assign all attributes before calling `build` to ensure the child record is visible in
+    `before_add` and `after_add` callbacks for `has_many :through` associations.
 
-    *Darwin Wu*
+    Fixes #33249.
 
-*   Fix regression setting children record in parent `before_save` callback.
+    *Ryan H. Kerr*
 
-    *Guo Xiang Tan*
+*   Add `ActiveRecord::Relation#extract_associated` for extracting associated records from a relation.
 
-*   Prevent leaking of user's DB credentials on `rails db:create` failure.
+    ```
+    account.memberships.extract_associated(:user)
+    # => Returns collection of User records
+    ```
 
-    *bogdanvlviv*
+    *DHH*
 
-*   Clear mutation tracker before continuing the around callbacks.
+*   Add `ActiveRecord::Relation#annotate` for adding SQL comments to its queries.
 
-    *Yuya Tanaka*
+    For example:
 
-*   Prevent deadlocks when waiting for connection from pool.
+    ```
+    Post.where(id: 123).annotate("this is a comment").to_sql
+    # SELECT "posts".* FROM "posts" WHERE "posts"."id" = 123 /* this is a comment */
+    ```
 
-    *Brent Wheeldon*
+    This can be useful in instrumentation or other analysis of issued queries.
 
-*   Avoid extra scoping when using `Relation#update` that was causing this method to change the current scope.
+    *Matt Yoho*
 
-    *Ryuta Kamizono*
+*   Support Optimizer Hints.
 
-*   Fix numericality validator not to be affected by custom getter.
+    In most databases, a way to control the optimizer is by using optimizer hints,
+    which can be specified within individual statements.
 
-    *Ryuta Kamizono*
+    Example (for MySQL):
 
-*   Fix bulk change table ignores comment option on PostgreSQL.
+        Topic.optimizer_hints("MAX_EXECUTION_TIME(50000)", "NO_INDEX_MERGE(topics)")
+        # SELECT /*+ MAX_EXECUTION_TIME(50000) NO_INDEX_MERGE(topics) */ `topics`.* FROM `topics`
 
-    *Yoshiyuki Kinjo*
+    Example (for PostgreSQL with pg_hint_plan):
 
+        Topic.optimizer_hints("SeqScan(topics)", "Parallel(topics 8)")
+        # SELECT /*+ SeqScan(topics) Parallel(topics 8) */ "topics".* FROM "topics"
 
-## Rails 5.2.1.1 (November 27, 2018) ##
+    See also:
 
-*   No changes.
+    * https://dev.mysql.com/doc/refman/8.0/en/optimizer-hints.html
+    * https://pghintplan.osdn.jp/pg_hint_plan.html
+    * https://docs.oracle.com/en/database/oracle/oracle-database/12.2/tgsql/influencing-the-optimizer.html
+    * https://docs.microsoft.com/en-us/sql/t-sql/queries/hints-transact-sql-query?view=sql-server-2017
+    * https://www.ibm.com/support/knowledgecenter/en/SSEPGG_11.1.0/com.ibm.db2.luw.admin.perf.doc/doc/c0070117.html
 
+    *Ryuta Kamizono*
 
-## Rails 5.2.1 (August 07, 2018) ##
+*   Fix query attribute method on user-defined attribute to be aware of typecasted value.
 
-*   PostgreSQL: Support new relkind for partitioned tables.
+    For example, the following code no longer return false as casted non-empty string:
 
-    Fixes #33008.
+    ```
+    class Post < ActiveRecord::Base
+      attribute :user_defined_text, :text
+    end
 
-    *Yannick Schutz*
+    Post.new(user_defined_text: "false").user_defined_text? # => true
+    ```
 
-*   Rollback parent transaction when children fails to update.
+    *Yuji Kamijima*
 
-    *Guillaume Malette*
+*   Quote empty ranges like other empty enumerables.
 
-*   Fix default value for MySQL time types with specified precision.
+    *Patrick Rebsch*
 
-    *Nikolay Kondratyev*
+*   Add `insert_all`/`insert_all!`/`upsert_all` methods to `ActiveRecord::Persistence`,
+    allowing bulk inserts akin to the bulk updates provided by `update_all` and
+    bulk deletes by `delete_all`.
 
-*   Fix `touch` option to behave consistently with `Persistence#touch` method.
+    Supports skipping or upserting duplicates through the `ON CONFLICT` syntax
+    for PostgreSQL (9.5+) and SQLite (3.24+) and `ON DUPLICATE KEY UPDATE` syntax
+    for MySQL.
 
-    *Ryuta Kamizono*
+    *Bob Lail*
 
-*   Fix `save` in `after_create_commit` won't invoke extra `after_create_commit`.
+*   Add `rails db:seed:replant` that truncates tables of each database
+    for current environment and loads the seeds.
 
-    Fixes #32831.
+    *bogdanvlviv*, *DHH*
 
-    *Ryuta Kamizono*
+*   Add `ActiveRecord::Base.connection.truncate` for SQLite3 adapter.
 
-*   Fix logic on disabling commit callbacks so they are not called unexpectedly when errors occur.
+    *bogdanvlviv*
 
-    *Brian Durand*
+*   Deprecate mismatched collation comparison for uniqueness validator.
 
-*   Fix parent record should not get saved with duplicate children records.
+    Uniqueness validator will no longer enforce case sensitive comparison in Rails 6.1.
+    To continue case sensitive comparison on the case insensitive column,
+    pass `case_sensitive: true` option explicitly to the uniqueness validator.
 
-    Fixes #32940.
+    *Ryuta Kamizono*
 
-    *Santosh Wadghule*
+*   Add `reselect` method. This is a short-hand for `unscope(:select).select(fields)`.
 
-*   Fix that association's after_touch is not called with counter cache.
+    Fixes #27340.
 
-    Fixes #31559.
+    *Willian Gustavo Veiga*
 
-    *Ryuta Kamizono*
+*   Add negative scopes for all enum values.
 
-*   `becomes` should clear the mutation tracker which is created in `after_initialize`.
+    Example:
 
-    Fixes #32867.
+        class Post < ActiveRecord::Base
+          enum status: %i[ drafted active trashed ]
+        end
 
-    *Ryuta Kamizono*
+        Post.not_drafted # => where.not(status: :drafted)
+        Post.not_active  # => where.not(status: :active)
+        Post.not_trashed # => where.not(status: :trashed)
 
-*   Allow a belonging to parent object to be created from a new record.
+    *DHH*
 
-    *Jolyon Pawlyn*
+*   Fix different `count` calculation when using `size` with manual `select` with DISTINCT.
 
-*   Fix that building record with assigning multiple has_one associations
-    wrongly persists through record.
+    Fixes #35214.
 
-    Fixes #32511.
+    *Juani Villarejo*
 
-    *Sam DeCesare*
 
-*   Fix relation merging when one of the relations is going to skip the
-    query cache.
+## Rails 6.0.0.beta3 (March 11, 2019) ##
 
-    *James Williams*
+*   No changes.
 
 
-## Rails 5.2.0 (April 09, 2018) ##
+## Rails 6.0.0.beta2 (February 25, 2019) ##
 
-*   MySQL: Support mysql2 0.5.x.
+*   Fix prepared statements caching to be enabled even when query caching is enabled.
 
-    *Aaron Stone*
+    *Ryuta Kamizono*
 
-*   Apply time column precision on assignment.
+*   Ensure `update_all` series cares about optimistic locking.
 
-    PR #20317 changed the behavior of datetime columns so that when they
-    have a specified precision then on assignment the value is rounded to
-    that precision. This behavior is now applied to time columns as well.
+    *Ryuta Kamizono*
 
-    Fixes #30301.
+*   Don't allow `where` with non numeric string matches to 0 values.
 
-    *Andrew White*
+    *Ryuta Kamizono*
 
-*   Normalize time column values for SQLite database.
+*   Introduce `ActiveRecord::Relation#destroy_by` and `ActiveRecord::Relation#delete_by`.
 
-    For legacy reasons, time columns in SQLite are stored as full datetimes
-    because until #24542 the quoting for time columns didn't remove the date
-    component. To ensure that values are consistent we now normalize the
-    date component to 2001-01-01 on reading and writing.
+    `destroy_by` allows relation to find all the records matching the condition and perform
+    `destroy_all` on the matched records.
 
-    *Andrew White*
+    Example:
 
-*   Ensure that the date component is removed when quoting times.
+        Person.destroy_by(name: 'David')
+        Person.destroy_by(name: 'David', rating: 4)
 
-    PR #24542 altered the quoting for time columns so that the date component
-    was removed however it only removed it when it was 2001-01-01. Now the
-    date component is removed irrespective of what the date is.
+        david = Person.find_by(name: 'David')
+        david.posts.destroy_by(id: [1, 2, 3])
 
-    *Andrew White*
+    `delete_by` allows relation to find all the records matching the condition and perform
+    `delete_all` on the matched records.
 
-*   Fix `dependent: :destroy` issue for has_one/belongs_to relationship where
-    the parent class was getting deleted when the child was not.
+    Example:
 
-    Fixes #32022.
+        Person.delete_by(name: 'David')
+        Person.delete_by(name: 'David', rating: 4)
 
-    *Fernando Gorodscy*
+        david = Person.find_by(name: 'David')
+        david.posts.delete_by(id: [1, 2, 3])
 
-*   Whitelist `NULLS FIRST` and `NULLS LAST` in order clauses too.
+    *Abhay Nikam*
 
-    *Xavier Noria*
+*   Don't allow `where` with invalid value matches to nil values.
 
-*   Fix that after commit callbacks on update does not triggered when optimistic locking is enabled.
+    Fixes #33624.
 
     *Ryuta Kamizono*
 
-*   Fix `#columns_for_distinct` of MySQL and PostgreSQL to make
-    `ActiveRecord::FinderMethods#limited_ids_for` use correct primary key values
-    even if `ORDER BY` columns include other table's primary key.
+*   SQLite3: Implement `add_foreign_key` and `remove_foreign_key`.
 
-    Fixes #28364.
-
-    *Takumi Kagiyama*
-
-*   Make `reflection.klass` raise if `polymorphic?` not to be misused.
+    *Ryuta Kamizono*
 
-    Fixes #31876.
+*   Deprecate using class level querying methods if the receiver scope
+    regarded as leaked. Use `klass.unscoped` to avoid the leaking scope.
 
     *Ryuta Kamizono*
 
-*   PostgreSQL: Allow pg-1.0 gem to be used with Active Record.
+*   Allow applications to automatically switch connections.
 
-    *Lars Kanis*
+    Adds a middleware and configuration options that can be used in your
+    application to automatically switch between the writing and reading
+    database connections.
 
-*   Deprecate `expand_hash_conditions_for_aggregates` without replacement.
-    Using a `Relation` for performing queries is the prefered API.
+    `GET` and `HEAD` requests will read from the replica unless there was
+    a write in the last 2 seconds, otherwise they will read from the primary.
+    Non-get requests will always write to the primary. The middleware accepts
+    an argument for a Resolver class and an Operations class where you are able
+    to change how the auto-switcher works to be most beneficial for your
+    application.
 
-    *Ryuta Kamizono*
-
-*   Fix not expanded problem when passing an Array object as argument to the where method using `composed_of` column.
+    To use the middleware in your application you can use the following
+    configuration options:
 
     ```
-    david_balance = customers(:david).balance
-    Customer.where(balance: [david_balance]).to_sql
-
-    # Before: WHERE `customers`.`balance` = NULL
-    # After : WHERE `customers`.`balance` = 50
+    config.active_record.database_selector = { delay: 2.seconds }
+    config.active_record.database_resolver = ActiveRecord::Middleware::DatabaseSelector::Resolver
+    config.active_record.database_resolver_context = ActiveRecord::Middleware::DatabaseSelector::Resolver::Session
     ```
 
-    Fixes #31723.
+    To change the database selection strategy, pass a custom class to the
+    configuration options:
 
-    *Yutaro Kanagawa*
+    ```
+    config.active_record.database_selector = { delay: 10.seconds }
+    config.active_record.database_resolver = MyResolver
+    config.active_record.database_resolver_context = MyResolver::MyCookies
+    ```
 
-*   Fix `count(:all)` with eager loading and having an order other than the driving table.
+    *Eileen M. Uchitelle*
 
-    Fixes #31783.
+*   MySQL: Support `:size` option to change text and blob size.
 
     *Ryuta Kamizono*
 
-*   Clear the transaction state when an Active Record object is duped.
+*   Make `t.timestamps` with precision by default.
 
-    Fixes #31670.
-
-    *Yuriy Ustushenko*
-
-*   Support for PostgreSQL foreign tables.
-
-    *fatkodima*
+    *Ryuta Kamizono*
 
-*   Fix relation merger issue with `left_outer_joins`.
 
-    *Mehmet Emin İNAÇ*
+## Rails 6.0.0.beta1 (January 18, 2019) ##
 
-*   Don't allow destroyed object mutation after `save` or `save!` is called.
+*   Remove deprecated `#set_state` from the transaction object.
 
-    *Ryuta Kamizono*
+    *Rafael Mendonça França*
 
-*   Take into account association conditions when deleting through records.
+*   Remove deprecated `#supports_statement_cache?` from the database adapters.
 
-    Fixes #18424.
+    *Rafael Mendonça França*
 
-    *Piotr Jakubowski*
+*   Remove deprecated `#insert_fixtures` from the database adapters.
 
-*   Fix nested `has_many :through` associations on unpersisted parent instances.
+    *Rafael Mendonça França*
 
-    For example, if you have
+*   Remove deprecated `ActiveRecord::ConnectionAdapters::SQLite3Adapter#valid_alter_table_type?`.
 
-        class Post < ActiveRecord::Base
-          belongs_to :author
-          has_many :books, through: :author
-          has_many :subscriptions, through: :books
-        end
+    *Rafael Mendonça França*
 
-        class Author < ActiveRecord::Base
-          has_one :post
-          has_many :books
-          has_many :subscriptions, through: :books
-        end
+*   Do not allow passing the column name to `sum` when a block is passed.
 
-        class Book < ActiveRecord::Base
-          belongs_to :author
-          has_many :subscriptions
-        end
+    *Rafael Mendonça França*
 
-        class Subscription < ActiveRecord::Base
-          belongs_to :book
-        end
+*   Do not allow passing the column name to `count` when a block is passed.
 
-    Before:
+    *Rafael Mendonça França*
 
-    If `post` is not persisted, then `post.subscriptions` will be empty.
+*   Remove delegation of missing methods in a relation to arel.
 
-    After:
+    *Rafael Mendonça França*
 
-    If `post` is not persisted, then `post.subscriptions` can be set and used
-    just like it would if `post` were persisted.
+*   Remove delegation of missing methods in a relation to private methods of the class.
 
-    Fixes #16313.
+    *Rafael Mendonça França*
 
-    *Zoltan Kiss*
+*   Deprecate `config.activerecord.sqlite3.represent_boolean_as_integer`.
 
-*   Fixed inconsistency with `first(n)` when used with `limit()`.
-    The `first(n)` finder now respects the `limit()`, making it consistent
-    with `relation.to_a.first(n)`, and also with the behavior of `last(n)`.
+    *Rafael Mendonça França*
 
-    Fixes #23979.
+*   Change `SQLite3Adapter` to always represent boolean values as integers.
 
-    *Brian Christian*
+    *Rafael Mendonça França*
 
-*   Use `count(:all)` in `HasManyAssociation#count_records` to prevent invalid
-    SQL queries for association counting.
+*   Remove ability to specify a timestamp name for `#cache_key`.
 
-    *Klas Eskilson*
+    *Rafael Mendonça França*
 
-*   Fix to invoke callbacks when using `update_attribute`.
+*   Remove deprecated `ActiveRecord::Migrator.migrations_path=`.
 
-    *Mike Busch*
+    *Rafael Mendonça França*
 
-*   Fix `count(:all)` to correctly work `distinct` with custom SELECT list.
+*   Remove deprecated `expand_hash_conditions_for_aggregates`.
 
-    *Ryuta Kamizono*
+    *Rafael Mendonça França*
 
-*   Using subselect for `delete_all` with `limit` or `offset`.
+*   Set polymorphic type column to NULL on `dependent: :nullify` strategy.
 
-    *Ryuta Kamizono*
+    On polymorphic associations both the foreign key and the foreign type columns will be set to NULL.
 
-*   Undefine attribute methods on descendants when resetting column
-    information.
+    *Laerti Papa*
 
-    *Chris Salzberg*
+*   Allow permitted instance of `ActionController::Parameters` as argument of `ActiveRecord::Relation#exists?`.
 
-*   Log database query callers.
+    *Gannon McGibbon*
 
-    Add `verbose_query_logs` configuration option to display the caller
-    of database queries in the log to facilitate N+1 query resolution
-    and other debugging.
+*   Add support for endless ranges introduces in Ruby 2.6.
 
-    Enabled in development only for new and upgraded applications. Not
-    recommended for use in the production environment since it relies
-    on Ruby's `Kernel#caller_locations` which is fairly slow.
+    *Greg Navis*
 
-    *Olivier Lacan*
+*   Deprecate passing `migrations_paths` to `connection.assume_migrated_upto_version`.
 
-*   Fix conflicts `counter_cache` with `touch: true` by optimistic locking.
+    *Ryuta Kamizono*
 
-    ```
-    # create_table :posts do |t|
-    #   t.integer :comments_count, default: 0
-    #   t.integer :lock_version
-    #   t.timestamps
-    # end
-    class Post < ApplicationRecord
-    end
+*   MySQL: `ROW_FORMAT=DYNAMIC` create table option by default.
 
-    # create_table :comments do |t|
-    #   t.belongs_to :post
-    # end
-    class Comment < ApplicationRecord
-      belongs_to :post, touch: true, counter_cache: true
-    end
-    ```
+    Since MySQL 5.7.9, the `innodb_default_row_format` option defines the default row
+    format for InnoDB tables. The default setting is `DYNAMIC`.
+    The row format is required for indexing on `varchar(255)` with `utf8mb4` columns.
 
-    Before:
-    ```
-    post = Post.create!
-    # => begin transaction
-         INSERT INTO "posts" ("created_at", "updated_at", "lock_version")
-         VALUES ("2017-12-11 21:27:11.387397", "2017-12-11 21:27:11.387397", 0)
-         commit transaction
-
-    comment = Comment.create!(post: post)
-    # => begin transaction
-         INSERT INTO "comments" ("post_id") VALUES (1)
-
-         UPDATE "posts" SET "comments_count" = COALESCE("comments_count", 0) + 1,
-         "lock_version" = COALESCE("lock_version", 0) + 1 WHERE "posts"."id" = 1
-
-         UPDATE "posts" SET "updated_at" = '2017-12-11 21:27:11.398330',
-         "lock_version" = 1 WHERE "posts"."id" = 1 AND "posts"."lock_version" = 0
-         rollback transaction
-    # => ActiveRecord::StaleObjectError: Attempted to touch a stale object: Post.
-
-    Comment.take.destroy!
-    # => begin transaction
-         DELETE FROM "comments" WHERE "comments"."id" = 1
-
-         UPDATE "posts" SET "comments_count" = COALESCE("comments_count", 0) - 1,
-         "lock_version" = COALESCE("lock_version", 0) + 1 WHERE "posts"."id" = 1
-
-         UPDATE "posts" SET "updated_at" = '2017-12-11 21:42:47.785901',
-         "lock_version" = 1 WHERE "posts"."id" = 1 AND "posts"."lock_version" = 0
-         rollback transaction
-    # => ActiveRecord::StaleObjectError: Attempted to touch a stale object: Post.
-    ```
+    *Ryuta Kamizono*
 
-    After:
-    ```
-    post = Post.create!
-    # => begin transaction
-         INSERT INTO "posts" ("created_at", "updated_at", "lock_version")
-         VALUES ("2017-12-11 21:27:11.387397", "2017-12-11 21:27:11.387397", 0)
-         commit transaction
-
-    comment = Comment.create!(post: post)
-    # => begin transaction
-         INSERT INTO "comments" ("post_id") VALUES (1)
-
-         UPDATE "posts" SET "comments_count" = COALESCE("comments_count", 0) + 1,
-         "lock_version" = COALESCE("lock_version", 0) + 1,
-         "updated_at" = '2017-12-11 21:37:09.802642' WHERE "posts"."id" = 1
-         commit transaction
-
-    comment.destroy!
-    # => begin transaction
-         DELETE FROM "comments" WHERE "comments"."id" = 1
-
-         UPDATE "posts" SET "comments_count" = COALESCE("comments_count", 0) - 1,
-         "lock_version" = COALESCE("lock_version", 0) + 1,
-         "updated_at" = '2017-12-11 21:39:02.685520' WHERE "posts"."id" = 1
-         commit transaction
-    ```
+*   Fix join table column quoting with SQLite.
 
-    Fixes #31199.
+    *Gannon McGibbon*
 
-    *bogdanvlviv*
+*   Allow disabling scopes generated by `ActiveRecord.enum`.
 
-*   Add support for PostgreSQL operator classes to `add_index`.
+    *Alfred Dominic*
 
-    Example:
+*   Ensure that `delete_all` on collection proxy returns affected count.
 
-        add_index :users, :name, using: :gist, opclass: { name: :gist_trgm_ops }
+    *Ryuta Kamizono*
 
-    *Greg Navis*
+*   Reset scope after delete on collection association to clear stale offsets of removed records.
 
-*   Don't allow scopes to be defined which conflict with instance methods on `Relation`.
+    *Gannon McGibbon*
 
-    Fixes #31120.
+*   Add the ability to prevent writes to a database for the duration of a block.
 
-    *kinnrot*
+    Allows the application to prevent writes to a database. This can be useful when
+    you're building out multiple databases and want to make sure you're not sending
+    writes when you want a read.
 
-*   Add new error class `QueryCanceled` which will be raised
-    when canceling statement due to user request.
+    If `while_preventing_writes` is called and the query is considered a write
+    query the database will raise an exception regardless of whether the database
+    user is able to write.
 
-    *Ryuta Kamizono*
+    This is not meant to be a catch-all for write queries but rather a way to enforce
+    read-only queries without opening a second connection. One purpose of this is to
+    catch accidental writes, not all writes.
 
-*   Add `#up_only` to database migrations for code that is only relevant when
-    migrating up, e.g. populating a new column.
+    *Eileen M. Uchitelle*
 
-    *Rich Daley*
+*   Allow aliased attributes to be used in `#update_columns` and `#update`.
 
-*   Require raw SQL fragments to be explicitly marked when used in
-    relation query methods.
+    *Gannon McGibbon*
 
-    Before:
-    ```
-    Article.order("LENGTH(title)")
-    ```
+*   Allow spaces in postgres table names.
 
-    After:
-    ```
-    Article.order(Arel.sql("LENGTH(title)"))
-    ```
+    Fixes issue where "user post" is misinterpreted as "\"user\".\"post\"" when quoting table names with the postgres adapter.
 
-    This prevents SQL injection if applications use the [strongly
-    discouraged] form `Article.order(params[:my_order])`, under the
-    mistaken belief that only column names will be accepted.
+    *Gannon McGibbon*
 
-    Raw SQL strings will now cause a deprecation warning, which will
-    become an UnknownAttributeReference error in Rails 6.0. Applications
-    can opt in to the future behavior by setting `allow_unsafe_raw_sql`
-    to `:disabled`.
+*   Cached `columns_hash` fields should be excluded from `ResultSet#column_types`.
 
-    Common and judged-safe string values (such as simple column
-    references) are unaffected:
-    ```
-    Article.order("title DESC")
-    ```
+    PR #34528 addresses the inconsistent behaviour when attribute is defined for an ignored column. The following test
+    was passing for SQLite and MySQL, but failed for PostgreSQL:
 
-    *Ben Toews*
+    ```ruby
+    class DeveloperName < ActiveRecord::Type::String
+      def deserialize(value)
+        "Developer: #{value}"
+      end
+    end
 
-*   `update_all` will now pass its values to `Type#cast` before passing them to
-    `Type#serialize`. This means that `update_all(foo: 'true')` will properly
-    persist a boolean.
+    class AttributedDeveloper < ActiveRecord::Base
+      self.table_name = "developers"
 
-    *Sean Griffin*
+      attribute :name, DeveloperName.new
 
-*   Add new error class `StatementTimeout` which will be raised
-    when statement timeout exceeded.
+      self.ignored_columns += ["name"]
+    end
 
-    *Ryuta Kamizono*
+    developer = AttributedDeveloper.create
+    developer.update_column :name, "name"
 
-*   Fix `bin/rails db:migrate` with specified `VERSION`.
-    `bin/rails db:migrate` with empty VERSION behaves as without `VERSION`.
-    Check a format of `VERSION`: Allow a migration version number
-    or name of a migration file. Raise error if format of `VERSION` is invalid.
-    Raise error if target migration doesn't exist.
+    loaded_developer = AttributedDeveloper.where(id: developer.id).select("*").first
+    puts loaded_developer.name # should be "Developer: name" but it's just "name"
+    ```
 
-    *bogdanvlviv*
+    *Dmitry Tsepelev*
 
-*   Fixed a bug where column orders for an index weren't written to
-    `db/schema.rb` when using the sqlite adapter.
+*   Make the implicit order column configurable.
 
-    Fixes #30902.
+    When calling ordered finder methods such as `first` or `last` without an
+    explicit order clause, ActiveRecord sorts records by primary key. This can
+    result in unpredictable and surprising behaviour when the primary key is
+    not an auto-incrementing integer, for example when it's a UUID. This change
+    makes it possible to override the column used for implicit ordering such
+    that `first` and `last` will return more predictable results.
 
-    *Paul Kuruvilla*
+    Example:
 
-*   Remove deprecated method `#sanitize_conditions`.
+        class Project < ActiveRecord::Base
+          self.implicit_order_column = "created_at"
+        end
 
-    *Rafael Mendonça França*
+    *Tekin Suleyman*
 
-*   Remove deprecated method `#scope_chain`.
+*   Bump minimum PostgreSQL version to 9.3.
 
-    *Rafael Mendonça França*
+    *Yasuo Honda*
 
-*   Remove deprecated configuration `.error_on_ignored_order_or_limit`.
+*   Values of enum are frozen, raising an error when attempting to modify them.
 
-    *Rafael Mendonça França*
+    *Emmanuel Byrd*
 
-*   Remove deprecated arguments from `#verify!`.
+*   Move `ActiveRecord::StatementInvalid` SQL to error property and include binds as separate error property.
 
-    *Rafael Mendonça França*
+    `ActiveRecord::ConnectionAdapters::AbstractAdapter#translate_exception_class` now requires `binds` to be passed as the last argument.
 
-*   Remove deprecated argument `name` from `#indexes`.
+    `ActiveRecord::ConnectionAdapters::AbstractAdapter#translate_exception` now requires `message`, `sql`, and `binds` to be passed as keyword arguments.
 
-    *Rafael Mendonça França*
+    Subclasses of `ActiveRecord::StatementInvalid` must now provide `sql:` and `binds:` arguments to `super`.
 
-*   Remove deprecated method `ActiveRecord::Migrator.schema_migrations_table_name`.
+    Example:
 
-    *Rafael Mendonça França*
+    ```
+    class MySubclassedError < ActiveRecord::StatementInvalid
+      def initialize(message, sql:, binds:)
+        super(message, sql: sql, binds: binds)
+      end
+    end
+    ```
 
-*   Remove deprecated method `supports_primary_key?`.
+    *Gannon McGibbon*
 
-    *Rafael Mendonça França*
+*   Add an `:if_not_exists` option to `create_table`.
 
-*   Remove deprecated method `supports_migrations?`.
+    Example:
 
-    *Rafael Mendonça França*
+        create_table :posts, if_not_exists: true do |t|
+          t.string :title
+        end
 
-*   Remove deprecated methods `initialize_schema_migrations_table` and `initialize_internal_metadata_table`.
+    That would execute:
 
-    *Rafael Mendonça França*
+        CREATE TABLE IF NOT EXISTS posts (
+          ...
+        )
 
-*   Raises when calling `lock!` in a dirty record.
+    If the table already exists, `if_not_exists: false` (the default) raises an
+    exception whereas `if_not_exists: true` does nothing.
 
-    *Rafael Mendonça França*
+    *fatkodima*, *Stefan Kanev*
 
-*   Remove deprecated support to passing a class to `:class_name` on associations.
+*   Defining an Enum as a Hash with blank key, or as an Array with a blank value, now raises an `ArgumentError`.
 
-    *Rafael Mendonça França*
+    *Christophe Maximin*
 
-*   Remove deprecated argument `default` from `index_name_exists?`.
+*   Adds support for multiple databases to `rails db:schema:cache:dump` and `rails db:schema:cache:clear`.
 
-    *Rafael Mendonça França*
+    *Gannon McGibbon*
 
-*   Remove deprecated support to `quoted_id` when typecasting an Active Record object.
+*   `update_columns` now correctly raises `ActiveModel::MissingAttributeError`
+    if the attribute does not exist.
 
-    *Rafael Mendonça França*
+    *Sean Griffin*
 
-*   Fix `bin/rails db:setup` and `bin/rails db:test:prepare` create wrong
-    ar_internal_metadata's data for a test database.
+*   Add support for hash and URL configs in database hash of `ActiveRecord::Base.connected_to`.
 
-    Before:
-    ```
-    $ RAILS_ENV=test rails dbconsole
-    > SELECT * FROM ar_internal_metadata;
-    key|value|created_at|updated_at
-    environment|development|2017-09-11 23:14:10.815679|2017-09-11 23:14:10.815679
-    ```
+    ````
+    User.connected_to(database: { writing: "postgres://foo" }) do
+      User.create!(name: "Gannon")
+    end
 
-    After:
-    ```
-    $ RAILS_ENV=test rails dbconsole
-    > SELECT * FROM ar_internal_metadata;
-    key|value|created_at|updated_at
-    environment|test|2017-09-11 23:14:10.815679|2017-09-11 23:14:10.815679
-    ```
+    config = { "adapter" => "sqlite3", "database" => "db/readonly.sqlite3" }
+    User.connected_to(database: { reading: config }) do
+      User.count
+    end
+    ````
 
-    Fixes #26731.
+    *Gannon McGibbon*
 
-    *bogdanvlviv*
+*   Support default expression for MySQL.
 
-*   Fix longer sequence name detection for serial columns.
+    MySQL 8.0.13 and higher supports default value to be a function or expression.
 
-    Fixes #28332.
+    https://dev.mysql.com/doc/refman/8.0/en/create-table.html
 
     *Ryuta Kamizono*
 
-*   MySQL: Don't lose `auto_increment: true` in the `db/schema.rb`.
-
-    Fixes #30894.
-
-    *Ryuta Kamizono*
+*   Support expression indexes for MySQL.
 
-*   Fix `COUNT(DISTINCT ...)` for `GROUP BY` with `ORDER BY` and `LIMIT`.
+    MySQL 8.0.13 and higher supports functional key parts that index
+    expression values rather than column or column prefix values.
 
-    Fixes #30886.
+    https://dev.mysql.com/doc/refman/8.0/en/create-index.html
 
     *Ryuta Kamizono*
 
-*   PostgreSQL `tsrange` now preserves subsecond precision.
-
-    PostgreSQL 9.1+ introduced range types, and Rails added support for using
-    this datatype in Active Record. However, the serialization of
-    `PostgreSQL::OID::Range` was incomplete, because it did not properly
-    cast the bounds that make up the range. This led to subseconds being
-    dropped in SQL commands:
+*   Fix collection cache key with limit and custom select to avoid ambiguous timestamp column error.
 
-    Before:
+    Fixes #33056.
 
-        connection.type_cast(tsrange.serialize(range_value))
-        # => "[2010-01-01 13:30:00 UTC,2011-02-02 19:30:00 UTC)"
+    *Federico Martinez*
 
-    Now:
+*   Add basic API for connection switching to support multiple databases.
 
-        connection.type_cast(tsrange.serialize(range_value))
-        # => "[2010-01-01 13:30:00.670277,2011-02-02 19:30:00.745125)"
+    1) Adds a `connects_to` method for models to connect to multiple databases. Example:
 
-    *Thomas Cannon*
+    ```
+    class AnimalsModel < ApplicationRecord
+      self.abstract_class = true
 
-*   Passing a `Set` to `Relation#where` now behaves the same as passing an
-    array.
+      connects_to database: { writing: :animals_primary, reading: :animals_replica }
+    end
 
-    *Sean Griffin*
+    class Dog < AnimalsModel
+      # connected to both the animals_primary db for writing and the animals_replica for reading
+    end
+    ```
 
-*   Use given algorithm while removing index from database.
+    2) Adds a `connected_to` block method for switching connection roles or connecting to
+    a database that the model didn't connect to. Connecting to the database in this block is
+    useful when you have another defined connection, for example `slow_replica` that you don't
+    want to connect to by default but need in the console, or a specific code block.
 
-    Fixes #24190.
+    ```
+    ActiveRecord::Base.connected_to(role: :reading) do
+      Dog.first # finds dog from replica connected to AnimalsBase
+      Book.first # doesn't have a reading connection, will raise an error
+    end
+    ```
 
-    *Mehmet Emin İNAÇ*
+    ```
+    ActiveRecord::Base.connected_to(database: :slow_replica) do
+      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
+    end
+    ```
 
-*   Update payload names for `sql.active_record` instrumentation to be
-    more descriptive.
+    *Eileen M. Uchitelle*
 
-    Fixes #30586.
+*   Enum raises on invalid definition values
 
-    *Jeremy Green*
+    When defining a Hash enum it can be easy to use `[]` instead of `{}`. This
+    commit checks that only valid definition values are provided, those can
+    be a Hash, an array of Symbols or an array of Strings. Otherwise it
+    raises an `ArgumentError`.
 
-*   Add new error class `LockWaitTimeout` which will be raised
-    when lock wait timeout exceeded.
+    Fixes #33961
 
-    *Gabriel Courtemanche*
+    *Alberto Almagro*
 
-*   Remove deprecated `#migration_keys`.
+*   Reloading associations now clears the Query Cache like `Persistence#reload` does.
 
-    *Ryuta Kamizono*
+    ```
+    class Post < ActiveRecord::Base
+      has_one :category
+      belongs_to :author
+      has_many :comments
+    end
 
-*   Automatically guess the inverse associations for STI.
+    # Each of the following will now clear the query cache.
+    post.reload_category
+    post.reload_author
+    post.comments.reload
+    ```
 
-    *Yuichiro Kaneko*
+    *Christophe Maximin*
 
-*   Ensure `sum` honors `distinct` on `has_many :through` associations.
+*   Added `index` option for `change_table` migration helpers.
+    With this change you can create indexes while adding new
+    columns into the existing tables.
 
-    Fixes #16791.
+    Example:
 
-    *Aaron Wortham*
+        change_table(:languages) do |t|
+          t.string :country_code, index: true
+        end
 
-*   Add `binary` fixture helper method.
+    *Mehmet Emin İNAÇ*
 
-    *Atsushi Yoshida*
+*   Fix `transaction` reverting for migrations.
 
-*   When using `Relation#or`, extract the common conditions and put them before the OR condition.
+    Before: Commands inside a `transaction` in a reverted migration ran uninverted.
+    Now: This change fixes that by reverting commands inside `transaction` block.
 
-    *Maxime Handfield Lapointe*
+    *fatkodima*, *David Verhasselt*
 
-*   `Relation#or` now accepts two relations who have different values for
-    `references` only, as `references` can be implicitly called by `where`.
+*   Raise an error instead of scanning the filesystem root when `fixture_path` is blank.
 
-    Fixes #29411.
+    *Gannon McGibbon*, *Max Albrecht*
 
-    *Sean Griffin*
+*   Allow `ActiveRecord::Base.configurations=` to be set with a symbolized hash.
 
-*   `ApplicationRecord` is no longer generated when generating models. If you
-    need to generate it, it can be created with `rails g application_record`.
+    *Gannon McGibbon*
 
-    *Lisa Ugray*
+*   Don't update counter cache unless the record is actually saved.
 
-*   Fix `COUNT(DISTINCT ...)` with `ORDER BY` and `LIMIT` to keep the existing select list.
+    Fixes #31493, #33113, #33117.
 
     *Ryuta Kamizono*
 
-*   When a `has_one` association is destroyed by `dependent: destroy`,
-    `destroyed_by_association` will now be set to the reflection, matching the
-    behaviour of `has_many` associations.
+*   Deprecate `ActiveRecord::Result#to_hash` in favor of `ActiveRecord::Result#to_a`.
 
-    *Lisa Ugray*
+    *Gannon McGibbon*, *Kevin Cheng*
 
-*   Fix `unscoped(where: [columns])` removing the wrong bind values.
-
-    When the `where` is called on a relation after a `or`, unscoping the column of that later `where` removed
-    bind values used by the `or` instead. (possibly other cases too)
+*   SQLite3 adapter supports expression indexes.
 
     ```
-    Post.where(id: 1).or(Post.where(id: 2)).where(foo: 3).unscope(where: :foo).to_sql
-    # Currently:
-    #     SELECT "posts".* FROM "posts" WHERE ("posts"."id" = 2 OR "posts"."id" = 3)
-    # With fix:
-    #     SELECT "posts".* FROM "posts" WHERE ("posts"."id" = 1 OR "posts"."id" = 2)
+    create_table :users do |t|
+      t.string :email
+    end
+
+    add_index :users, 'lower(email)', name: 'index_users_on_email', unique: true
     ```
 
-    *Maxime Handfield Lapointe*
+    *Gray Kemmey*
 
-*   Values constructed using multi-parameter assignment will now use the
-    post-type-cast value for rendering in single-field form inputs.
+*   Allow subclasses to redefine autosave callbacks for associated records.
 
-    *Sean Griffin*
+    Fixes #33305.
 
-*   `Relation#joins` is no longer affected by the target model's
-    `current_scope`, with the exception of `unscoped`.
+    *Andrey Subbota*
 
-    Fixes #29338.
+*   Bump minimum MySQL version to 5.5.8.
 
-    *Sean Griffin*
+    *Yasuo Honda*
 
-*   Change sqlite3 boolean serialization to use 1 and 0.
+*   Use MySQL utf8mb4 character set by default.
 
-    SQLite natively recognizes 1 and 0 as true and false, but does not natively
-    recognize 't' and 'f' as was previously serialized.
+    `utf8mb4` character set with 4-Byte encoding supports supplementary characters including emoji.
+    The previous default 3-Byte encoding character set `utf8` is not enough to support them.
 
-    This change in serialization requires a migration of stored boolean data
-    for SQLite databases, so it's implemented behind a configuration flag
-    whose default false value is deprecated.
+    *Yasuo Honda*
 
-    *Lisa Ugray*
+*   Fix duplicated record creation when using nested attributes with `create_with`.
 
-*   Skip query caching when working with batches of records (`find_each`, `find_in_batches`,
-    `in_batches`).
+    *Darwin Wu*
 
-    Previously, records would be fetched in batches, but all records would be retained in memory
-    until the end of the request or job.
+*   Configuration item `config.filter_parameters` could also filter out
+    sensitive values of database columns when calling `#inspect`.
+    We also added `ActiveRecord::Base::filter_attributes`/`=` in order to
+    specify sensitive attributes to specific model.
 
-    *Eugene Kenny*
+    ```
+    Rails.application.config.filter_parameters += [:credit_card_number, /phone/]
+    Account.last.inspect # => #<Account id: 123, name: "DHH", credit_card_number: [FILTERED], telephone_number: [FILTERED] ...>
+    SecureAccount.filter_attributes += [:name]
+    SecureAccount.last.inspect # => #<SecureAccount id: 42, name: [FILTERED], credit_card_number: [FILTERED] ...>
+    ```
 
-*   Prevent errors raised by `sql.active_record` notification subscribers from being converted into
-    `ActiveRecord::StatementInvalid` exceptions.
+    *Zhang Kang*, *Yoshiyuki Kinjo*
 
-    *Dennis Taylor*
+*   Deprecate `column_name_length`, `table_name_length`, `columns_per_table`,
+    `indexes_per_table`, `columns_per_multicolumn_index`, `sql_query_length`,
+    and `joins_per_query` methods in `DatabaseLimits`.
 
-*   Fix eager loading/preloading association with scope including joins.
+    *Ryuta Kamizono*
 
-    Fixes #28324.
+*   `ActiveRecord::Base.configurations` now returns an object.
 
-    *Ryuta Kamizono*
+    `ActiveRecord::Base.configurations` used to return a hash, but this
+    is an inflexible data model. In order to improve multiple-database
+    handling in Rails, we've changed this to return an object. Some methods
+    are provided to make the object behave hash-like in order to ease the
+    transition process. Since most applications don't manipulate the hash
+    we've decided to add backwards-compatible functionality that will throw
+    a deprecation warning if used, however calling `ActiveRecord::Base.configurations`
+    will use the new version internally and externally.
 
-*   Fix transactions to apply state to child transactions.
+    For example, the following `database.yml`:
 
-    Previously, if you had a nested transaction and the outer transaction was rolledback, the record from the
-    inner transaction would still be marked as persisted.
+    ```
+    development:
+      adapter: sqlite3
+      database: db/development.sqlite3
+    ```
 
-    This change fixes that by applying the state of the parent transaction to the child transaction when the
-    parent transaction is rolledback. This will correctly mark records from the inner transaction as not persisted.
+    Used to become a hash:
 
-    *Eileen M. Uchitelle*, *Aaron Patterson*
+    ```
+    { "development" => { "adapter" => "sqlite3", "database" => "db/development.sqlite3" } }
+    ```
+
+    Is now converted into the following object:
 
-*   Deprecate `set_state` method in `TransactionState`.
+    ```
+    #<ActiveRecord::DatabaseConfigurations:0x00007fd1acbdf800 @configurations=[
+      #<ActiveRecord::DatabaseConfigurations::HashConfig:0x00007fd1acbded10 @env_name="development",
+        @spec_name="primary", @config={"adapter"=>"sqlite3", "database"=>"db/development.sqlite3"}>
+      ]
+    ```
 
-    Deprecated the `set_state` method in favor of setting the state via specific methods. If you need to mark the
-    state of the transaction you can now use `rollback!`, `commit!` or `nullify!` instead of
-    `set_state(:rolledback)`, `set_state(:committed)`, or `set_state(nil)`.
+    Iterating over the database configurations has also changed. Instead of
+    calling hash methods on the `configurations` hash directly, a new method `configs_for` has
+    been provided that allows you to select the correct configuration. `env_name` and
+    `spec_name` arguments are optional. For example, these return an array of
+    database config objects for the requested environment and a single database config object
+    will be returned for the requested environment and specification name respectively.
 
-    *Eileen M. Uchitelle*, *Aaron Patterson*
+    ```
+    ActiveRecord::Base.configurations.configs_for(env_name: "development")
+    ActiveRecord::Base.configurations.configs_for(env_name: "development", spec_name: "primary")
+    ```
 
-*   Deprecate delegating to `arel` in `Relation`.
+    *Eileen M. Uchitelle*, *Aaron Patterson*
 
-    *Ryuta Kamizono*
+*   Add database configuration to disable advisory locks.
 
-*   Query cache was unavailable when entering the `ActiveRecord::Base.cache` block
-    without being connected.
+    ```
+    production:
+      adapter: postgresql
+      advisory_locks: false
+    ```
 
-    *Tsukasa Oishi*
+    *Guo Xiang*
 
-*   Previously, when building records using a `has_many :through` association,
-    if the child records were deleted before the parent was saved, they would
-    still be persisted. Now, if child records are deleted before the parent is saved
-    on a `has_many :through` association, the child records will not be persisted.
+*   SQLite3 adapter `alter_table` method restores foreign keys.
 
-    *Tobias Kraze*
+    *Yasuo Honda*
 
-*   Merging two relations representing nested joins no longer transforms the joins of
-    the merged relation into LEFT OUTER JOIN.
+*   Allow `:to_table` option to `invert_remove_foreign_key`.
 
     Example:
 
-    ```
-    Author.joins(:posts).merge(Post.joins(:comments))
-    # Before the change:
-    #=> SELECT ... FROM authors INNER JOIN posts ON ... LEFT OUTER JOIN comments ON...
+       remove_foreign_key :accounts, to_table: :owners
 
-    # After the change:
-    #=> SELECT ... FROM authors INNER JOIN posts ON ... INNER JOIN comments ON...
-    ```
+    *Nikolay Epifanov*, *Rich Chen*
 
-    *Maxime Handfield Lapointe*
+*   Add environment & load_config dependency to `bin/rake db:seed` to enable
+    seed load in environments without Rails and custom DB configuration
 
-*   `ActiveRecord::Persistence#touch` does not work well when optimistic locking enabled and
-    `locking_column`, without default value, is null in the database.
+    *Tobias Bielohlawek*
 
-    *bogdanvlviv*
+*   Fix default value for mysql time types with specified precision.
+
+    *Nikolay Kondratyev*
 
-*   Fix destroying existing object does not work well when optimistic locking enabled and
-    `locking_column` is null in the database.
+*   Fix `touch` option to behave consistently with `Persistence#touch` method.
 
-    *bogdanvlviv*
+    *Ryuta Kamizono*
 
-*   Use bulk INSERT to insert fixtures for better performance.
+*   Migrations raise when duplicate column definition.
 
-    *Kir Shatrov*
+    Fixes #33024.
 
-*   Prevent creation of bind param if casted value is nil.
+    *Federico Martinez*
 
-    *Ryuta Kamizono*
+*   Bump minimum SQLite version to 3.8
 
-*   Deprecate passing arguments and block at the same time to `count` and `sum` in `ActiveRecord::Calculations`.
+    *Yasuo Honda*
 
-    *Ryuta Kamizono*
+*   Fix parent record should not get saved with duplicate children records.
 
-*   Loading model schema from database is now thread-safe.
+    Fixes #32940.
 
-    Fixes #28589.
+    *Santosh Wadghule*
 
-    *Vikrant Chaudhary*, *David Abdemoulaie*
+*   Fix logic on disabling commit callbacks so they are not called unexpectedly when errors occur.
 
-*   Add `ActiveRecord::Base#cache_version` to support recyclable cache keys via the new versioned entries
-    in `ActiveSupport::Cache`. This also means that `ActiveRecord::Base#cache_key` will now return a stable key
-    that does not include a timestamp any more.
+    *Brian Durand*
 
-    NOTE: This feature is turned off by default, and `#cache_key` will still return cache keys with timestamps
-    until you set `ActiveRecord::Base.cache_versioning = true`. That's the setting for all new apps on Rails 5.2+
+*   Ensure `Associations::CollectionAssociation#size` and `Associations::CollectionAssociation#empty?`
+    use loaded association ids if present.
 
-    *DHH*
+    *Graham Turner*
 
-*   Respect `SchemaDumper.ignore_tables` in rake tasks for databases structure dump.
+*   Add support to preload associations of polymorphic associations when not all the records have the requested associations.
 
-    *Rusty Geldmacher*, *Guillermo Iguaran*
+    *Dana Sherson*
 
-*   Add type caster to `RuntimeReflection#alias_name`.
+*   Add `touch_all` method to `ActiveRecord::Relation`.
 
-    Fixes #28959.
+    Example:
 
-    *Jon Moss*
+        Person.where(name: "David").touch_all(time: Time.new(2020, 5, 16, 0, 0, 0))
 
-*   Deprecate `supports_statement_cache?`.
+    *fatkodima*, *duggiefresh*
 
-    *Ryuta Kamizono*
+*   Add `ActiveRecord::Base.base_class?` predicate.
 
-*   Raise error `UnknownMigrationVersionError` on the movement of migrations
-    when the current migration does not exist.
+    *Bogdan Gusiev*
 
-    *bogdanvlviv*
+*   Add custom prefix/suffix options to `ActiveRecord::Store.store_accessor`.
 
-*   Fix `bin/rails db:forward` first migration.
+    *Tan Huynh*, *Yukio Mizuta*
 
-    *bogdanvlviv*
+*   Rails 6 requires Ruby 2.5.0 or newer.
 
-*   Support Descending Indexes for MySQL.
+    *Jeremy Daer*, *Kasper Timm Hansen*
 
-    MySQL 8.0.1 and higher supports descending indexes: `DESC` in an index definition is no longer ignored.
-    See https://dev.mysql.com/doc/refman/8.0/en/descending-indexes.html.
+*   Deprecate `update_attributes`/`!` in favor of `update`/`!`.
 
-    *Ryuta Kamizono*
+    *Eddie Lebow*
 
-*   Fix inconsistency with changed attributes when overriding Active Record attribute reader.
+*   Add `ActiveRecord::Base.create_or_find_by`/`!` to deal with the SELECT/INSERT race condition in
+    `ActiveRecord::Base.find_or_create_by`/`!` by leaning on unique constraints in the database.
 
-    *bogdanvlviv*
+    *DHH*
 
-*   When calling the dynamic fixture accessor method with no arguments, it now returns all fixtures of this type.
-    Previously this method always returned an empty array.
+*   Add `Relation#pick` as short-hand for single-value plucks.
 
-    *Kevin McPhillips*
+    *DHH*
 
 
-Please check [5-1-stable](https://github.com/rails/rails/blob/5-1-stable/activerecord/CHANGELOG.md) for previous changes.
+Please check [5-2-stable](https://github.com/rails/rails/blob/5-2-stable/activerecord/CHANGELOG.md) for previous changes.