CHANGELOG.md 32.3 KB
Newer Older
1 2 3 4 5
*   Lookup the attribute name for `restrict_with_error` messages on the
    model class that defines the association.

    *kuboon*, *Ronak Jangir*

6 7 8 9
*   Correct query for PostgreSQL 8.2 compatibility.

    *Ben Murphy*, *Matthew Draper*

10 11 12
*   `bin/rake db:migrate` uses
    `ActiveRecord::Tasks::DatabaseTasks.migrations_paths` instead of
    `Migrator.migrations_paths`.
13 14 15

    *Tobias Bielohlawek*

Y
Yves Senn 已提交
16
*   Support dropping indexes concurrently in PostgreSQL.
17 18 19 20 21 22

    See http://www.postgresql.org/docs/9.4/static/sql-dropindex.html for more
    details.

    *Grey Baker*

23
*   Deprecate passing conditions to `ActiveRecord::Relation#delete_all`
Y
Yves Senn 已提交
24
    and `ActiveRecord::Relation#destroy_all`.
25 26 27

    *Wojciech Wnętrzak*

28 29 30 31 32 33 34 35 36 37 38 39
*   PostgreSQL, `create_schema`, `drop_schema` and `rename_table` now quote
    schema names.

    Fixes #21418.

    Example:

        create_schema("my.schema")
        # CREATE SCHEMA "my.schema";

    *Yves Senn*

40 41 42 43 44 45
*   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.

    *Yves Senn*

46 47 48 49 50 51
*   Only try to nullify has_one target association if the record is persisted.

    Fixes #21223.

    *Agis Anastasopoulos*

52 53 54
*   Uniqueness validator raises descriptive error when running on a persisted
    record without primary key.

Y
Yves Senn 已提交
55
    Fixes #21304.
56 57 58

    *Yves Senn*

59 60 61 62 63 64 65 66 67 68
*   Add a native JSON data type support in MySQL.

    Example:

        create_table :json_data_type do |t|
          t.json :settings
        end

    *Ryuta Kamizono*

69 70
*   Descriptive error message when fixtures contain a missing column.

Y
Yves Senn 已提交
71
    Fixes #21201.
72 73 74

    *Yves Senn*

75 76
*   `ActiveRecord::Tasks::PostgreSQLDatabaseTasks` fail if shellout to
    postgresql commands (like `pg_dump`) is not successful.
77

78 79
    *Bryan Paxton*, *Nate Berkopec*

80 81 82 83 84 85 86 87 88 89 90 91 92 93 94
*   Add `ActiveRecord::Relation#in_batches` to work with records and relations
    in batches.

    Available options are `of` (batch size), `load`, `begin_at`, and `end_at`.

    Examples:

        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

Y
Yves Senn 已提交
95
    Fixes #20933.
96 97 98

    *Sina Siadat*

Y
Yves Senn 已提交
99
*   Added methods for PostgreSQL geometric data types to use in migrations.
100 101 102 103 104 105 106 107 108 109 110 111 112 113

    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

    *Mehmet Emin İNAÇ*

114 115 116 117 118 119 120 121 122 123
*   Add `cache_key` to ActiveRecord::Relation.

    Example:

      @users = User.where("name like ?", "%Alberto%")
      @users.cache_key
      => "/users/query-5942b155a43b139f2471b872ac54251f-3-20150714212107656125000"

    *Alberto Fernández-Capel*

124 125 126 127
*   Properly allow uniqueness validations on primary keys.

    Fixes #20966.

Y
Yves Senn 已提交
128
    *Sean Griffin*, *presskey*
129

130 131 132 133 134 135 136
*   Don't raise an error if an association failed to destroy when `destroy` was
    called on the parent (as opposed to `destroy!`).

    Fixes #20991.

    *Sean Griffin*

Y
Yves Senn 已提交
137
*   `ActiveRecord::RecordNotFound` modified to store model name, primary_key and
138
    id of the caller model. It allows the catcher of this exception to make
Y
Yves Senn 已提交
139 140 141
    a better decision to what to do with it.

    Example:
142 143 144 145 146 147 148 149 150 151 152 153

        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

    *Sameer Rahmani*

154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169
*   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*

170 171 172 173 174 175 176 177 178 179 180 181 182 183
*   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*

184 185 186 187 188 189 190
*   Correctly ignore `mark_for_destruction` when `autosave` isn't set to `true`
    when validating associations.

    Fixes #20882.

    *Sean Griffin*

Y
Yves Senn 已提交
191
*   Fix a bug where counter_cache doesn't always work with polymorphic
192 193 194 195
    relations.

    Fixes #16407.

Y
Yves Senn 已提交
196
    *Stefan Kanev*, *Sean Griffin*
197

198 199 200 201 202 203 204
*   Ensure that cyclic associations with autosave don't cause duplicate errors
    to be added to the parent record.

    Fixes #20874.

    *Sean Griffin*

205 206 207 208 209 210 211
*   Ensure that `ActionController::Parameters` can still be passed to nested
    attributes.

    Fixes #20922.

    *Sean Griffin*

212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229
*   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*

230 231 232 233 234
*   Replaced `ActiveSupport::Concurrency::Latch` with `Concurrent::CountDownLatch`
    from the concurrent-ruby gem.

    *Jerry D'Antonio*

235 236 237 238 239 240 241 242
*   Fix through associations using scopes having the scope merged multiple
    times.

    Fixes #20721.
    Fixes #20727.

    *Sean Griffin*

243 244 245 246 247 248 249
*   `ActiveRecord::Base.dump_schema_after_migration` applies migration tasks
    other than `db:migrate`. (eg. `db:rollback`, `db:migrate:dup`, ...)

    Fixes #20743.

    *Yves Senn*

250 251 252 253 254 255 256 257
*   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 已提交
258
        change_column_default :users, :authorized, from: true, to: false
259 260 261

    *Prem Sichanugrist*

262 263 264 265 266 267 268
*   Prevent error when using `force_reload: true` on an unassigned polymorphic
    belongs_to association.

    Fixes #20426.

    *James Dabbs*

269 270
*   Correctly raise `ActiveRecord::AssociationTypeMismatch` when assigning
    a wrong type to a namespaced association.
271

272
    Fixes #20545.
273 274 275

    *Diego Carrion*

276 277 278 279 280 281
*   `validates_absence_of` respects `marked_for_destruction?`.

    Fixes #20449.

    *Yves Senn*

282 283 284 285
*   Include the `Enumerable` module in `ActiveRecord::Relation`

    *Sean Griffin & bogdan*

286 287 288 289
*   Use `Enumerable#sum` in `ActiveRecord::Relation` if a block is given.

    *Sean Griffin*

290
*   Let `WITH` queries (Common Table Expressions) be explainable.
291 292 293

    *Vladimir Kochnev*

294 295 296 297
*   Make `remove_index :table, :column` reversible.

    *Yves Senn*

298 299 300 301 302 303 304
*   Fixed an error which would occur in dirty checking when calling
    `update_attributes` from a getter.

    Fixes #20531.

    *Sean Griffin*

305 306
*   Make `remove_foreign_key` reversible. Any foreign key options must be
    specified, similar to `remove_column`.
307 308 309

    *Aster Ryan*

310
*   Add `:_prefix` and `:_suffix` options to `enum` definition.
311

312
    Fixes #17511, #17415.
313 314 315

    *Igor Kapkov*

316 317 318 319
*   Correctly handle decimal arrays with defaults in the schema dumper.

    Fixes #20515.

320
    *Sean Griffin & jmondo*
321

322
*   Deprecate the PostgreSQL `:point` type in favor of a new one which will return
323 324 325 326
    `Point` objects instead of an `Array`

    *Sean Griffin*

327 328 329 330 331 332 333
*   Ensure symbols passed to `ActiveRecord::Relation#select` are always treated
    as columns.

    Fixes #20360.

    *Sean Griffin*

334 335
*   Do not set `sql_mode` if `strict: :default` is specified.

Y
Yves Senn 已提交
336
        # config/database.yml
337 338 339 340 341 342 343 344
        production:
          adapter: mysql2
          database: foo_prod
          user: foo
          strict: :default

    *Ryuta Kamizono*

345 346 347
*   Allow proc defaults to be passed to the attributes API. See documentation
    for examples.

348
    *Sean Griffin*, *Kir Shatrov*
349

350 351 352 353 354 355 356 357 358 359 360 361 362 363 364
*   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 已提交
365 366 367 368 369 370 371 372 373
*   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*

374
*   Clear query cache when `ActiveRecord::Base#reload` is called.
375

376
    *Shane Hender, Pierre Nespo*
377

378 379 380 381
*   Include stored procedures and function on the MySQL structure dump.

    *Jonathan Worek*

382 383
*   Pass `:extend` option for `has_and_belongs_to_many` associations to the
    underlying `has_many :through`.
384 385 386

    *Jaehyun Shin*

387 388 389 390 391 392
*   Deprecate `Relation#uniq` use `Relation#distinct` instead.

    See #9683.

    *Yves Senn*

393 394
*   Allow single table inheritance instantiation to work when storing
    demodulized class names.
395 396 397

    *Alex Robbin*

398 399
*   Correctly pass MySQL options when using `structure_dump` or
    `structure_load`.
400 401 402 403 404

    Specifically, it fixes an issue when using SSL authentication.

    *Alex Coomans*

405 406
*   Dump indexes in `create_table` instead of `add_index`.

407
    If the adapter supports indexes in `create_table`, generated SQL is
408 409 410 411
    slightly more efficient.

    *Ryuta Kamizono*

412 413 414 415
*   Correctly dump `:options` on `create_table` for MySQL.

    *Ryuta Kamizono*

416 417 418 419 420 421 422 423 424 425 426
*   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*

427 428 429 430
*   Remove `ActiveRecord::Serialization::XmlSerializer` from core.

    *Zachary Scott*

431 432 433 434
*   Make `unscope` aware of "less than" and "greater than" conditions.

    *TAKAHASHI Kazuaki*

435 436 437 438 439
*   `find_by` and `find_by!` raise `ArgumentError` when called without
    arguments.

    *Kohei Suzuki*

440 441 442 443 444 445 446
*   Revert behavior of `db:schema:load` back to loading the full
    environment. This ensures that initializers are run.

    Fixes #19545.

    *Yves Senn*

447 448 449 450 451 452 453 454
*   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*

455 456 457 458 459 460
*   Rename `:class` to `:anonymous_class` in association options.

    Fixes #19659.

    *Andrew White*

461 462 463 464 465 466 467
*   Autosave existing records on a has many through association when the parent
    is new.

    Fixes #19782.

    *Sean Griffin*

468 469
*   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.
470 471 472

    *Andrey Voronkov*

473
*   MySQL: `:charset` and `:collation` support for string and text columns.
474 475 476 477 478 479 480 481 482 483

    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*

484 485 486 487 488 489 490
*   Foreign key related methods in the migration DSL respect
    `ActiveRecord::Base.pluralize_table_names = false`.

    Fixes #19643.

    *Mehmet Emin İNAÇ*

Y
Yves Senn 已提交
491
*   Reduce memory usage from loading types on PostgreSQL.
492 493 494 495 496

    Fixes #19578.

    *Sean Griffin*

Y
Yves Senn 已提交
497
*   Add `config.active_record.warn_on_records_fetched_greater_than` option.
498 499

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

    Fixes #16463.
503 504 505

    *Jason Nochlin*

Y
Yves Senn 已提交
506
*   Ignore `.psqlrc` when loading database structure.
507 508 509

    *Jason Weathered*

510 511
*   Fix referencing wrong table aliases while joining tables of has many through
    association (only when calling calculation methods).
512

513
    Fixes #19276.
514 515 516

    *pinglamb*

517 518 519 520 521 522 523
*   Correctly persist a serialized attribute that has been returned to
    its default value by an in-place modification.

    Fixes #19467.

    *Matthew Draper*

524 525 526 527 528 529 530 531
*   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*

532 533 534 535 536
*   Reuse the `CollectionAssociation#reader` cache when the foreign key is
    available prior to save.

    *Ben Woosley*

537 538 539 540 541 542 543
*   Add `config.active_record.dump_schemas` to fix `db:structure:dump`
    when using schema_search_path and PostgreSQL extensions.

    Fixes #17157.

    *Ryan Wallace*

544 545 546 547 548 549
*   Renaming `use_transactional_fixtures` to `use_transactional_tests` for clarity.

    Fixes #18864.

    *Brandon Weiss*

550 551 552 553 554
*   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*

555 556 557 558
*   Correctly dump `serial` and `bigserial`.

    *Ryuta Kamizono*

559 560 561 562
*   Fix default `format` value in `ActiveRecord::Tasks::DatabaseTasks#schema_file`.

    *James Cox*

563 564
*   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.
565 566 567 568 569

    Fixes #15549.

    *Will Bryant*, *Aaron Patterson*

570 571 572 573 574 575 576
*   Correctly create through records when created on a has many through
    association when using `where`.

    Fixes #19073.

    *Sean Griffin*

577
*   Add `SchemaMigration.create_table` support for any unicode charsets with MySQL.
578 579 580

    *Ryuta Kamizono*

581
*   PostgreSQL no longer disables user triggers if system triggers can't be
582 583 584 585 586 587 588 589 590 591 592 593 594
    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*

595 596
*   In PostgreSQL, print a warning message if `disable_referential_integrity`
    fails due to missing permissions.
597 598 599

    *Andrey Nering*, *Yves Senn*

600
*   Allow a `:limit` option for MySQL bigint primary key support.
601 602 603 604 605 606 607 608 609 610 611 612 613 614

    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*

615 616 617 618 619 620 621
*   `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*

622
*   Fixed `ActiveRecord::Relation#becomes!` and `changed_attributes` issues for type
623
    columns.
624 625 626 627 628

    Fixes #17139.

    *Miklos Fazekas*

629 630 631 632
*   Format the time string according to the precision of the time column.

    *Ryuta Kamizono*

633
*   Allow a `:precision` option for time type columns.
634 635 636

    *Ryuta Kamizono*

637
*   Add `ActiveRecord::Base.suppress` to prevent the receiver from being saved
M
Michael Ryan 已提交
638 639 640 641 642 643
    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):

644 645 646 647 648
        class Comment < ActiveRecord::Base
          belongs_to :commentable, polymorphic: true
          after_create -> { Notification.create! comment: self,
            recipients: commentable.recipients }
        end
M
Michael Ryan 已提交
649

650 651 652 653
    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 已提交
654

655 656 657 658 659 660 661
        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 已提交
662 663 664 665
        end

    *Michael Ryan*

666 667
*   `:time` option added for `#touch`.

H
Hyonjee Joo 已提交
668 669 670 671
    Fixes #18905.

    *Hyonjee Joo*

672
*   Deprecate passing of `start` value to `find_in_batches` and `find_each`
673 674 675 676
    in favour of `begin_at` value.

    *Vipul A M*

677 678 679 680
*   Add `foreign_key_exists?` method.

    *Tõnis Simo*

681 682 683 684
*   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`)
685 686 687 688 689 690 691 692 693 694 695 696 697 698 699 700 701 702 703

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

704 705 706 707 708
*   Have `enum` perform type casting consistently with the rest of Active
    Record, such as `where`.

    *Sean Griffin*

709 710 711
*   `scoping` no longer pollutes the current scope of sibling classes when using
    STI. e.x.

712 713 714
        StiOne.none.scoping do
          StiTwo.all
        end
715 716 717 718 719

    Fixes #18806.

    *Sean Griffin*

720 721 722 723 724 725 726 727
*   `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*

728 729 730 731 732
*   `find_in_batches` now accepts an `:end_at` parameter that complements the `:start`
     parameter to specify where to stop batch processing.

    *Vipul A M*

733
*   Fix a rounding problem for PostgreSQL timestamp columns.
734

735 736
    If a timestamp column has a precision specified, it needs to
    format according to that.
737 738 739

    *Ryuta Kamizono*

740 741
*   Respect the database default charset for `schema_migrations` table.

742
    The charset of `version` column in `schema_migrations` table depends
743 744 745 746 747
    on the database default charset and collation rather than the encoding
    of the connection.

    *Ryuta Kamizono*

748 749
*   Raise `ArgumentError` when passing `nil` or `false` to `Relation#merge`.

750
    These are not valid values to merge in a relation, so it should warn users
751 752 753 754
    early.

    *Rafael Mendonça França*

755
*   Use `SCHEMA` instead of `DB_STRUCTURE` for specifying a structure file.
756 757 758 759 760

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

    *Dieter Komendera*

761 762 763 764 765 766
*   Respect custom primary keys for associations when calling `Relation#where`

    Fixes #18813.

    *Sean Griffin*

767
*   Fix several edge cases which could result in a counter cache updating
768 769 770 771 772 773
    twice or not updating at all for `has_many` and `has_many :through`.

    Fixes #10865.

    *Sean Griffin*

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

783 784 785 786 787 788 789 790 791 792 793 794
*   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*

795 796 797 798
*   Fix n+1 query problem when eager loading nil associations (fixes #18312)

    *Sammy Larbi*

799
*   Change the default error message from `can't be blank` to `must exist` for
800 801
    the presence validator of the `:required` option on `belongs_to`/`has_one`
    associations.
802 803 804

    *Henrik Nygren*

805 806
*   Fixed `ActiveRecord::Relation#group` method when an argument is an SQL
    reserved keyword:
807

Y
Yves Senn 已提交
808 809 810 811
    Example:

        SplitTest.group(:key).count
        Property.group(:value).count
812 813 814

    *Bogdan Gusiev*

815
*   Added the `#or` method on `ActiveRecord::Relation`, allowing use of the OR
816 817 818 819 820 821 822 823 824
    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*

825 826 827 828 829 830 831
*   Don't define autosave association callbacks twice from
    `accepts_nested_attributes_for`.

    Fixes #18704.

    *Sean Griffin*

832 833 834 835 836 837 838 839
*   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*

840
*   Values which would error while being sent to the database (such as an
841
    ASCII-8BIT string with invalid UTF-8 bytes on SQLite3), no longer error on
842 843 844 845 846 847 848
    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*

849 850
*   Don't remove join dependencies in `Relation#exists?`

851
    Fixes #18632.
852 853 854

    *Sean Griffin*

855 856 857 858 859 860
*   Invalid values assigned to a JSON column are assumed to be `nil`.

    Fixes #18629.

    *Sean Griffin*

861 862 863 864 865 866
*   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*

867 868 869 870 871 872 873 874 875 876 877 878 879 880 881
*   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*

882 883 884 885
*   Don't run SQL if attribute value is not changed for update_attribute method.

    *Prathamesh Sonpatki*

886
*   `time` columns can now get affected by `time_zone_aware_attributes`. If you have
887
    set `config.time_zone` to a value other than `'UTC'`, they will be treated
888
    as in that time zone by default in Rails 5.1. If this is not the desired
889 890 891 892 893 894 895
    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 已提交
896
    Fixes #3145.
897 898 899

    *Sean Griffin*

900 901 902 903 904 905 906 907 908
*   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*

909 910 911 912 913
*   `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*

914 915 916 917 918 919 920
*   `attribute_will_change!` will no longer cause non-persistable attributes to
    be sent to the database.

    Fixes #18407.

    *Sean Griffin*

921 922
*   Remove support for the `protected_attributes` gem.

923
    *Carlos Antonio da Silva*, *Roberto Miranda*
924

925
*   Fix accessing of fixtures having non-string labels like Fixnum.
926 927 928

    *Prathamesh Sonpatki*

929
*   Remove deprecated support to preload instance-dependent associations.
930 931 932

    *Yves Senn*

933 934 935 936
*   Remove deprecated support for PostgreSQL ranges with exclusive lower bounds.

    *Yves Senn*

937
*   Remove deprecation when modifying a relation with cached Arel.
938 939 940 941
    This raises an `ImmutableRelation` error instead.

    *Yves Senn*

Y
Yves Senn 已提交
942 943
*   Added `ActiveRecord::SecureToken` in order to encapsulate generation of
    unique tokens for attributes in a model using `SecureRandom`.
944 945 946

    *Roberto Miranda*

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

956 957 958 959
*   Deprecate `ActiveRecord::Base.errors_in_transactional_callbacks=`.

    *Rafael Mendonça França*

960
*   Change transaction callbacks to not swallow errors.
961

962 963
    Before this change any errors raised inside a transaction callback
    were getting rescued and printed in the logs.
964

965
    Now these errors are not rescued anymore and just bubble up, as the other callbacks.
966 967 968

    *Rafael Mendonça França*

969 970 971 972
*   Remove deprecated `sanitize_sql_hash_for_conditions`.

    *Rafael Mendonça França*

973 974 975 976
*   Remove deprecated `Reflection#source_macro`.

    *Rafael Mendonça França*

977 978 979 980
*   Remove deprecated `symbolized_base_class` and `symbolized_sti_name`.

    *Rafael Mendonça França*

981 982 983 984
*   Remove deprecated `ActiveRecord::Base.disable_implicit_join_references=`.

    *Rafael Mendonça França*

985
*   Remove deprecated access to connection specification using a string accessor.
986 987 988 989 990

    Now all strings will be handled as a URL.

    *Rafael Mendonça França*

991 992 993 994
*   Change the default `null` value for `timestamps` to `false`.

    *Rafael Mendonça França*

995 996 997 998
*   Return an array of pools from `connection_pools`.

    *Rafael Mendonça França*

999 1000 1001 1002
*   Return a null column from `column_for_attribute` when no column exists.

    *Rafael Mendonça França*

1003 1004 1005 1006
*   Remove deprecated `serialized_attributes`.

    *Rafael Mendonça França*

1007 1008 1009 1010
*   Remove deprecated automatic counter caches on `has_many :through`.

    *Rafael Mendonça França*

1011 1012 1013 1014
*   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)`.
1015
    In the past, returning `false` in an Active Record `before_` callback had the
1016 1017 1018 1019
    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.
1020 1021 1022

    *claudiob*

1023
*   Clear query cache on rollback.
Y
Yves Senn 已提交
1024

1025
    *Florian Weingarten*
Y
Yves Senn 已提交
1026

1027
*   Fix setting of foreign_key for through associations when building a new record.
1028 1029 1030 1031 1032

    Fixes #12698.

    *Ivan Antropov*

1033
*   Improve dumping of the primary key. If it is not a default primary key,
1034 1035 1036 1037 1038 1039
    correctly dump the type and options.

    Fixes #14169, #16599.

    *Ryuta Kamizono*

1040 1041 1042 1043 1044 1045 1046 1047 1048 1049 1050
*   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*

1051
*   Allow a precision option for MySQL datetimes.
1052 1053 1054

    *Ryuta Kamizono*

1055
*   Fixed automatic `inverse_of` for models nested in a module.
1056 1057 1058

    *Andrew McCloud*

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

1062
    This change allows updating multiple records returned by
1063 1064 1065 1066 1067 1068 1069 1070 1071 1072 1073 1074
    `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*

1075 1076 1077 1078 1079 1080
*   Fix `reaping_frequency` option when the value is a string.

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

    *korbin*

1081 1082 1083 1084 1085 1086 1087 1088 1089 1090 1091 1092 1093
*   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*

1094 1095 1096 1097 1098 1099 1100
*   Fix change detection problem for PostgreSQL bytea type and
    `ArgumentError: string contains null byte` exception with pg-0.18.

    Fixes #17680.

    *Lars Kanis*

1101 1102 1103 1104
*   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.
1105 1106 1107 1108 1109

    Fixes #18070.

    *arthurnn*

1110
*   `validates_size_of` / `validates_length_of` do not count records
1111 1112 1113 1114 1115 1116
    which are `marked_for_destruction?`.

    Fixes #7247.

    *Yves Senn*

1117 1118 1119 1120 1121 1122
*   Ensure `first!` and friends work on loaded associations.

    Fixes #18237.

    *Sean Griffin*

1123 1124
*   `eager_load` preserves readonly flag for associations.

Y
Yves Senn 已提交
1125
    Fixes #15853.
1126 1127 1128

    *Takashi Kokubun*

1129
*   Provide `:touch` option to `save()` to accommodate saving without updating
1130 1131
    timestamps.

1132
    Fixes #18202.
1133 1134 1135

    *Dan Olson*

1136
*   Provide a more helpful error message when an unsupported class is passed to
1137
    `serialize`.
1138

1139
    Fixes #18224.
1140 1141 1142

    *Sean Griffin*

1143 1144 1145 1146 1147 1148 1149 1150 1151
*   Add bigint primary key support for MySQL.

    Example:

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

    *Ryuta Kamizono*

1152
*   Support for any type of primary key.
R
Ryuta Kamizono 已提交
1153 1154 1155 1156 1157

    Fixes #14194.

    *Ryuta Kamizono*

1158 1159 1160 1161
*   Dump the default `nil` for PostgreSQL UUID primary key.

    *Ryuta Kamizono*

1162 1163 1164 1165 1166 1167
*   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*

1168 1169 1170 1171 1172
*   Don't raise when writing an attribute with an out-of-range datetime passed
    by the user.

    *Grey Baker*

1173 1174 1175 1176 1177
*   Replace deprecated `ActiveRecord::Tasks::DatabaseTasks#load_schema` with
    `ActiveRecord::Tasks::DatabaseTasks#load_schema_for`.

    *Yves Senn*

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

Y
Yves Senn 已提交
1181
    Fixes #18161.
1182 1183 1184

    *Daniel Fox*

1185 1186 1187 1188 1189 1190 1191
*   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*

1192 1193 1194 1195
*   `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.

Y
Yves Senn 已提交
1196
    Fixes #17945.
1197 1198 1199

    *Yves Senn*

Y
Yves Senn 已提交
1200
*   Fix undesirable RangeError by `Type::Integer`. Add `Type::UnsignedInteger`.
1201 1202 1203

    *Ryuta Kamizono*

1204 1205 1206 1207
*   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.

1208
    *Ulisses Almeida*, *Kassio Borges*
1209

1210 1211 1212 1213 1214
*   Remove deprecated behavior allowing nested arrays to be passed as query
    values.

    *Melanie Gilman*

1215 1216 1217 1218 1219
*   Deprecate passing a class as a value in a query. Users should pass strings
    instead.

    *Melanie Gilman*

1220 1221 1222 1223 1224
*   `add_timestamps` and `remove_timestamps` now properly reversible with
    options.

    *Noam Gagliardi-Rabinovich*

1225 1226 1227 1228 1229 1230 1231
*   `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*

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