activerecord 3.2.22.5 → 5.2.8

data/CHANGELOG.md

@@ -1,1020 +1,1056 @@
-* Support Ruby 2.3 by not unexpectedly calling `.to_proc` on Hash objects
+## Rails 5.2.8 (May 09, 2022) ##
 
-    Fixes #25010
+*   No changes.
 
-    *tlrdstd*
 
-## Rails 3.2.22 (Jun 16, 2015) ##
+## Rails 5.2.7.1 (April 26, 2022) ##
 
-* No changes.
+*   No changes.
 
 
-## Rails 3.2.19 (Jul 2, 2014) ##
+## Rails 5.2.7 (March 10, 2022) ##
 
-*   Fix SQL Injection Vulnerability in 'bitstring' quoting.
+*   No changes.
 
-    Fixes CVE-2014-3482.
 
-    *Rafael Mendonça França*
+## Rails 5.2.6.3 (March 08, 2022) ##
 
+*   No changes.
 
-## Rails 3.2.18 (May 6, 2014) ##
 
-* No changes.
+## Rails 5.2.6.2 (February 11, 2022) ##
 
+*   No changes.
 
-## Rails 3.2.17 (Feb 18, 2014) ##
 
-* No changes.
+## Rails 5.2.6.1 (February 11, 2022) ##
 
+*   No changes.
 
-## Rails 3.2.16 (Dec 3, 2013) ##
 
-* No changes.
+## Rails 5.2.6 (May 05, 2021) ##
 
+*   No changes.
 
-## Rails 3.2.15 (Oct 16, 2013) ##
 
-*   When calling the method .find_or_initialize_by_* from a collection_proxy
-    it should set the inverse_of relation even when the entry was found on the db.
+## Rails 5.2.5 (March 26, 2021) ##
 
-    *arthurnn*
+*   No changes.
 
-*   Callbacks on has_many should access the in memory parent if a inverse_of is set.
 
-    *arthurnn*
+## Rails 5.2.4.6 (May 05, 2021) ##
 
-*   Fix `FinderMethods#last` unscoped primary key.
+*   No changes.
 
-    Fixes #11917.
 
-    *Eugene Kalenkovich*
+## Rails 5.2.4.5 (February 10, 2021) ##
 
-*   Load fixtures from linked folders.
+*   Fix possible DoS vector in PostgreSQL money type
 
-    *Kassio Borges*
+    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.
 
-*   When using optimistic locking, `update` was not passing the column to `quote_value`
-    to allow the connection adapter to properly determine how to quote the value. This was
-    affecting certain databases that use specific colmn types.
+    Thanks to @dee-see from Hackerone for this patch!
 
-    Fixes: #6763
+    [CVE-2021-22880]
 
-    *Alfred Wong*
+    *Aaron Patterson*
 
 
-## Rails 3.2.14 (Jul 22, 2013) ##
+## Rails 5.2.4.4 (September 09, 2020) ##
 
-*   Fix merge error when Equality LHS is non-attribute.
-    Backport of #7380.
+*   No changes.
 
-    *Karmes Alexander*
 
-*   Do not re-create destroyed association when saving the parent object.
+## Rails 5.2.4.3 (May 18, 2020) ##
 
-    Fixes #11450.
+*   No changes.
 
-    *Paul Nikitochkin*
+## Rails 5.2.4.2 (March 19, 2020) ##
 
-*   Do not shallow the original exception in `exec_cache` on PostgreSQL adapter.
+*   No changes.
 
-    Fixes #11260.
 
-    *Rafael Mendonça França*
+## Rails 5.2.4.1 (December 18, 2019) ##
 
-*   Fix `ActiveRecord::Store` incorrectly tracking changes of its attributes.
-    Fixes #10373.
+*   No changes.
 
-    *Janko Marohnić*
 
-*   Fix a bug that prevented the use of the default STI inheritance column
-    (ActiveRecord::Base.inheritance_column = 'some_column'.)
+## Rails 5.2.4 (November 27, 2019) ##
 
-    *chapmajs + Takehiro Adachi*
+*   Fix circular `autosave: true` causes invalid records to be saved.
 
-*   Fix mysql2 adapter raises the correct exception when executing a query on a
-    closed connection.
+    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`.
 
-    *Yves Senn*
+    Fixes #28080.
 
-*   Fixes bug where `Company.new.contract_ids` would incorrectly load
-    all non-associated contracts.
+    *Larry Reid*
 
-    Example:
+*   PostgreSQL: Fix GROUP BY with ORDER BY virtual count attribute.
 
-        company = Company.new # Company has many :contracts
+    Fixes #36022.
 
-        # before
-        company.contract_ids # => SELECT ... WHERE `contracts`.`company_id` IS NULL
+    *Ryuta Kamizono*
 
-        # after
-        company.contract_ids # => []
+*   Fix sqlite3 collation parsing when using decimal columns.
 
-    *Jared Armstrong*
+    *Martin R. Schuster*
 
-*   Fix the `:primary_key` option for `has_many` associations.
-    Fixes #10693.
+*   Make ActiveRecord `ConnectionPool.connections` method thread-safe.
 
-    *Yves Senn*
+    Fixes #36465.
 
-*   fixes bug introduced by #3329.  Now, when autosaving associations,
-    deletions happen before inserts and saves.  This prevents a 'duplicate
-    unique value' database error that would occur if a record being created had
-    the same value on a unique indexed field as that of a record being destroyed.
+    *Jeff Doering*
 
-    Backport of #10417
+*   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.
 
-    *Johnny Holton*
+    Fixes #33249.
 
-*   Fix that under some conditions, Active Record could produce invalid SQL of the sort:
-    "SELECT DISTINCT DISTINCT".
+    *Ryan H. Kerr*
 
-    Backport of #6792.
 
-    *Ben Woosley*
+## Rails 5.2.3 (March 27, 2019) ##
 
-*   Require `ActiveRecord::Base` in railtie hooks for rake_tasks, console and runner to
-    avoid circular constant loading issues.
+*   Fix different `count` calculation when using `size` with manual `select` with DISTINCT.
 
-    Backport #7695.
+    Fixes #35214.
 
-    Fixes #7683 and #882
+    *Juani Villarejo*
 
-    *Ben Holley*
+*   Fix prepared statements caching to be enabled even when query caching is enabled.
 
-*   Maintain context for joins within ActiveRecord::Relation merges.
-    Backport #10164.
+    *Ryuta Kamizono*
 
-    *Neeraj Singh + Andrew Horner*
+*   Don't allow `where` with invalid value matches to nil values.
 
-*   Make sure the `EXPLAIN` command is never triggered by a `select_db` call.
+    Fixes #33624.
 
-    *Daniel Schierbeck*
+    *Ryuta Kamizono*
 
-*   Revert changes on `pluck` that was ignoring the select clause when the relation already
-    has one. This caused a regression since it changed the behavior in a stable release.
+*   Restore an ability that class level `update` without giving ids.
 
-    Fixes #9777.
+    Fixes #34743.
 
-    *Rafael Mendonça França*
+    *Ryuta Kamizono*
 
-*   Confirm a record has not already been destroyed before decrementing counter cache.
+*   Fix join table column quoting with SQLite.
 
-    *Ben Tucker*
+    *Gannon McGibbon*
 
-*   Default values for PostgreSQL bigint types now get parsed and dumped to the
-    schema correctly.
-    Backport #10098.
+*   Ensure that `delete_all` on collection proxy returns affected count.
 
-    *Erik Peterson*
+    *Ryuta Kamizono*
 
-*   Removed warning when `auto_explain_threshold_in_seconds` is set and the
-    connection adapter doesn't support explain.
-    This is causing a regression since the Active Record Railtie is trying to
-    connect to the development database in the application boot.
+*   Reset scope after delete on collection association to clear stale offsets of removed records.
 
-    *Rafael Mendonça França*
+    *Gannon McGibbon*
 
-*   Do not reset `inheritance_column` when it's set explicitly.
-    Backport of #5327.
 
-    *kennyj + Fred Wu*
+## Rails 5.2.2.1 (March 11, 2019) ##
 
-*   Fix a problem wrong exception is occured
-    when raising no translatable exception in PostgreSQL.
+*   No changes.
 
-    *kennyj*
 
-*   Resets the postgres search path in the structure.sql after the structure
-    is dumped in order to find schema_migrations table when multiples schemas
-    are used.
-    Fixes #9796.
+## Rails 5.2.2 (December 04, 2018) ##
 
-    *Juan M. Cuello + Dembskiy Alexander*
+*   Do not ignore the scoping with query methods in the scope block.
 
-*   Reload the association target if it's stale. `@stale_state` should be nil
-    when a model isn't saved.
-    Fixes #7526.
+    *Ryuta Kamizono*
 
-    *Larry Lv*
+*   Allow aliased attributes to be used in `#update_columns` and `#update`.
 
-*   Don't read CSV files during execution of `db:fixtures:load`. CSV support for
-    fixtures was removed some time ago but the task was still loading them, even
-    though later the code was looking for the related yaml file instead.
+    *Gannon McGibbon*
 
-    *kennyj*
+*   Allow spaces in postgres table names.
 
+    Fixes issue where "user post" is misinterpreted as "\"user\".\"post\"" when quoting table names with the postgres
+    adapter.
 
-## Rails 3.2.13 (Mar 18, 2013) ##
+    *Gannon McGibbon*
 
-*   Chaining multiple preloaded scopes will correctly preload all the scopes
-    at the same time.
+*   Cached columns_hash fields should be excluded from ResultSet#column_types
 
-    *Chris Geihsler*
+    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:
 
-*   Reverted 921a296a3390192a71abeec6d9a035cc6d1865c8, 'Quote numeric values
-    compared to string columns.' This caused several regressions.
+    ```ruby
+    class DeveloperName < ActiveRecord::Type::String
+      def deserialize(value)
+        "Developer: #{value}"
+      end
+    end
 
-    *Steve Klabnik*
+    class AttributedDeveloper < ActiveRecord::Base
+      self.table_name = "developers"
 
-*   Fix overriding of attributes by `default_scope` on `ActiveRecord::Base#dup`.
+      attribute :name, DeveloperName.new
 
-    *Hiroshige UMINO*
+      self.ignored_columns += ["name"]
+    end
 
-*   Fix issue with overriding Active Record reader methods with a composed object
-    and using that attribute as the scope of a `uniqueness_of` validation.
-    Backport #7072.
+    developer = AttributedDeveloper.create
+    developer.update_column :name, "name"
 
-    *Peter Brown*
+    loaded_developer = AttributedDeveloper.where(id: developer.id).select("*").first
+    puts loaded_developer.name # should be "Developer: name" but it's just "name"
+    ```
 
-*   Sqlite now preserves custom primary keys when copying or altering tables.
-    Fixes #9367.
-    Backport #2312.
+    *Dmitry Tsepelev*
 
-    *Sean Scally + Yves Senn*
+*   Values of enum are frozen, raising an error when attempting to modify them.
 
-*   Preloading `has_many :through` associations with conditions won't
-    cache the `:through` association. This will prevent invalid
-    subsets to be cached.
-    Fixes #8423.
-    Backport #9252.
+    *Emmanuel Byrd*
 
-    Example:
+*   `update_columns` now correctly raises `ActiveModel::MissingAttributeError`
+    if the attribute does not exist.
 
-        class User
-          has_many :posts
-          has_many :recent_comments, -> { where('created_at > ?', 1.week.ago) }, :through => :posts
-        end
+    *Sean Griffin*
 
-        a_user = User.includes(:recent_comments).first
+*   Do not use prepared statement in queries that have a large number of binds.
 
-        # this is preloaded
-        a_user.recent_comments
+    *Ryuta Kamizono*
 
-        # fetching the recent_comments through the posts association won't preload it.
-        a_user.posts
+*   Fix query cache to load before first request.
 
-    *Yves Senn*
+    *Eileen M. Uchitelle*
 
-*   Fix handling of dirty time zone aware attributes
+*   Fix collection cache key with limit and custom select to avoid ambiguous timestamp column error.
 
-    Previously, when `time_zone_aware_attributes` were enabled, after
-    changing a datetime or timestamp attribute and then changing it back
-    to the original value, `changed_attributes` still tracked the
-    attribute as changed. This caused `[attribute]_changed?` and
-    `changed?` methods to return true incorrectly.
+    Fixes #33056.
 
-    Example:
+    *Federico Martinez*
 
-        in_time_zone 'Paris' do
-          order = Order.new
-          original_time = Time.local(2012, 10, 10)
-          order.shipped_at = original_time
-          order.save
-          order.changed? # => false
+*   Fix duplicated record creation when using nested attributes with `create_with`.
 
-          # changing value
-          order.shipped_at = Time.local(2013, 1, 1)
-          order.changed? # => true
+    *Darwin Wu*
 
-          # reverting to original value
-          order.shipped_at = original_time
-          order.changed? # => false, used to return true
-        end
+*   Fix regression setting children record in parent `before_save` callback.
 
-    Backport of #9073
-    Fixes #8898
+    *Guo Xiang Tan*
 
-    *Lilibeth De La Cruz*
+*   Prevent leaking of user's DB credentials on `rails db:create` failure.
 
-*   Fix counter cache columns not updated when replacing `has_many :through`
-    associations.
-    Backport #8400.
-    Fix #7630.
+    *bogdanvlviv*
 
-    *Matthew Robertson*
+*   Clear mutation tracker before continuing the around callbacks.
 
-*   Don't update `column_defaults` when calling destructive methods on column with default value.
-    Backport c517602.
-    Fix #6115.
+    *Yuya Tanaka*
 
-    *Piotr Sarnacki + Aleksey Magusev + Alan Daud*
+*   Prevent deadlocks when waiting for connection from pool.
 
-*   When `#count` is used in conjunction with `#uniq` we perform `count(:distinct => true)`.
-    Fix #6865.
+    *Brent Wheeldon*
 
-    Example:
+*   Avoid extra scoping when using `Relation#update` that was causing this method to change the current scope.
 
-      relation.uniq.count # => SELECT COUNT(DISTINCT *)
+    *Ryuta Kamizono*
 
-    *Yves Senn + Kaspar Schiess*
+*   Fix numericality validator not to be affected by custom getter.
 
-*   Fix `ActiveRecord::Relation#pluck` when columns or tables are reserved words.
-    Backport #7536.
-    Fix #8968.
+    *Ryuta Kamizono*
 
-    *Ian Lesperance + Yves Senn + Kaspar Schiess*
+*   Fix bulk change table ignores comment option on PostgreSQL.
 
-*   Don't run explain on slow queries for database adapters that don't support it.
-    Backport #6197.
+    *Yoshiyuki Kinjo*
 
-    *Blake Smith*
 
-*   Revert round usec when comparing timestamp attributes in the dirty tracking.
-    Fixes #8460.
+## Rails 5.2.1.1 (November 27, 2018) ##
 
-    *Andrew White*
+*   No changes.
 
-*   Revert creation of through association models when using `collection=[]`
-    on a `has_many :through` association from an unsaved model.
-    Fix #7661, #8269.
 
-    *Ernie Miller*
+## Rails 5.2.1 (August 07, 2018) ##
 
-*   Fix undefined method `to_i` when calling `new` on a scope that uses an
-    Array; Fix FloatDomainError when setting integer column to NaN.
-    Fixes #8718, #8734, #8757.
+*   PostgreSQL: Support new relkind for partitioned tables.
 
-    *Jason Stirk + Tristan Harward*
+    Fixes #33008.
 
-*   Serialized attributes can be serialized in integer columns.
-    Fix #8575.
+    *Yannick Schutz*
 
-    *Rafael Mendonça França*
+*   Rollback parent transaction when children fails to update.
 
-*   Keep index names when using `alter_table` with sqlite3.
-    Fix #3489.
-    Backport #8522.
+    *Guillaume Malette*
 
-    *Yves Senn*
+*   Fix default value for MySQL time types with specified precision.
 
-*   Recognize migrations placed in directories containing numbers and 'rb'.
-    Fix #8492.
-    Backport of #8500.
+    *Nikolay Kondratyev*
 
-    *Yves Senn*
+*   Fix `touch` option to behave consistently with `Persistence#touch` method.
 
-*   Add `ActiveRecord::Base.cache_timestamp_format` class attribute to control
-    the format of the timestamp value in the cache key.
-    This allows users to improve the precision of the cache key.
-    Fixes #8195.
+    *Ryuta Kamizono*
 
-    *Rafael Mendonça França*
+*   Fix `save` in `after_create_commit` won't invoke extra `after_create_commit`.
+
+    Fixes #32831.
 
-*   Add `:nsec` date format. This can be used to improve the precision of cache key.
-    Please note that this format only works with Ruby 1.9, Ruby 1.8 will ignore it completely.
+    *Ryuta Kamizono*
 
-    *Jamie Gaskins*
+*   Fix logic on disabling commit callbacks so they are not called unexpectedly when errors occur.
 
-*   Unscope `update_column(s)` query to ignore default scope.
+    *Brian Durand*
 
-    When applying `default_scope` to a class with a where clause, using
-    `update_column(s)` could generate a query that would not properly update
-    the record due to the where clause from the `default_scope` being applied
-    to the update query.
+*   Fix parent record should not get saved with duplicate children records.
 
-        class User < ActiveRecord::Base
-          default_scope where(active: true)
-        end
+    Fixes #32940.
 
-        user = User.first
-        user.active = false
-        user.save!
+    *Santosh Wadghule*
 
-        user.update_column(:active, true) # => false
+*   Fix that association's after_touch is not called with counter cache.
 
-    In this situation we want to skip the default_scope clause and just
-    update the record based on the primary key. With this change:
+    Fixes #31559.
 
-        user.update_column(:active, true) # => true
+    *Ryuta Kamizono*
 
-    Backport of #8436 fix.
+*   `becomes` should clear the mutation tracker which is created in `after_initialize`.
 
-    *Carlos Antonio da Silva*
+    Fixes #32867.
 
-*   Fix performance problem with primary_key method in PostgreSQL adapter when having many schemas.
-    Uses pg_constraint table instead of pg_depend table which has many records in general.
-    Fix #8414
+    *Ryuta Kamizono*
 
-    *kennyj*
+*   Allow a belonging to parent object to be created from a new record.
 
-*   Do not instantiate intermediate Active Record objects when eager loading.
-    These records caused `after_find` to run more than expected.
-    Fix #3313
-    Backport of #8403
+    *Jolyon Pawlyn*
 
-    *Yves Senn*
+*   Fix that building record with assigning multiple has_one associations
+    wrongly persists through record.
 
-*   Fix `pluck` to work with joins. Backport of #4942.
+    Fixes #32511.
 
-    *Carlos Antonio da Silva*
+    *Sam DeCesare*
 
-*   Fix a problem with `translate_exception` method in a non English environment.
-    Backport of #6397.
+*   Fix relation merging when one of the relations is going to skip the
+    query cache.
 
-    *kennyj*
+    *James Williams*
 
-*   Fix dirty attribute checks for TimeZoneConversion with nil and blank
-    datetime attributes. Setting a nil datetime to a blank string should not
-    result in a change being flagged.
-    Fixes #8310.
-    Backport of #8311.
 
-    *Alisdair McDiarmid*
+## Rails 5.2.0 (April 09, 2018) ##
 
-*   Prevent mass assignment to the type column of polymorphic associations when using `build`.
-    Fixes #8265.
-    Backport of #8291.
+*   MySQL: Support mysql2 0.5.x.
 
-    *Yves Senn*
+    *Aaron Stone*
 
-*   When running migrations on Postgresql, the `:limit` option for `binary` and `text` columns is
-    silently dropped.
-    Previously, these migrations caused sql exceptions, because Postgresql doesn't support limits
-    on these types.
+*   Apply time column precision on assignment.
 
-    *Victor Costan*
+    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.
 
-*   `#pluck` can be used on a relation with `select` clause.
-    Fixes #7551.
-    Backport of #8176.
+    Fixes #30301.
 
-    Example:
+    *Andrew White*
 
-        Topic.select([:approved, :id]).order(:id).pluck(:id)
+*   Normalize time column values for SQLite database.
 
-    *Yves Senn*
+    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.
 
-*   Use `nil?` instead of `blank?` to check whether dynamic finder with a bang
-    should raise RecordNotFound.
-    Fixes #7238.
+    *Andrew White*
 
-    *Nikita Afanasenko*
+*   Ensure that the date component is removed when quoting times.
 
-*   Fix deleting from a HABTM join table upon destroying an object of a model
-    with optimistic locking enabled.
-    Fixes #5332.
+    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.
 
-    *Nick Rogers*
+    *Andrew White*
 
-*   Use query cache/uncache when using ENV["DATABASE_URL"].
-    Fixes #6951.
-    Backport of #8074.
+*   Fix `dependent: :destroy` issue for has_one/belongs_to relationship where
+    the parent class was getting deleted when the child was not.
 
-    *kennyj*
+    Fixes #32022.
 
-*   Do not create useless database transaction when building `has_one` association.
+    *Fernando Gorodscy*
 
-    Example:
+*   Whitelist `NULLS FIRST` and `NULLS LAST` in order clauses too.
 
-        User.has_one :profile
-        User.new.build_profile
+    *Xavier Noria*
 
-    Backport of #8154.
+*   Fix that after commit callbacks on update does not triggered when optimistic locking is enabled.
 
-    *Bogdan Gusiev*
+    *Ryuta Kamizono*
 
-*   `AR::Base#attributes_before_type_cast` now returns unserialized values for serialized attributes.
+*   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.
 
-    *Nikita Afanasenko*
+    Fixes #28364.
 
-*   Fix issue that raises `NameError` when overriding the `accepts_nested_attributes` in child classes.
+    *Takumi Kagiyama*
 
-    Before:
+*   Make `reflection.klass` raise if `polymorphic?` not to be misused.
+
+    Fixes #31876.
+
+    *Ryuta Kamizono*
+
+*   PostgreSQL: Allow pg-1.0 gem to be used with Active Record.
+
+    *Lars Kanis*
+
+*   Deprecate `expand_hash_conditions_for_aggregates` without replacement.
+    Using a `Relation` for performing queries is the prefered API.
+
+    *Ryuta Kamizono*
+
+*   Fix not expanded problem when passing an Array object as argument to the where method using `composed_of` column.
+
+    ```
+    david_balance = customers(:david).balance
+    Customer.where(balance: [david_balance]).to_sql
+
+    # Before: WHERE `customers`.`balance` = NULL
+    # After : WHERE `customers`.`balance` = 50
+    ```
+
+    Fixes #31723.
+
+    *Yutaro Kanagawa*
+
+*   Fix `count(:all)` with eager loading and having an order other than the driving table.
+
+    Fixes #31783.
+
+    *Ryuta Kamizono*
+
+*   Clear the transaction state when an Active Record object is duped.
+
+    Fixes #31670.
+
+    *Yuriy Ustushenko*
+
+*   Support for PostgreSQL foreign tables.
+
+    *fatkodima*
+
+*   Fix relation merger issue with `left_outer_joins`.
 
-        class Shared::Person < ActiveRecord::Base
-          has_one :address
+    *Mehmet Emin İNAÇ*
 
-          accepts_nested_attributes :address, :reject_if => :all_blank
+*   Don't allow destroyed object mutation after `save` or `save!` is called.
+
+    *Ryuta Kamizono*
+
+*   Take into account association conditions when deleting through records.
+
+    Fixes #18424.
+
+    *Piotr Jakubowski*
+
+*   Fix nested `has_many :through` associations on unpersisted parent instances.
+
+    For example, if you have
+
+        class Post < ActiveRecord::Base
+          belongs_to :author
+          has_many :books, through: :author
+          has_many :subscriptions, through: :books
         end
 
-        class Person < Shared::Person
-          accepts_nested_attributes :address
+        class Author < ActiveRecord::Base
+          has_one :post
+          has_many :books
+          has_many :subscriptions, through: :books
         end
 
-        Person
-        #=> NameError: method `address_attributes=' not defined in Person
+        class Book < ActiveRecord::Base
+          belongs_to :author
+          has_many :subscriptions
+        end
+
+        class Subscription < ActiveRecord::Base
+          belongs_to :book
+        end
+
+    Before:
+
+    If `post` is not persisted, then `post.subscriptions` will be empty.
 
     After:
 
-        Person
-        #=> Person(id: integer, ...)
+    If `post` is not persisted, then `post.subscriptions` can be set and used
+    just like it would if `post` were persisted.
 
-    Fixes #8131.
+    Fixes #16313.
 
-    *Gabriel Sobrinho, Ricardo Henrique*
+    *Zoltan Kiss*
 
+*   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)`.
 
-## Rails 3.2.12 (Feb 11, 2013) ##
+    Fixes #23979.
 
-*   Quote numeric values being compared to non-numeric columns. Otherwise,
-    in some database, the string column values will be coerced to a numeric
-    allowing 0, 0.0 or false to match any string starting with a non-digit.
+    *Brian Christian*
 
-    Example:
+*   Use `count(:all)` in `HasManyAssociation#count_records` to prevent invalid
+    SQL queries for association counting.
 
-        App.where(apikey: 0) # => SELECT * FROM users WHERE apikey = '0'
+    *Klas Eskilson*
 
-    *Dylan Smith*
+*   Fix to invoke callbacks when using `update_attribute`.
 
+    *Mike Busch*
 
-## Rails 3.2.11 (Jan 8, 2013) ##
+*   Fix `count(:all)` to correctly work `distinct` with custom SELECT list.
 
-*   Fix querying with an empty hash *Damien Mathieu* [CVE-2013-0155]
+    *Ryuta Kamizono*
 
+*   Using subselect for `delete_all` with `limit` or `offset`.
 
-## Rails 3.2.10 (Jan 2, 2013) ##
+    *Ryuta Kamizono*
 
-*   CVE-2012-5664 options hashes should only be extracted if there are extra
-    parameters
+*   Undefine attribute methods on descendants when resetting column
+    information.
 
+    *Chris Salzberg*
 
-## Rails 3.2.9 (Nov 12, 2012) ##
+*   Log database query callers.
 
-*   Fix `find_in_batches` crashing when IDs are strings and start option is not specified.
+    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.
 
-    *Alexis Bernard*
+    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.
 
-*   Fix issue with collection associations calling first(n)/last(n) and attempting
-    to set the inverse association when `:inverse_of` was used. Fixes #8087.
+    *Olivier Lacan*
 
-    *Carlos Antonio da Silva*
+*   Fix conflicts `counter_cache` with `touch: true` by optimistic locking.
 
-*   Fix bug when Column is trying to type cast boolean values to integer.
-    Fixes #8067.
+    ```
+    # create_table :posts do |t|
+    #   t.integer :comments_count, default: 0
+    #   t.integer :lock_version
+    #   t.timestamps
+    # end
+    class Post < ApplicationRecord
+    end
 
-    *Rafael Mendonça França*
+    # create_table :comments do |t|
+    #   t.belongs_to :post
+    # end
+    class Comment < ApplicationRecord
+      belongs_to :post, touch: true, counter_cache: true
+    end
+    ```
 
-*   Fix bug where `rake db:test:prepare` tries to load the structure.sql into development database.
-    Fixes #8032.
+    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.
+    ```
 
-    *Grace Liu + Rafael Mendonça França*
+    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
 
-*   Fixed support for `DATABASE_URL` environment variable for rake db tasks. *Grace Liu*
+    comment = Comment.create!(post: post)
+    # => begin transaction
+         INSERT INTO "comments" ("post_id") VALUES (1)
 
-*   Fix bug where `update_columns` and `update_column` would not let you update the primary key column.
+         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
 
-    *Henrik Nyh*
+    comment.destroy!
+    # => begin transaction
+         DELETE FROM "comments" WHERE "comments"."id" = 1
 
-*   Decode URI encoded attributes on database connection URLs.
+         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
+    ```
 
-    *Shawn Veader*
+    Fixes #31199.
 
-*   Fix AR#dup to nullify the validation errors in the dup'ed object. Previously the original
-    and the dup'ed object shared the same errors.
+    *bogdanvlviv*
 
-    *Christian Seiler*
+*   Add support for PostgreSQL operator classes to `add_index`.
 
-*   Synchronize around deleting from the reserved connections hash.
-    Fixes #7955
+    Example:
 
-*   PostgreSQL adapter correctly fetches default values when using
-    multiple schemas and domains in a db. Fixes #7914
+        add_index :users, :name, using: :gist, opclass: { name: :gist_trgm_ops }
 
-    *Arturo Pie*
+    *Greg Navis*
 
-*   Fix deprecation notice when loading a collection association that
-    selects columns from other tables, if a new record was previously
-    built using that association.
+*   Don't allow scopes to be defined which conflict with instance methods on `Relation`.
 
-    *Ernie Miller*
+    Fixes #31120.
 
-*   The postgres adapter now supports tables with capital letters.
-    Fix #5920
+    *kinnrot*
 
-    *Yves Senn*
+*   Add new error class `QueryCanceled` which will be raised
+    when canceling statement due to user request.
 
-*   `CollectionAssociation#count` returns `0` without querying if the
-    parent record is not persisted.
+    *Ryuta Kamizono*
 
-    Before:
+*   Add `#up_only` to database migrations for code that is only relevant when
+    migrating up, e.g. populating a new column.
 
-        person.pets.count
-        # SELECT COUNT(*) FROM "pets" WHERE "pets"."person_id" IS NULL
-        # => 0
+    *Rich Daley*
+
+*   Require raw SQL fragments to be explicitly marked when used in
+    relation query methods.
+
+    Before:
+    ```
+    Article.order("LENGTH(title)")
+    ```
 
     After:
+    ```
+    Article.order(Arel.sql("LENGTH(title)"))
+    ```
 
-        person.pets.count
-        # fires without sql query
-        # => 0
+    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.
 
-    *Francesco Rodriguez*
+    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`.
 
-*   Fix `reset_counters` crashing on `has_many :through` associations.
-    Fix #7822.
+    Common and judged-safe string values (such as simple column
+    references) are unaffected:
+    ```
+    Article.order("title DESC")
+    ```
 
-    *lulalala*
+    *Ben Toews*
 
-*   ConnectionPool recognizes checkout_timeout spec key as taking
-    precedence over legacy wait_timeout spec key, can be used to avoid
-    conflict with mysql2 use of wait_timeout.  Closes #7684.
+*   `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.
 
-    *jrochkind*
+    *Sean Griffin*
 
-*   Rename field_changed? to _field_changed? so that users can create a field named field
+*   Add new error class `StatementTimeout` which will be raised
+    when statement timeout exceeded.
 
-    *Akira Matsuda*, backported by *Steve Klabnik*
+    *Ryuta Kamizono*
 
-*   Fix creation of through association models when using `collection=[]`
-    on a `has_many :through` association from an unsaved model.
-    Fix #7661.
+*   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.
 
-    *Ernie Miller*
+    *bogdanvlviv*
 
-*   Explain only normal CRUD sql (select / update / insert / delete).
-    Fix problem that explains unexplainable sql. Closes #7544 #6458.
+*   Fixed a bug where column orders for an index weren't written to
+    `db/schema.rb` when using the sqlite adapter.
 
-    *kennyj*
+    Fixes #30902.
 
-*   Backport test coverage to ensure that PostgreSQL auto-reconnect functionality
-    remains healthy.
+    *Paul Kuruvilla*
 
-    *Steve Jorgensen*
+*   Remove deprecated method `#sanitize_conditions`.
 
-*   Use config['encoding'] instead of config['charset'] when executing
-    databases.rake in the mysql/mysql2. A correct option for a database.yml
-    is 'encoding'.
+    *Rafael Mendonça França*
 
-    *kennyj*
+*   Remove deprecated method `#scope_chain`.
 
-*   Fix ConnectionAdapters::Column.type_cast_code integer conversion,
-    to always convert values to integer calling #to_i. Fixes #7509.
+    *Rafael Mendonça França*
 
-    *Thiago Pradi*
+*   Remove deprecated configuration `.error_on_ignored_order_or_limit`.
 
-*   Fix time column type casting for invalid time string values to correctly return nil.
+    *Rafael Mendonça França*
 
-    *Adam Meehan*
+*   Remove deprecated arguments from `#verify!`.
 
-*   Fix `becomes` when using a configured `inheritance_column`.
+    *Rafael Mendonça França*
 
-    *Yves Senn*
+*   Remove deprecated argument `name` from `#indexes`.
 
-*   Fix `reset_counters` when there are multiple `belongs_to` association with the
-    same foreign key and one of them have a counter cache.
-    Fixes #5200.
+    *Rafael Mendonça França*
 
-    *Dave Desrochers*
+*   Remove deprecated method `ActiveRecord::Migrator.schema_migrations_table_name`.
 
-*   Round usec when comparing timestamp attributes in the dirty tracking.
-    Fixes #6975.
+    *Rafael Mendonça França*
 
-    *kennyj*
+*   Remove deprecated method `supports_primary_key?`.
 
-*   Use inversed parent for first and last child of has_many association.
+    *Rafael Mendonça França*
 
-    *Ravil Bayramgalin*
+*   Remove deprecated method `supports_migrations?`.
 
-*   Fix Column.microseconds and Column.fast_string_to_date to avoid converting
-    timestamp seconds to a float, since it occasionally results in inaccuracies
-    with microsecond-precision times. Fixes #7352.
+    *Rafael Mendonça França*
+
+*   Remove deprecated methods `initialize_schema_migrations_table` and `initialize_internal_metadata_table`.
 
-    *Ari Pollak*
+    *Rafael Mendonça França*
 
-*   Fix `increment!`, `decrement!`, `toggle!` that was skipping callbacks.
-    Fixes #7306.
+*   Raises when calling `lock!` in a dirty record.
 
     *Rafael Mendonça França*
 
-*   Fix AR#create to return an unsaved record when AR::RecordInvalid is
-    raised. Fixes #3217.
+*   Remove deprecated support to passing a class to `:class_name` on associations.
 
-    *Dave Yeu*
+    *Rafael Mendonça França*
 
-*   Remove unnecessary transaction when assigning has_one associations with a nil or equal value.
-    Fix #7191.
+*   Remove deprecated argument `default` from `index_name_exists?`.
 
-    *kennyj*
+    *Rafael Mendonça França*
 
-*   Allow store to work with an empty column.
-    Fix #4840.
+*   Remove deprecated support to `quoted_id` when typecasting an Active Record object.
 
-    *Jeremy Walker*
+    *Rafael Mendonça França*
 
-*   Remove prepared statement from system query in postgresql adapter.
-    Fix #5872.
+*   Fix `bin/rails db:setup` and `bin/rails db:test:prepare` create wrong
+    ar_internal_metadata's data for a test database.
 
-    *Ivan Evtuhovich*
+    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
+    ```
 
-*   Make sure `:environment` task is executed before `db:schema:load` or `db:structure:load`
-    Fixes #4772.
+    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
+    ```
 
-    *Seamus Abshere*
+    Fixes #26731.
 
+    *bogdanvlviv*
 
-## Rails 3.2.8 (Aug 9, 2012) ##
+*   Fix longer sequence name detection for serial columns.
 
-*   Do not consider the numeric attribute as changed if the old value is zero and the new value
-    is not a string.
-    Fixes #7237.
+    Fixes #28332.
 
-    *Rafael Mendonça França*
+    *Ryuta Kamizono*
 
-*   Removes the deprecation of `update_attribute`. *fxn*
+*   MySQL: Don't lose `auto_increment: true` in the `db/schema.rb`.
 
-*   Reverted the deprecation of `composed_of`. *Rafael Mendonça França*
+    Fixes #30894.
 
-*   Reverted the deprecation of `*_sql` association options. They will
-    be deprecated in 4.0 instead. *Jon Leighton*
+    *Ryuta Kamizono*
 
-*   Do not eager load AR session store. ActiveRecord::SessionStore depends on the abstract store
-    in Action Pack. Eager loading this class would break client code that eager loads Active Record
-    standalone.
-    Fixes #7160
+*   Fix `COUNT(DISTINCT ...)` for `GROUP BY` with `ORDER BY` and `LIMIT`.
 
-    *Xavier Noria*
+    Fixes #30886.
 
-*   Do not set RAILS_ENV to "development" when using `db:test:prepare` and related rake tasks.
-    This was causing the truncation of the development database data when using RSpec.
-    Fixes #7175.
+    *Ryuta Kamizono*
 
-    *Rafael Mendonça França*
+*   PostgreSQL `tsrange` now preserves subsecond precision.
 
-## Rails 3.2.7 (Jul 26, 2012) ##
+    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:
 
-*   `:finder_sql` and `:counter_sql` options on collection associations
-    are deprecated. Please transition to using scopes.
+    Before:
 
-    *Jon Leighton*
+        connection.type_cast(tsrange.serialize(range_value))
+        # => "[2010-01-01 13:30:00 UTC,2011-02-02 19:30:00 UTC)"
 
-*   `:insert_sql` and `:delete_sql` options on `has_and_belongs_to_many`
-    associations are deprecated. Please transition to using `has_many
-    :through`
+    Now:
 
-    *Jon Leighton*
+        connection.type_cast(tsrange.serialize(range_value))
+        # => "[2010-01-01 13:30:00.670277,2011-02-02 19:30:00.745125)"
 
-*   `composed_of` has been deprecated. You'll have to write your own accessor
-    and mutator methods if you'd like to use value objects to represent some
-    portion of your models.
+    *Thomas Cannon*
 
-    *Steve Klabnik*
+*   Passing a `Set` to `Relation#where` now behaves the same as passing an
+    array.
 
-*   `update_attribute` has been deprecated. Use `update_column` if
-    you want to bypass mass-assignment protection, validations, callbacks,
-    and touching of updated_at. Otherwise please use `update_attributes`.
+    *Sean Griffin*
 
-    *Steve Klabnik*
+*   Use given algorithm while removing index from database.
 
-## Rails 3.2.6 (Jun 12, 2012) ##
+    Fixes #24190.
 
-*   protect against the nesting of hashes changing the
-    table context in the next call to build_from_hash. This fix
-    covers this case as well.
+    *Mehmet Emin İNAÇ*
 
-    CVE-2012-2695
+*   Update payload names for `sql.active_record` instrumentation to be
+    more descriptive.
 
-*   Revert earlier 'perf fix' (see 3.2.4 changelog / GH #6289). This
-    change introduced a regression (GH #6609). assoc.clear and
-    assoc.delete_all have loaded the association before doing the delete
-    since at least Rails 2.3. Doing the delete without loading the
-    records means that the `before_remove` and `after_remove` callbacks do
-    not get invoked. Therefore, this change was less a fix a more an
-    optimisation, which should only have gone into master.
+    Fixes #30586.
 
-    *Jon Leighton*
+    *Jeremy Green*
 
-## Rails 3.2.5 (Jun 1, 2012) ##
+*   Add new error class `LockWaitTimeout` which will be raised
+    when lock wait timeout exceeded.
 
-*   Restore behavior of Active Record 3.2.3 scopes.
-    A series of commits relating to preloading and scopes caused a regression.
+    *Gabriel Courtemanche*
 
-    *Andrew White*
+*   Remove deprecated `#migration_keys`.
 
+    *Ryuta Kamizono*
 
-## Rails 3.2.4 (May 31, 2012) ##
+*   Automatically guess the inverse associations for STI.
 
-*   Perf fix: Don't load the records when doing assoc.delete_all.
-    GH #6289. *Jon Leighton*
+    *Yuichiro Kaneko*
 
-*   Association preloading shouldn't be affected by the current scoping.
-    This could cause infinite recursion and potentially other problems.
-    See GH #5667. *Jon Leighton*
+*   Ensure `sum` honors `distinct` on `has_many :through` associations.
 
-*   Datetime attributes are forced to be changed. GH #3965
+    Fixes #16791.
 
-*   Fix attribute casting. GH #5549
+    *Aaron Wortham*
 
-*   Fix #5667. Preloading should ignore scoping.
+*   Add `binary` fixture helper method.
 
-*   Predicate builder should not recurse for determining where columns.
-    Thanks to Ben Murphy for reporting this! CVE-2012-2661
+    *Atsushi Yoshida*
 
+*   When using `Relation#or`, extract the common conditions and put them before the OR condition.
 
-## Rails 3.2.3 (March 30, 2012) ##
+    *Maxime Handfield Lapointe*
 
-*   Added find_or_create_by_{attribute}! dynamic method. *Andrew White*
+*   `Relation#or` now accepts two relations who have different values for
+    `references` only, as `references` can be implicitly called by `where`.
 
-*   Whitelist all attribute assignment by default. Change the default for newly generated applications to whitelist all attribute assignment.  Also update the generated model classes so users are reminded of the importance of attr_accessible. *NZKoz*
+    Fixes #29411.
 
-*   Update ActiveRecord::AttributeMethods#attribute_present? to return false for empty strings. *Jacobkg*
+    *Sean Griffin*
 
-*   Fix associations when using per class databases. *larskanis*
+*   `ApplicationRecord` is no longer generated when generating models. If you
+    need to generate it, it can be created with `rails g application_record`.
 
-*   Revert setting NOT NULL constraints in add_timestamps *fxn*
+    *Lisa Ugray*
 
-*   Fix mysql to use proper text types. Fixes #3931. *kennyj*
+*   Fix `COUNT(DISTINCT ...)` with `ORDER BY` and `LIMIT` to keep the existing select list.
 
-*   Fix #5069 - Protect foreign key from mass assignment through association builder. *byroot*
+    *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.
 
-## Rails 3.2.2 (March 1, 2012) ##
+    *Lisa Ugray*
 
-*   No changes.
+*   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)
 
-## Rails 3.2.1 (January 26, 2012) ##
+    ```
+    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)
+    ```
 
-*   The threshold for auto EXPLAIN is ignored if there's no logger. *fxn*
+    *Maxime Handfield Lapointe*
 
-*   Call `to_s` on the value passed to `table_name=`, in particular symbols
-    are supported (regression). *Sergey Nartimov*
+*   Values constructed using multi-parameter assignment will now use the
+    post-type-cast value for rendering in single-field form inputs.
 
-*   Fix possible race condition when two threads try to define attribute
-    methods for the same class. *Jon Leighton*
+    *Sean Griffin*
 
+*   `Relation#joins` is no longer affected by the target model's
+    `current_scope`, with the exception of `unscoped`.
 
-## Rails 3.2.0 (January 20, 2012) ##
+    Fixes #29338.
 
-*   Added a `with_lock` method to ActiveRecord objects, which starts
-    a transaction, locks the object (pessimistically) and yields to the block.
-    The method takes one (optional) parameter and passes it to `lock!`.
+    *Sean Griffin*
 
-    Before:
+*   Change sqlite3 boolean serialization to use 1 and 0.
 
-        class Order < ActiveRecord::Base
-          def cancel!
-            transaction do
-              lock!
-              # ... cancelling logic
-            end
-          end
-        end
+    SQLite natively recognizes 1 and 0 as true and false, but does not natively
+    recognize 't' and 'f' as was previously serialized.
 
-    After:
+    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.
 
-        class Order < ActiveRecord::Base
-          def cancel!
-            with_lock do
-              # ... cancelling logic
-            end
-          end
-        end
+    *Lisa Ugray*
 
-    *Olek Janiszewski*
+*   Skip query caching when working with batches of records (`find_each`, `find_in_batches`,
+    `in_batches`).
 
-*   'on' and 'ON' boolean columns values are type casted to true
-    *Santiago Pastorino*
+    Previously, records would be fetched in batches, but all records would be retained in memory
+    until the end of the request or job.
 
-*   Added ability to run migrations only for given scope, which allows
-    to run migrations only from one engine (for example to revert changes
-    from engine that you want to remove).
+    *Eugene Kenny*
 
-    Example:
-      rake db:migrate SCOPE=blog
+*   Prevent errors raised by `sql.active_record` notification subscribers from being converted into
+    `ActiveRecord::StatementInvalid` exceptions.
 
-    *Piotr Sarnacki*
+    *Dennis Taylor*
 
-*   Migrations copied from engines are now scoped with engine's name,
-    for example 01_create_posts.blog.rb. *Piotr Sarnacki*
+*   Fix eager loading/preloading association with scope including joins.
 
-*   Implements `AR::Base.silence_auto_explain`. This method allows the user to
-    selectively disable automatic EXPLAINs within a block. *fxn*
+    Fixes #28324.
 
-*   Implements automatic EXPLAIN logging for slow queries.
+    *Ryuta Kamizono*
 
-    A new configuration parameter `config.active_record.auto_explain_threshold_in_seconds`
-    determines what's to be considered a slow query. Setting that to `nil` disables
-    this feature. Defaults are 0.5 in development mode, and `nil` in test and production
-    modes.
+*   Fix transactions to apply state to child transactions.
 
-    As of this writing there's support for SQLite, MySQL (mysql2 adapter), and
-    PostgreSQL.
+    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.
 
-    *fxn*
+    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.
 
-*   Implemented ActiveRecord::Relation#pluck method
+    *Eileen M. Uchitelle*, *Aaron Patterson*
 
-    Method returns Array of column value from table under ActiveRecord model
+*   Deprecate `set_state` method in `TransactionState`.
 
-        Client.pluck(:id)
+    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)`.
 
-    *Bogdan Gusiev*
+    *Eileen M. Uchitelle*, *Aaron Patterson*
 
-*   Automatic closure of connections in threads is deprecated.  For example
-    the following code is deprecated:
+*   Deprecate delegating to `arel` in `Relation`.
 
-    Thread.new { Post.find(1) }.join
+    *Ryuta Kamizono*
 
-    It should be changed to close the database connection at the end of
-    the thread:
+*   Query cache was unavailable when entering the `ActiveRecord::Base.cache` block
+    without being connected.
 
-    Thread.new {
-      Post.find(1)
-      Post.connection.close
-    }.join
+    *Tsukasa Oishi*
 
-    Only people who spawn threads in their application code need to worry
-    about this change.
+*   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.
 
-*   Deprecated:
+    *Tobias Kraze*
 
-      * `set_table_name`
-      * `set_inheritance_column`
-      * `set_sequence_name`
-      * `set_primary_key`
-      * `set_locking_column`
+*   Merging two relations representing nested joins no longer transforms the joins of
+    the merged relation into LEFT OUTER JOIN.
 
-    Use an assignment method instead. For example, instead of `set_table_name`, use `self.table_name=`:
+    Example:
 
-         class Project < ActiveRecord::Base
-           self.table_name = "project"
-         end
+    ```
+    Author.joins(:posts).merge(Post.joins(:comments))
+    # Before the change:
+    #=> SELECT ... FROM authors INNER JOIN posts ON ... LEFT OUTER JOIN comments ON...
 
-    Or define your own `self.table_name` method:
+    # After the change:
+    #=> SELECT ... FROM authors INNER JOIN posts ON ... INNER JOIN comments ON...
+    ```
 
-         class Post < ActiveRecord::Base
-           def self.table_name
-             "special_" + super
-           end
-         end
-         Post.table_name # => "special_posts"
+    *Maxime Handfield Lapointe*
 
-    *Jon Leighton*
+*   `ActiveRecord::Persistence#touch` does not work well when optimistic locking enabled and
+    `locking_column`, without default value, is null in the database.
 
-*   Generated association methods are created within a separate module to allow overriding and
-    composition using `super`. For a class named `MyModel`, the module is named
-    `MyModel::GeneratedFeatureMethods`. It is included into the model class immediately after
-    the `generated_attributes_methods` module defined in ActiveModel, so association methods
-    override attribute methods of the same name. *Josh Susser*
+    *bogdanvlviv*
 
-*   Implemented ActiveRecord::Relation#explain. *fxn*
+*   Fix destroying existing object does not work well when optimistic locking enabled and
+    `locking_column` is null in the database.
 
-*   Add ActiveRecord::Relation#uniq for generating unique queries.
+    *bogdanvlviv*
 
-    Before:
+*   Use bulk INSERT to insert fixtures for better performance.
 
-        Client.select('DISTINCT name')
+    *Kir Shatrov*
 
-    After:
+*   Prevent creation of bind param if casted value is nil.
 
-        Client.select(:name).uniq
+    *Ryuta Kamizono*
 
-    This also allows you to revert the unqueness in a relation:
+*   Deprecate passing arguments and block at the same time to `count` and `sum` in `ActiveRecord::Calculations`.
 
-        Client.select(:name).uniq.uniq(false)
+    *Ryuta Kamizono*
 
-    *Jon Leighton*
+*   Loading model schema from database is now thread-safe.
 
-*   Support index sort order in sqlite, mysql and postgres adapters. *Vlad Jebelev*
+    Fixes #28589.
 
-*   Allow the :class_name option for associations to take a symbol (:Client) in addition to
-    a string ('Client').
+    *Vikrant Chaudhary*, *David Abdemoulaie*
 
-    This is to avoid confusing newbies, and to be consistent with the fact that other options
-    like :foreign_key already allow a symbol or a string.
+*   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.
 
-    *Jon Leighton*
+    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+
 
-*   In development mode the db:drop task also drops the test database. For symmetry with
-    the db:create task. *Dmitriy Kiriyenko*
+    *DHH*
 
-*   Added ActiveRecord::Base.store for declaring simple single-column key/value stores *DHH*
+*   Respect `SchemaDumper.ignore_tables` in rake tasks for databases structure dump.
 
-        class User < ActiveRecord::Base
-          store :settings, accessors: [ :color, :homepage ]
-        end
+    *Rusty Geldmacher*, *Guillermo Iguaran*
 
-        u = User.new(color: 'black', homepage: '37signals.com')
-        u.color                          # Accessor stored attribute
-        u.settings[:country] = 'Denmark' # Any attribute, even if not specified with an accessor
+*   Add type caster to `RuntimeReflection#alias_name`.
 
+    Fixes #28959.
 
-*   MySQL: case-insensitive uniqueness validation avoids calling LOWER when
-    the column already uses a case-insensitive collation. Fixes #561.
+    *Jon Moss*
 
-    *Joseph Palermo*
+*   Deprecate `supports_statement_cache?`.
 
-*   Transactional fixtures enlist all active database connections. You can test
-    models on different connections without disabling transactional fixtures.
+    *Ryuta Kamizono*
 
-    *Jeremy Kemper*
+*   Raise error `UnknownMigrationVersionError` on the movement of migrations
+    when the current migration does not exist.
 
-*   Add first_or_create, first_or_create!, first_or_initialize methods to Active Record. This is a
-    better approach over the old find_or_create_by dynamic methods because it's clearer which
-    arguments are used to find the record and which are used to create it:
+    *bogdanvlviv*
 
-        User.where(:first_name => "Scarlett").first_or_create!(:last_name => "Johansson")
+*   Fix `bin/rails db:forward` first migration.
 
-    *Andrés Mejía*
+    *bogdanvlviv*
 
-*   Fix nested attributes bug where _destroy parameter is taken into account
-    during :reject_if => :all_blank (fixes #2937)
+*   Support Descending Indexes for MySQL.
 
-    *Aaron Christy*
+    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.
 
-*   Add ActiveSupport::Cache::NullStore for use in development and testing.
+    *Ryuta Kamizono*
+
+*   Fix inconsistency with changed attributes when overriding Active Record attribute reader.
+
+    *bogdanvlviv*
+
+*   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.
+
+    *Kevin McPhillips*
 
-    *Brian Durand*
 
-Please check [3-1-stable](https://github.com/rails/rails/blob/3-1-stable/activerecord/CHANGELOG.md) for previous changes.
+Please check [5-1-stable](https://github.com/rails/rails/blob/5-1-stable/activerecord/CHANGELOG.md) for previous changes.