CHANGELOG.md 13.7 KB
Newer Older
1 2 3 4
*   Remove deprecated `#uniq`, `#uniq!`, and `#uniq_value`.

    *Ryuta Kamizono*

5 6 7 8
*   Remove deprecated `#insert_sql`, `#update_sql`, and `#delete_sql`.

    *Ryuta Kamizono*

9 10 11 12
*   Remove deprecated `#use_transactional_fixtures` configuration.

    *Rafael Mendonça França*

13 14 15 16
*   Remove deprecated `#raise_in_transactional_callbacks` configuration.

    *Rafael Mendonça França*

17 18 19 20
*   Remove deprecated `#load_schema_for`.

    *Rafael Mendonça França*

21
*   Remove deprecated conditions parameter from `#destroy_all` and `#delete_all`.
22 23 24

    *Rafael Mendonça França*

25 26 27 28
*   Remove deprecated support to passing arguments to `#select` when a block is provided.

    *Rafael Mendonça França*

29 30 31 32
*   Remove deprecated support to query using commas on LIMIT.

    *Rafael Mendonça França*

33 34 35 36
*   Remove deprecated support to passing a class as a value in a query.

    *Rafael Mendonça França*

37
*   Raise `ActiveRecord::IrreversibleOrderError` when using `last` with an irreversible
38 39 40 41
    order.

    *Rafael Mendonça França*

42
*   Raise when a `has_many :through` association has an ambiguous reflection name.
43 44 45

    *Rafael Mendonça França*

46
*   Raise when `ActiveRecord::Migration` is inherited directly.
47 48 49

    *Rafael Mendonça França*

50 51 52 53 54
*   Remove deprecated `original_exception` argument in `ActiveRecord::StatementInvalid#initialize`
    and `ActiveRecord::StatementInvalid#original_exception`.

    *Rafael Mendonça França*

K
kenta-s 已提交
55
*   `#tables` and `#table_exists?` return only tables and not views.
56 57 58 59 60

    All the deprecations on those methods were removed.

    *Rafael Mendonça França*

61 62 63 64
*   Remove deprecated `name` argument from `#tables`.

    *Rafael Mendonça França*

65 66 67 68
*   Remove deprecated support to passing a column to `#quote`.

    *Rafael Mendonça França*

69 70
*   Set `:time` as a timezone aware type and remove deprecation when
    `config.active_record.time_zone_aware_types` is not explictly set.
71 72 73

    *Rafael Mendonça França*

74 75 76 77
*   Remove deprecated force reload argument in singular and collection association readers.

    *Rafael Mendonça França*

78 79 80 81 82
*   Remove deprecated `activerecord.errors.messages.restrict_dependent_destroy.one` and
    `activerecord.errors.messages.restrict_dependent_destroy.many` i18n scopes.

    *Rafael Mendonça França*

83 84 85 86 87 88 89
*   Allow passing extra flags to `db:structure:load` and `db:structure:dump`

    Introduces `ActiveRecord::Tasks::DatabaseTasks.structure_(load|dump)_flags` to customize the
    eventual commands run against the database, e.g. mysqldump/pg_dump.

    *Kir Shatrov*

R
Richard Monette 已提交
90 91
*   Notifications see frozen SQL string.

92
    Fixes #23774.
R
Richard Monette 已提交
93 94 95

    *Richard Monette*

96
*   RuntimeErrors are no longer translated to `ActiveRecord::StatementInvalid`.
R
Richard Monette 已提交
97 98 99

    *Richard Monette*

100 101 102 103
*   Change the schema cache format to use YAML instead of Marshal.

    *Kir Shatrov*

104 105 106 107 108 109 110
*   Support index length and order options using both string and symbol
    column names.

    Fixes #27243.

    *Ryuta Kamizono*

111 112 113 114
*   Raise `ActiveRecord::RangeError` when values that executed are out of range.

    *Ryuta Kamizono*

115 116 117 118 119 120
*   Raise `ActiveRecord::NotNullViolation` when a record cannot be inserted
    or updated because it would violate a not null constraint.

    *Ryuta Kamizono*

*   Emulate db trigger behaviour for after_commit :destroy, :update.
121 122 123 124 125 126 127

    Race conditions can occur when an ActiveRecord is destroyed
    twice or destroyed and updated. The callbacks should only be
    triggered once, similar to a SQL database trigger.

    *Stefan Budeanu*

128
*   Moved `DecimalWithoutScale`, `Text`, and `UnsignedInteger` from Active Model to Active Record.
129 130 131

    *Iain Beeston*

132 133 134 135 136
*   Fix `write_attribute` method to check whether an attribute is aliased or not, and
    use the aliased attribute name if needed.

    *Prathamesh Sonpatki*

137 138 139 140 141 142 143
*   Fix `read_attribute` method to check whether an attribute is aliased or not, and
    use the aliased attribute name if needed.

    Fixes #26417.

    *Prathamesh Sonpatki*

144
*   PostgreSQL & MySQL: Use big integer as primary key type for new tables.
145 146 147

    *Jon McCartie*, *Pavel Pravosud*

148 149 150 151 152 153
*   Change the type argument of `ActiveRecord::Base#attribute` to be optional.
    The default is now `ActiveRecord::Type::Value.new`, which provides no type
    casting behavior.

    *Sean Griffin*

154 155 156 157 158 159
*   Fix that unsigned with zerofill is treated as signed.

    Fixes #27125.

    *Ryuta Kamizono*

160 161 162 163
*   Fix the uniqueness validation scope with a polymorphic association.

    *Sergey Alekseev*

164
*   Raise `ActiveRecord::RecordNotFound` from collection `*_ids` setters
165 166
    for unknown IDs with a better error message.

167 168 169 170
    Changes the collection `*_ids` setters to cast provided IDs the data
    type of the primary key set in the association, not the model
    primary key.

171 172
    *Dominic Cleal*

173 174 175 176 177
*   For PostgreSQL >= 9.4 use `pgcrypto`'s `gen_random_uuid()` instead of
    `uuid-ossp`'s UUID generation function.

    *Yuji Yaginuma*, *Yaw Boakye*

178 179 180 181
*   Introduce `Model#reload_<association>` to bring back the behavior
    of `Article.category(true)` where `category` is a singular
    association.

182 183
    The force reloading of the association reader was deprecated
    in #20888. Unfortunately the suggested alternative of
184 185 186 187 188 189 190 191
    `article.reload.category` does not expose the same behavior.

    This patch adds a reader method with the prefix `reload_` for
    singular associations. This method has the same semantics as
    passing true to the association reader used to have.

    *Yves Senn*

Y
Yves Senn 已提交
192 193 194 195 196
*   Make sure eager loading `ActiveRecord::Associations` also loads
    constants defined in `ActiveRecord::Associations::Preloader`.

    *Yves Senn*

J
Jon Moss 已提交
197 198 199 200 201 202 203
*   Allow `ActionController::Parameters`-like objects to be passed as
    values for Postgres HStore columns.

    Fixes #26904.

    *Jon Moss*

204
*   Added `stat` method to `ActiveRecord::ConnectionAdapters::ConnectionPool`.
205 206 207 208 209 210 211 212

    Example:

        ActiveRecord::Base.connection_pool.stat # =>
        { size: 15, connections: 1, busy: 1, dead: 0, idle: 0, waiting: 0, checkout_timeout: 5 }

    *Pavel Evstigneev*

213 214
*   Avoid `unscope(:order)` when `limit_value` is presented for `count`
    and `exists?`.
215 216

    If `limit_value` is presented, records fetching order is very important
V
Vipul A M 已提交
217
    for performance. We should not unscope the order in the case.
218 219 220

    *Ryuta Kamizono*

V
Vipul A M 已提交
221
*   Fix an Active Record `DateTime` field `NoMethodError` caused by incomplete
222 223 224
    datetime.

    Fixes #24195.
S
Sen-Zhang 已提交
225 226 227

    *Sen Zhang*

V
Vipul A M 已提交
228
*   Allow `slice` to take an array of methods(without the need for splatting).
229 230 231

    *Cohen Carlisle*

232 233 234 235 236 237 238
*   Improved partial writes with HABTM and has many through associations
    to fire database query only if relation has been changed.

    Fixes #19663.

    *Mehmet Emin İNAÇ*

239 240 241 242 243
*   Deprecate passing arguments and block at the same time to
    `ActiveRecord::QueryMethods#select`.

    *Prathamesh Sonpatki*

V
Vipul A M 已提交
244 245
*   Optimistic locking: Added ability to update `locking_column` value.
    Ignore optimistic locking if trying to update with new `locking_column` value.
246 247 248

    *bogdanvlviv*

V
Vipul A M 已提交
249
*   Fixed: Optimistic locking does not work well with `null` in the database.
250

251
    Fixes #26024.
252 253 254

    *bogdanvlviv*

255 256 257 258 259
*   Fixed support for case insensitive comparisons of `text` columns in
    PostgreSQL.

    *Edho Arief*

260
*   Serialize JSON attribute value `nil` as SQL `NULL`, not JSON `null`.
261 262 263

    *Trung Duc Tran*

264 265 266 267 268 269 270
*   Return `true` from `update_attribute` when the value of the attribute
    to be updated is unchanged.

    Fixes #26593.

    *Prathamesh Sonpatki*

271 272 273 274 275 276 277 278 279 280 281 282 283 284 285
*   Always store errors details information with symbols.

    When the association is autosaved we were storing the details with
    string keys. This was creating inconsistency with other details that are
    added using the `Errors#add` method. It was also inconsistent with the
    `Errors#messages` storage.

    To fix this inconsistency we are always storing with symbols. This will
    cause a small breaking change because in those cases the details could
    be accessed as strings keys but now it can not.

    Fix #26499.

    *Rafael Mendonça França*, *Marcus Vieira*

286 287 288 289 290 291 292
*   Calling `touch` on a model using optimistic locking will now leave the model
    in a non-dirty state with no attribute changes.

    Fixes #26496.

    *Jakob Skjerning*

293 294 295 296 297
*   Using a mysql2 connection after it fails to reconnect will now have an error message
    saying the connection is closed rather than an undefined method error message.

    *Dylan Thacker-Smith*

298 299 300 301 302 303 304
*   PostgreSQL array columns will now respect the encoding of strings contained
    in the array.

    Fixes #26326.

    *Sean Griffin*

305 306 307 308 309 310 311
*   Inverse association instances will now be set before `after_find` or
    `after_initialize` callbacks are run.

    Fixes #26320.

    *Sean Griffin*

312 313 314 315 316
*   Remove unnecessarily association load when a `belongs_to` association has already been
    loaded then the foreign key is changed directly and the record saved.

    *James Coleman*

317
*   Remove standardized column types/arguments spaces in schema dump.
318 319 320

    *Tim Petricola*

321 322 323 324 325 326 327
*   Avoid loading records from database when they are already loaded using
    the `pluck` method on a collection.

    Fixes #25921.

    *Ryuta Kamizono*

328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359
*   Remove text default treated as an empty string in non-strict mode for
    consistency with other types.

    Strict mode controls how MySQL handles invalid or missing values in
    data-change statements such as INSERT or UPDATE. If strict mode is not
    in effect, MySQL inserts adjusted values for invalid or missing values
    and produces warnings.

        def test_mysql_not_null_defaults_non_strict
          using_strict(false) do
            with_mysql_not_null_table do |klass|
              record = klass.new
              assert_nil record.non_null_integer
              assert_nil record.non_null_string
              assert_nil record.non_null_text
              assert_nil record.non_null_blob

              record.save!
              record.reload

              assert_equal 0,  record.non_null_integer
              assert_equal "", record.non_null_string
              assert_equal "", record.non_null_text
              assert_equal "", record.non_null_blob
            end
          end
        end

    https://dev.mysql.com/doc/refman/5.7/en/sql-mode.html#sql-mode-strict

    *Ryuta Kamizono*

360 361 362 363
*   Sqlite3 migrations to add a column to an existing table can now be
    successfully rolled back when the column was given and invalid column
    type.

364
    Fixes #26087.
365 366 367

    *Travis O'Neill*

368 369 370 371
*   Deprecate `sanitize_conditions`. Use `sanitize_sql` instead.

    *Ryuta Kamizono*

372 373 374 375 376
*   Doing count on relations that contain LEFT OUTER JOIN Arel node no longer
    force a DISTINCT. This solves issues when using count after a left_joins.

    *Maxime Handfield Lapointe*

377 378 379 380 381
*   RecordNotFound raised by association.find exposes `id`, `primary_key` and
    `model` methods to be consistent with RecordNotFound raised by Record.find.

    *Michel Pigassou*

382 383 384 385 386 387 388
*   Hashes can once again be passed to setters of `composed_of`, if all of the
    mapping methods are methods implemented on `Hash`.

    Fixes #25978.

    *Sean Griffin*

389 390 391 392
*   Fix the SELECT statement in `#table_comment` for MySQL.

    *Takeshi Akima*

393
*   Virtual attributes will no longer raise when read on models loaded from the
394
    database.
395 396 397

    *Sean Griffin*

398 399 400 401
*   Support calling the method `merge` in `scope`'s lambda.

    *Yasuhiro Sugino*

402 403 404 405
*   Fixes multi-parameter attributes conversion with invalid params.

    *Hiroyuki Ishii*

406
*   Add newline between each migration in `structure.sql`.
407 408

    Keeps schema migration inserts as a single commit, but allows for easier
409 410 411
    git diffing.

    Fixes #25504.
412 413 414

    *Grey Baker*, *Norberto Lopes*

415 416 417 418 419 420 421 422 423 424 425 426 427 428 429
*   The flag `error_on_ignored_order_or_limit` has been deprecated in favor of
    the current `error_on_ignored_order`.

    *Xavier Noria*

*   Batch processing methods support `limit`:

        Post.limit(10_000).find_each do |post|
          # ...
        end

    It also works in `find_in_batches` and `in_batches`.

    *Xavier Noria*

430
*   Using `group` with an attribute that has a custom type will properly cast
431 432
    the hash keys after calling a calculation method like `count`.

V
Vipul A M 已提交
433
    Fixes #25595.
434 435 436

    *Sean Griffin*

437
*   Fix the generated `#to_param` method to use `omission: ''` so that
438 439 440 441 442 443
    the resulting output is actually up to 20 characters, not
    effectively 17 to leave room for the default "...".
    Also call `#parameterize` before `#truncate` and make the
    `separator: /-/` to maximize the information included in the
    output.

444
    Fixes #23635.
445 446 447

    *Rob Biedenharn*

448 449 450 451 452 453 454
*   Ensure concurrent invocations of the connection reaper cannot allocate the
    same connection to two threads.

    Fixes #25585.

    *Matthew Draper*

455 456 457 458 459 460
*   Inspecting an object with an associated array of over 10 elements no longer
    truncates the array, preventing `inspect` from looping infinitely in some
    cases.

    *Kevin McPhillips*

461
*   Removed the unused methods `ActiveRecord::Base.connection_id` and
462
    `ActiveRecord::Base.connection_id=`.
463 464 465

    *Sean Griffin*

466
*   Ensure hashes can be assigned to attributes created using `composed_of`.
467

468 469 470 471
    Fixes #25210.

    *Sean Griffin*

472 473
*   Fix logging edge case where if an attribute was of the binary type and
    was provided as a Hash.
R
Rafael Mendonça França 已提交
474

475 476
    *Jon Moss*

477 478 479 480
*   Handle JSON deserialization correctly if the column default from database
    adapter returns `''` instead of `nil`.

    *Johannes Opper*
481

482
*   Introduce `ActiveRecord::TransactionSerializationError` for catching
483 484 485 486
    transaction serialization failures or deadlocks.

    *Erol Fornoles*

V
Vipul A M 已提交
487
*   PostgreSQL: Fix `db:structure:load` silent failure on SQL error.
488

489 490
    The command line flag `-v ON_ERROR_STOP=1` should be used
    when invoking `psql` to make sure errors are not suppressed.
491 492 493 494 495 496 497 498 499 500

    Example:

        psql -v ON_ERROR_STOP=1 -q -f awesome-file.sql my-app-db

    Fixes #23818.

    *Ralin Chimev*


501
Please check [5-0-stable](https://github.com/rails/rails/blob/5-0-stable/activerecord/CHANGELOG.md) for previous changes.