CHANGELOG.md 26.1 KB
Newer Older
1 2 3 4 5 6 7 8
*   Fix through associations using scopes having the scope merged multiple
    times.

    Fixes #20721.
    Fixes #20727.

    *Sean Griffin*

9 10 11 12 13 14 15
*   `ActiveRecord::Base.dump_schema_after_migration` applies migration tasks
    other than `db:migrate`. (eg. `db:rollback`, `db:migrate:dup`, ...)

    Fixes #20743.

    *Yves Senn*

16 17 18 19 20 21 22 23 24 25 26 27
*   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"
        change_column_default :users, authorized, from: true, to: false

    *Prem Sichanugrist*

28 29 30 31 32 33 34
*   Prevent error when using `force_reload: true` on an unassigned polymorphic
    belongs_to association.

    Fixes #20426.

    *James Dabbs*

35 36
*   Correctly raise `ActiveRecord::AssociationTypeMismatch` when assigning
    a wrong type to a namespaced association.
37

38
    Fixes #20545.
39 40 41

    *Diego Carrion*

42 43 44 45 46 47
*   `validates_absence_of` respects `marked_for_destruction?`.

    Fixes #20449.

    *Yves Senn*

48 49 50 51
*   Include the `Enumerable` module in `ActiveRecord::Relation`

    *Sean Griffin & bogdan*

52 53 54 55
*   Use `Enumerable#sum` in `ActiveRecord::Relation` if a block is given.

    *Sean Griffin*

56
*   Let `WITH` queries (Common Table Expressions) be explainable.
57 58 59

    *Vladimir Kochnev*

60 61 62 63
*   Make `remove_index :table, :column` reversible.

    *Yves Senn*

64 65 66 67 68 69 70
*   Fixed an error which would occur in dirty checking when calling
    `update_attributes` from a getter.

    Fixes #20531.

    *Sean Griffin*

71 72
*   Make `remove_foreign_key` reversible. Any foreign key options must be
    specified, similar to `remove_column`.
73 74 75

    *Aster Ryan*

76 77
*   Add `:enum_prefix`/`:enum_suffix` option to `enum` definition.

78
    Fixes #17511, #17415.
79 80 81

    *Igor Kapkov*

82 83 84 85
*   Correctly handle decimal arrays with defaults in the schema dumper.

    Fixes #20515.

86
    *Sean Griffin & jmondo*
87

88
*   Deprecate the PostgreSQL `:point` type in favor of a new one which will return
89 90 91 92
    `Point` objects instead of an `Array`

    *Sean Griffin*

93 94 95 96 97 98 99
*   Ensure symbols passed to `ActiveRecord::Relation#select` are always treated
    as columns.

    Fixes #20360.

    *Sean Griffin*

100 101 102 103 104 105 106 107 108 109 110 111 112
*   Do not set `sql_mode` if `strict: :default` is specified.

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

    *Ryuta Kamizono*

113 114 115
*   Allow proc defaults to be passed to the attributes API. See documentation
    for examples.

116
    *Sean Griffin*, *Kir Shatrov*
117

118 119 120 121 122 123 124 125 126 127 128 129 130 131 132
*   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 已提交
133 134 135 136 137 138 139 140 141
*   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*

142
*   Clear query cache when `ActiveRecord::Base#reload` is called.
143

144
    *Shane Hender, Pierre Nespo*
145

146 147 148 149
*   Include stored procedures and function on the MySQL structure dump.

    *Jonathan Worek*

150 151
*   Pass `:extend` option for `has_and_belongs_to_many` associations to the
    underlying `has_many :through`.
152 153 154

    *Jaehyun Shin*

155 156 157 158 159 160
*   Deprecate `Relation#uniq` use `Relation#distinct` instead.

    See #9683.

    *Yves Senn*

161 162
*   Allow single table inheritance instantiation to work when storing
    demodulized class names.
163 164 165

    *Alex Robbin*

166 167
*   Correctly pass MySQL options when using `structure_dump` or
    `structure_load`.
168 169 170 171 172

    Specifically, it fixes an issue when using SSL authentication.

    *Alex Coomans*

173 174
*   Dump indexes in `create_table` instead of `add_index`.

175
    If the adapter supports indexes in `create_table`, generated SQL is
176 177 178 179
    slightly more efficient.

    *Ryuta Kamizono*

180 181 182 183
*   Correctly dump `:options` on `create_table` for MySQL.

    *Ryuta Kamizono*

184 185 186 187 188 189 190 191 192 193 194
*   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*

195 196 197 198
*   Make `unscope` aware of "less than" and "greater than" conditions.

    *TAKAHASHI Kazuaki*

199 200 201 202 203
*   `find_by` and `find_by!` raise `ArgumentError` when called without
    arguments.

    *Kohei Suzuki*

204 205 206 207 208 209 210
*   Revert behavior of `db:schema:load` back to loading the full
    environment. This ensures that initializers are run.

    Fixes #19545.

    *Yves Senn*

211 212 213 214 215 216 217 218
*   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*

219 220 221 222 223 224
*   Rename `:class` to `:anonymous_class` in association options.

    Fixes #19659.

    *Andrew White*

225 226 227 228 229 230 231
*   Autosave existing records on a has many through association when the parent
    is new.

    Fixes #19782.

    *Sean Griffin*

232 233
*   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.
234 235 236

    *Andrey Voronkov*

237
*   MySQL: `:charset` and `:collation` support for string and text columns.
238 239 240 241 242 243 244 245 246 247

    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*

248 249 250 251 252 253 254
*   Foreign key related methods in the migration DSL respect
    `ActiveRecord::Base.pluralize_table_names = false`.

    Fixes #19643.

    *Mehmet Emin İNAÇ*

Y
Yves Senn 已提交
255
*   Reduce memory usage from loading types on PostgreSQL.
256 257 258 259 260

    Fixes #19578.

    *Sean Griffin*

Y
Yves Senn 已提交
261
*   Add `config.active_record.warn_on_records_fetched_greater_than` option.
262 263

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

    Fixes #16463.
267 268 269

    *Jason Nochlin*

Y
Yves Senn 已提交
270
*   Ignore `.psqlrc` when loading database structure.
271 272 273

    *Jason Weathered*

274 275
*   Fix referencing wrong table aliases while joining tables of has many through
    association (only when calling calculation methods).
276

277
    Fixes #19276.
278 279 280

    *pinglamb*

281 282 283 284 285 286 287
*   Correctly persist a serialized attribute that has been returned to
    its default value by an in-place modification.

    Fixes #19467.

    *Matthew Draper*

288 289 290 291 292 293 294 295
*   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*

296 297 298 299 300
*   Reuse the `CollectionAssociation#reader` cache when the foreign key is
    available prior to save.

    *Ben Woosley*

301 302 303 304 305 306 307
*   Add `config.active_record.dump_schemas` to fix `db:structure:dump`
    when using schema_search_path and PostgreSQL extensions.

    Fixes #17157.

    *Ryan Wallace*

308 309 310 311 312 313
*   Renaming `use_transactional_fixtures` to `use_transactional_tests` for clarity.

    Fixes #18864.

    *Brandon Weiss*

314 315 316 317 318
*   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*

319 320 321 322
*   Correctly dump `serial` and `bigserial`.

    *Ryuta Kamizono*

323 324 325 326
*   Fix default `format` value in `ActiveRecord::Tasks::DatabaseTasks#schema_file`.

    *James Cox*

327 328
*   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.
329 330 331 332 333

    Fixes #15549.

    *Will Bryant*, *Aaron Patterson*

334 335 336 337 338 339 340
*   Correctly create through records when created on a has many through
    association when using `where`.

    Fixes #19073.

    *Sean Griffin*

341
*   Add `SchemaMigration.create_table` support for any unicode charsets with MySQL.
342 343 344

    *Ryuta Kamizono*

345
*   PostgreSQL no longer disables user triggers if system triggers can't be
346 347 348 349 350 351 352 353 354 355 356 357 358
    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*

359 360
*   In PostgreSQL, print a warning message if `disable_referential_integrity`
    fails due to missing permissions.
361 362 363

    *Andrey Nering*, *Yves Senn*

364
*   Allow a `:limit` option for MySQL bigint primary key support.
365 366 367 368 369 370 371 372 373 374 375 376 377 378

    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*

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

386
*   Fixed `ActiveRecord::Relation#becomes!` and `changed_attributes` issues for type
387
    columns.
388 389 390 391 392

    Fixes #17139.

    *Miklos Fazekas*

393 394 395 396
*   Format the time string according to the precision of the time column.

    *Ryuta Kamizono*

397
*   Allow a `:precision` option for time type columns.
398 399 400

    *Ryuta Kamizono*

401
*   Add `ActiveRecord::Base.suppress` to prevent the receiver from being saved
M
Michael Ryan 已提交
402 403 404 405 406 407
    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):

408 409 410 411 412
        class Comment < ActiveRecord::Base
          belongs_to :commentable, polymorphic: true
          after_create -> { Notification.create! comment: self,
            recipients: commentable.recipients }
        end
M
Michael Ryan 已提交
413

414 415 416 417
    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 已提交
418

419 420 421 422 423 424 425
        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 已提交
426 427 428 429
        end

    *Michael Ryan*

430 431
*   `:time` option added for `#touch`.

H
Hyonjee Joo 已提交
432 433 434 435
    Fixes #18905.

    *Hyonjee Joo*

436
*   Deprecate passing of `start` value to `find_in_batches` and `find_each`
437 438 439 440
    in favour of `begin_at` value.

    *Vipul A M*

441 442 443 444
*   Add `foreign_key_exists?` method.

    *Tõnis Simo*

445 446 447 448
*   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`)
449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467

        # 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*

468 469 470 471 472
*   Have `enum` perform type casting consistently with the rest of Active
    Record, such as `where`.

    *Sean Griffin*

473 474 475
*   `scoping` no longer pollutes the current scope of sibling classes when using
    STI. e.x.

476 477 478
        StiOne.none.scoping do
          StiTwo.all
        end
479 480 481 482 483

    Fixes #18806.

    *Sean Griffin*

484 485 486 487 488 489 490 491
*   `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*

492 493 494 495 496
*   `find_in_batches` now accepts an `:end_at` parameter that complements the `:start`
     parameter to specify where to stop batch processing.

    *Vipul A M*

497
*   Fix a rounding problem for PostgreSQL timestamp columns.
498

499 500
    If a timestamp column has a precision specified, it needs to
    format according to that.
501 502 503

    *Ryuta Kamizono*

504 505
*   Respect the database default charset for `schema_migrations` table.

506
    The charset of `version` column in `schema_migrations` table depends
507 508 509 510 511
    on the database default charset and collation rather than the encoding
    of the connection.

    *Ryuta Kamizono*

512 513
*   Raise `ArgumentError` when passing `nil` or `false` to `Relation#merge`.

514
    These are not valid values to merge in a relation, so it should warn users
515 516 517 518
    early.

    *Rafael Mendonça França*

519
*   Use `SCHEMA` instead of `DB_STRUCTURE` for specifying a structure file.
520 521 522 523 524

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

    *Dieter Komendera*

525 526 527 528 529 530
*   Respect custom primary keys for associations when calling `Relation#where`

    Fixes #18813.

    *Sean Griffin*

531
*   Fix several edge cases which could result in a counter cache updating
532 533 534 535 536 537
    twice or not updating at all for `has_many` and `has_many :through`.

    Fixes #10865.

    *Sean Griffin*

538 539 540 541 542 543 544 545 546
*   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*

547 548 549 550 551 552 553 554 555 556 557 558
*   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*

559 560 561 562
*   Fix n+1 query problem when eager loading nil associations (fixes #18312)

    *Sammy Larbi*

563
*   Change the default error message from `can't be blank` to `must exist` for
564 565
    the presence validator of the `:required` option on `belongs_to`/`has_one`
    associations.
566 567 568

    *Henrik Nygren*

569 570
*   Fixed `ActiveRecord::Relation#group` method when an argument is an SQL
    reserved keyword:
571

Y
Yves Senn 已提交
572 573 574 575
    Example:

        SplitTest.group(:key).count
        Property.group(:value).count
576 577 578

    *Bogdan Gusiev*

579
*   Added the `#or` method on `ActiveRecord::Relation`, allowing use of the OR
580 581 582 583 584 585 586 587 588
    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*

589 590 591 592 593 594 595
*   Don't define autosave association callbacks twice from
    `accepts_nested_attributes_for`.

    Fixes #18704.

    *Sean Griffin*

596 597 598 599 600 601 602 603
*   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*

604
*   Values which would error while being sent to the database (such as an
605
    ASCII-8BIT string with invalid UTF-8 bytes on SQLite3), no longer error on
606 607 608 609 610 611 612
    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*

613 614
*   Don't remove join dependencies in `Relation#exists?`

615
    Fixes #18632.
616 617 618

    *Sean Griffin*

619 620 621 622 623 624
*   Invalid values assigned to a JSON column are assumed to be `nil`.

    Fixes #18629.

    *Sean Griffin*

625 626 627 628 629 630
*   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*

631 632 633 634 635 636 637 638 639 640 641 642 643 644 645
*   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*

646 647 648 649
*   Don't run SQL if attribute value is not changed for update_attribute method.

    *Prathamesh Sonpatki*

650
*   `time` columns can now get affected by `time_zone_aware_attributes`. If you have
651
    set `config.time_zone` to a value other than `'UTC'`, they will be treated
652
    as in that time zone by default in Rails 5.1. If this is not the desired
653 654 655 656 657 658 659
    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 已提交
660
    Fixes #3145.
661 662 663

    *Sean Griffin*

664 665 666 667 668 669 670 671 672
*   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*

673 674 675 676 677
*   `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*

678 679 680 681 682 683 684
*   `attribute_will_change!` will no longer cause non-persistable attributes to
    be sent to the database.

    Fixes #18407.

    *Sean Griffin*

685 686
*   Remove support for the `protected_attributes` gem.

687
    *Carlos Antonio da Silva*, *Roberto Miranda*
688

689
*   Fix accessing of fixtures having non-string labels like Fixnum.
690 691 692

    *Prathamesh Sonpatki*

693
*   Remove deprecated support to preload instance-dependent associations.
694 695 696

    *Yves Senn*

697 698 699 700
*   Remove deprecated support for PostgreSQL ranges with exclusive lower bounds.

    *Yves Senn*

701
*   Remove deprecation when modifying a relation with cached Arel.
702 703 704 705
    This raises an `ImmutableRelation` error instead.

    *Yves Senn*

Y
Yves Senn 已提交
706 707
*   Added `ActiveRecord::SecureToken` in order to encapsulate generation of
    unique tokens for attributes in a model using `SecureRandom`.
708 709 710

    *Roberto Miranda*

711 712 713 714 715 716 717 718 719
*   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*

720 721 722 723
*   Deprecate `ActiveRecord::Base.errors_in_transactional_callbacks=`.

    *Rafael Mendonça França*

724
*   Change transaction callbacks to not swallow errors.
725

726 727
    Before this change any errors raised inside a transaction callback
    were getting rescued and printed in the logs.
728

729
    Now these errors are not rescued anymore and just bubble up, as the other callbacks.
730 731 732

    *Rafael Mendonça França*

733 734 735 736
*   Remove deprecated `sanitize_sql_hash_for_conditions`.

    *Rafael Mendonça França*

737 738 739 740
*   Remove deprecated `Reflection#source_macro`.

    *Rafael Mendonça França*

741 742 743 744
*   Remove deprecated `symbolized_base_class` and `symbolized_sti_name`.

    *Rafael Mendonça França*

745 746 747 748
*   Remove deprecated `ActiveRecord::Base.disable_implicit_join_references=`.

    *Rafael Mendonça França*

749
*   Remove deprecated access to connection specification using a string accessor.
750 751 752 753 754

    Now all strings will be handled as a URL.

    *Rafael Mendonça França*

755 756 757 758
*   Change the default `null` value for `timestamps` to `false`.

    *Rafael Mendonça França*

759 760 761 762
*   Return an array of pools from `connection_pools`.

    *Rafael Mendonça França*

763 764 765 766
*   Return a null column from `column_for_attribute` when no column exists.

    *Rafael Mendonça França*

767 768 769 770
*   Remove deprecated `serialized_attributes`.

    *Rafael Mendonça França*

771 772 773 774
*   Remove deprecated automatic counter caches on `has_many :through`.

    *Rafael Mendonça França*

775 776 777 778
*   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)`.
779
    In the past, returning `false` in an Active Record `before_` callback had the
780 781 782 783
    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.
784 785 786

    *claudiob*

787
*   Clear query cache on rollback.
Y
Yves Senn 已提交
788

789
    *Florian Weingarten*
Y
Yves Senn 已提交
790

791
*   Fix setting of foreign_key for through associations when building a new record.
792 793 794 795 796

    Fixes #12698.

    *Ivan Antropov*

797
*   Improve dumping of the primary key. If it is not a default primary key,
798 799 800 801 802 803
    correctly dump the type and options.

    Fixes #14169, #16599.

    *Ryuta Kamizono*

804 805 806 807 808 809 810 811 812 813 814
*   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*

815
*   Allow a precision option for MySQL datetimes.
816 817 818

    *Ryuta Kamizono*

819
*   Fixed automatic `inverse_of` for models nested in a module.
820 821 822

    *Andrew McCloud*

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

826
    This change allows updating multiple records returned by
827 828 829 830 831 832 833 834 835 836 837 838
    `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*

839 840 841 842 843 844
*   Fix `reaping_frequency` option when the value is a string.

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

    *korbin*

845 846 847 848 849 850 851 852 853 854 855 856 857
*   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*

858 859 860 861 862 863 864
*   Fix change detection problem for PostgreSQL bytea type and
    `ArgumentError: string contains null byte` exception with pg-0.18.

    Fixes #17680.

    *Lars Kanis*

865 866 867 868
*   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.
869 870 871 872 873

    Fixes #18070.

    *arthurnn*

874
*   `validates_size_of` / `validates_length_of` do not count records
875 876 877 878 879 880
    which are `marked_for_destruction?`.

    Fixes #7247.

    *Yves Senn*

881 882 883 884 885 886
*   Ensure `first!` and friends work on loaded associations.

    Fixes #18237.

    *Sean Griffin*

887 888 889 890 891 892
*   `eager_load` preserves readonly flag for associations.

    Closes #15853.

    *Takashi Kokubun*

893
*   Provide `:touch` option to `save()` to accommodate saving without updating
894 895
    timestamps.

896
    Fixes #18202.
897 898 899

    *Dan Olson*

900
*   Provide a more helpful error message when an unsupported class is passed to
901
    `serialize`.
902

903
    Fixes #18224.
904 905 906

    *Sean Griffin*

907 908 909 910 911 912 913 914 915
*   Add bigint primary key support for MySQL.

    Example:

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

    *Ryuta Kamizono*

916
*   Support for any type of primary key.
R
Ryuta Kamizono 已提交
917 918 919 920 921

    Fixes #14194.

    *Ryuta Kamizono*

922 923 924 925
*   Dump the default `nil` for PostgreSQL UUID primary key.

    *Ryuta Kamizono*

926 927 928 929 930 931
*   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*

932 933 934 935 936
*   Don't raise when writing an attribute with an out-of-range datetime passed
    by the user.

    *Grey Baker*

937 938 939 940 941
*   Replace deprecated `ActiveRecord::Tasks::DatabaseTasks#load_schema` with
    `ActiveRecord::Tasks::DatabaseTasks#load_schema_for`.

    *Yves Senn*

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

Y
Yves Senn 已提交
945
    Closes #18161.
946 947 948

    *Daniel Fox*

949 950 951 952 953 954 955
*   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*

956 957 958 959 960 961 962 963
*   `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 已提交
964
*   Fix undesirable RangeError by `Type::Integer`. Add `Type::UnsignedInteger`.
965 966 967

    *Ryuta Kamizono*

968 969 970 971
*   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.

972
    *Ulisses Almeida*, *Kassio Borges*
973

974 975 976 977 978
*   Remove deprecated behavior allowing nested arrays to be passed as query
    values.

    *Melanie Gilman*

979 980 981 982 983
*   Deprecate passing a class as a value in a query. Users should pass strings
    instead.

    *Melanie Gilman*

984 985 986 987 988
*   `add_timestamps` and `remove_timestamps` now properly reversible with
    options.

    *Noam Gagliardi-Rabinovich*

989 990 991 992 993 994 995
*   `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*

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