CHANGELOG.md 27.8 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14
*   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*

15 16 17 18 19 20 21
*   Correctly ignore `mark_for_destruction` when `autosave` isn't set to `true`
    when validating associations.

    Fixes #20882.

    *Sean Griffin*

22 23 24 25 26 27 28
*   Fix a bug where counter_cache doesn't always work with  polymorphic
    relations.

    Fixes #16407.

    *Stefan Kanev & Sean Griffin*

29 30 31 32 33 34 35
*   Ensure that cyclic associations with autosave don't cause duplicate errors
    to be added to the parent record.

    Fixes #20874.

    *Sean Griffin*

36 37 38 39 40 41 42
*   Ensure that `ActionController::Parameters` can still be passed to nested
    attributes.

    Fixes #20922.

    *Sean Griffin*

43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60
*   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)

    Passing a truthy argument to force association to reload will be removed in
    Rails 5.1.

    *Prem Sichanugrist*

61 62 63 64 65
*   Replaced `ActiveSupport::Concurrency::Latch` with `Concurrent::CountDownLatch`
    from the concurrent-ruby gem.

    *Jerry D'Antonio*

66 67 68 69 70 71 72 73
*   Fix through associations using scopes having the scope merged multiple
    times.

    Fixes #20721.
    Fixes #20727.

    *Sean Griffin*

74 75 76 77 78 79 80
*   `ActiveRecord::Base.dump_schema_after_migration` applies migration tasks
    other than `db:migrate`. (eg. `db:rollback`, `db:migrate:dup`, ...)

    Fixes #20743.

    *Yves Senn*

81 82 83 84 85 86 87 88
*   Add alternate syntax to make `change_column_default` reversible.

    User can pass in `:from` and `:to` to make `change_column_default` command
    become reversible.

    Example:

        change_column_default :posts, :status, from: nil, to: "draft"
D
Dmitry Zudochkin 已提交
89
        change_column_default :users, :authorized, from: true, to: false
90 91 92

    *Prem Sichanugrist*

93 94 95 96 97 98 99
*   Prevent error when using `force_reload: true` on an unassigned polymorphic
    belongs_to association.

    Fixes #20426.

    *James Dabbs*

100 101
*   Correctly raise `ActiveRecord::AssociationTypeMismatch` when assigning
    a wrong type to a namespaced association.
102

103
    Fixes #20545.
104 105 106

    *Diego Carrion*

107 108 109 110 111 112
*   `validates_absence_of` respects `marked_for_destruction?`.

    Fixes #20449.

    *Yves Senn*

113 114 115 116
*   Include the `Enumerable` module in `ActiveRecord::Relation`

    *Sean Griffin & bogdan*

117 118 119 120
*   Use `Enumerable#sum` in `ActiveRecord::Relation` if a block is given.

    *Sean Griffin*

121
*   Let `WITH` queries (Common Table Expressions) be explainable.
122 123 124

    *Vladimir Kochnev*

125 126 127 128
*   Make `remove_index :table, :column` reversible.

    *Yves Senn*

129 130 131 132 133 134 135
*   Fixed an error which would occur in dirty checking when calling
    `update_attributes` from a getter.

    Fixes #20531.

    *Sean Griffin*

136 137
*   Make `remove_foreign_key` reversible. Any foreign key options must be
    specified, similar to `remove_column`.
138 139 140

    *Aster Ryan*

141 142
*   Add `:enum_prefix`/`:enum_suffix` option to `enum` definition.

143
    Fixes #17511, #17415.
144 145 146

    *Igor Kapkov*

147 148 149 150
*   Correctly handle decimal arrays with defaults in the schema dumper.

    Fixes #20515.

151
    *Sean Griffin & jmondo*
152

153
*   Deprecate the PostgreSQL `:point` type in favor of a new one which will return
154 155 156 157
    `Point` objects instead of an `Array`

    *Sean Griffin*

158 159 160 161 162 163 164
*   Ensure symbols passed to `ActiveRecord::Relation#select` are always treated
    as columns.

    Fixes #20360.

    *Sean Griffin*

165 166 167 168 169 170 171 172 173 174 175 176 177
*   Do not set `sql_mode` if `strict: :default` is specified.

        ```
        # database.yml
        production:
          adapter: mysql2
          database: foo_prod
          user: foo
          strict: :default
        ```

    *Ryuta Kamizono*

178 179 180
*   Allow proc defaults to be passed to the attributes API. See documentation
    for examples.

181
    *Sean Griffin*, *Kir Shatrov*
182

183 184 185 186 187 188 189 190 191 192 193 194 195 196 197
*   SQLite: `:collation` support for string and text columns.

    Example:

        create_table :foo do |t|
          t.string :string_nocase, collation: 'NOCASE'
          t.text :text_rtrim, collation: 'RTRIM'
        end

        add_column :foo, :title, :string, collation: 'RTRIM'

        change_column :foo, :title, :string, collation: 'NOCASE'

    *Akshay Vishnoi*

G
George Claghorn 已提交
198 199 200 201 202 203 204 205 206
*   Allow the use of symbols or strings to specify enum values in test
    fixtures:

        awdr:
          title: "Agile Web Development with Rails"
          status: :proposed

    *George Claghorn*

207
*   Clear query cache when `ActiveRecord::Base#reload` is called.
208

209
    *Shane Hender, Pierre Nespo*
210

211 212 213 214
*   Include stored procedures and function on the MySQL structure dump.

    *Jonathan Worek*

215 216
*   Pass `:extend` option for `has_and_belongs_to_many` associations to the
    underlying `has_many :through`.
217 218 219

    *Jaehyun Shin*

220 221 222 223 224 225
*   Deprecate `Relation#uniq` use `Relation#distinct` instead.

    See #9683.

    *Yves Senn*

226 227
*   Allow single table inheritance instantiation to work when storing
    demodulized class names.
228 229 230

    *Alex Robbin*

231 232
*   Correctly pass MySQL options when using `structure_dump` or
    `structure_load`.
233 234 235 236 237

    Specifically, it fixes an issue when using SSL authentication.

    *Alex Coomans*

238 239
*   Dump indexes in `create_table` instead of `add_index`.

240
    If the adapter supports indexes in `create_table`, generated SQL is
241 242 243 244
    slightly more efficient.

    *Ryuta Kamizono*

245 246 247 248
*   Correctly dump `:options` on `create_table` for MySQL.

    *Ryuta Kamizono*

249 250 251 252 253 254 255 256 257 258 259
*   PostgreSQL: `:collation` support for string and text columns.

    Example:

        create_table :foos do |t|
          t.string :string_en, collation: 'en_US.UTF-8'
          t.text   :text_ja,   collation: 'ja_JP.UTF-8'
        end

    *Ryuta Kamizono*

260 261 262 263
*   Make `unscope` aware of "less than" and "greater than" conditions.

    *TAKAHASHI Kazuaki*

264 265 266 267 268
*   `find_by` and `find_by!` raise `ArgumentError` when called without
    arguments.

    *Kohei Suzuki*

269 270 271 272 273 274 275
*   Revert behavior of `db:schema:load` back to loading the full
    environment. This ensures that initializers are run.

    Fixes #19545.

    *Yves Senn*

276 277 278 279 280 281 282 283
*   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.

    *Paul Mucur*

284 285 286 287 288 289
*   Rename `:class` to `:anonymous_class` in association options.

    Fixes #19659.

    *Andrew White*

290 291 292 293 294 295 296
*   Autosave existing records on a has many through association when the parent
    is new.

    Fixes #19782.

    *Sean Griffin*

297 298
*   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.
299 300 301

    *Andrey Voronkov*

302
*   MySQL: `:charset` and `:collation` support for string and text columns.
303 304 305 306 307 308 309 310 311 312

    Example:

        create_table :foos do |t|
          t.string :string_utf8_bin, charset: 'utf8', collation: 'utf8_bin'
          t.text   :text_ascii,      charset: 'ascii'
        end

    *Ryuta Kamizono*

313 314 315 316 317 318 319
*   Foreign key related methods in the migration DSL respect
    `ActiveRecord::Base.pluralize_table_names = false`.

    Fixes #19643.

    *Mehmet Emin İNAÇ*

Y
Yves Senn 已提交
320
*   Reduce memory usage from loading types on PostgreSQL.
321 322 323 324 325

    Fixes #19578.

    *Sean Griffin*

Y
Yves Senn 已提交
326
*   Add `config.active_record.warn_on_records_fetched_greater_than` option.
327 328

    When set to an integer, a warning will be logged whenever a result set
Y
Yves Senn 已提交
329 330 331
    larger than the specified size is returned by a query.

    Fixes #16463.
332 333 334

    *Jason Nochlin*

Y
Yves Senn 已提交
335
*   Ignore `.psqlrc` when loading database structure.
336 337 338

    *Jason Weathered*

339 340
*   Fix referencing wrong table aliases while joining tables of has many through
    association (only when calling calculation methods).
341

342
    Fixes #19276.
343 344 345

    *pinglamb*

346 347 348 349 350 351 352
*   Correctly persist a serialized attribute that has been returned to
    its default value by an in-place modification.

    Fixes #19467.

    *Matthew Draper*

353 354 355 356 357 358 359 360
*   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*

361 362 363 364 365
*   Reuse the `CollectionAssociation#reader` cache when the foreign key is
    available prior to save.

    *Ben Woosley*

366 367 368 369 370 371 372
*   Add `config.active_record.dump_schemas` to fix `db:structure:dump`
    when using schema_search_path and PostgreSQL extensions.

    Fixes #17157.

    *Ryan Wallace*

373 374 375 376 377 378
*   Renaming `use_transactional_fixtures` to `use_transactional_tests` for clarity.

    Fixes #18864.

    *Brandon Weiss*

379 380 381 382 383
*   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*

384 385 386 387
*   Correctly dump `serial` and `bigserial`.

    *Ryuta Kamizono*

388 389 390 391
*   Fix default `format` value in `ActiveRecord::Tasks::DatabaseTasks#schema_file`.

    *James Cox*

392 393
*   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.
394 395 396 397 398

    Fixes #15549.

    *Will Bryant*, *Aaron Patterson*

399 400 401 402 403 404 405
*   Correctly create through records when created on a has many through
    association when using `where`.

    Fixes #19073.

    *Sean Griffin*

406
*   Add `SchemaMigration.create_table` support for any unicode charsets with MySQL.
407 408 409

    *Ryuta Kamizono*

410
*   PostgreSQL no longer disables user triggers if system triggers can't be
411 412 413 414 415 416 417 418 419 420 421 422 423
    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*

424 425
*   In PostgreSQL, print a warning message if `disable_referential_integrity`
    fails due to missing permissions.
426 427 428

    *Andrey Nering*, *Yves Senn*

429
*   Allow a `:limit` option for MySQL bigint primary key support.
430 431 432 433 434 435 436 437 438 439 440 441 442 443

    Example:

        create_table :foos, id: :primary_key, limit: 8 do |t|
        end

        # or

        create_table :foos, id: false do |t|
          t.primary_key :id, limit: 8
        end

    *Ryuta Kamizono*

444 445 446 447 448 449 450
*   `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.)

    *Josef Šimánek*

451
*   Fixed `ActiveRecord::Relation#becomes!` and `changed_attributes` issues for type
452
    columns.
453 454 455 456 457

    Fixes #17139.

    *Miklos Fazekas*

458 459 460 461
*   Format the time string according to the precision of the time column.

    *Ryuta Kamizono*

462
*   Allow a `:precision` option for time type columns.
463 464 465

    *Ryuta Kamizono*

466
*   Add `ActiveRecord::Base.suppress` to prevent the receiver from being saved
M
Michael Ryan 已提交
467 468 469 470 471 472
    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):

473 474 475 476 477
        class Comment < ActiveRecord::Base
          belongs_to :commentable, polymorphic: true
          after_create -> { Notification.create! comment: self,
            recipients: commentable.recipients }
        end
M
Michael Ryan 已提交
478

479 480 481 482
    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:
M
Michael Ryan 已提交
483

484 485 486 487 488 489 490
        module Copyable
          def copy_to(destination)
            Notification.suppress do
              # Copy logic that creates new comments that we do not want triggering
              # notifications.
            end
          end
M
Michael Ryan 已提交
491 492 493 494
        end

    *Michael Ryan*

495 496
*   `:time` option added for `#touch`.

H
Hyonjee Joo 已提交
497 498 499 500
    Fixes #18905.

    *Hyonjee Joo*

501
*   Deprecate passing of `start` value to `find_in_batches` and `find_each`
502 503 504 505
    in favour of `begin_at` value.

    *Vipul A M*

506 507 508 509
*   Add `foreign_key_exists?` method.

    *Tõnis Simo*

510 511 512 513
*   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`)
514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532

        # Before:

        users.none?
        # SELECT "users".* FROM "users"

        users.one?
        # SELECT "users".* FROM "users"

        # After:

        users.none?
        # SELECT 1 AS one FROM "users" LIMIT 1

        users.one?
        # SELECT COUNT(*) FROM "users"

    *Eugene Gilburg*

533 534 535 536 537
*   Have `enum` perform type casting consistently with the rest of Active
    Record, such as `where`.

    *Sean Griffin*

538 539 540
*   `scoping` no longer pollutes the current scope of sibling classes when using
    STI. e.x.

541 542 543
        StiOne.none.scoping do
          StiTwo.all
        end
544 545 546 547 548

    Fixes #18806.

    *Sean Griffin*

549 550 551 552 553 554 555 556
*   `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.

    Fixes #18664.

    *Yves Senn*

557 558 559 560 561
*   `find_in_batches` now accepts an `:end_at` parameter that complements the `:start`
     parameter to specify where to stop batch processing.

    *Vipul A M*

562
*   Fix a rounding problem for PostgreSQL timestamp columns.
563

564 565
    If a timestamp column has a precision specified, it needs to
    format according to that.
566 567 568

    *Ryuta Kamizono*

569 570
*   Respect the database default charset for `schema_migrations` table.

571
    The charset of `version` column in `schema_migrations` table depends
572 573 574 575 576
    on the database default charset and collation rather than the encoding
    of the connection.

    *Ryuta Kamizono*

577 578
*   Raise `ArgumentError` when passing `nil` or `false` to `Relation#merge`.

579
    These are not valid values to merge in a relation, so it should warn users
580 581 582 583
    early.

    *Rafael Mendonça França*

584
*   Use `SCHEMA` instead of `DB_STRUCTURE` for specifying a structure file.
585 586 587 588 589

    This makes the db:structure tasks consistent with test:load_structure.

    *Dieter Komendera*

590 591 592 593 594 595
*   Respect custom primary keys for associations when calling `Relation#where`

    Fixes #18813.

    *Sean Griffin*

596
*   Fix several edge cases which could result in a counter cache updating
597 598 599 600 601 602
    twice or not updating at all for `has_many` and `has_many :through`.

    Fixes #10865.

    *Sean Griffin*

603 604 605 606 607 608 609 610 611
*   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.

    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.

    *Chris Sinjakli*

612 613 614 615 616 617 618 619 620 621 622 623
*   Validation errors would be raised for parent records when an association
    was saved when the parent had `validate: false`. It should not be the
    responsibility of the model to validate an associated object unless the
    object was created or modified by the parent.

    This fixes the issue by skipping validations if the parent record is
    persisted, not changed, and not marked for destruction.

    Fixes #17621.

    *Eileen M. Uchitelle, Aaron Patterson*

624 625 626 627
*   Fix n+1 query problem when eager loading nil associations (fixes #18312)

    *Sammy Larbi*

628
*   Change the default error message from `can't be blank` to `must exist` for
629 630
    the presence validator of the `:required` option on `belongs_to`/`has_one`
    associations.
631 632 633

    *Henrik Nygren*

634 635
*   Fixed `ActiveRecord::Relation#group` method when an argument is an SQL
    reserved keyword:
636

Y
Yves Senn 已提交
637 638 639 640
    Example:

        SplitTest.group(:key).count
        Property.group(:value).count
641 642 643

    *Bogdan Gusiev*

644
*   Added the `#or` method on `ActiveRecord::Relation`, allowing use of the OR
645 646 647 648 649 650 651 652 653
    operator to combine WHERE or HAVING clauses.

    Example:

        Post.where('id = 1').or(Post.where('id = 2'))
        # => SELECT * FROM posts WHERE (id = 1) OR (id = 2)

    *Sean Griffin*, *Matthew Draper*, *Gael Muller*, *Olivier El Mekki*

654 655 656 657 658 659 660
*   Don't define autosave association callbacks twice from
    `accepts_nested_attributes_for`.

    Fixes #18704.

    *Sean Griffin*

661 662 663 664 665 666 667 668
*   Integer types will no longer raise a `RangeError` when assigning an
    attribute, but will instead raise when going to the database.

    Fixes several vague issues which were never reported directly. See the
    commit message from the commit which added this line for some examples.

    *Sean Griffin*

669
*   Values which would error while being sent to the database (such as an
670
    ASCII-8BIT string with invalid UTF-8 bytes on SQLite3), no longer error on
671 672 673 674 675 676 677
    assignment. They will still error when sent to the database, but you are
    given the ability to re-assign it to a valid value.

    Fixes #18580.

    *Sean Griffin*

678 679
*   Don't remove join dependencies in `Relation#exists?`

680
    Fixes #18632.
681 682 683

    *Sean Griffin*

684 685 686 687 688 689
*   Invalid values assigned to a JSON column are assumed to be `nil`.

    Fixes #18629.

    *Sean Griffin*

690 691 692 693 694 695
*   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.

    *Sean Griffin*

696 697 698 699 700 701 702 703 704 705 706 707 708 709 710
*   Introduce the `:if_exists` option for `drop_table`.

    Example:

        drop_table(:posts, if_exists: true)

    That would execute:

        DROP TABLE IF EXISTS posts

    If the table doesn't exist, `if_exists: false` (the default) raises an
    exception whereas `if_exists: true` does nothing.

    *Cody Cutrer*, *Stefan Kanev*, *Ryuta Kamizono*

711 712 713 714
*   Don't run SQL if attribute value is not changed for update_attribute method.

    *Prathamesh Sonpatki*

715
*   `time` columns can now get affected by `time_zone_aware_attributes`. If you have
716
    set `config.time_zone` to a value other than `'UTC'`, they will be treated
717
    as in that time zone by default in Rails 5.1. If this is not the desired
718 719 720 721 722 723 724
    behavior, you can set

        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.

Y
Yves Senn 已提交
725
    Fixes #3145.
726 727 728

    *Sean Griffin*

729 730 731 732 733 734 735 736 737
*   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*

738 739 740 741 742
*   `nil` as a value for a binary column in a query no longer logs as
    "<NULL binary data>", and instead logs as just "nil".

    *Sean Griffin*

743 744 745 746 747 748 749
*   `attribute_will_change!` will no longer cause non-persistable attributes to
    be sent to the database.

    Fixes #18407.

    *Sean Griffin*

750 751
*   Remove support for the `protected_attributes` gem.

752
    *Carlos Antonio da Silva*, *Roberto Miranda*
753

754
*   Fix accessing of fixtures having non-string labels like Fixnum.
755 756 757

    *Prathamesh Sonpatki*

758
*   Remove deprecated support to preload instance-dependent associations.
759 760 761

    *Yves Senn*

762 763 764 765
*   Remove deprecated support for PostgreSQL ranges with exclusive lower bounds.

    *Yves Senn*

766
*   Remove deprecation when modifying a relation with cached Arel.
767 768 769 770
    This raises an `ImmutableRelation` error instead.

    *Yves Senn*

Y
Yves Senn 已提交
771 772
*   Added `ActiveRecord::SecureToken` in order to encapsulate generation of
    unique tokens for attributes in a model using `SecureRandom`.
773 774 775

    *Roberto Miranda*

776 777 778 779 780 781 782 783 784
*   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*

785 786 787 788
*   Deprecate `ActiveRecord::Base.errors_in_transactional_callbacks=`.

    *Rafael Mendonça França*

789
*   Change transaction callbacks to not swallow errors.
790

791 792
    Before this change any errors raised inside a transaction callback
    were getting rescued and printed in the logs.
793

794
    Now these errors are not rescued anymore and just bubble up, as the other callbacks.
795 796 797

    *Rafael Mendonça França*

798 799 800 801
*   Remove deprecated `sanitize_sql_hash_for_conditions`.

    *Rafael Mendonça França*

802 803 804 805
*   Remove deprecated `Reflection#source_macro`.

    *Rafael Mendonça França*

806 807 808 809
*   Remove deprecated `symbolized_base_class` and `symbolized_sti_name`.

    *Rafael Mendonça França*

810 811 812 813
*   Remove deprecated `ActiveRecord::Base.disable_implicit_join_references=`.

    *Rafael Mendonça França*

814
*   Remove deprecated access to connection specification using a string accessor.
815 816 817 818 819

    Now all strings will be handled as a URL.

    *Rafael Mendonça França*

820 821 822 823
*   Change the default `null` value for `timestamps` to `false`.

    *Rafael Mendonça França*

824 825 826 827
*   Return an array of pools from `connection_pools`.

    *Rafael Mendonça França*

828 829 830 831
*   Return a null column from `column_for_attribute` when no column exists.

    *Rafael Mendonça França*

832 833 834 835
*   Remove deprecated `serialized_attributes`.

    *Rafael Mendonça França*

836 837 838 839
*   Remove deprecated automatic counter caches on `has_many :through`.

    *Rafael Mendonça França*

840 841 842 843
*   Change the way in which callback chains can be halted.

    The preferred method to halt a callback chain from now on is to explicitly
    `throw(:abort)`.
844
    In the past, returning `false` in an Active Record `before_` callback had the
845 846 847 848
    side effect of halting the callback chain.
    This is not recommended anymore and, depending on the value of the
    `config.active_support.halt_callback_chains_on_return_false` option, will
    either not work at all or display a deprecation warning.
849 850 851

    *claudiob*

852
*   Clear query cache on rollback.
Y
Yves Senn 已提交
853

854
    *Florian Weingarten*
Y
Yves Senn 已提交
855

856
*   Fix setting of foreign_key for through associations when building a new record.
857 858 859 860 861

    Fixes #12698.

    *Ivan Antropov*

862
*   Improve dumping of the primary key. If it is not a default primary key,
863 864 865 866 867 868
    correctly dump the type and options.

    Fixes #14169, #16599.

    *Ryuta Kamizono*

869 870 871 872 873 874 875 876 877 878 879
*   Format the datetime string according to the precision of the datetime field.

    Incompatible to rounding behavior between MySQL 5.6 and earlier.

    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`:

    http://bugs.mysql.com/bug.php?id=68760

    *Ryuta Kamizono*

880
*   Allow a precision option for MySQL datetimes.
881 882 883

    *Ryuta Kamizono*

884
*   Fixed automatic `inverse_of` for models nested in a module.
885 886 887

    *Andrew McCloud*

888 889 890
*   Change `ActiveRecord::Relation#update` behavior so that it can
    be called without passing ids of the records to be updated.

891
    This change allows updating multiple records returned by
892 893 894 895 896 897 898 899 900 901 902 903
    `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")

        # After
        # Comments with group expert updated with body "Group of Rails Experts"
        Comment.where(group: 'expert').update(body: "Group of Rails Experts")

    *Prathamesh Sonpatki*

904 905 906 907 908 909
*   Fix `reaping_frequency` option when the value is a string.

    This usually happens when it is configured using `DATABASE_URL`.

    *korbin*

910 911 912 913 914 915 916 917 918 919 920 921 922
*   Fix error message when trying to create an associated record and the foreign
    key is missing.

    Before this fix the following exception was being raised:

        NoMethodError: undefined method `val' for #<Arel::Nodes::BindParam:0x007fc64d19c218>

    Now the message is:

        ActiveRecord::UnknownAttributeError: unknown attribute 'foreign_key' for Model.

    *Rafael Mendonça França*

923 924 925 926 927 928 929
*   Fix change detection problem for PostgreSQL bytea type and
    `ArgumentError: string contains null byte` exception with pg-0.18.

    Fixes #17680.

    *Lars Kanis*

930 931 932 933
*   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.
934 935 936 937 938

    Fixes #18070.

    *arthurnn*

939
*   `validates_size_of` / `validates_length_of` do not count records
940 941 942 943 944 945
    which are `marked_for_destruction?`.

    Fixes #7247.

    *Yves Senn*

946 947 948 949 950 951
*   Ensure `first!` and friends work on loaded associations.

    Fixes #18237.

    *Sean Griffin*

952 953 954 955 956 957
*   `eager_load` preserves readonly flag for associations.

    Closes #15853.

    *Takashi Kokubun*

958
*   Provide `:touch` option to `save()` to accommodate saving without updating
959 960
    timestamps.

961
    Fixes #18202.
962 963 964

    *Dan Olson*

965
*   Provide a more helpful error message when an unsupported class is passed to
966
    `serialize`.
967

968
    Fixes #18224.
969 970 971

    *Sean Griffin*

972 973 974 975 976 977 978 979 980
*   Add bigint primary key support for MySQL.

    Example:

        create_table :foos, id: :bigint do |t|
        end

    *Ryuta Kamizono*

981
*   Support for any type of primary key.
R
Ryuta Kamizono 已提交
982 983 984 985 986

    Fixes #14194.

    *Ryuta Kamizono*

987 988 989 990
*   Dump the default `nil` for PostgreSQL UUID primary key.

    *Ryuta Kamizono*

991 992 993 994 995 996
*   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.

    *Sean Griffin*

997 998 999 1000 1001
*   Don't raise when writing an attribute with an out-of-range datetime passed
    by the user.

    *Grey Baker*

1002 1003 1004 1005 1006
*   Replace deprecated `ActiveRecord::Tasks::DatabaseTasks#load_schema` with
    `ActiveRecord::Tasks::DatabaseTasks#load_schema_for`.

    *Yves Senn*

1007
*   Fix bug with `ActiveRecord::Type::Numeric` that caused negative values to
1008 1009
    be marked as having changed when set to the same negative value.

Y
Yves Senn 已提交
1010
    Closes #18161.
1011 1012 1013

    *Daniel Fox*

1014 1015 1016 1017 1018 1019 1020
*   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.

    *Matthew Draper*, *Yves Senn*

1021 1022 1023 1024 1025 1026 1027 1028
*   `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.

    Closes #17945.

    *Yves Senn*

Y
Yves Senn 已提交
1029
*   Fix undesirable RangeError by `Type::Integer`. Add `Type::UnsignedInteger`.
1030 1031 1032

    *Ryuta Kamizono*

1033 1034 1035 1036
*   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.

1037
    *Ulisses Almeida*, *Kassio Borges*
1038

1039 1040 1041 1042 1043
*   Remove deprecated behavior allowing nested arrays to be passed as query
    values.

    *Melanie Gilman*

1044 1045 1046 1047 1048
*   Deprecate passing a class as a value in a query. Users should pass strings
    instead.

    *Melanie Gilman*

1049 1050 1051 1052 1053
*   `add_timestamps` and `remove_timestamps` now properly reversible with
    options.

    *Noam Gagliardi-Rabinovich*

1054 1055 1056 1057 1058 1059 1060
*   `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.

    *Yves Senn*

1061
Please check [4-2-stable](https://github.com/rails/rails/blob/4-2-stable/activerecord/CHANGELOG.md) for previous changes.