activerecord 4.2.0 → 5.2.8.1

data/CHANGELOG.md

@@ -1,1372 +1,1084 @@
-*   Introduce `force: :cascade` option for `create_table`. Using this option
-    will recreate tables even if they have dependent objects (like foreign keys).
-    `db/schema.rb` now uses `force: :cascade`. This makes it possible to
-    reload the schema when foreign keys are in place.
+## Rails 5.2.8.1 (July 12, 2022) ##
 
-    *Matthew Draper*, *Yves Senn*
+*   Change ActiveRecord::Coders::YAMLColumn default to safe_load
 
-*   `db:schema:load` and `db:structure:load` no longer purge the database
-    before loading the schema. This is left for the user to do.
-    `db:test:prepare` will still purge the database.
+    This adds two new configuration options The configuration options are as
+    follows:
+    
+    * `config.active_storage.use_yaml_unsafe_load`
+    
+    When set to true, this configuration option tells Rails to use the old
+    "unsafe" YAML loading strategy, maintaining the existing behavior but leaving
+    the possible escalation vulnerability in place.  Setting this option to true
+    is *not* recommended, but can aid in upgrading.
+    
+    * `config.active_record.yaml_column_permitted_classes`
+    
+    The "safe YAML" loading method does not allow all classes to be deserialized
+    by default.  This option allows you to specify classes deemed "safe" in your
+    application.  For example, if your application uses Symbol and Time in
+    serialized data, you can add Symbol and Time to the allowed list as follows:
+    
+    ```
+    config.active_record.yaml_column_permitted_classes = [Symbol, Date, Time]
+    ```
 
-    Closes #17945.
+    [CVE-2022-32224]
 
-    *Yves Senn*
 
-*   Fix undesirable RangeError by Type::Integer. Add Type::UnsignedInteger.
+## Rails 5.2.8 (May 09, 2022) ##
 
-    *Ryuta Kamizono*
-
-*   Add `foreign_type` option to `has_one` and `has_many` association macros.
-
-    This option enables to define the column name of associated object's type for polymorphic associations.
-
-    *Ulisses Almeida, Kassio Borges*
-
-*   `add_timestamps` and `remove_timestamps` now properly reversible with
-    options.
-
-    *Noam Gagliardi-Rabinovich*
-
-*   Bring back `db:test:prepare` to synchronize the test database schema.
-
-    Manual synchronization using `bin/rake db:test:prepare` is required
-    when a migration is rolled-back, edited and reapplied.
+*   No changes.
 
-    `ActiveRecord::Base.maintain_test_schema` now uses `db:test:prepare`
-    to synchronize the schema. Plugins can use this task as a hook to
-    provide custom behavior after the schema has been loaded.
 
-    NOTE: `test:prepare` runs before the schema is synchronized.
+## Rails 5.2.7.1 (April 26, 2022) ##
 
-    Fixes #17171, #15787.
+*   No changes.
 
-    *Yves Senn*
 
-*   Change `reflections` public api to return the keys as String objects.
+## Rails 5.2.7 (March 10, 2022) ##
 
-    Fixes #16928.
+*   No changes.
 
-    *arthurnn*
 
-*   Renaming a table in pg also renames the primary key index.
+## Rails 5.2.6.3 (March 08, 2022) ##
 
-    Fixes #12856
+*   No changes.
 
-    *Sean Griffin*
-
-*   Make it possible to access fixtures excluded by a `default_scope`.
-
-    *Yves Senn*
-
-*   Fix preloading of associations with a scope containing joins along with
-    conditions on the joined association.
 
-    *Siddharth Sharma*
+## Rails 5.2.6.2 (February 11, 2022) ##
 
-*   Add `Table#name` to match `TableDefinition#name`.
+*   No changes.
 
-    *Cody Cutrer*
 
-*   Cache `CollectionAssociation#reader` proxies separately before and after
-    the owner has been saved so that the proxy is not cached without the
-    owner's id.
+## Rails 5.2.6.1 (February 11, 2022) ##
 
-    *Ben Woosley*
+*   No changes.
 
-*   `ActiveRecord::ReadOnlyRecord` now has a descriptive message.
 
-    *Franky W.*
+## Rails 5.2.6 (May 05, 2021) ##
 
-*   Fix preloading of associations which unscope a default scope.
+*   No changes.
 
-    Fixes #11036.
 
-    *Byron Bischoff*
+## Rails 5.2.5 (March 26, 2021) ##
 
-*   Added SchemaDumper support for tables with jsonb columns.
-
-    *Ted O'Meara*
-
-*   Deprecate `sanitize_sql_hash_for_conditions` without replacement. Using a
-    `Relation` for performing queries and updates is the prefered API.
-
-    *Sean Griffin*
+*   No changes.
 
-*   Queries now properly type cast values that are part of a join statement,
-    even when using type decorators such as `serialize`.
 
-    *Melanie Gilman & Sean Griffin*
+## Rails 5.2.4.6 (May 05, 2021) ##
 
-*   MySQL enum type lookups, with values matching another type, no longer result
-    in an endless loop.
+*   No changes.
 
-    Fixes #17402.
 
-    *Yves Senn*
+## Rails 5.2.4.5 (February 10, 2021) ##
 
-*   Raise `ArgumentError` when the body of a scope is not callable.
+*   Fix possible DoS vector in PostgreSQL money type
 
-    *Mauro George*
+    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.
 
-*   Use type column first in multi-column indexes created with `add-reference`.
+    Thanks to @dee-see from Hackerone for this patch!
 
-    *Derek Prior*
-
-*   Fix `Relation.rewhere` to work with Range values.
-
-    *Dan Olson*
-
-*   `AR::UnknownAttributeError` now includes the class name of a record.
-
-        User.new(name: "Yuki Nishijima", project_attributes: {name: "kaminari"})
-        # => ActiveRecord::UnknownAttributeError: unknown attribute 'name' for User.
-
-    *Yuki Nishijima*
-
-*   Fix a regression causing `after_create` callbacks to run before associated
-    records are autosaved.
-
-    Fixes #17209.
-
-    *Agis Anastasopoulos*
-
-*   Honor overridden `rack.test` in Rack environment for the connection
-    management middleware.
-
-    *Simon Eskildsen*
-
-*   Add a truncate method to the connection.
+    [CVE-2021-22880]
 
     *Aaron Patterson*
 
-*   Don't autosave unchanged has_one through records.
-
-    *Alan Kennedy*, *Steve Parrington*
-
-*   Do not dump foreign keys for ignored tables.
-
-    *Yves Senn*
-
-*   PostgreSQL adapter correctly dumps foreign keys targeting tables
-    outside the schema search path.
-
-    Fixes #16907.
-
-    *Matthew Draper*, *Yves Senn*
-
-*   When a thread is killed, rollback the active transaction, instead of
-    committing it during the stack unwind. Previously, we could commit half-
-    completed work. This fix only works for Ruby 2.0+; on 1.9, we can't
-    distinguish a thread kill from an ordinary non-local (block) return, so must
-    default to committing.
-
-    *Chris Hanks*
-
-*   A `NullRelation` should represent nothing. This fixes a bug where
-    `Comment.where(post_id: Post.none)` returned a non-empty result.
-
-    Fixes #15176.
-
-    *Matthew Draper*, *Yves Senn*
-
-*   Include default column limits in schema.rb. Allows defaults to be changed
-    in the future without affecting old migrations that assumed old defaults.
-
-    *Jeremy Kemper*
-
-*   MySQL: schema.rb now includes TEXT and BLOB column limits.
-
-    *Jeremy Kemper*
-
-*   MySQL: correct LONGTEXT and LONGBLOB limits from 2GB to their true 4GB.
-
-    *Jeremy Kemper*
-
-*   SQLite3Adapter now checks for views in `table_exists?`. Fixes #14041.
-
-    *Girish Sonawane*
-
-*   Introduce `connection.supports_views?` to check whether the current adapter
-    has support for SQL views. Connection adapters should define this method.
-
-    *Yves Senn*
-
-*   Allow included modules to override association methods.
-
-    Fixes #16684.
-
-    *Yves Senn*
-
-*   Schema loading rake tasks (like `db:schema:load` and `db:setup`) maintain
-    the database connection to the current environment.
-
-    Fixes #16757.
-
-    *Joshua Cody*, *Yves Senn*
-
-*   MySQL: set the connection collation along with the charset.
-
-    Sets the connection collation to the database collation configured in
-    database.yml. Otherwise, `SET NAMES utf8mb4` will use the default
-    collation for that charset (utf8mb4_general_ci) when you may have chosen
-    a different collation, like utf8mb4_unicode_ci.
-
-    This only applies to literal string comparisons, not column values, so it
-    is unlikely to affect you.
-
-    *Jeremy Kemper*
-
-*   `default_sequence_name` from the PostgreSQL adapter returns a `String`.
-
-    *Yves Senn*
-
-*   Fix a regression where whitespaces were stripped from DISTINCT queries in
-    PostgreSQL.
-
-    *Agis Anastasopoulos*
 
-    Fixes #16623.
+## Rails 5.2.4.4 (September 09, 2020) ##
 
-*   Fix has_many :through relation merging failing when dynamic conditions are
-    passed as a lambda with an arity of one.
+*   No changes.
 
-    Fixes #16128.
 
-    *Agis Anastasopoulos*
+## Rails 5.2.4.3 (May 18, 2020) ##
 
-*   Fix `Relation#exists?` to work with polymorphic associations.
+*   No changes.
 
-    Fixes #15821.
+## Rails 5.2.4.2 (March 19, 2020) ##
 
-    *Kassio Borges*
+*   No changes.
 
-*   Currently, Active Record rescues any errors raised within
-    `after_rollback`/`after_create` callbacks and prints them to the logs.
-    Future versions of Rails will not rescue these errors anymore and
-    just bubble them up like the other callbacks.
 
-    This commit adds an opt-in flag to enable not rescuing the errors.
+## Rails 5.2.4.1 (December 18, 2019) ##
 
-    Example:
-
-        # Do not swallow errors in after_commit/after_rollback callbacks.
-        config.active_record.raise_in_transactional_callbacks = true
-
-    Fixes #13460.
-
-    *arthurnn*
-
-*   Fix an issue where custom accessor methods (such as those generated by
-    `enum`) with the same name as a global method are incorrectly overridden
-    when subclassing.
-
-    Fixes #16288.
-
-    *Godfrey Chan*
-
-*   `*_was` and `changes` now work correctly for in-place attribute changes as
-    well.
-
-    *Sean Griffin*
-
-*   Fix regression on `after_commit` that did not fire with nested transactions.
-
-    Fixes #16425.
-
-    *arthurnn*
-
-*   Do not try to write timestamps when a table has no timestamps columns.
-
-    Fixes #8813.
-
-    *Sergey Potapov*
-
-*   `index_exists?` with `:name` option does verify specified columns.
-
-    Example:
-
-        add_index :articles, :title, name: "idx_title"
-
-        # Before:
-        index_exists? :articles, :title, name: "idx_title" # => `true`
-        index_exists? :articles, :body, name: "idx_title" # => `true`
-
-        # After:
-        index_exists? :articles, :title, name: "idx_title" # => `true`
-        index_exists? :articles, :body, name: "idx_title" # => `false`
-
-    *Yves Senn*, *Matthew Draper*
-
-*   `add_timestamps` and `t.timestamps` now require you to pass the `:null` option.
-    Not passing the option is deprecated but the default is still `null: true`.
-    With Rails 5 this will change to `null: false`.
-
-    *Sean Griffin*
-
-*   When calling `update_columns` on a record that is not persisted, the error
-    message now reflects whether that object is a new record or has been
-    destroyed.
-
-    *Lachlan Sylvester*
-
-*   Define `id_was` to get the previous value of the primary key.
-
-    Currently when we call `id_was` and we have a custom primary key name,
-    Active Record will return the current value of the primary key. This
-    makes it impossible to correctly do an update operation if you change the
-    id.
-
-    Fixes #16413.
+*   No changes.
 
-    *Rafael Mendonça França*
-
-*   Deprecate `DatabaseTasks.load_schema` to act on the current connection.
-    Use `.load_schema_current` instead. In the future `load_schema` will
-    require the `configuration` to act on as an argument.
-
-    *Yves Senn*
-
-*   Fix automatic maintaining test schema to properly handle sql structure
-    schema format.
 
-    Fixes #15394.
+## Rails 5.2.4 (November 27, 2019) ##
 
-    *Wojciech Wnętrzak*
+*   Fix circular `autosave: true` causes invalid records to be saved.
 
-*   Fix type casting to Decimal from Float with large precision.
+    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`.
 
-    *Tomohiro Hashidate*
+    Fixes #28080.
 
-*   Deprecate `Reflection#source_macro`
+    *Larry Reid*
 
-    `Reflection#source_macro` is no longer needed in Active Record
-    source so it has been deprecated. Code that used `source_macro`
-    was removed in #16353.
+*   PostgreSQL: Fix GROUP BY with ORDER BY virtual count attribute.
 
-    *Eileen M. Uchtitelle*, *Aaron Patterson*
+    Fixes #36022.
 
-*   No verbose backtrace by `db:drop` when database does not exist.
-
-    Fixes #16295.
+    *Ryuta Kamizono*
 
-    *Kenn Ejima*
+*   Fix sqlite3 collation parsing when using decimal columns.
 
-*   Add support for PostgreSQL JSONB.
+    *Martin R. Schuster*
 
-    Example:
+*   Make ActiveRecord `ConnectionPool.connections` method thread-safe.
 
-        create_table :posts do |t|
-          t.jsonb :meta_data
-        end
+    Fixes #36465.
 
-    *Philippe Creux*, *Chris Teague*
+    *Jeff Doering*
 
-*   `db:purge` with MySQL respects `Rails.env`.
+*   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.
 
-    *Yves Senn*
+    Fixes #33249.
 
-*   `change_column_default :table, :column, nil` with PostgreSQL will issue a
-    `DROP DEFAULT` instead of a `DEFAULT NULL` query.
+    *Ryan H. Kerr*
 
-    Fixes #16261.
 
-    *Matthew Draper*, *Yves Senn*
+## Rails 5.2.3 (March 27, 2019) ##
 
-*   Allow to specify a type for the foreign key column in `references`
-    and `add_reference`.
+*   Fix different `count` calculation when using `size` with manual `select` with DISTINCT.
 
-    Example:
+    Fixes #35214.
 
-        change_table :vehicle do |t|
-          t.references :station, type: :uuid
-        end
+    *Juani Villarejo*
 
-    *Andrey Novikov*, *Łukasz Sarnacki*
+*   Fix prepared statements caching to be enabled even when query caching is enabled.
 
-*   `create_join_table` removes a common prefix when generating the join table.
-    This matches the existing behavior of HABTM associations.
+    *Ryuta Kamizono*
 
-    Fixes #13683.
+*   Don't allow `where` with invalid value matches to nil values.
 
-    *Stefan Kanev*
+    Fixes #33624.
 
-*   Do not swallow errors on `compute_type` when having a bad `alias_method` on
-    a class.
+    *Ryuta Kamizono*
 
-    *arthurnn*
+*   Restore an ability that class level `update` without giving ids.
 
-*   PostgreSQL invalid `uuid` are convert to nil.
+    Fixes #34743.
 
-    *Abdelkader Boudih*
+    *Ryuta Kamizono*
 
-*   Restore 4.0 behavior for using serialize attributes with `JSON` as coder.
+*   Fix join table column quoting with SQLite.
 
-    With 4.1.x, `serialize` started returning a string when `JSON` was passed as
-    the second attribute. It will now return a hash as per previous versions.
+    *Gannon McGibbon*
 
-    Example:
+*   Ensure that `delete_all` on collection proxy returns affected count.
 
-        class Post < ActiveRecord::Base
-          serialize :comment, JSON
-        end
-
-        class Comment
-          include ActiveModel::Model
-          attr_accessor :category, :text
-        end
-
-        post = Post.create!
-        post.comment = Comment.new(category: "Animals", text: "This is a comment about squirrels.")
-        post.save!
+    *Ryuta Kamizono*
 
-        # 4.0
-        post.comment # => {"category"=>"Animals", "text"=>"This is a comment about squirrels."}
+*   Reset scope after delete on collection association to clear stale offsets of removed records.
 
-        # 4.1 before
-        post.comment # => "#<Comment:0x007f80ab48ff98>"
+    *Gannon McGibbon*
 
-        # 4.1 after
-        post.comment # => {"category"=>"Animals", "text"=>"This is a comment about squirrels."}
 
-    When using `JSON` as the coder in `serialize`, Active Record will use the
-    new `ActiveRecord::Coders::JSON` coder which delegates its `dump/load` to
-    `ActiveSupport::JSON.encode/decode`. This ensures special objects are dumped
-    correctly using the `#as_json` hook.
+## Rails 5.2.2.1 (March 11, 2019) ##
 
-    To keep the previous behaviour, supply a custom coder instead
-    ([example](https://gist.github.com/jenncoop/8c4142bbe59da77daa63)).
+*   No changes.
 
-    Fixes #15594.
 
-    *Jenn Cooper*
+## Rails 5.2.2 (December 04, 2018) ##
 
-*   Do not use `RENAME INDEX` syntax for MariaDB 10.0.
+*   Do not ignore the scoping with query methods in the scope block.
 
-    Fixes #15931.
+    *Ryuta Kamizono*
 
-    *Jeff Browning*
+*   Allow aliased attributes to be used in `#update_columns` and `#update`.
 
-*   Calling `#empty?` on a `has_many` association would use the value from the
-    counter cache if one exists.
+    *Gannon McGibbon*
 
-    *David Verhasselt*
+*   Allow spaces in postgres table names.
 
-*   Fix the schema dump generated for tables without constraints and with
-    primary key with default value of custom PostgreSQL function result.
+    Fixes issue where "user post" is misinterpreted as "\"user\".\"post\"" when quoting table names with the postgres
+    adapter.
 
-    Fixes #16111.
+    *Gannon McGibbon*
 
-    *Andrey Novikov*
+*   Cached columns_hash fields should be excluded from ResultSet#column_types
 
-*   Fix the SQL generated when a `delete_all` is run on an association to not
-    produce an `IN` statements.
+    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
+    end
 
-      UPDATE "categorizations" SET "category_id" = NULL WHERE
-      "categorizations"."category_id" = 1 AND "categorizations"."id" IN (1, 2)
+    class AttributedDeveloper < ActiveRecord::Base
+      self.table_name = "developers"
 
-    After:
+      attribute :name, DeveloperName.new
 
-      UPDATE "categorizations" SET "category_id" = NULL WHERE
-      "categorizations"."category_id" = 1
+      self.ignored_columns += ["name"]
+    end
 
-    *Eileen M. Uchitelle, Aaron Patterson*
+    developer = AttributedDeveloper.create
+    developer.update_column :name, "name"
 
-*   Avoid type casting boolean and `ActiveSupport::Duration` values to numeric
-    values for string columns. Otherwise, in some database, the string column
-    values will be coerced to a numeric allowing false or 0.seconds match any
-    string starting with a non-digit.
+    loaded_developer = AttributedDeveloper.where(id: developer.id).select("*").first
+    puts loaded_developer.name # should be "Developer: name" but it's just "name"
+    ```
 
-    Example:
+    *Dmitry Tsepelev*
 
-        App.where(apikey: false) # => SELECT * FROM users WHERE apikey = '0'
+*   Values of enum are frozen, raising an error when attempting to modify them.
 
-    *Dylan Thacker-Smith*
+    *Emmanuel Byrd*
 
-*   Add a `:required` option to singular associations, providing a nicer
-    API for presence validations on associations.
+*   `update_columns` now correctly raises `ActiveModel::MissingAttributeError`
+    if the attribute does not exist.
 
     *Sean Griffin*
 
-*   Fix an error in `reset_counters` when associations have `select` scope.
-    (Call to `count` generated invalid SQL.)
-
-    *Cade Truitt*
-
-*   After a successful `reload`, `new_record?` is always false.
-
-    Fixes #12101.
-
-    *Matthew Draper*
-
-*   PostgreSQL renaming table doesn't attempt to rename non existent sequences.
-
-    *Abdelkader Boudih*
-
-*   Move 'dependent: :destroy' handling for `belongs_to`
-    from `before_destroy` to `after_destroy` callback chain
+*   Do not use prepared statement in queries that have a large number of binds.
 
-    Fixes #12380.
-
-    *Ivan Antropov*
-
-*   Detect in-place modifications on String attributes.
-
-    Before this change, an attribute modified in-place had to be marked as
-    changed in order for it to be persisted in the database. Now it is no longer
-    required.
-
-    Before:
-
-        user = User.first
-        user.name << ' Griffin'
-        user.name_will_change!
-        user.save
-        user.reload.name # => "Sean Griffin"
-
-    After:
-
-        user = User.first
-        user.name << ' Griffin'
-        user.save
-        user.reload.name # => "Sean Griffin"
-
-    *Sean Griffin*
+    *Ryuta Kamizono*
 
-*   Add `ActiveRecord::Base#validate!` that raises `RecordInvalid` if the record
-    is invalid.
+*   Fix query cache to load before first request.
 
-    *Bogdan Gusiev*, *Marc Schütz*
+    *Eileen M. Uchitelle*
 
-*   Support for adding and removing foreign keys. Foreign keys are now
-    a part of `schema.rb`. This is supported by Mysql2Adapter, MysqlAdapter
-    and PostgreSQLAdapter.
+*   Fix collection cache key with limit and custom select to avoid ambiguous timestamp column error.
 
-    Many thanks to *Matthew Higgins* for laying the foundation with his work on
-    [foreigner](https://github.com/matthuhiggins/foreigner).
+    Fixes #33056.
 
-    Example:
+    *Federico Martinez*
 
-        # within your migrations:
-        add_foreign_key :articles, :authors
-        remove_foreign_key :articles, :authors
+*   Fix duplicated record creation when using nested attributes with `create_with`.
 
-    *Yves Senn*
+    *Darwin Wu*
 
-*   Fix subtle bugs regarding attribute assignment on models with no primary
-    key. `'id'` will no longer be part of the attributes hash.
+*   Fix regression setting children record in parent `before_save` callback.
 
-    *Sean Griffin*
+    *Guo Xiang Tan*
 
-*   Deprecate automatic counter caches on `has_many :through`. The behavior was
-    broken and inconsistent.
+*   Prevent leaking of user's DB credentials on `rails db:create` failure.
 
-    *Sean Griffin*
+    *bogdanvlviv*
 
-*   `preload` preserves readonly flag for associations.
+*   Clear mutation tracker before continuing the around callbacks.
 
-    See #15853.
+    *Yuya Tanaka*
 
-    *Yves Senn*
+*   Prevent deadlocks when waiting for connection from pool.
 
-*   Assume numeric types have changed if they were assigned to a value that
-    would fail numericality validation, regardless of the old value. Previously
-    this would only occur if the old value was 0.
+    *Brent Wheeldon*
 
-    Example:
+*   Avoid extra scoping when using `Relation#update` that was causing this method to change the current scope.
 
-        model = Model.create!(number: 5)
-        model.number = '5wibble'
-        model.number_changed? # => true
+    *Ryuta Kamizono*
 
-    Fixes #14731.
+*   Fix numericality validator not to be affected by custom getter.
 
-    *Sean Griffin*
+    *Ryuta Kamizono*
 
-*   `reload` no longer merges with the existing attributes.
-    The attribute hash is fully replaced. The record is put into the same state
-    as it would be with `Model.find(model.id)`.
+*   Fix bulk change table ignores comment option on PostgreSQL.
 
-    *Sean Griffin*
+    *Yoshiyuki Kinjo*
 
-*   The object returned from `select_all` must respond to `column_types`.
-    If this is not the case a `NoMethodError` is raised.
 
-    *Sean Griffin*
+## Rails 5.2.1.1 (November 27, 2018) ##
 
-*   Detect in-place modifications of PG array types
+*   No changes.
 
-    *Sean Griffin*
 
-*   Add `bin/rake db:purge` task to empty the current database.
+## Rails 5.2.1 (August 07, 2018) ##
 
-    *Yves Senn*
+*   PostgreSQL: Support new relkind for partitioned tables.
 
-*   Deprecate `serialized_attributes` without replacement.
+    Fixes #33008.
 
-    *Sean Griffin*
+    *Yannick Schutz*
 
-*   Correctly extract IPv6 addresses from `DATABASE_URI`: the square brackets
-    are part of the URI structure, not the actual host.
+*   Rollback parent transaction when children fails to update.
 
-    Fixes #15705.
+    *Guillaume Malette*
 
-    *Andy Bakun*, *Aaron Stone*
+*   Fix default value for MySQL time types with specified precision.
 
-*   Ensure both parent IDs are set on join records when both sides of a
-    through association are new.
+    *Nikolay Kondratyev*
 
-    *Sean Griffin*
+*   Fix `touch` option to behave consistently with `Persistence#touch` method.
 
-*   `ActiveRecord::Dirty` now detects in-place changes to mutable values.
-    Serialized attributes on ActiveRecord models will no longer save when
-    unchanged.
+    *Ryuta Kamizono*
 
-    Fixes #8328.
+*   Fix `save` in `after_create_commit` won't invoke extra `after_create_commit`.
 
-    *Sean Griffin*
+    Fixes #32831.
 
-*   `Pluck` now works when selecting columns from different tables with the same
-    name.
+    *Ryuta Kamizono*
 
-    Fixes #15649.
+*   Fix logic on disabling commit callbacks so they are not called unexpectedly when errors occur.
 
-    *Sean Griffin*
+    *Brian Durand*
 
-*   Remove `cache_attributes` and friends. All attributes are cached.
+*   Fix parent record should not get saved with duplicate children records.
 
-    *Sean Griffin*
+    Fixes #32940.
 
-*   Remove deprecated method `ActiveRecord::Base.quoted_locking_column`.
+    *Santosh Wadghule*
 
-    *Akshay Vishnoi*
+*   Fix that association's after_touch is not called with counter cache.
 
-*   `ActiveRecord::FinderMethods.find` with block can handle proc parameter as
-    `Enumerable#find` does.
+    Fixes #31559.
 
-    Fixes #15382.
+    *Ryuta Kamizono*
 
-    *James Yang*
+*   `becomes` should clear the mutation tracker which is created in `after_initialize`.
 
-*   Make timezone aware attributes work with PostgreSQL array columns.
+    Fixes #32867.
 
-    Fixes #13402.
+    *Ryuta Kamizono*
 
-    *Kuldeep Aggarwal*, *Sean Griffin*
+*   Allow a belonging to parent object to be created from a new record.
 
-*   `ActiveRecord::SchemaMigration` has no primary key regardless of the
-    `primary_key_prefix_type` configuration.
+    *Jolyon Pawlyn*
 
-    Fixes #15051.
+*   Fix that building record with assigning multiple has_one associations
+    wrongly persists through record.
 
-    *JoseLuis Torres*, *Yves Senn*
+    Fixes #32511.
 
-*   `rake db:migrate:status` works with legacy migration numbers like `00018_xyz.rb`.
+    *Sam DeCesare*
 
-    Fixes #15538.
+*   Fix relation merging when one of the relations is going to skip the
+    query cache.
 
-    *Yves Senn*
+    *James Williams*
 
-*   Baseclass becomes! subclass.
 
-    Before this change, a record which changed its STI type, could not be
-    updated.
+## Rails 5.2.0 (April 09, 2018) ##
 
-    Fixes #14785.
+*   MySQL: Support mysql2 0.5.x.
 
-    *Matthew Draper*, *Earl St Sauver*, *Edo Balvers*
+    *Aaron Stone*
 
-*   Remove deprecated `ActiveRecord::Migrator.proper_table_name`. Use the
-    `proper_table_name` instance method on `ActiveRecord::Migration` instead.
+*   Apply time column precision on assignment.
 
-    *Akshay Vishnoi*
+    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.
 
-*   Fix regression on eager loading association based on SQL query rather than
-    existing column.
+    Fixes #30301.
 
-    Fixes #15480.
+    *Andrew White*
 
-    *Lauro Caetano*, *Carlos Antonio da Silva*
+*   Normalize time column values for SQLite database.
 
-*   Deprecate returning `nil` from `column_for_attribute` when no column exists.
-    It will return a null object in Rails 5.0
+    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.
 
-    *Sean Griffin*
+    *Andrew White*
 
-*   Implemented `ActiveRecord::Base#pretty_print` to work with PP.
+*   Ensure that the date component is removed when quoting times.
 
-    *Ethan*
+    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.
 
-*   Preserve type when dumping PostgreSQL point, bit, bit varying and money
-    columns.
+    *Andrew White*
 
-    *Yves Senn*
+*   Fix `dependent: :destroy` issue for has_one/belongs_to relationship where
+    the parent class was getting deleted when the child was not.
 
-*   New records remain new after YAML serialization.
+    Fixes #32022.
 
-    *Sean Griffin*
+    *Fernando Gorodscy*
 
-*   PostgreSQL support default values for enum types. Fixes #7814.
+*   Whitelist `NULLS FIRST` and `NULLS LAST` in order clauses too.
 
-    *Yves Senn*
+    *Xavier Noria*
 
-*   PostgreSQL `default_sequence_name` respects schema. Fixes #7516.
+*   Fix that after commit callbacks on update does not triggered when optimistic locking is enabled.
 
-    *Yves Senn*
+    *Ryuta Kamizono*
 
-*   Fix `columns_for_distinct` of PostgreSQL adapter to work correctly
-    with orders without sort direction modifiers.
+*   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.
 
-    *Nikolay Kondratyev*
+    Fixes #28364.
 
-*   PostgreSQL `reset_pk_sequence!` respects schemas. Fixes #14719.
+    *Takumi Kagiyama*
 
-    *Yves Senn*
+*   Make `reflection.klass` raise if `polymorphic?` not to be misused.
 
-*   Keep PostgreSQL `hstore` and `json` attributes as `Hash` in `@attributes`.
-    Fixes duplication in combination with `store_accessor`.
+    Fixes #31876.
 
-    Fixes #15369.
+    *Ryuta Kamizono*
 
-    *Yves Senn*
+*   PostgreSQL: Allow pg-1.0 gem to be used with Active Record.
 
-*   `rake railties:install:migrations` respects the order of railties.
+    *Lars Kanis*
 
-    *Arun Agrawal*
+*   Deprecate `expand_hash_conditions_for_aggregates` without replacement.
+    Using a `Relation` for performing queries is the prefered API.
 
-*   Fix redefine a `has_and_belongs_to_many` inside inherited class
-    Fixing regression case, where redefining the same `has_and_belongs_to_many`
-    definition into a subclass would raise.
+    *Ryuta Kamizono*
 
-    Fixes #14983.
+*   Fix not expanded problem when passing an Array object as argument to the where method using `composed_of` column.
 
-    *arthurnn*
+    ```
+    david_balance = customers(:david).balance
+    Customer.where(balance: [david_balance]).to_sql
 
-*   Fix `has_and_belongs_to_many` public reflection.
-    When defining a `has_and_belongs_to_many`, internally we convert that to two has_many.
-    But as `reflections` is a public API, people expect to see the right macro.
+    # Before: WHERE `customers`.`balance` = NULL
+    # After : WHERE `customers`.`balance` = 50
+    ```
 
-    Fixes #14682.
+    Fixes #31723.
 
-    *arthurnn*
+    *Yutaro Kanagawa*
 
-*   Fix serialization for records with an attribute named `format`.
+*   Fix `count(:all)` with eager loading and having an order other than the driving table.
 
-    Fixes #15188.
+    Fixes #31783.
 
-    *Godfrey Chan*
+    *Ryuta Kamizono*
 
-*   When a `group` is set, `sum`, `size`, `average`, `minimum` and `maximum`
-    on a NullRelation should return a Hash.
+*   Clear the transaction state when an Active Record object is duped.
 
-    *Kuldeep Aggarwal*
+    Fixes #31670.
 
-*   Fix serialized fields returning serialized data after being updated with
-    `update_column`.
+    *Yuriy Ustushenko*
 
-    *Simon Hørup Eskildsen*
+*   Support for PostgreSQL foreign tables.
 
-*   Fix polymorphic eager loading when using a String as foreign key.
+    *fatkodima*
 
-    Fixes #14734.
+*   Fix relation merger issue with `left_outer_joins`.
 
-    *Lauro Caetano*
+    *Mehmet Emin İNAÇ*
 
-*   Change belongs_to touch to be consistent with timestamp updates
+*   Don't allow destroyed object mutation after `save` or `save!` is called.
 
-    If a model is set up with a belongs_to: touch relationship the parent
-    record will only be touched if the record was modified. This makes it
-    consistent with timestamp updating on the record itself.
+    *Ryuta Kamizono*
 
-    *Brock Trappitt*
+*   Take into account association conditions when deleting through records.
 
-*   Fix the inferred table name of a `has_and_belongs_to_many` auxiliary
-    table inside a schema.
+    Fixes #18424.
 
-    Fixes #14824.
+    *Piotr Jakubowski*
 
-    *Eric Chahin*
+*   Fix nested `has_many :through` associations on unpersisted parent instances.
 
-*   Remove unused `:timestamp` type. Transparently alias it to `:datetime`
-    in all cases. Fixes inconsistencies when column types are sent outside of
-    `ActiveRecord`, such as for XML Serialization.
+    For example, if you have
 
-    *Sean Griffin*
+        class Post < ActiveRecord::Base
+          belongs_to :author
+          has_many :books, through: :author
+          has_many :subscriptions, through: :books
+        end
 
-*   Fix bug that added `table_name_prefix` and `table_name_suffix` to
-    extension names in PostgreSQL when migrating.
+        class Author < ActiveRecord::Base
+          has_one :post
+          has_many :books
+          has_many :subscriptions, through: :books
+        end
 
-    *Joao Carlos*
+        class Book < ActiveRecord::Base
+          belongs_to :author
+          has_many :subscriptions
+        end
 
-*   The `:index` option in migrations, which previously was only available for
-    `references`, now works with any column types.
+        class Subscription < ActiveRecord::Base
+          belongs_to :book
+        end
 
-    *Marc Schütz*
+    Before:
 
-*   Add support for counter name to be passed as parameter on `CounterCache::ClassMethods#reset_counters`.
+    If `post` is not persisted, then `post.subscriptions` will be empty.
 
-    *jnormore*
+    After:
 
-*   Restrict deletion of record when using `delete_all` with `uniq`, `group`, `having`
-    or `offset`.
+    If `post` is not persisted, then `post.subscriptions` can be set and used
+    just like it would if `post` were persisted.
 
-    In these cases the generated query ignored them and that caused unintended
-    records to be deleted.
+    Fixes #16313.
 
-    Fixes #11985.
+    *Zoltan Kiss*
 
-    *Leandro Facchinetti*
+*   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)`.
 
-*   Floats with limit >= 25 that get turned into doubles in MySQL no longer have
-    their limit dropped from the schema.
+    Fixes #23979.
 
-    Fixes #14135.
+    *Brian Christian*
 
-    *Aaron Nelson*
+*   Use `count(:all)` in `HasManyAssociation#count_records` to prevent invalid
+    SQL queries for association counting.
 
-*   Fix how to calculate associated class name when using namespaced `has_and_belongs_to_many`
-    association.
+    *Klas Eskilson*
 
-    Fixes #14709.
+*   Fix to invoke callbacks when using `update_attribute`.
 
-    *Kassio Borges*
+    *Mike Busch*
 
-*   `ActiveRecord::Relation::Merger#filter_binds` now compares equivalent symbols and
-    strings in column names as equal.
+*   Fix `count(:all)` to correctly work `distinct` with custom SELECT list.
 
-    This fixes a rare case in which more bind values are passed than there are
-    placeholders for them in the generated SQL statement, which can make PostgreSQL
-    throw a `StatementInvalid` exception.
+    *Ryuta Kamizono*
 
-    *Nat Budin*
+*   Using subselect for `delete_all` with `limit` or `offset`.
 
-*   Fix `stored_attributes` to correctly merge the details of stored
-    attributes defined in parent classes.
+    *Ryuta Kamizono*
 
-    Fixes #14672.
+*   Undefine attribute methods on descendants when resetting column
+    information.
 
-    *Brad Bennett*, *Jessica Yao*, *Lakshmi Parthasarathy*
+    *Chris Salzberg*
 
-*   `change_column_default` allows `[]` as argument to `change_column_default`.
+*   Log database query callers.
 
-    Fixes #11586.
+    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.
 
-    *Yves Senn*
+    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.
 
-*   Handle `name` and `"char"` column types in the PostgreSQL adapter.
+    *Olivier Lacan*
 
-    `name` and `"char"` are special character types used internally by
-    PostgreSQL and are used by internal system catalogs. These field types
-    can sometimes show up in structure-sniffing queries that feature internal system
-    structures or with certain PostgreSQL extensions.
+*   Fix conflicts `counter_cache` with `touch: true` by optimistic locking.
 
-    *J Smith*, *Yves Senn*
+    ```
+    # create_table :posts do |t|
+    #   t.integer :comments_count, default: 0
+    #   t.integer :lock_version
+    #   t.timestamps
+    # end
+    class Post < ApplicationRecord
+    end
 
-*   Fix `PostgreSQLAdapter::OID::Float#type_cast` to convert Infinity and
-    NaN PostgreSQL values into a native Ruby `Float::INFINITY` and `Float::NAN`
+    # create_table :comments do |t|
+    #   t.belongs_to :post
+    # end
+    class Comment < ApplicationRecord
+      belongs_to :post, touch: true, counter_cache: true
+    end
+    ```
 
     Before:
-
-        Point.create(value: 1.0/0)
-        Point.last.value # => 0.0
+    ```
+    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.
+    ```
 
     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
 
-        Point.create(value: 1.0/0)
-        Point.last.value # => Infinity
-
-    *Innokenty Mikhailov*
-
-*   Allow the PostgreSQL adapter to handle bigserial primary key types again.
-
-    Fixes #10410.
-
-    *Patrick Robertson*
-
-*   Deprecate joining, eager loading and preloading of instance dependent
-    associations without replacement. These operations happen before instances
-    are created. The current behavior is unexpected and can result in broken
-    behavior.
-
-    Fixes #15024.
-
-    *Yves Senn*
-
-*   Fix `has_and_belongs_to_many` CollectionAssociation size calculations.
-
-    `has_and_belongs_to_many` should fall back to using the normal CollectionAssociation's
-    size calculation if the collection is not cached or loaded.
-
-    Fixes #14913, #14914.
-
-    *Fred Wu*
+    comment = Comment.create!(post: post)
+    # => begin transaction
+         INSERT INTO "comments" ("post_id") VALUES (1)
 
-*   Return a non zero status when running `rake db:migrate:status` and migration table does
-    not exist.
+         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
 
-    *Paul B.*
+    comment.destroy!
+    # => begin transaction
+         DELETE FROM "comments" WHERE "comments"."id" = 1
 
-*   Add support for module-level `table_name_suffix` in models.
+         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
+    ```
 
-    This makes `table_name_suffix` work the same way as `table_name_prefix` when
-    using namespaced models.
+    Fixes #31199.
 
-    *Jenner LaFave*
+    *bogdanvlviv*
 
-*   Revert the behaviour of `ActiveRecord::Relation#join` changed through 4.0 => 4.1 to 4.0.
+*   Add support for PostgreSQL operator classes to `add_index`.
 
-    In 4.1.0 `Relation#join` is delegated to `Arel#SelectManager`.
-    In 4.0 series it is delegated to `Array#join`.
-
-    *Bogdan Gusiev*
-
-*   Log nil binary column values correctly.
-
-    When an object with a binary column is updated with a nil value
-    in that column, the SQL logger would throw an exception when trying
-    to log that nil value. This only occurs when updating a record
-    that already has a non-nil value in that column since an initial nil
-    value isn't included in the SQL anyway (at least, when dirty checking
-    is enabled.) The column's new value will now be logged as `<NULL binary data>`
-    to parallel the existing `<N bytes of binary data>` for non-nil values.
-
-    *James Coleman*
-
-*   Rails will now pass a custom validation context through to autosave associations
-    in order to validate child associations with the same context.
-
-    Fixes #13854.
+    Example:
 
-    *Eric Chahin*, *Aaron Nelson*, *Kevin Casey*
+        add_index :users, :name, using: :gist, opclass: { name: :gist_trgm_ops }
 
-*   Stringify all variables keys of MySQL connection configuration.
+    *Greg Navis*
 
-    When `sql_mode` variable for MySQL adapters set in configuration as `String`
-    was ignored and overwritten by strict mode option.
+*   Don't allow scopes to be defined which conflict with instance methods on `Relation`.
 
-    Fixes #14895.
+    Fixes #31120.
 
-    *Paul Nikitochkin*
+    *kinnrot*
 
-*   Ensure SQLite3 statements are closed on errors.
+*   Add new error class `QueryCanceled` which will be raised
+    when canceling statement due to user request.
 
-    Fixes #13631.
+    *Ryuta Kamizono*
 
-    *Timur Alperovich*
+*   Add `#up_only` to database migrations for code that is only relevant when
+    migrating up, e.g. populating a new column.
 
-*   Give `ActiveRecord::PredicateBuilder` private methods the privacy they deserve.
+    *Rich Daley*
 
-    *Hector Satre*
+*   Require raw SQL fragments to be explicitly marked when used in
+    relation query methods.
 
-*   When using a custom `join_table` name on a `habtm`, rails was not saving it
-    on Reflections. This causes a problem when rails loads fixtures, because it
-    uses the reflections to set database with fixtures.
+    Before:
+    ```
+    Article.order("LENGTH(title)")
+    ```
 
-    Fixes #14845.
+    After:
+    ```
+    Article.order(Arel.sql("LENGTH(title)"))
+    ```
 
-    *Kassio Borges*
+    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.
 
-*   Reset the cache when modifying a Relation with cached Arel.
-    Additionally display a warning message to make the user aware.
+    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`.
 
-    *Yves Senn*
+    Common and judged-safe string values (such as simple column
+    references) are unaffected:
+    ```
+    Article.order("title DESC")
+    ```
 
-*   PostgreSQL should internally use `:datetime` consistently for TimeStamp. Assures
-    different spellings of timestamps are treated the same.
+    *Ben Toews*
 
-    Example:
+*   `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.
 
-        mytimestamp.simplified_type('timestamp without time zone')
-        # => :datetime
-        mytimestamp.simplified_type('timestamp(6) without time zone')
-        # => also :datetime (previously would be :timestamp)
+    *Sean Griffin*
 
-    See #14513.
+*   Add new error class `StatementTimeout` which will be raised
+    when statement timeout exceeded.
 
-    *Jefferson Lai*
+    *Ryuta Kamizono*
 
-*   `ActiveRecord::Base.no_touching` no longer triggers callbacks or start empty transactions.
+*   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.
 
-    Fixes #14841.
+    *bogdanvlviv*
 
-    *Lucas Mazza*
+*   Fixed a bug where column orders for an index weren't written to
+    `db/schema.rb` when using the sqlite adapter.
 
-*   Fix name collision with `Array#select!` with `Relation#select!`.
+    Fixes #30902.
 
-    Fixes #14752.
+    *Paul Kuruvilla*
 
-    *Earl St Sauver*
+*   Remove deprecated method `#sanitize_conditions`.
 
-*   Fix unexpected behavior for `has_many :through` associations going through
-    a scoped `has_many`.
+    *Rafael Mendonça França*
 
-    If a `has_many` association is adjusted using a scope, and another
-    `has_many :through` uses this association, then the scope adjustment is
-    unexpectedly neglected.
+*   Remove deprecated method `#scope_chain`.
 
-    Fixes #14537.
+    *Rafael Mendonça França*
 
-    *Jan Habermann*
+*   Remove deprecated configuration `.error_on_ignored_order_or_limit`.
 
-*   `@destroyed` should always be set to `false` when an object is duped.
+    *Rafael Mendonça França*
 
-    *Kuldeep Aggarwal*
+*   Remove deprecated arguments from `#verify!`.
 
-*   Enable `has_many` associations to support irregular inflections.
+    *Rafael Mendonça França*
 
-    Fixes #8928.
+*   Remove deprecated argument `name` from `#indexes`.
 
-    *arthurnn*, *Javier Goizueta*
+    *Rafael Mendonça França*
 
-*   Fix `count` used with a grouping not returning a Hash.
+*   Remove deprecated method `ActiveRecord::Migrator.schema_migrations_table_name`.
 
-    Fixes #14721.
+    *Rafael Mendonça França*
 
-    *Eric Chahin*
+*   Remove deprecated method `supports_primary_key?`.
 
-*   `sanitize_sql_like` helper method to escape a string for safe use in an SQL
-    LIKE statement.
+    *Rafael Mendonça França*
 
-    Example:
+*   Remove deprecated method `supports_migrations?`.
 
-        class Article
-          def self.search(term)
-            where("title LIKE ?", sanitize_sql_like(term))
-          end
-        end
+    *Rafael Mendonça França*
 
-        Article.search("20% _reduction_")
-        # => Query looks like "... title LIKE '20\% \_reduction\_' ..."
+*   Remove deprecated methods `initialize_schema_migrations_table` and `initialize_internal_metadata_table`.
 
-    *Rob Gilson*, *Yves Senn*
+    *Rafael Mendonça França*
 
-*   Do not quote uuid default value on `change_column`.
+*   Raises when calling `lock!` in a dirty record.
 
-    Fixes #14604.
+    *Rafael Mendonça França*
 
-    *Eric Chahin*
+*   Remove deprecated support to passing a class to `:class_name` on associations.
 
-*   The comparison between `Relation` and `CollectionProxy` should be consistent.
+    *Rafael Mendonça França*
 
-    Example:
+*   Remove deprecated argument `default` from `index_name_exists?`.
 
-        author.posts == Post.where(author_id: author.id)
-        # => true
-        Post.where(author_id: author.id) == author.posts
-        # => true
+    *Rafael Mendonça França*
 
-    Fixes #13506.
+*   Remove deprecated support to `quoted_id` when typecasting an Active Record object.
 
-    *Lauro Caetano*
+    *Rafael Mendonça França*
 
-*   Calling `delete_all` on an unloaded `CollectionProxy` no longer
-    generates an SQL statement containing each id of the collection:
+*   Fix `bin/rails db:setup` and `bin/rails db:test:prepare` create wrong
+    ar_internal_metadata's data for a test database.
 
     Before:
-
-        DELETE FROM `model` WHERE `model`.`parent_id` = 1
-        AND `model`.`id` IN (1, 2, 3...)
+    ```
+    $ 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
+    ```
 
     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
+    ```
 
-        DELETE FROM `model` WHERE `model`.`parent_id` = 1
+    Fixes #26731.
 
-    *Eileen M. Uchitelle*, *Aaron Patterson*
+    *bogdanvlviv*
 
-*   Fix invalid SQL when aggregate methods (`empty?`, `any?`, `count`) used
-    with `select`.
+*   Fix longer sequence name detection for serial columns.
 
-    Fixes #13648.
+    Fixes #28332.
 
-    *Simon Woker*
+    *Ryuta Kamizono*
 
-*   PostgreSQL adapter only warns once for every missing OID per connection.
+*   MySQL: Don't lose `auto_increment: true` in the `db/schema.rb`.
 
-    Fixes #14275.
+    Fixes #30894.
 
-    *Matthew Draper*, *Yves Senn*
+    *Ryuta Kamizono*
 
-*   PostgreSQL adapter automatically reloads it's type map when encountering
-    unknown OIDs.
+*   Fix `COUNT(DISTINCT ...)` for `GROUP BY` with `ORDER BY` and `LIMIT`.
 
-    Fixes #14678.
+    Fixes #30886.
 
-    *Matthew Draper*, *Yves Senn*
+    *Ryuta Kamizono*
 
-*   Fix insertion of records via `has_many :through` association with scope.
+*   PostgreSQL `tsrange` now preserves subsecond precision.
 
-    Fixes #3548.
+    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:
 
-    *Ivan Antropov*
+    Before:
 
-*   Auto-generate stable fixture UUIDs on PostgreSQL.
+        connection.type_cast(tsrange.serialize(range_value))
+        # => "[2010-01-01 13:30:00 UTC,2011-02-02 19:30:00 UTC)"
 
-    Fixes #11524.
+    Now:
 
-    *Roderick van Domburg*
+        connection.type_cast(tsrange.serialize(range_value))
+        # => "[2010-01-01 13:30:00.670277,2011-02-02 19:30:00.745125)"
 
-*   Fix a problem where an enum would overwrite values of another enum with the
-    same name in an unrelated class.
+    *Thomas Cannon*
 
-    Fixes #14607.
+*   Passing a `Set` to `Relation#where` now behaves the same as passing an
+    array.
 
-    *Evan Whalen*
+    *Sean Griffin*
 
-*   PostgreSQL and SQLite string columns no longer have a default limit of 255.
+*   Use given algorithm while removing index from database.
 
-    Fixes #13435, #9153.
+    Fixes #24190.
 
-    *Vladimir Sazhin*, *Toms Mikoss*, *Yves Senn*
+    *Mehmet Emin İNAÇ*
 
-*   Make possible to have an association called `records`.
+*   Update payload names for `sql.active_record` instrumentation to be
+    more descriptive.
 
-    Fixes #11645.
+    Fixes #30586.
 
-    *prathamesh-sonpatki*
+    *Jeremy Green*
 
-*   `to_sql` on an association now matches the query that is actually executed, where it
-    could previously have incorrectly accrued additional conditions (e.g. as a result of
-    a previous query). `CollectionProxy` now always defers to the association scope's
-    `arel` method so the (incorrect) inherited one should be entirely concealed.
+*   Add new error class `LockWaitTimeout` which will be raised
+    when lock wait timeout exceeded.
 
-    Fixes #14003.
+    *Gabriel Courtemanche*
 
-    *Jefferson Lai*
+*   Remove deprecated `#migration_keys`.
 
-*   Block a few default Class methods as scope name.
+    *Ryuta Kamizono*
 
-    For instance, this will raise:
+*   Automatically guess the inverse associations for STI.
 
-        scope :public, -> { where(status: 1) }
+    *Yuichiro Kaneko*
 
-    *arthurnn*
+*   Ensure `sum` honors `distinct` on `has_many :through` associations.
 
-*   Fix error when using `with_options` with lambda.
+    Fixes #16791.
 
-    Fixes #9805.
+    *Aaron Wortham*
 
-    *Lauro Caetano*
+*   Add `binary` fixture helper method.
 
-*   Switch `sqlite3:///` URLs (which were temporarily
-    deprecated in 4.1) from relative to absolute.
+    *Atsushi Yoshida*
 
-    If you still want the previous interpretation, you should replace
-    `sqlite3:///my/path` with `sqlite3:my/path`.
+*   When using `Relation#or`, extract the common conditions and put them before the OR condition.
 
-    *Matthew Draper*
+    *Maxime Handfield Lapointe*
 
-*   Treat blank UUID values as `nil`.
+*   `Relation#or` now accepts two relations who have different values for
+    `references` only, as `references` can be implicitly called by `where`.
 
-    Example:
+    Fixes #29411.
 
-        Sample.new(uuid_field: '') #=> <Sample id: nil, uuid_field: nil>
+    *Sean Griffin*
 
-    *Dmitry Lavrov*
+*   `ApplicationRecord` is no longer generated when generating models. If you
+    need to generate it, it can be created with `rails g application_record`.
 
-*   Enable support for materialized views on PostgreSQL >= 9.3.
+    *Lisa Ugray*
 
-    *Dave Lee*
+*   Fix `COUNT(DISTINCT ...)` with `ORDER BY` and `LIMIT` to keep the existing select list.
 
-*   The PostgreSQL adapter supports custom domains. Fixes #14305.
+    *Ryuta Kamizono*
 
-    *Yves Senn*
+*   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.
 
-*   PostgreSQL `Column#type` is now determined through the corresponding OID.
-    The column types stay the same except for enum columns. They no longer have
-    `nil` as type but `enum`.
+    *Lisa Ugray*
 
-    See #7814.
+*   Fix `unscoped(where: [columns])` removing the wrong bind values.
 
-    *Yves Senn*
+    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)
 
-*   Fix error when specifying a non-empty default value on a PostgreSQL array
-    column.
+    ```
+    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)
+    ```
 
-    Fixes #10613.
+    *Maxime Handfield Lapointe*
 
-    *Luke Steensen*
+*   Values constructed using multi-parameter assignment will now use the
+    post-type-cast value for rendering in single-field form inputs.
 
-*   Fix error where `.persisted?` throws SystemStackError for an unsaved model with a
-    custom primary key that did not save due to validation error.
+    *Sean Griffin*
 
-    Fixes #14393.
+*   `Relation#joins` is no longer affected by the target model's
+    `current_scope`, with the exception of `unscoped`.
 
-    *Chris Finne*
+    Fixes #29338.
 
-*   Introduce `validate` as an alias for `valid?`.
+    *Sean Griffin*
 
-    This is more intuitive when you want to run validations but don't care about the return value.
+*   Change sqlite3 boolean serialization to use 1 and 0.
 
-    *Henrik Nyh*
+    SQLite natively recognizes 1 and 0 as true and false, but does not natively
+    recognize 't' and 'f' as was previously serialized.
 
-*   Create indexes inline in CREATE TABLE for MySQL.
+    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.
 
-    This is important, because adding an index on a temporary table after it has been created
-    would commit the transaction.
+    *Lisa Ugray*
 
-    It also allows creating and dropping indexed tables with fewer queries and fewer permissions
-    required.
+*   Skip query caching when working with batches of records (`find_each`, `find_in_batches`,
+    `in_batches`).
 
-    Example:
+    Previously, records would be fetched in batches, but all records would be retained in memory
+    until the end of the request or job.
 
-        create_table :temp, temporary: true, as: "SELECT id, name, zip FROM a_really_complicated_query" do |t|
-          t.index :zip
-        end
-        # => CREATE TEMPORARY TABLE temp (INDEX (zip)) AS SELECT id, name, zip FROM a_really_complicated_query
+    *Eugene Kenny*
 
-    *Cody Cutrer*, *Steve Rice*, *Rafael Mendonça Franca*
+*   Prevent errors raised by `sql.active_record` notification subscribers from being converted into
+    `ActiveRecord::StatementInvalid` exceptions.
 
-*   Use singular table name in generated migrations when
-    `ActiveRecord::Base.pluralize_table_names` is `false`.
+    *Dennis Taylor*
 
-    Fixes #13426.
+*   Fix eager loading/preloading association with scope including joins.
 
-    *Kuldeep Aggarwal*
+    Fixes #28324.
 
-*   `touch` accepts many attributes to be touched at once.
+    *Ryuta Kamizono*
 
-    Example:
+*   Fix transactions to apply state to child transactions.
 
-        # touches :signed_at, :sealed_at, and :updated_at/on attributes.
-        Photo.last.touch(:signed_at, :sealed_at)
+    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.
 
-    *James Pinto*
+    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.
 
-*   `rake db:structure:dump` only dumps schema information if the schema
-    migration table exists.
+    *Eileen M. Uchitelle*, *Aaron Patterson*
 
-    Fixes #14217.
+*   Deprecate `set_state` method in `TransactionState`.
 
-    *Yves Senn*
+    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)`.
 
-*   Reap connections that were checked out by now-dead threads, instead
-    of waiting until they disconnect by themselves. Before this change,
-    a suitably constructed series of short-lived threads could starve
-    the connection pool, without ever having more than a couple alive at
-    the same time.
+    *Eileen M. Uchitelle*, *Aaron Patterson*
 
-    *Matthew Draper*
+*   Deprecate delegating to `arel` in `Relation`.
 
-*   `pk_and_sequence_for` now ensures that only the pg_depend entries
-    pointing to pg_class, and thus only sequence objects, are considered.
+    *Ryuta Kamizono*
 
-    *Josh Williams*
+*   Query cache was unavailable when entering the `ActiveRecord::Base.cache` block
+    without being connected.
 
-*   `where.not` adds `references` for `includes` like normal `where` calls do.
+    *Tsukasa Oishi*
 
-    Fixes #14406.
+*   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.
 
-    *Yves Senn*
+    *Tobias Kraze*
 
-*   Extend fixture `$LABEL` replacement to allow string interpolation.
+*   Merging two relations representing nested joins no longer transforms the joins of
+    the merged relation into LEFT OUTER JOIN.
 
     Example:
 
-        martin:
-          email: $LABEL@email.com
-
-        users(:martin).email # => martin@email.com
+    ```
+    Author.joins(:posts).merge(Post.joins(:comments))
+    # Before the change:
+    #=> SELECT ... FROM authors INNER JOIN posts ON ... LEFT OUTER JOIN comments ON...
 
-    *Eric Steele*
+    # After the change:
+    #=> SELECT ... FROM authors INNER JOIN posts ON ... INNER JOIN comments ON...
+    ```
 
-*   Add support for `Relation` be passed as parameter on `QueryCache#select_all`.
+    *Maxime Handfield Lapointe*
 
-    Fixes #14361.
+*   `ActiveRecord::Persistence#touch` does not work well when optimistic locking enabled and
+    `locking_column`, without default value, is null in the database.
 
-    *arthurnn*
+    *bogdanvlviv*
 
-*   Passing an Active Record object to `find` or `exists?` is now deprecated.
-    Call `.id` on the object first.
+*   Fix destroying existing object does not work well when optimistic locking enabled and
+    `locking_column` is null in the database.
 
-    *Aaron Patterson*
-
-*   Only use BINARY for MySQL case sensitive uniqueness check when column
-    has a case insensitive collation.
-
-    *Ryuta Kamizono*
+    *bogdanvlviv*
 
-*   Support for MySQL 5.6 fractional seconds.
+*   Use bulk INSERT to insert fixtures for better performance.
 
-    *arthurnn*, *Tatsuhiko Miyagawa*
+    *Kir Shatrov*
 
-*   Support for PostgreSQL `citext` data type enabling case-insensitive
-   `where` values without needing to wrap in UPPER/LOWER sql functions.
+*   Prevent creation of bind param if casted value is nil.
 
-    *Troy Kruthoff*, *Lachlan Sylvester*
-
-*   Only save has_one associations if record has changes.
-    Previously after save related callbacks, such as `#after_commit`, were triggered when the has_one
-    object did not get saved to the db.
+    *Ryuta Kamizono*
 
-    *Alan Kennedy*
+*   Deprecate passing arguments and block at the same time to `count` and `sum` in `ActiveRecord::Calculations`.
 
-*   Allow strings to specify the `#order` value.
+    *Ryuta Kamizono*
 
-    Example:
+*   Loading model schema from database is now thread-safe.
 
-        Model.order(id: 'asc').to_sql == Model.order(id: :asc).to_sql
+    Fixes #28589.
 
-    *Marcelo Casiraghi*, *Robin Dupret*
+    *Vikrant Chaudhary*, *David Abdemoulaie*
 
-*   Dynamically register PostgreSQL enum OIDs. This prevents "unknown OID"
-    warnings on enum columns.
+*   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.
 
-    *Dieter Komendera*
+    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+
 
-*   `includes` is able to detect the right preloading strategy when string
-    joins are involved.
+    *DHH*
 
-    Fixes #14109.
+*   Respect `SchemaDumper.ignore_tables` in rake tasks for databases structure dump.
 
-    *Aaron Patterson*, *Yves Senn*
+    *Rusty Geldmacher*, *Guillermo Iguaran*
 
-*   Fix error with validation with enum fields for records where the value for
-    any enum attribute is always evaluated as 0 during uniqueness validation.
+*   Add type caster to `RuntimeReflection#alias_name`.
 
-    Fixes #14172.
+    Fixes #28959.
 
-    *Vilius Luneckas* *Ahmed AbouElhamayed*
+    *Jon Moss*
 
-*   `before_add` callbacks are fired before the record is saved on
-    `has_and_belongs_to_many` associations *and* on `has_many :through`
-    associations.  Before this change, `before_add` callbacks would be fired
-    before the record was saved on `has_and_belongs_to_many` associations, but
-    *not* on `has_many :through` associations.
+*   Deprecate `supports_statement_cache?`.
 
-    Fixes #14144.
+    *Ryuta Kamizono*
 
-*   Fix STI classes not defining an attribute method if there is a conflicting
-    private method defined on its ancestors.
+*   Raise error `UnknownMigrationVersionError` on the movement of migrations
+    when the current migration does not exist.
 
-    Fixes #11569.
+    *bogdanvlviv*
 
-    *Godfrey Chan*
+*   Fix `bin/rails db:forward` first migration.
 
-*   Coerce strings when reading attributes. Fixes #10485.
+    *bogdanvlviv*
 
-    Example:
+*   Support Descending Indexes for MySQL.
 
-        book = Book.new(title: 12345)
-        book.save!
-        book.title # => "12345"
+    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.
 
-    *Yves Senn*
+    *Ryuta Kamizono*
 
-*   Deprecate half-baked support for PostgreSQL range values with excluding beginnings.
-    We currently map PostgreSQL ranges to Ruby ranges. This conversion is not fully
-    possible because the Ruby range does not support excluded beginnings.
+*   Fix inconsistency with changed attributes when overriding Active Record attribute reader.
 
-    The current solution of incrementing the beginning is not correct and is now
-    deprecated. For subtypes where we don't know how to increment (e.g. `#succ`
-    is not defined) it will raise an `ArgumentException` for ranges with excluding
-    beginnings.
+    *bogdanvlviv*
 
-    *Yves Senn*
+*   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.
 
-*   Support for user created range types in PostgreSQL.
+    *Kevin McPhillips*
 
-    *Yves Senn*
 
-Please check [4-1-stable](https://github.com/rails/rails/blob/4-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.