activerecord 3.2.19 → 5.0.0

data/CHANGELOG.md

@@ -1,1009 +1,2120 @@
-## Rails 3.2.19 (Jul 2, 2014) ##
+## Rails 5.0.0 (June 30, 2016) ##
 
-*   Fix SQL Injection Vulnerability in 'bitstring' quoting.
+*   Ensure hashes can be assigned to attributes created using `composed_of`.
+    Fixes #25210.
 
-    Fixes CVE-2014-3482.
+    *Sean Griffin*
 
-    *Rafael Mendonça França*
+*   Fix logging edge case where if an attribute was of the binary type and
+    was provided as a Hash.
+
+    *Jon Moss*
+
+*   Handle JSON deserialization correctly if the column default from database
+    adapter returns `''` instead of `nil`.
+
+    *Johannes Opper*
+
+*   PostgreSQL: Support Expression Indexes and Operator Classes.
+
+    Example:
+
+        create_table :users do |t|
+          t.string :name
+          t.index 'lower(name) varchar_pattern_ops'
+        end
+
+    Fixes #19090, #21765, #21819, #24359.
+
+    *Ryuta Kamizono*
+
+*   MySQL: Prepared statements support.
+
+    To enable, set `prepared_statements: true` in config/database.yml.
+    Requires mysql2 0.4.4+.
+
+    *Ryuta Kamizono*
+
+*   Schema dumper: Indexes are now included in the `create_table` block
+    instead of listed afterward as separate `add_index` lines.
+
+    This tidies up schema.rb and makes it easy to read as a list of tables.
+
+    Bonus: Allows databases that support it (MySQL) to perform as single
+    `CREATE TABLE` query, no additional query per index.
+
+    *Ryuta Kamizono*
+
+*   SQLite: Fix uniqueness validation when values exceed the column limit.
+
+    SQLite doesn't impose length restrictions on strings, BLOBs, or numeric
+    values. It treats them as helpful metadata. When we truncate strings
+    before checking uniqueness, we'd miss values that exceed the column limit.
+
+    Other databases enforce length limits. A large value will pass uniqueness
+    validation since the column limit guarantees no value that long exists.
+    When we insert the row, it'll raise `ActiveRecord::ValueTooLong` as we
+    expect.
+
+    This fixes edge-case incorrect validation failures for values that exceed
+    the column limit but are identical to an existing value *when truncated*.
+    Now these will pass validation and raise an exception.
+
+    *Ryuta Kamizono*
+
+*   Raise `ActiveRecord::ValueTooLong` when column limits are exceeded.
+    Supported by MySQL and PostgreSQL adapters.
+
+    *Ryuta Kamizono*
+
+*   Migrations: `#foreign_key` respects `table_name_prefix` and `_suffix`.
+
+    *Ryuta Kamizono*
+
+*   SQLite: Force NOT NULL primary keys.
+
+    From SQLite docs: https://www.sqlite.org/lang_createtable.html
+        According to the SQL standard, PRIMARY KEY should always imply NOT
+        NULL. Unfortunately, due to a bug in some early versions, this is not
+        the case in SQLite. Unless the column is an INTEGER PRIMARY KEY or the
+        table is a WITHOUT ROWID table or the column is declared NOT NULL,
+        SQLite allows NULL values in a PRIMARY KEY column. SQLite could be
+        fixed to conform to the standard, but doing so might break legacy
+        applications. Hence, it has been decided to merely document the fact
+        that SQLite allowing NULLs in most PRIMARY KEY columns.
+
+    Now we override column options to explicitly set NOT NULL rather than rely
+    on implicit NOT NULL like MySQL and PostgreSQL adapters.
+
+    *Ryuta Kamizono*
+
+*   Added notice when a database is successfully created or dropped.
+
+    Example:
+
+        $ bin/rails db:create
+        Created database 'blog_development'
+        Created database 'blog_test'
+
+        $ bin/rails db:drop
+        Dropped database 'blog_development'
+        Dropped database 'blog_test'
+
+    Changed older notices
+    `blog_development already exists` to `Database 'blog_development' already exists`.
+    and
+    `Couldn't drop blog_development` to `Couldn't drop database 'blog_development'`.
+
+    *bogdanvlviv*
+
+*   Database comments. Annotate database objects (tables, columns, indexes)
+    with comments stored in database metadata. PostgreSQL & MySQL support.
+
+        create_table :pages, force: :cascade, comment: 'CMS content pages' do |t|
+          t.string :path,   comment: 'Path fragment of page URL used for routing'
+          t.string :locale, comment: 'RFC 3066 locale code of website language section'
+          t.index [:path, :locale], comment: 'Look up pages by URI'
+        end
+
+    *Andrey Novikov*
+
+*   Add `quoted_time` for truncating the date part of a TIME column value.
+    This fixes queries on TIME column on MariaDB, as it doesn't ignore the
+    date part of the string when it coerces to time.
+
+    *Ryuta Kamizono*
+
+*   Properly accept all valid JSON primitives in the JSON data type.
+
+    Fixes #24234
+
+    *Sean Griffin*
+
+*   MariaDB 5.3+ supports microsecond datetime precision.
+
+    *Jeremy Daer*
+
+*   Delegate `none?` and `one?`. Now they can be invoked as model class methods.
+
+    Example:
+
+        # When no record is found on the table
+        Topic.none?  # => true
+
+        # When only one record is found on the table
+        Topic.one?   # => true
+
+    *Kenta Shirai*
+
+*   The form builder now properly displays values when passing a proc form
+    default to the attributes API.
+
+    Fixes #24249.
+
+    *Sean Griffin*
+
+*   The schema cache is now cleared after the `db:migrate` task is run.
+
+    Closes #24273.
+
+    *Chris Arcand*
+
+*   MySQL: strict mode respects other SQL modes rather than overwriting them.
+    Setting `strict: true` adds `STRICT_ALL_TABLES` to `sql_mode`. Setting
+    `strict: false` removes `STRICT_TRANS_TABLES`, `STRICT_ALL_TABLES`, and
+    `TRADITIONAL` from `sql_mode`.
+
+    *Ryuta Kamizono*
+
+*   Execute default_scope defined by abstract class in the context of subclass.
+
+    Fixes #23413.
+    Fixes #10658.
+
+    *Mehmet Emin İNAÇ*
+
+*   Fix an issue when preloading associations with extensions.
+    Previously every association with extension methods was transformed into an
+    instance dependent scope. This is no longer the case.
+
+    Fixes #23934.
+
+    *Yves Senn*
+
+*   Deprecate `{insert|update|delete}_sql` in `DatabaseStatements`.
+    Use the `{insert|update|delete}` public methods instead.
+
+    *Ryuta Kamizono*
+
+*   Added a configuration option to have active record raise an ArgumentError
+    if the order or limit is ignored in a batch query, rather than logging a
+    warning message.
+
+    *Scott Ringwelski*
+
+*   Honour the order of the joining model in a `has_many :through` association when eager loading.
+
+    Example:
+
+    The below will now follow the order of `by_lines` when eager loading `authors`.
+
+        class Article < ActiveRecord::Base
+          has_many :by_lines, -> { order(:position) }
+          has_many :authors, through: :by_lines
+        end
+
+    Fixes #17864.
+
+    *Yasyf Mohamedali*, *Joel Turkel*
+
+*   Ensure that the Suppressor runs before validations.
+
+    This moves the suppressor up to be run before validations rather than after
+    validations. There's no reason to validate a record you aren't planning on saving.
+
+    *Eileen M. Uchitelle*
+
+*   Save many-to-many objects based on association primary key.
+
+    Fixes #20995.
+
+    *himesh-r*
+
+*   Ensure that mutations of the array returned from `ActiveRecord::Relation#to_a`
+    do not affect the original relation, by returning a duplicate array each time.
+
+    This brings the behavior in line with `CollectionProxy#to_a`, which was
+    already more careful.
+
+    *Matthew Draper*
+
+*   Fixed `where` for polymorphic associations when passed an array containing different types.
+
+    Fixes #17011.
+
+    Example:
+
+        PriceEstimate.where(estimate_of: [Treasure.find(1), Car.find(2)])
+        # => SELECT "price_estimates".* FROM "price_estimates"
+             WHERE (("price_estimates"."estimate_of_type" = 'Treasure' AND "price_estimates"."estimate_of_id" = 1)
+             OR ("price_estimates"."estimate_of_type" = 'Car' AND "price_estimates"."estimate_of_id" = 2))
+
+    *Philippe Huibonhoa*
+
+*   Fix a bug where using `t.foreign_key` twice with the same `to_table` within
+    the same table definition would only create one foreign key.
+
+    *George Millo*
+
+*   Fix a regression on has many association, where calling a child from parent in child's callback
+    results in same child records getting added repeatedly to target.
+
+    Fixes #13387.
+
+    *Bogdan Gusiev*, *Jon Hinson*
+
+*   Rework `ActiveRecord::Relation#last`.
+
+    1. Never perform additional SQL on loaded relation
+    2. Use SQL reverse order instead of loading relation if relation doesn't have limit
+    3. Deprecated relation loading when SQL order can not be automatically reversed
+
+        Topic.order("title").load.last(3)
+          # before: SELECT ...
+          # after: No SQL
+
+        Topic.order("title").last
+          # before: SELECT * FROM `topics`
+          # after:  SELECT * FROM `topics` ORDER BY `topics`.`title` DESC LIMIT 1
+
+        Topic.order("coalesce(author, title)").last
+          # before: SELECT * FROM `topics`
+          # after:  Deprecation Warning for irreversible order
+
+    *Bogdan Gusiev*
+
+*   Allow `joins` to be unscoped.
+
+    Fixes #13775.
+
+    *Takashi Kokubun*
+
+*   Add ActiveRecord `#second_to_last` and `#third_to_last` methods.
+
+    *Brian Christian*
+
+*   Added `numeric` helper into migrations.
+
+    Example:
+
+        create_table(:numeric_types) do |t|
+          t.numeric :numeric_type, precision: 10, scale: 2
+        end
+
+    *Mehmet Emin İNAÇ*
+
+*   Bumped the minimum supported version of PostgreSQL to >= 9.1.
+    Both PG 9.0 and 8.4 are past their end of life date:
+    http://www.postgresql.org/support/versioning/
+
+    *Remo Mueller*
+
+*   `ActiveRecord::Relation#reverse_order` throws `ActiveRecord::IrreversibleOrderError`
+    when the order can not be reversed using current trivial algorithm.
+    Also raises the same error when `#reverse_order` is called on
+    relation without any order and table has no primary key:
+
+        Topic.order("concat(author_name, title)").reverse_order
+          # Before: SELECT `topics`.* FROM `topics` ORDER BY concat(author_name DESC, title) DESC
+          # After: raises ActiveRecord::IrreversibleOrderError
+        Edge.all.reverse_order
+          # Before: SELECT `edges`.* FROM `edges` ORDER BY `edges`.`` DESC
+          # After: raises ActiveRecord::IrreversibleOrderError
+
+    *Bogdan Gusiev*
+
+*   Improve schema_migrations insertion performance by inserting all versions
+    in one INSERT SQL.
+
+    *Akira Matsuda*, *Naoto Koshikawa*
+
+*   Using `references` or `belongs_to` in migrations will always add index
+    for the referenced column by default, without adding `index: true` option
+    to generated migration file. Users can opt out of this by passing
+    `index: false`.
+
+    Fixes #18146.
+
+    *Matthew Draper*, *Prathamesh Sonpatki*
+
+*   Run `type` attributes through attributes API type-casting before
+    instantiating the corresponding subclass. This makes it possible to define
+    custom STI mappings.
+
+    Fixes #21986.
+
+    *Yves Senn*
+
+*   Don't try to quote functions or expressions passed to `:default` option if
+    they are passed as procs.
+
+    This will generate proper query with the passed function or expression for
+    the default option, instead of trying to quote it in incorrect fashion.
+
+    Example:
+
+        create_table :posts do |t|
+          t.datetime :published_at, default: -> { 'NOW()' }
+        end
+
+    *Ryuta Kamizono*
+
+*   Fix regression when loading fixture files with symbol keys.
+
+    Fixes #22584.
+
+    *Yves Senn*
+
+*   Use `version` column as primary key for schema_migrations table because
+    `schema_migrations` versions are guaranteed to be unique.
+
+    This makes it possible to use `update_attributes` on models that do
+    not have a primary key.
+
+    *Richard Schneeman*
+
+*   Add short-hand methods for text and blob types in MySQL.
+
+    In Pg and Sqlite3, `:text` and `:binary` have variable unlimited length.
+    But in MySQL, these have limited length for each types (ref #21591, #21619).
+    This change adds short-hand methods for each text and blob types.
+
+    Example:
+
+        create_table :foos do |t|
+          t.tinyblob   :tiny_blob
+          t.mediumblob :medium_blob
+          t.longblob   :long_blob
+          t.tinytext   :tiny_text
+          t.mediumtext :medium_text
+          t.longtext   :long_text
+        end
+
+    *Ryuta Kamizono*
+
+*   Take into account UTC offset when assigning string representation of
+    timestamp with offset specified to attribute of time type.
+
+    *Andrey Novikov*
+
+*   When calling `first` with a `limit` argument, return directly from the
+    `loaded?` records if available.
+
+    *Ben Woosley*
+
+*   Deprecate sending the `offset` argument to `find_nth`. Please use the
+    `offset` method on relation instead.
+
+    *Ben Woosley*
+
+*   Limit record touching to once per transaction.
+
+    If you have a parent/grand-parent relation like:
+
+        Comment belongs_to :message, touch: true
+        Message belongs_to :project, touch: true
+        Project belongs_to :account, touch: true
+
+    When the lowest entry(`Comment`) is saved, now, it won't repeat the touch
+    call multiple times for the parent records.
+
+    Related #18606.
+
+    *arthurnn*
+
+*   Order the result of `find(ids)` to match the passed array, if the relation
+    has no explicit order defined.
+
+    Fixes #20338.
+
+    *Miguel Grazziotin*, *Matthew Draper*
+
+*   Omit default limit values in dumped schema. It's tidier, and if the defaults
+    change in the future, we can address that via Migration API Versioning.
+
+    *Jean Boussier*
+
+*   Support passing the schema name as a prefix to table name in
+    `ConnectionAdapters::SchemaStatements#indexes`. Previously the prefix would
+    be considered a full part of the index name, and only the schema in the
+    current search path would be considered.
+
+    *Grey Baker*
+
+*   Ignore index name in `index_exists?` and `remove_index` when not passed a
+    name to check for.
+
+    *Grey Baker*
+
+*   Extract support for the legacy `mysql` database adapter from core. It will
+    live on in a separate gem for now, but most users should just use `mysql2`.
+
+    *Abdelkader Boudih*
+
+*   ApplicationRecord is a new superclass for all app models, analogous to app
+    controllers subclassing ApplicationController instead of
+    ActionController::Base. This gives apps a single spot to configure app-wide
+    model behavior.
+
+    Newly generated applications have `app/models/application_record.rb`
+    present by default.
+
+    *Genadi Samokovarov*
+
+*   Version the API presented to migration classes, so we can change parameter
+    defaults without breaking existing migrations, or forcing them to be
+    rewritten through a deprecation cycle.
+
+    New migrations specify the Rails version they were written for:
+
+        class AddStatusToOrders < ActiveRecord::Migration[5.0]
+          def change
+            # ...
+          end
+        end
+
+    *Matthew Draper*, *Ravil Bayramgalin*
+
+*   Use bind params for `limit` and `offset`. This will generate significantly
+    fewer prepared statements for common tasks like pagination. To support this
+    change, passing a string containing a comma to `limit` has been deprecated,
+    and passing an Arel node to `limit` is no longer supported.
+
+    Fixes #22250.
+
+    *Sean Griffin*
+
+*   Introduce after_{create,update,delete}_commit callbacks.
+
+    Before:
+
+        after_commit :add_to_index_later, on: :create
+        after_commit :update_in_index_later, on: :update
+        after_commit :remove_from_index_later, on: :destroy
+
+    After:
+
+        after_create_commit  :add_to_index_later
+        after_update_commit  :update_in_index_later
+        after_destroy_commit :remove_from_index_later
+
+    Fixes #22515.
+
+    *Genadi Samokovarov*
+
+*   Respect the column default values for `inheritance_column` when
+    instantiating records through the base class.
+
+    Fixes #17121.
+
+    Example:
+
+        # The schema of BaseModel has `t.string :type, default: 'SubType'`
+        subtype = BaseModel.new
+        assert_equals SubType, subtype.class
+
+    *Kuldeep Aggarwal*
+
+*   Fix `rake db:structure:dump` on Postgres when multiple schemas are used.
+
+    Fixes #22346.
+
+    *Nick Muerdter*, *ckoenig*
+
+*   Add schema dumping support for PostgreSQL geometric data types.
+
+    *Ryuta Kamizono*
+
+*   Except keys of `build_record`'s argument from `create_scope` in `initialize_attributes`.
+
+    Fixes #21893.
+
+    *Yuichiro Kaneko*
+
+*   Deprecate `connection.tables` on the SQLite3 and MySQL adapters.
+    Also deprecate passing arguments to `#tables`.
+    And deprecate `table_exists?`.
+
+    The `#tables` method of some adapters (mysql, mysql2, sqlite3) would return
+    both tables and views while others (postgresql) just return tables. To make
+    their behavior consistent, `#tables` will return only tables in the future.
+
+    The `#table_exists?` method would check both tables and views. To make
+    their behavior consistent with `#tables`, `#table_exists?` will check only
+    tables in the future.
+
+    *Yuichiro Kaneko*
+
+*   Improve support for non Active Record objects on `validates_associated`
+
+    Skipping `marked_for_destruction?` when the associated object does not responds
+    to it make easier to validate virtual associations built on top of Active Model
+    objects and/or serialized objects that implement a `valid?` instance method.
+
+    *Kassio Borges*, *Lucas Mazza*
+
+*   Change connection management middleware to return a new response with
+    a body proxy, rather than mutating the original.
+
+    *Kevin Buchanan*
+
+*   Make `db:migrate:status` to render `1_some.rb` format migrate files.
+
+    These files are in `db/migrate`:
+
+        * 1_valid_people_have_last_names.rb
+        * 20150819202140_irreversible_migration.rb
+        * 20150823202140_add_admin_flag_to_users.rb
+        * 20150823202141_migration_tests.rb
+        * 2_we_need_reminders.rb
+        * 3_innocent_jointable.rb
+
+    Before:
+
+        $ bundle exec rake db:migrate:status
+        ...
+
+         Status   Migration ID    Migration Name
+        --------------------------------------------------
+           up     001             ********** NO FILE **********
+           up     002             ********** NO FILE **********
+           up     003             ********** NO FILE **********
+           up     20150819202140  Irreversible migration
+           up     20150823202140  Add admin flag to users
+           up     20150823202141  Migration tests
+
+    After:
+
+        $ bundle exec rake db:migrate:status
+        ...
+
+         Status   Migration ID    Migration Name
+        --------------------------------------------------
+           up     001             Valid people have last names
+           up     002             We need reminders
+           up     003             Innocent jointable
+           up     20150819202140  Irreversible migration
+           up     20150823202140  Add admin flag to users
+           up     20150823202141  Migration tests
+
+    *Yuichiro Kaneko*
+
+*   Define `ActiveRecord::Sanitization.sanitize_sql_for_order` and use it inside
+    `preprocess_order_args`.
+
+    *Yuichiro Kaneko*
+
+*   Allow bigint with default nil for avoiding auto increment primary key.
+
+    *Ryuta Kamizono*
+
+*   Remove `DEFAULT_CHARSET` and `DEFAULT_COLLATION` in `MySQLDatabaseTasks`.
+
+    We should omit the collation entirely rather than providing a default.
+    Then the choice is the responsibility of the server and MySQL distribution.
+
+    *Ryuta Kamizono*
+
+*   Alias `ActiveRecord::Relation#left_joins` to
+    `ActiveRecord::Relation#left_outer_joins`.
+
+    *Takashi Kokubun*
+
+*   Use advisory locking to raise a `ConcurrentMigrationError` instead of
+    attempting to migrate when another migration is currently running.
+
+    *Sam Davies*
+
+*   Added `ActiveRecord::Relation#left_outer_joins`.
+
+    Example:
+
+        User.left_outer_joins(:posts)
+        # => SELECT "users".* FROM "users" LEFT OUTER JOIN "posts" ON
+             "posts"."user_id" = "users"."id"
+
+    *Florian Thomas*
+
+*   Support passing an array to `order` for SQL parameter sanitization.
+
+    *Aaron Suggs*
+
+*   Avoid disabling errors on the PostgreSQL connection when enabling the
+    `standard_conforming_strings` setting. Errors were previously disabled because
+    the setting wasn't writable in Postgres 8.1 and didn't exist in earlier
+    versions. Now Rails only supports Postgres 8.2+ we're fine to assume the
+    setting exists. Disabling errors caused problems when using a connection
+    pooling tool like PgBouncer because it's not guaranteed to have the same
+    connection between calls to `execute` and it could leave the connection
+    with errors disabled.
+
+    Fixes #22101.
+
+    *Harry Marr*
+
+*   Set `scope.reordering_value` to `true` if `:reordering`-values are specified.
+
+    Fixes #21886.
+
+    *Hiroaki Izu*
+
+*   Add support for bidirectional destroy dependencies.
+
+    Fixes #13609.
+
+    Example:
+
+        class Content < ActiveRecord::Base
+          has_one :position, dependent: :destroy
+        end
+
+        class Position < ActiveRecord::Base
+          belongs_to :content, dependent: :destroy
+        end
+
+    *Seb Jacobs*
+
+*   Includes HABTM returns correct size now. It's caused by the join dependency
+    only instantiates one HABTM object because the join table hasn't a primary key.
+
+    Fixes #16032.
+
+    Examples:
+
+        before:
+
+        Project.first.salaried_developers.size # => 3
+        Project.includes(:salaried_developers).first.salaried_developers.size # => 1
+
+        after:
+
+        Project.first.salaried_developers.size # => 3
+        Project.includes(:salaried_developers).first.salaried_developers.size # => 3
+
+    *Bigxiang*
+
+*   Add option to index errors in nested attributes.
+
+    For models which have nested attributes, errors within those models will
+    now be indexed if `:index_errors` option is set to true when defining a
+    `has_many` relationship or by setting the configuration option
+    `config.active_record.index_nested_attribute_errors` to true.
+
+    Example:
+
+        class Guitar < ActiveRecord::Base
+          has_many :tuning_pegs, index_errors: true
+          accepts_nested_attributes_for :tuning_pegs
+        end
+
+        class TuningPeg < ActiveRecord::Base
+          belongs_to :guitar
+          validates_numericality_of :pitch
+        end
+
+        # Before
+        guitar.errors["tuning_pegs.pitch"] = ["is not a number"]
+
+        # After
+        guitar.errors["tuning_pegs[1].pitch"] = ["is not a number"]
+
+    *Michael Probber*, *Terence Sun*
+
+*   Exit with non-zero status for failed database rake tasks.
+
+    *Jay Hayes*
+
+*   Queries such as `Computer.joins(:monitor).group(:status).count` will now be
+    interpreted as  `Computer.joins(:monitor).group('computers.status').count`
+    so that when `Computer` and `Monitor` have both `status` columns we don't
+    have conflicts in projection.
+
+    *Rafael Sales*
+
+*   Add ability to default to `uuid` as primary key when generating database migrations.
+
+    Example:
+
+        config.generators do |g|
+          g.orm :active_record, primary_key_type: :uuid
+        end
+
+    *Jon McCartie*
+
+*   Don't cache arguments in `#find_by` if they are an `ActiveRecord::Relation`.
+
+    Fixes #20817.
+
+    *Hiroaki Izu*
+
+*   Qualify column name inserted by `group` in calculation.
+
+    Giving `group` an unqualified column name now works, even if the relation
+    has `JOIN` with another table which also has a column of the name.
+
+    *Soutaro Matsumoto*
+
+*   Don't cache prepared statements containing an IN clause or a SQL literal, as
+    these queries will change often and are unlikely to have a cache hit.
+
+    *Sean Griffin*
+
+*   Fix `rewhere` in a `has_many` association.
+
+    Fixes #21955.
+
+    *Josh Branchaud*, *Kal*
+
+*   `where` raises ArgumentError on unsupported types.
+
+    Fixes #20473.
+
+    *Jake Worth*
+
+*   Add an immutable string type to help reduce memory usage for apps which do
+    not need mutation detection on strings.
+
+    *Sean Griffin*
+
+*   Give `ActiveRecord::Relation#update` its own deprecation warning when
+    passed an `ActiveRecord::Base` instance.
+
+    Fixes #21945.
+
+    *Ted Johansson*
+
+*   Make it possible to pass `:to_table` when adding a foreign key through
+    `add_reference`.
+
+    Fixes #21563.
 
+    *Yves Senn*
 
-## Rails 3.2.18 (May 6, 2014) ##
+*   No longer pass deprecated option `-i` to `pg_dump`.
 
-* No changes.
+    *Paul Sadauskas*
 
+*   Concurrent `AR::Base#increment!` and `#decrement!` on the same record
+    are all reflected in the database rather than overwriting each other.
 
-## Rails 3.2.17 (Feb 18, 2014) ##
+    *Bogdan Gusiev*
 
-* No changes.
+*   Avoid leaking the first relation we call `first` on, per model.
 
+    Fixes #21921.
 
-## Rails 3.2.16 (Dec 3, 2013) ##
+    *Matthew Draper*, *Jean Boussier*
 
-* No changes.
+*   Remove unused `pk_and_sequence_for` in `AbstractMysqlAdapter`.
 
+    *Ryuta Kamizono*
 
-## Rails 3.2.15 (Oct 16, 2013) ##
+*   Allow fixtures files to set the model class in the YAML file itself.
 
-*   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.
+    To load the fixtures file `accounts.yml` as the `User` model, use:
 
-    *arthurnn*
+        _fixture:
+          model_class: User
+        david:
+          name: David
 
-*   Callbacks on has_many should access the in memory parent if a inverse_of is set.
+    Fixes #9516.
 
-    *arthurnn*
+    *Roque Pinel*
 
-*   Fix `FinderMethods#last` unscoped primary key.
+*   Don't require a database connection to load a class which uses acceptance
+    validations.
 
-    Fixes #11917.
+    *Sean Griffin*
 
-    *Eugene Kalenkovich*
+*   Correctly apply `unscope` when preloading through associations.
 
-*   Load fixtures from linked folders.
+    *Jimmy Bourassa*
 
-    *Kassio Borges*
+*   Fixed taking precision into count when assigning a value to timestamp attribute.
 
-*   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.
+    Timestamp column can have less precision than ruby timestamp
+    In result in how big a fraction of a second can be stored in the
+    database.
 
-    Fixes: #6763
 
-    *Alfred Wong*
+        m = Model.create!
+        m.created_at.usec == m.reload.created_at.usec # => false
+        # due to different precision in Time.now and database column
 
+    If the precision is low enough, (mysql default is 0, so it is always low
+    enough by default) the value changes when model is reloaded from the
+    database. This patch fixes that issue ensuring that any timestamp
+    assigned as an attribute is converted to column precision under the
+    attribute.
 
-## Rails 3.2.14 (Jul 22, 2013) ##
+    *Bogdan Gusiev*
 
-*   Fix merge error when Equality LHS is non-attribute.
-    Backport of #7380.
+*   Introduce `connection.data_sources` and `connection.data_source_exists?`.
+    These methods determine what relations can be used to back Active Record
+    models (usually tables and views).
 
-    *Karmes Alexander*
+    Also deprecate `SchemaCache#tables`, `SchemaCache#table_exists?` and
+    `SchemaCache#clear_table_cache!` in favor of their new data source
+    counterparts.
 
-*   Do not re-create destroyed association when saving the parent object.
+    *Yves Senn*, *Matthew Draper*
 
-    Fixes #11450.
+*   Add `ActiveRecord::Base.ignored_columns` to make some columns
+    invisible from Active Record.
 
-    *Paul Nikitochkin*
+    *Jean Boussier*
 
-*   Do not shallow the original exception in `exec_cache` on PostgreSQL adapter.
+*   `ActiveRecord::Tasks::MySQLDatabaseTasks` fails if shellout to
+    mysql commands (like `mysqldump`) is not successful.
 
-    Fixes #11260.
+    *Steve Mitchell*
 
-    *Rafael Mendonça França*
+*   Ensure `select` quotes aliased attributes, even when using `from`.
+
+    Fixes #21488.
+
+    *Sean Griffin*, *@johanlunds*
 
-*   Fix `ActiveRecord::Store` incorrectly tracking changes of its attributes.
-    Fixes #10373.
+*   MySQL: support `unsigned` numeric data types.
 
-    *Janko Marohnić*
+    Example:
 
-*   Fix a bug that prevented the use of the default STI inheritance column
-    (ActiveRecord::Base.inheritance_column = 'some_column'.)
+        create_table :foos do |t|
+          t.unsigned_integer :quantity
+          t.unsigned_bigint  :total
+          t.unsigned_float   :percentage
+          t.unsigned_decimal :price, precision: 10, scale: 2
+        end
 
-    *chapmajs + Takehiro Adachi*
+    The `unsigned: true` option may be used for the primary key:
 
-*   Fix mysql2 adapter raises the correct exception when executing a query on a
-    closed connection.
+        create_table :foos, id: :bigint, unsigned: true do |t|
+          …
+        end
 
-    *Yves Senn*
+    *Ryuta Kamizono*
 
-*   Fixes bug where `Company.new.contract_ids` would incorrectly load
-    all non-associated contracts.
+*   Add `#views` and `#view_exists?` methods on connection adapters.
+
+    *Ryuta Kamizono*
+
+*   Correctly dump composite primary key.
 
     Example:
 
-        company = Company.new # Company has many :contracts
+        create_table :barcodes, primary_key: ["region", "code"] do |t|
+          t.string :region
+          t.integer :code
+        end
 
-        # before
-        company.contract_ids # => SELECT ... WHERE `contracts`.`company_id` IS NULL
+    *Ryuta Kamizono*
 
-        # after
-        company.contract_ids # => []
+*   Lookup the attribute name for `restrict_with_error` messages on the
+    model class that defines the association.
 
-    *Jared Armstrong*
+    *kuboon*, *Ronak Jangir*
 
-*   Fix the `:primary_key` option for `has_many` associations.
-    Fixes #10693.
+*   Correct query for PostgreSQL 8.2 compatibility.
 
-    *Yves Senn*
+    *Ben Murphy*, *Matthew Draper*
 
-*   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.
+*   `bin/rails db:migrate` uses
+    `ActiveRecord::Tasks::DatabaseTasks.migrations_paths` instead of
+    `Migrator.migrations_paths`.
 
-    Backport of #10417
+    *Tobias Bielohlawek*
 
-    *Johnny Holton*
+*   Support dropping indexes concurrently in PostgreSQL.
 
-*   Fix that under some conditions, Active Record could produce invalid SQL of the sort:
-    "SELECT DISTINCT DISTINCT".
+    See http://www.postgresql.org/docs/9.4/static/sql-dropindex.html for more
+    details.
 
-    Backport of #6792.
+    *Grey Baker*
 
-    *Ben Woosley*
+*   Deprecate passing conditions to `ActiveRecord::Relation#delete_all`
+    and `ActiveRecord::Relation#destroy_all`.
+
+    *Wojciech Wnętrzak*
 
-*   Require `ActiveRecord::Base` in railtie hooks for rake_tasks, console and runner to
-    avoid circular constant loading issues.
+*   Instantiating an AR model with `ActionController::Parameters` now raises
+    an `ActiveModel::ForbiddenAttributesError` if the parameters include a
+    `type` field that has not been explicitly permitted. Previously, the
+    `type` field was simply ignored in the same situation.
 
-    Backport #7695.
+    *Prem Sichanugrist*
 
-    Fixes #7683 and #882
+*   PostgreSQL, `create_schema`, `drop_schema` and `rename_table` now quote
+    schema names.
 
-    *Ben Holley*
+    Fixes #21418.
 
-*   Maintain context for joins within ActiveRecord::Relation merges.
-    Backport #10164.
+    Example:
 
-    *Neeraj Singh + Andrew Horner*
+        create_schema("my.schema")
+        # CREATE SCHEMA "my.schema";
 
-*   Make sure the `EXPLAIN` command is never triggered by a `select_db` call.
+    *Yves Senn*
 
-    *Daniel Schierbeck*
+*   PostgreSQL, add `:if_exists` option to `#drop_schema`. This makes it
+    possible to drop a schema that might exist without raising an exception if
+    it doesn't.
 
-*   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.
+    *Yves Senn*
 
-    Fixes #9777.
+*   Only try to nullify has_one target association if the record is persisted.
 
-    *Rafael Mendonça França*
+    Fixes #21223.
 
-*   Confirm a record has not already been destroyed before decrementing counter cache.
+    *Agis Anastasopoulos*
 
-    *Ben Tucker*
+*   Uniqueness validator raises descriptive error when running on a persisted
+    record without primary key.
 
-*   Default values for PostgreSQL bigint types now get parsed and dumped to the
-    schema correctly.
-    Backport #10098.
+    Fixes #21304.
 
-    *Erik Peterson*
+    *Yves Senn*
 
-*   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.
+*   Add a native JSON data type support in MySQL.
 
-    *Rafael Mendonça França*
+    Example:
+
+        create_table :json_data_type do |t|
+          t.json :settings
+        end
+
+    *Ryuta Kamizono*
+
+*   Descriptive error message when fixtures contain a missing column.
+
+    Fixes #21201.
+
+    *Yves Senn*
 
-*   Do not reset `inheritance_column` when it's set explicitly.
-    Backport of #5327.
+*   `ActiveRecord::Tasks::PostgreSQLDatabaseTasks` fail if shellout to
+    postgresql commands (like `pg_dump`) is not successful.
 
-    *kennyj + Fred Wu*
+    *Bryan Paxton*, *Nate Berkopec*
 
-*   Fix a problem wrong exception is occured
-    when raising no translatable exception in PostgreSQL.
+*   Add `ActiveRecord::Relation#in_batches` to work with records and relations
+    in batches.
 
-    *kennyj*
+    Available options are `of` (batch size), `load`, `start`, and `finish`.
 
-*   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.
+    Examples:
 
-    *Juan M. Cuello + Dembskiy Alexander*
+        Person.in_batches.each_record(&:party_all_night!)
+        Person.in_batches.update_all(awesome: true)
+        Person.in_batches.delete_all
+        Person.in_batches.each do |relation|
+          relation.delete_all
+          sleep 10 # Throttles the delete queries
+        end
 
-*   Reload the association target if it's stale. `@stale_state` should be nil
-    when a model isn't saved.
-    Fixes #7526.
+    Fixes #20933.
 
-    *Larry Lv*
+    *Sina Siadat*
 
-*   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.
+*   Added methods for PostgreSQL geometric data types to use in migrations.
 
-    *kennyj*
+    Example:
 
+        create_table :foo do |t|
+          t.line :foo_line
+          t.lseg :foo_lseg
+          t.box :foo_box
+          t.path :foo_path
+          t.polygon :foo_polygon
+          t.circle :foo_circle
+        end
 
-## Rails 3.2.13 (Mar 18, 2013) ##
+    *Mehmet Emin İNAÇ*
 
-*   Chaining multiple preloaded scopes will correctly preload all the scopes
-    at the same time.
+*   Add `cache_key` to ActiveRecord::Relation.
 
-    *Chris Geihsler*
+    Example:
 
-*   Reverted 921a296a3390192a71abeec6d9a035cc6d1865c8, 'Quote numeric values
-    compared to string columns.' This caused several regressions.
+        @users = User.where("name like ?", "%Alberto%")
+        @users.cache_key
+        # => "/users/query-5942b155a43b139f2471b872ac54251f-3-20150714212107656125000"
 
-    *Steve Klabnik*
+    *Alberto Fernández-Capel*
 
-*   Fix overriding of attributes by `default_scope` on `ActiveRecord::Base#dup`.
+*   Properly allow uniqueness validations on primary keys.
 
-    *Hiroshige UMINO*
+    Fixes #20966.
 
-*   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.
+    *Sean Griffin*, *presskey*
 
-    *Peter Brown*
+*   Don't raise an error if an association failed to destroy when `destroy` was
+    called on the parent (as opposed to `destroy!`).
 
-*   Sqlite now preserves custom primary keys when copying or altering tables.
-    Fixes #9367.
-    Backport #2312.
+    Fixes #20991.
 
-    *Sean Scally + Yves Senn*
+    *Sean Griffin*
 
-*   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.
+*   `ActiveRecord::RecordNotFound` modified to store model name, primary_key and
+    id of the caller model. It allows the catcher of this exception to make
+    a better decision to what to do with it.
 
     Example:
 
-        class User
-          has_many :posts
-          has_many :recent_comments, -> { where('created_at > ?', 1.week.ago) }, :through => :posts
+        class SomeAbstractController < ActionController::Base
+          rescue_from ActiveRecord::RecordNotFound, with: :redirect_to_404
+
+          private def redirect_to_404(e)
+            return redirect_to(posts_url) if e.model == 'Post'
+            raise
+          end
         end
 
-        a_user = User.includes(:recent_comments).first
+    *Sameer Rahmani*
+
+*   Deprecate the keys for association `restrict_dependent_destroy` errors in favor
+    of new key names.
+
+    Previously `has_one` and `has_many` associations were using the
+    `one` and `many` keys respectively. Both of these keys have special
+    meaning in I18n (they are considered to be pluralizations) so by
+    renaming them to `has_one` and `has_many` we make the messages more explicit
+    and most importantly they don't clash with linguistical systems that need to
+    validate translation keys (and their pluralizations).
+
+    The `:'restrict_dependent_destroy.one'` key should be replaced with
+    `:'restrict_dependent_destroy.has_one'`, and `:'restrict_dependent_destroy.many'`
+    with `:'restrict_dependent_destroy.has_many'`.
+
+    *Roque Pinel*, *Christopher Dell*
+
+*   Fix state being carried over from previous transaction.
+
+    Considering the following example where `name` is a required attribute.
+    Before we had `new_record?` returning `true` for a persisted record:
+
+        author = Author.create! name: 'foo'
+        author.name = nil
+        author.save        # => false
+        author.new_record? # => true
+
+    Fixes #20824.
+
+    *Roque Pinel*
+
+*   Correctly ignore `mark_for_destruction` when `autosave` isn't set to `true`
+    when validating associations.
+
+    Fixes #20882.
+
+    *Sean Griffin*
+
+*   Fix a bug where counter_cache doesn't always work with polymorphic
+    relations.
+
+    Fixes #16407.
+
+    *Stefan Kanev*, *Sean Griffin*
+
+*   Ensure that cyclic associations with autosave don't cause duplicate errors
+    to be added to the parent record.
+
+    Fixes #20874.
+
+    *Sean Griffin*
+
+*   Ensure that `ActionController::Parameters` can still be passed to nested
+    attributes.
+
+    Fixes #20922.
+
+    *Sean Griffin*
+
+*   Deprecate force association reload by passing a truthy argument to
+    association method.
+
+    For collection association, you can call `#reload` on association proxy to
+    force a reload:
+
+        @user.posts.reload   # Instead of @user.posts(true)
+
+    For singular association, you can call `#reload` on the parent object to
+    clear its association cache then call the association method:
+
+        @user.reload.profile   # Instead of @user.profile(true)
 
-        # this is preloaded
-        a_user.recent_comments
+    Passing a truthy argument to force association to reload will be removed in
+    Rails 5.1.
 
-        # fetching the recent_comments through the posts association won't preload it.
-        a_user.posts
+    *Prem Sichanugrist*
+
+*   Replaced `ActiveSupport::Concurrency::Latch` with `Concurrent::CountDownLatch`
+    from the concurrent-ruby gem.
+
+    *Jerry D'Antonio*
+
+*   Fix through associations using scopes having the scope merged multiple
+    times.
+
+    Fixes #20721.
+    Fixes #20727.
+
+    *Sean Griffin*
+
+*   `ActiveRecord::Base.dump_schema_after_migration` applies migration tasks
+    other than `db:migrate`. (eg. `db:rollback`, `db:migrate:dup`, ...)
+
+    Fixes #20743.
 
     *Yves Senn*
 
-*   Fix handling of dirty time zone aware attributes
+*   Add alternate syntax to make `change_column_default` reversible.
 
-    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.
+    User can pass in `:from` and `:to` to make `change_column_default` command
+    become reversible.
 
     Example:
 
-        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
+        change_column_default :posts, :status, from: nil, to: "draft"
+        change_column_default :users, :authorized, from: true, to: false
 
-          # changing value
-          order.shipped_at = Time.local(2013, 1, 1)
-          order.changed? # => true
+    *Prem Sichanugrist*
 
-          # reverting to original value
-          order.shipped_at = original_time
-          order.changed? # => false, used to return true
-        end
+*   Prevent error when using `force_reload: true` on an unassigned polymorphic
+    belongs_to association.
 
-    Backport of #9073
-    Fixes #8898
+    Fixes #20426.
 
-    *Lilibeth De La Cruz*
+    *James Dabbs*
 
-*   Fix counter cache columns not updated when replacing `has_many :through`
-    associations.
-    Backport #8400.
-    Fix #7630.
+*   Correctly raise `ActiveRecord::AssociationTypeMismatch` when assigning
+    a wrong type to a namespaced association.
+
+    Fixes #20545.
+
+    *Diego Carrion*
+
+*   `validates_absence_of` respects `marked_for_destruction?`.
+
+    Fixes #20449.
+
+    *Yves Senn*
+
+*   Include the `Enumerable` module in `ActiveRecord::Relation`
+
+    *Sean Griffin*, *bogdan*
+
+*   Use `Enumerable#sum` in `ActiveRecord::Relation` if a block is given.
+
+    *Sean Griffin*
+
+*   Let `WITH` queries (Common Table Expressions) be explainable.
+
+    *Vladimir Kochnev*
+
+*   Make `remove_index :table, :column` reversible.
+
+    *Yves Senn*
+
+*   Fixed an error which would occur in dirty checking when calling
+    `update_attributes` from a getter.
+
+    Fixes #20531.
+
+    *Sean Griffin*
+
+*   Make `remove_foreign_key` reversible. Any foreign key options must be
+    specified, similar to `remove_column`.
+
+    *Aster Ryan*
+
+*   Add `:_prefix` and `:_suffix` options to `enum` definition.
+
+    Fixes #17511, #17415.
+
+    *Igor Kapkov*
 
-    *Matthew Robertson*
+*   Correctly handle decimal arrays with defaults in the schema dumper.
 
-*   Don't update `column_defaults` when calling destructive methods on column with default value.
-    Backport c517602.
-    Fix #6115.
+    Fixes #20515.
 
-    *Piotr Sarnacki + Aleksey Magusev + Alan Daud*
+    *Sean Griffin*, *jmondo*
 
-*   When `#count` is used in conjunction with `#uniq` we perform `count(:distinct => true)`.
-    Fix #6865.
+*   Deprecate the PostgreSQL `:point` type in favor of a new one which will return
+    `Point` objects instead of an `Array`
+
+    *Sean Griffin*
+
+*   Ensure symbols passed to `ActiveRecord::Relation#select` are always treated
+    as columns.
+
+    Fixes #20360.
+
+    *Sean Griffin*
+
+*   Do not set `sql_mode` if `strict: :default` is specified.
+
+        # config/database.yml
+        production:
+          adapter: mysql2
+          database: foo_prod
+          user: foo
+          strict: :default
+
+    *Ryuta Kamizono*
+
+*   Allow proc defaults to be passed to the attributes API. See documentation
+    for examples.
+
+    *Sean Griffin*, *Kir Shatrov*
+
+*   SQLite: `:collation` support for string and text columns.
 
     Example:
 
-      relation.uniq.count # => SELECT COUNT(DISTINCT *)
+        create_table :foo do |t|
+          t.string :string_nocase, collation: 'NOCASE'
+          t.text :text_rtrim, collation: 'RTRIM'
+        end
 
-    *Yves Senn + Kaspar Schiess*
+        add_column :foo, :title, :string, collation: 'RTRIM'
 
-*   Fix `ActiveRecord::Relation#pluck` when columns or tables are reserved words.
-    Backport #7536.
-    Fix #8968.
+        change_column :foo, :title, :string, collation: 'NOCASE'
 
-    *Ian Lesperance + Yves Senn + Kaspar Schiess*
+    *Akshay Vishnoi*
 
-*   Don't run explain on slow queries for database adapters that don't support it.
-    Backport #6197.
+*   Allow the use of symbols or strings to specify enum values in test
+    fixtures:
 
-    *Blake Smith*
+        awdr:
+          title: "Agile Web Development with Rails"
+          status: :proposed
 
-*   Revert round usec when comparing timestamp attributes in the dirty tracking.
-    Fixes #8460.
+    *George Claghorn*
 
-    *Andrew White*
+*   Clear query cache when `ActiveRecord::Base#reload` is called.
 
-*   Revert creation of through association models when using `collection=[]`
-    on a `has_many :through` association from an unsaved model.
-    Fix #7661, #8269.
+    *Shane Hender, Pierre Nespo*
 
-    *Ernie Miller*
+*   Include stored procedures and function on the MySQL structure dump.
 
-*   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.
+    *Jonathan Worek*
 
-    *Jason Stirk + Tristan Harward*
+*   Pass `:extend` option for `has_and_belongs_to_many` associations to the
+    underlying `has_many :through`.
 
-*   Serialized attributes can be serialized in integer columns.
-    Fix #8575.
+    *Jaehyun Shin*
 
-    *Rafael Mendonça França*
+*   Deprecate `Relation#uniq` use `Relation#distinct` instead.
 
-*   Keep index names when using `alter_table` with sqlite3.
-    Fix #3489.
-    Backport #8522.
+    See #9683.
 
     *Yves Senn*
 
-*   Recognize migrations placed in directories containing numbers and 'rb'.
-    Fix #8492.
-    Backport of #8500.
+*   Allow single table inheritance instantiation to work when storing
+    demodulized class names.
 
-    *Yves Senn*
+    *Alex Robbin*
 
-*   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.
+*   Correctly pass MySQL options when using `structure_dump` or
+    `structure_load`.
 
-    *Rafael Mendonça França*
+    Specifically, it fixes an issue when using SSL authentication.
+
+    *Alex Coomans*
 
-*   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.
+*   Correctly dump `:options` on `create_table` for MySQL.
 
-    *Jamie Gaskins*
+    *Ryuta Kamizono*
 
-*   Unscope `update_column(s)` query to ignore default scope.
+*   PostgreSQL: `:collation` support for string and text columns.
 
-    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.
+    Example:
 
-        class User < ActiveRecord::Base
-          default_scope where(active: true)
+        create_table :foos do |t|
+          t.string :string_en, collation: 'en_US.UTF-8'
+          t.text   :text_ja,   collation: 'ja_JP.UTF-8'
         end
 
-        user = User.first
-        user.active = false
-        user.save!
+    *Ryuta Kamizono*
 
-        user.update_column(:active, true) # => false
+*   Remove `ActiveRecord::Serialization::XmlSerializer` from core.
 
-    In this situation we want to skip the default_scope clause and just
-    update the record based on the primary key. With this change:
+    *Zachary Scott*
 
-        user.update_column(:active, true) # => true
+*   Make `unscope` aware of "less than" and "greater than" conditions.
 
-    Backport of #8436 fix.
+    *TAKAHASHI Kazuaki*
 
-    *Carlos Antonio da Silva*
+*   `find_by` and `find_by!` raise `ArgumentError` when called without
+    arguments.
 
-*   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
+    *Kohei Suzuki*
 
-    *kennyj*
+*   Revert behavior of `db:schema:load` back to loading the full
+    environment. This ensures that initializers are run.
 
-*   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
+    Fixes #19545.
 
     *Yves Senn*
 
-*   Fix `pluck` to work with joins. Backport of #4942.
+*   Fix missing index when using `timestamps` with the `index` option.
+
+    The `index` option used with `timestamps` should be passed to both
+    `column` definitions for `created_at` and `updated_at` rather than just
+    the first.
 
-    *Carlos Antonio da Silva*
+    *Paul Mucur*
 
-*   Fix a problem with `translate_exception` method in a non English environment.
-    Backport of #6397.
+*   Rename `:class` to `:anonymous_class` in association options.
 
-    *kennyj*
+    Fixes #19659.
 
-*   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.
+    *Andrew White*
 
-    *Alisdair McDiarmid*
+*   Autosave existing records on a has many through association when the parent
+    is new.
 
-*   Prevent mass assignment to the type column of polymorphic associations when using `build`.
-    Fixes #8265.
-    Backport of #8291.
+    Fixes #19782.
 
-    *Yves Senn*
+    *Sean Griffin*
 
-*   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.
+*   Fixed a bug where uniqueness validations would error on out of range values,
+    even if an validation should have prevented it from hitting the database.
 
-    *Victor Costan*
+    *Andrey Voronkov*
 
-*   `#pluck` can be used on a relation with `select` clause.
-    Fixes #7551.
-    Backport of #8176.
+*   MySQL: `:charset` and `:collation` support for string and text columns.
 
     Example:
 
-        Topic.select([:approved, :id]).order(:id).pluck(:id)
+        create_table :foos do |t|
+          t.string :string_utf8_bin, charset: 'utf8', collation: 'utf8_bin'
+          t.text   :text_ascii,      charset: 'ascii'
+        end
 
-    *Yves Senn*
+    *Ryuta Kamizono*
+
+*   Foreign key related methods in the migration DSL respect
+    `ActiveRecord::Base.pluralize_table_names = false`.
+
+    Fixes #19643.
+
+    *Mehmet Emin İNAÇ*
+
+*   Reduce memory usage from loading types on PostgreSQL.
+
+    Fixes #19578.
+
+    *Sean Griffin*
+
+*   Add `config.active_record.warn_on_records_fetched_greater_than` option.
+
+    When set to an integer, a warning will be logged whenever a result set
+    larger than the specified size is returned by a query.
+
+    Fixes #16463.
+
+    *Jason Nochlin*
 
-*   Use `nil?` instead of `blank?` to check whether dynamic finder with a bang
-    should raise RecordNotFound.
-    Fixes #7238.
+*   Ignore `.psqlrc` when loading database structure.
 
-    *Nikita Afanasenko*
+    *Jason Weathered*
 
-*   Fix deleting from a HABTM join table upon destroying an object of a model
-    with optimistic locking enabled.
-    Fixes #5332.
+*   Fix referencing wrong table aliases while joining tables of has many through
+    association (only when calling calculation methods).
 
-    *Nick Rogers*
+    Fixes #19276.
 
-*   Use query cache/uncache when using ENV["DATABASE_URL"].
-    Fixes #6951.
-    Backport of #8074.
+    *pinglamb*
 
-    *kennyj*
+*   Correctly persist a serialized attribute that has been returned to
+    its default value by an in-place modification.
 
-*   Do not create useless database transaction when building `has_one` association.
+    Fixes #19467.
+
+    *Matthew Draper*
+
+*   Fix generating the schema file when using PostgreSQL `BigInt[]` data type.
+    Previously the `limit: 8` was not coming through, and this caused it to
+    become `Int[]` data type after rebuilding from the schema.
+
+    Fixes #19420.
+
+    *Jake Waller*
+
+*   Reuse the `CollectionAssociation#reader` cache when the foreign key is
+    available prior to save.
+
+    *Ben Woosley*
+
+*   Add `config.active_record.dump_schemas` to fix `db:structure:dump`
+    when using schema_search_path and PostgreSQL extensions.
+
+    Fixes #17157.
+
+    *Ryan Wallace*
+
+*   Renaming `use_transactional_fixtures` to `use_transactional_tests` for clarity.
+
+    Fixes #18864.
+
+    *Brandon Weiss*
+
+*   Increase pg gem version requirement to `~> 0.18`. Earlier versions of the
+    pg gem are known to have problems with Ruby 2.2.
+
+    *Matt Brictson*
+
+*   Correctly dump `serial` and `bigserial`.
+
+    *Ryuta Kamizono*
+
+*   Fix default `format` value in `ActiveRecord::Tasks::DatabaseTasks#schema_file`.
+
+    *James Cox*
+
+*   Don't enroll records in the transaction if they don't have commit callbacks.
+    This was causing a memory leak when creating many records inside a transaction.
+
+    Fixes #15549.
+
+    *Will Bryant*, *Aaron Patterson*
+
+*   Correctly create through records when created on a has many through
+    association when using `where`.
+
+    Fixes #19073.
+
+    *Sean Griffin*
+
+*   Add `SchemaMigration.create_table` support for any unicode charsets with MySQL.
+
+    *Ryuta Kamizono*
+
+*   PostgreSQL no longer disables user triggers if system triggers can't be
+    disabled. Disabling user triggers does not fulfill what the method promises.
+    Rails currently requires superuser privileges for this method.
+
+    If you absolutely rely on this behavior, consider patching
+    `disable_referential_integrity`.
+
+    *Yves Senn*
+
+*   Restore aborted transaction state when `disable_referential_integrity` fails
+    due to missing permissions.
+
+    *Toby Ovod-Everett*, *Yves Senn*
+
+*   In PostgreSQL, print a warning message if `disable_referential_integrity`
+    fails due to missing permissions.
+
+    *Andrey Nering*, *Yves Senn*
+
+*   Allow a `:limit` option for MySQL bigint primary key support.
 
     Example:
 
-        User.has_one :profile
-        User.new.build_profile
+        create_table :foos, id: :primary_key, limit: 8 do |t|
+        end
 
-    Backport of #8154.
+        # or
 
-    *Bogdan Gusiev*
+        create_table :foos, id: false do |t|
+          t.primary_key :id, limit: 8
+        end
 
-*   `AR::Base#attributes_before_type_cast` now returns unserialized values for serialized attributes.
+    *Ryuta Kamizono*
 
-    *Nikita Afanasenko*
+*   `belongs_to` will now trigger a validation error by default if the association is not present.
+    You can turn this off on a per-association basis with `optional: true`.
+    (Note this new default only applies to new Rails apps that will be generated with
+    `config.active_record.belongs_to_required_by_default = true` in initializer.)
 
-*   Fix issue that raises `NameError` when overriding the `accepts_nested_attributes` in child classes.
+    *Josef Šimánek*
 
-    Before:
+*   Fixed `ActiveRecord::Relation#becomes!` and `changed_attributes` issues for type
+    columns.
 
-        class Shared::Person < ActiveRecord::Base
-          has_one :address
+    Fixes #17139.
 
-          accepts_nested_attributes :address, :reject_if => :all_blank
+    *Miklos Fazekas*
+
+*   Format the time string according to the precision of the time column.
+
+    *Ryuta Kamizono*
+
+*   Allow a `:precision` option for time type columns.
+
+    *Ryuta Kamizono*
+
+*   Add `ActiveRecord::Base.suppress` to prevent the receiver from being saved
+    during the given block.
+
+    For example, here's a pattern of creating notifications when new comments
+    are posted. (The notification may in turn trigger an email, a push
+    notification, or just appear in the UI somewhere):
+
+        class Comment < ActiveRecord::Base
+          belongs_to :commentable, polymorphic: true
+          after_create -> { Notification.create! comment: self,
+            recipients: commentable.recipients }
         end
 
-        class Person < Shared::Person
-          accepts_nested_attributes :address
+    That's what you want the bulk of the time. A new comment creates a new
+    Notification. There may be edge cases where you don't want that, like
+    when copying a commentable and its comments, in which case write a
+    concern with something like this:
+
+        module Copyable
+          def copy_to(destination)
+            Notification.suppress do
+              # Copy logic that creates new comments that we do not want triggering
+              # notifications.
+            end
+          end
         end
 
-        Person
-        #=> NameError: method `address_attributes=' not defined in Person
+    *Michael Ryan*
 
-    After:
+*   `:time` option added for `#touch`.
+
+    Fixes #18905.
+
+    *Hyonjee Joo*
+
+*   Add `foreign_key_exists?` method.
+
+    *Tõnis Simo*
+
+*   Use SQL COUNT and LIMIT 1 queries for `none?` and `one?` methods
+    if no block or limit is given, instead of loading the entire
+    collection into memory. This applies to relations (e.g. `User.all`)
+    as well as associations (e.g. `account.users`)
 
-        Person
-        #=> Person(id: integer, ...)
+        # Before:
 
-    Fixes #8131.
+        users.none?
+        # SELECT "users".* FROM "users"
 
-    *Gabriel Sobrinho, Ricardo Henrique*
+        users.one?
+        # SELECT "users".* FROM "users"
 
+        # After:
 
-## Rails 3.2.12 (Feb 11, 2013) ##
+        users.none?
+        # SELECT 1 AS one FROM "users" LIMIT 1
 
-*   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.
+        users.one?
+        # SELECT COUNT(*) FROM "users"
+
+    *Eugene Gilburg*
+
+*   Have `enum` perform type casting consistently with the rest of Active
+    Record, such as `where`.
+
+    *Sean Griffin*
+
+*   `scoping` no longer pollutes the current scope of sibling classes when using
+    STI.
+
+    Fixes #18806.
 
     Example:
 
-        App.where(apikey: 0) # => SELECT * FROM users WHERE apikey = '0'
+        StiOne.none.scoping do
+          StiTwo.all
+        end
+
 
-    *Dylan Smith*
+    *Sean Griffin*
 
+*   `remove_reference` with `foreign_key: true` removes the foreign key before
+    removing the column. This fixes a bug where it was not possible to remove
+    the column on MySQL.
 
-## Rails 3.2.11 (Jan 8, 2013) ##
+    Fixes #18664.
 
-*   Fix querying with an empty hash *Damien Mathieu* [CVE-2013-0155]
+    *Yves Senn*
 
+*   `find_in_batches` now accepts an `:finish` parameter that complements the `:start`
+     parameter to specify where to stop batch processing.
 
-## Rails 3.2.10 (Jan 2, 2013) ##
+    *Vipul A M*
 
-*   CVE-2012-5664 options hashes should only be extracted if there are extra
-    parameters
+*   Fix a rounding problem for PostgreSQL timestamp columns.
 
+    If a timestamp column has a precision specified, it needs to
+    format according to that.
 
-## Rails 3.2.9 (Nov 12, 2012) ##
+    *Ryuta Kamizono*
 
-*   Fix `find_in_batches` crashing when IDs are strings and start option is not specified.
+*   Respect the database default charset for `schema_migrations` table.
 
-    *Alexis Bernard*
+    The charset of `version` column in `schema_migrations` table depends
+    on the database default charset and collation rather than the encoding
+    of the connection.
 
-*   Fix issue with collection associations calling first(n)/last(n) and attempting
-    to set the inverse association when `:inverse_of` was used. Fixes #8087.
+    *Ryuta Kamizono*
 
-    *Carlos Antonio da Silva*
+*   Raise `ArgumentError` when passing `nil` or `false` to `Relation#merge`.
 
-*   Fix bug when Column is trying to type cast boolean values to integer.
-    Fixes #8067.
+    These are not valid values to merge in a relation, so it should warn users
+    early.
 
     *Rafael Mendonça França*
 
-*   Fix bug where `rake db:test:prepare` tries to load the structure.sql into development database.
-    Fixes #8032.
+*   Use `SCHEMA` instead of `DB_STRUCTURE` for specifying a structure file.
 
-    *Grace Liu + Rafael Mendonça França*
+    This makes the `db:structure` tasks consistent with `test:load_structure`.
 
-*   Fixed support for `DATABASE_URL` environment variable for rake db tasks. *Grace Liu*
+    *Dieter Komendera*
 
-*   Fix bug where `update_columns` and `update_column` would not let you update the primary key column.
+*   Respect custom primary keys for associations when calling `Relation#where`
 
-    *Henrik Nyh*
+    Fixes #18813.
 
-*   Decode URI encoded attributes on database connection URLs.
+    *Sean Griffin*
 
-    *Shawn Veader*
+*   Fix several edge cases which could result in a counter cache updating
+    twice or not updating at all for `has_many` and `has_many :through`.
 
-*   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.
+    Fixes #10865.
 
-    *Christian Seiler*
+    *Sean Griffin*
 
-*   Synchronize around deleting from the reserved connections hash.
-    Fixes #7955
+*   Foreign keys added by migrations were given random, generated names. This
+    meant a different `structure.sql` would be generated every time a developer
+    ran migrations on their machine.
 
-*   PostgreSQL adapter correctly fetches default values when using
-    multiple schemas and domains in a db. Fixes #7914
+    The generated part of foreign key names is now a hash of the table name and
+    column name, which is consistent every time you run the migration.
 
-    *Arturo Pie*
+    *Chris Sinjakli*
 
-*   Fix deprecation notice when loading a collection association that
-    selects columns from other tables, if a new record was previously
-    built using that association.
+*   Fix n+1 query problem when eager loading nil associations (fixes #18312)
 
-    *Ernie Miller*
+    *Sammy Larbi*
 
-*   The postgres adapter now supports tables with capital letters.
-    Fix #5920
+*   Change the default error message from `can't be blank` to `must exist` for
+    the presence validator of the `:required` option on `belongs_to`/`has_one`
+    associations.
 
-    *Yves Senn*
+    *Henrik Nygren*
 
-*   `CollectionAssociation#count` returns `0` without querying if the
-    parent record is not persisted.
+*   Fixed `ActiveRecord::Relation#group` method when an argument is an SQL
+    reserved keyword:
 
-    Before:
+    Example:
 
-        person.pets.count
-        # SELECT COUNT(*) FROM "pets" WHERE "pets"."person_id" IS NULL
-        # => 0
+        SplitTest.group(:key).count
+        Property.group(:value).count
 
-    After:
+    *Bogdan Gusiev*
 
-        person.pets.count
-        # fires without sql query
-        # => 0
+*   Added the `#or` method on `ActiveRecord::Relation`, allowing use of the OR
+    operator to combine WHERE or HAVING clauses.
 
-    *Francesco Rodriguez*
+    Example:
 
-*   Fix `reset_counters` crashing on `has_many :through` associations.
-    Fix #7822.
+        Post.where('id = 1').or(Post.where('id = 2'))
+        # => SELECT * FROM posts WHERE (id = 1) OR (id = 2)
 
-    *lulalala*
+    *Sean Griffin*, *Matthew Draper*, *Gael Muller*, *Olivier El Mekki*
 
-*   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.
+*   Don't define autosave association callbacks twice from
+    `accepts_nested_attributes_for`.
 
-    *jrochkind*
+    Fixes #18704.
 
-*   Rename field_changed? to _field_changed? so that users can create a field named field
+    *Sean Griffin*
 
-    *Akira Matsuda*, backported by *Steve Klabnik*
+*   Integer types will no longer raise a `RangeError` when assigning an
+    attribute, but will instead raise when going to the database.
 
-*   Fix creation of through association models when using `collection=[]`
-    on a `has_many :through` association from an unsaved model.
-    Fix #7661.
+    Fixes several vague issues which were never reported directly. See the
+    commit message from the commit which added this line for some examples.
 
-    *Ernie Miller*
+    *Sean Griffin*
 
-*   Explain only normal CRUD sql (select / update / insert / delete).
-    Fix problem that explains unexplainable sql. Closes #7544 #6458.
+*   Values which would error while being sent to the database (such as an
+    ASCII-8BIT string with invalid UTF-8 bytes on SQLite3), no longer error on
+    assignment. They will still error when sent to the database, but you are
+    given the ability to re-assign it to a valid value.
 
-    *kennyj*
+    Fixes #18580.
 
-*   Backport test coverage to ensure that PostgreSQL auto-reconnect functionality
-    remains healthy.
+    *Sean Griffin*
 
-    *Steve Jorgensen*
+*   Don't remove join dependencies in `Relation#exists?`
 
-*   Use config['encoding'] instead of config['charset'] when executing
-    databases.rake in the mysql/mysql2. A correct option for a database.yml
-    is 'encoding'.
+    Fixes #18632.
 
-    *kennyj*
+    *Sean Griffin*
 
-*   Fix ConnectionAdapters::Column.type_cast_code integer conversion,
-    to always convert values to integer calling #to_i. Fixes #7509.
+*   Invalid values assigned to a JSON column are assumed to be `nil`.
 
-    *Thiago Pradi*
+    Fixes #18629.
 
-*   Fix time column type casting for invalid time string values to correctly return nil.
+    *Sean Griffin*
 
-    *Adam Meehan*
+*   Add `ActiveRecord::Base#accessed_fields`, which can be used to quickly
+    discover which fields were read from a model when you are looking to only
+    select the data you need from the database.
 
-*   Fix `becomes` when using a configured `inheritance_column`.
+    *Sean Griffin*
 
-    *Yves Senn*
+*   Introduce the `:if_exists` option for `drop_table`.
 
-*   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.
+    Example:
 
-    *Dave Desrochers*
+        drop_table(:posts, if_exists: true)
 
-*   Round usec when comparing timestamp attributes in the dirty tracking.
-    Fixes #6975.
+    That would execute:
 
-    *kennyj*
+        DROP TABLE IF EXISTS posts
 
-*   Use inversed parent for first and last child of has_many association.
+    If the table doesn't exist, `if_exists: false` (the default) raises an
+    exception whereas `if_exists: true` does nothing.
 
-    *Ravil Bayramgalin*
+    *Cody Cutrer*, *Stefan Kanev*, *Ryuta Kamizono*
 
-*   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.
+*   Don't run SQL if attribute value is not changed for update_attribute method.
 
-    *Ari Pollak*
+    *Prathamesh Sonpatki*
 
-*   Fix `increment!`, `decrement!`, `toggle!` that was skipping callbacks.
-    Fixes #7306.
+*   `time` columns can now get affected by `time_zone_aware_attributes`. If you have
+    set `config.time_zone` to a value other than `'UTC'`, they will be treated
+    as in that time zone by default in Rails 5.1. If this is not the desired
+    behavior, you can set
 
-    *Rafael Mendonça França*
+        ActiveRecord::Base.time_zone_aware_types = [:datetime]
+
+    A deprecation warning will be emitted if you have a `:time` column, and have
+    not explicitly opted out.
+
+    Fixes #3145.
+
+    *Sean Griffin*
+
+*   Tests now run after_commit callbacks. You no longer have to declare
+    `uses_transaction ‘test name’` to test the results of an after_commit.
+
+    after_commit callbacks run after committing a transaction whose parent
+    is not `joinable?`: un-nested transactions, transactions within test cases,
+    and transactions in `console --sandbox`.
+
+    *arthurnn*, *Ravil Bayramgalin*, *Matthew Draper*
 
-*   Fix AR#create to return an unsaved record when AR::RecordInvalid is
-    raised. Fixes #3217.
+*   `nil` as a value for a binary column in a query no longer logs as
+    "<NULL binary data>", and instead logs as just "nil".
 
-    *Dave Yeu*
+    *Sean Griffin*
 
-*   Remove unnecessary transaction when assigning has_one associations with a nil or equal value.
-    Fix #7191.
+*   `attribute_will_change!` will no longer cause non-persistable attributes to
+    be sent to the database.
 
-    *kennyj*
+    Fixes #18407.
 
-*   Allow store to work with an empty column.
-    Fix #4840.
+    *Sean Griffin*
 
-    *Jeremy Walker*
+*   Remove support for the `protected_attributes` gem.
 
-*   Remove prepared statement from system query in postgresql adapter.
-    Fix #5872.
+    *Carlos Antonio da Silva*, *Roberto Miranda*
 
-    *Ivan Evtuhovich*
+*   Fix accessing of fixtures having non-string labels like Fixnum.
 
-*   Make sure `:environment` task is executed before `db:schema:load` or `db:structure:load`
-    Fixes #4772.
+    *Prathamesh Sonpatki*
 
-    *Seamus Abshere*
+*   Remove deprecated support to preload instance-dependent associations.
 
+    *Yves Senn*
+
+*   Remove deprecated support for PostgreSQL ranges with exclusive lower bounds.
+
+    *Yves Senn*
+
+*   Remove deprecation when modifying a relation with cached Arel.
+    This raises an `ImmutableRelation` error instead.
+
+    *Yves Senn*
+
+*   Added `ActiveRecord::SecureToken` in order to encapsulate generation of
+    unique tokens for attributes in a model using `SecureRandom`.
 
-## Rails 3.2.8 (Aug 9, 2012) ##
+    *Roberto Miranda*
 
-*   Do not consider the numeric attribute as changed if the old value is zero and the new value
-    is not a string.
-    Fixes #7237.
+*   Change the behavior of boolean columns to be closer to Ruby's semantics.
+
+    Before this change we had a small set of "truthy", and all others are "falsy".
+
+    Now, we have a small set of "falsy" values and all others are "truthy" matching
+    Ruby's semantics.
+
+    *Rafael Mendonça França*
+
+*   Deprecate `ActiveRecord::Base.errors_in_transactional_callbacks=`.
 
     *Rafael Mendonça França*
 
-*   Removes the deprecation of `update_attribute`. *fxn*
+*   Change transaction callbacks to not swallow errors.
+
+    Before this change any errors raised inside a transaction callback
+    were getting rescued and printed in the logs.
+
+    Now these errors are not rescued anymore and just bubble up, as the other callbacks.
+
+    *Rafael Mendonça França*
 
-*   Reverted the deprecation of `composed_of`. *Rafael Mendonça França*
+*   Remove deprecated `sanitize_sql_hash_for_conditions`.
 
-*   Reverted the deprecation of `*_sql` association options. They will
-    be deprecated in 4.0 instead. *Jon Leighton*
+    *Rafael Mendonça França*
 
-*   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
+*   Remove deprecated `Reflection#source_macro`.
 
-    *Xavier Noria*
+    *Rafael Mendonça França*
 
-*   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.
+*   Remove deprecated `symbolized_base_class` and `symbolized_sti_name`.
 
     *Rafael Mendonça França*
 
-## Rails 3.2.7 (Jul 26, 2012) ##
+*   Remove deprecated `ActiveRecord::Base.disable_implicit_join_references=`.
 
-*   `:finder_sql` and `:counter_sql` options on collection associations
-    are deprecated. Please transition to using scopes.
+    *Rafael Mendonça França*
 
-    *Jon Leighton*
+*   Remove deprecated access to connection specification using a string accessor.
 
-*   `:insert_sql` and `:delete_sql` options on `has_and_belongs_to_many`
-    associations are deprecated. Please transition to using `has_many
-    :through`
+    Now all strings will be handled as a URL.
 
-    *Jon Leighton*
+    *Rafael Mendonça França*
 
-*   `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.
+*   Change the default `null` value for `timestamps` to `false`.
 
-    *Steve Klabnik*
+    *Rafael Mendonça França*
 
-*   `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`.
+*   Return an array of pools from `connection_pools`.
 
-    *Steve Klabnik*
+    *Rafael Mendonça França*
 
-## Rails 3.2.6 (Jun 12, 2012) ##
+*   Return a null column from `column_for_attribute` when no column exists.
 
-*   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.
+    *Rafael Mendonça França*
 
-    CVE-2012-2695
+*   Remove deprecated `serialized_attributes`.
 
-*   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.
+    *Rafael Mendonça França*
 
-    *Jon Leighton*
+*   Remove deprecated automatic counter caches on `has_many :through`.
 
-## Rails 3.2.5 (Jun 1, 2012) ##
+    *Rafael Mendonça França*
 
-*   Restore behavior of Active Record 3.2.3 scopes.
-    A series of commits relating to preloading and scopes caused a regression.
+*   Change the way in which callback chains can be halted.
 
-    *Andrew White*
+    The preferred method to halt a callback chain from now on is to explicitly
+    `throw(:abort)`.
+    In the past, returning `false` in an Active Record `before_` callback had the
+    side effect of halting the callback chain.
+    This is not recommended anymore and, depending on the value of the
+    `ActiveSupport.halt_callback_chains_on_return_false` option, will
+    either not work at all or display a deprecation warning.
 
+    *claudiob*
 
-## Rails 3.2.4 (May 31, 2012) ##
+*   Clear query cache on rollback.
 
-*   Perf fix: Don't load the records when doing assoc.delete_all.
-    GH #6289. *Jon Leighton*
+    *Florian Weingarten*
 
-*   Association preloading shouldn't be affected by the current scoping.
-    This could cause infinite recursion and potentially other problems.
-    See GH #5667. *Jon Leighton*
+*   Fix setting of foreign_key for through associations when building a new record.
 
-*   Datetime attributes are forced to be changed. GH #3965
+    Fixes #12698.
 
-*   Fix attribute casting. GH #5549
+    *Ivan Antropov*
 
-*   Fix #5667. Preloading should ignore scoping.
+*   Improve dumping of the primary key. If it is not a default primary key,
+    correctly dump the type and options.
 
-*   Predicate builder should not recurse for determining where columns.
-    Thanks to Ben Murphy for reporting this! CVE-2012-2661
+    Fixes #14169, #16599.
 
+    *Ryuta Kamizono*
 
-## Rails 3.2.3 (March 30, 2012) ##
+*   Format the datetime string according to the precision of the datetime field.
 
-*   Added find_or_create_by_{attribute}! dynamic method. *Andrew White*
+    Incompatible to rounding behavior between MySQL 5.6 and earlier.
 
-*   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*
+    In 5.5, when you insert `2014-08-17 12:30:00.999999` the fractional part
+    is ignored. In 5.6, it's rounded to `2014-08-17 12:30:01`:
 
-*   Update ActiveRecord::AttributeMethods#attribute_present? to return false for empty strings. *Jacobkg*
+    http://bugs.mysql.com/bug.php?id=68760
 
-*   Fix associations when using per class databases. *larskanis*
+    *Ryuta Kamizono*
 
-*   Revert setting NOT NULL constraints in add_timestamps *fxn*
+*   Allow a precision option for MySQL datetimes.
 
-*   Fix mysql to use proper text types. Fixes #3931. *kennyj*
+    *Ryuta Kamizono*
 
-*   Fix #5069 - Protect foreign key from mass assignment through association builder. *byroot*
+*   Fixed automatic `inverse_of` for models nested in a module.
 
+    *Andrew McCloud*
 
-## Rails 3.2.2 (March 1, 2012) ##
+*   Change `ActiveRecord::Relation#update` behavior so that it can
+    be called without passing ids of the records to be updated.
 
-*   No changes.
+    This change allows updating multiple records returned by
+    `ActiveRecord::Relation` with callbacks and validations.
 
+        # Before
+        # ArgumentError: wrong number of arguments (1 for 2)
+        Comment.where(group: 'expert').update(body: "Group of Rails Experts")
 
-## Rails 3.2.1 (January 26, 2012) ##
+        # After
+        # Comments with group expert updated with body "Group of Rails Experts"
+        Comment.where(group: 'expert').update(body: "Group of Rails Experts")
 
-*   The threshold for auto EXPLAIN is ignored if there's no logger. *fxn*
+    *Prathamesh Sonpatki*
 
-*   Call `to_s` on the value passed to `table_name=`, in particular symbols
-    are supported (regression). *Sergey Nartimov*
+*   Fix `reaping_frequency` option when the value is a string.
 
-*   Fix possible race condition when two threads try to define attribute
-    methods for the same class. *Jon Leighton*
+    This usually happens when it is configured using `DATABASE_URL`.
 
+    *korbin*
 
-## Rails 3.2.0 (January 20, 2012) ##
+*   Fix error message when trying to create an associated record and the foreign
+    key is missing.
 
-*   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!`.
+    Before this fix the following exception was being raised:
 
-    Before:
+        NoMethodError: undefined method `val' for #<Arel::Nodes::BindParam:0x007fc64d19c218>
 
-        class Order < ActiveRecord::Base
-          def cancel!
-            transaction do
-              lock!
-              # ... cancelling logic
-            end
-          end
-        end
+    Now the message is:
 
-    After:
+        ActiveRecord::UnknownAttributeError: unknown attribute 'foreign_key' for Model.
 
-        class Order < ActiveRecord::Base
-          def cancel!
-            with_lock do
-              # ... cancelling logic
-            end
-          end
-        end
+    *Rafael Mendonça França*
 
-    *Olek Janiszewski*
+*   Fix change detection problem for PostgreSQL bytea type and
+    `ArgumentError: string contains null byte` exception with pg-0.18.
 
-*   'on' and 'ON' boolean columns values are type casted to true
-    *Santiago Pastorino*
+    Fixes #17680.
 
-*   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).
+    *Lars Kanis*
 
-    Example:
-      rake db:migrate SCOPE=blog
+*   When a table has a composite primary key, the `primary_key` method for
+    SQLite3 and PostgreSQL adapters was only returning the first field of the key.
+    Ensures that it will return nil instead, as Active Record doesn't support
+    composite primary keys.
 
-    *Piotr Sarnacki*
+    Fixes #18070.
 
-*   Migrations copied from engines are now scoped with engine's name,
-    for example 01_create_posts.blog.rb. *Piotr Sarnacki*
+    *arthurnn*
 
-*   Implements `AR::Base.silence_auto_explain`. This method allows the user to
-    selectively disable automatic EXPLAINs within a block. *fxn*
+*   `validates_size_of` / `validates_length_of` do not count records
+    which are `marked_for_destruction?`.
 
-*   Implements automatic EXPLAIN logging for slow queries.
+    Fixes #7247.
 
-    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.
+    *Yves Senn*
 
-    As of this writing there's support for SQLite, MySQL (mysql2 adapter), and
-    PostgreSQL.
+*   Ensure `first!` and friends work on loaded associations.
 
-    *fxn*
+    Fixes #18237.
 
-*   Implemented ActiveRecord::Relation#pluck method
+    *Sean Griffin*
 
-    Method returns Array of column value from table under ActiveRecord model
+*   `eager_load` preserves readonly flag for associations.
 
-        Client.pluck(:id)
+    Fixes #15853.
 
-    *Bogdan Gusiev*
+    *Takashi Kokubun*
 
-*   Automatic closure of connections in threads is deprecated.  For example
-    the following code is deprecated:
+*   Provide `:touch` option to `save()` to accommodate saving without updating
+    timestamps.
 
-    Thread.new { Post.find(1) }.join
+    Fixes #18202.
 
-    It should be changed to close the database connection at the end of
-    the thread:
+    *Dan Olson*
 
-    Thread.new {
-      Post.find(1)
-      Post.connection.close
-    }.join
+*   Provide a more helpful error message when an unsupported class is passed to
+    `serialize`.
 
-    Only people who spawn threads in their application code need to worry
-    about this change.
+    Fixes #18224.
 
-*   Deprecated:
+    *Sean Griffin*
 
-      * `set_table_name`
-      * `set_inheritance_column`
-      * `set_sequence_name`
-      * `set_primary_key`
-      * `set_locking_column`
+*   Add bigint primary key support for MySQL.
 
-    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
+        create_table :foos, id: :bigint do |t|
+        end
 
-    Or define your own `self.table_name` method:
+    *Ryuta Kamizono*
 
-         class Post < ActiveRecord::Base
-           def self.table_name
-             "special_" + super
-           end
-         end
-         Post.table_name # => "special_posts"
+*   Support for any type of primary key.
 
-    *Jon Leighton*
+    Fixes #14194.
 
-*   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*
+    *Ryuta Kamizono*
 
-*   Implemented ActiveRecord::Relation#explain. *fxn*
+*   Dump the default `nil` for PostgreSQL UUID primary key.
 
-*   Add ActiveRecord::Relation#uniq for generating unique queries.
+    *Ryuta Kamizono*
 
-    Before:
+*   Add a `:foreign_key` option to `references` and associated migration
+    methods. The model and migration generators now use this option, rather than
+    the `add_foreign_key` form.
 
-        Client.select('DISTINCT name')
+    *Sean Griffin*
 
-    After:
+*   Don't raise when writing an attribute with an out-of-range datetime passed
+    by the user.
 
-        Client.select(:name).uniq
+    *Grey Baker*
 
-    This also allows you to revert the unqueness in a relation:
+*   Replace deprecated `ActiveRecord::Tasks::DatabaseTasks#load_schema` with
+    `ActiveRecord::Tasks::DatabaseTasks#load_schema_for`.
 
-        Client.select(:name).uniq.uniq(false)
+    *Yves Senn*
 
-    *Jon Leighton*
+*   Fix bug with `ActiveRecord::Type::Numeric` that caused negative values to
+    be marked as having changed when set to the same negative value.
 
-*   Support index sort order in sqlite, mysql and postgres adapters. *Vlad Jebelev*
+    Fixes #18161.
 
-*   Allow the :class_name option for associations to take a symbol (:Client) in addition to
-    a string ('Client').
+    *Daniel Fox*
 
-    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.
+*   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.
 
-    *Jon Leighton*
+    *Matthew Draper*, *Yves Senn*
 
-*   In development mode the db:drop task also drops the test database. For symmetry with
-    the db:create task. *Dmitriy Kiriyenko*
+*   `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.
 
-*   Added ActiveRecord::Base.store for declaring simple single-column key/value stores *DHH*
+    Fixes #17945.
 
-        class User < ActiveRecord::Base
-          store :settings, accessors: [ :color, :homepage ]
-        end
+    *Yves Senn*
 
-        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
+*   Fix undesirable RangeError by `Type::Integer`. Add `Type::UnsignedInteger`.
 
+    *Ryuta Kamizono*
 
-*   MySQL: case-insensitive uniqueness validation avoids calling LOWER when
-    the column already uses a case-insensitive collation. Fixes #561.
+*   Add `foreign_type` option to `has_one` and `has_many` association macros.
 
-    *Joseph Palermo*
+    This option enables to define the column name of associated object's type for polymorphic associations.
 
-*   Transactional fixtures enlist all active database connections. You can test
-    models on different connections without disabling transactional fixtures.
+    *Ulisses Almeida*, *Kassio Borges*
 
-    *Jeremy Kemper*
+*   Remove deprecated behavior allowing nested arrays to be passed as query
+    values.
 
-*   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:
+    *Melanie Gilman*
 
-        User.where(:first_name => "Scarlett").first_or_create!(:last_name => "Johansson")
+*   Deprecate passing a class as a value in a query. Users should pass strings
+    instead.
 
-    *Andrés Mejía*
+    *Melanie Gilman*
 
-*   Fix nested attributes bug where _destroy parameter is taken into account
-    during :reject_if => :all_blank (fixes #2937)
+*   `add_timestamps` and `remove_timestamps` now properly reversible with
+    options.
 
-    *Aaron Christy*
+    *Noam Gagliardi-Rabinovich*
 
-*   Add ActiveSupport::Cache::NullStore for use in development and testing.
+*   `ActiveRecord::ConnectionAdapters::ColumnDumper#column_spec` and
+    `ActiveRecord::ConnectionAdapters::ColumnDumper#prepare_column_options` no
+    longer have a `types` argument. They should access
+    `connection#native_database_types` directly.
 
-    *Brian Durand*
+    *Yves Senn*
 
-Please check [3-1-stable](https://github.com/rails/rails/blob/3-1-stable/activerecord/CHANGELOG.md) for previous changes.
+Please check [4-2-stable](https://github.com/rails/rails/blob/4-2-stable/activerecord/CHANGELOG.md) for previous changes.