RubyGems - activerecord - Versions diffs - 7.2.2 → 8.0.0 - Mend

activerecord 7.2.2 → 8.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.

This version of activerecord might be problematic. Click here for more details.

Files changed (114) hide show

data/CHANGELOG.md CHANGED Viewed

@@ -1,4 +1,4 @@
-## Rails 7.2.2 (October 30, 2024) ##
+## Rails 8.0.0 (November 07, 2024) ##
 *   Fix support for `query_cache: false` in `database.yml`.
@@ -6,1088 +6,449 @@
     *zzak*
-*   Set `.attributes_for_inspect` to `:all` by default.
+## Rails 8.0.0.rc2 (October 30, 2024) ##
-    For new applications it is set to `[:id]` in config/environment/production.rb.
+*   NULLS NOT DISTINCT works with UNIQUE CONSTRAINT as well as UNIQUE INDEX.
-    In the console all the attributes are always shown.
+    *Ryuta Kamizono*
-    *Andrew Novoselac*
+*   The `db:prepare` task no longer loads seeds when a non-primary database is created.
-*   `PG::UnableToSend: no connection to the server` is now retryable as a connection-related exception
-    *Kazuma Watanabe*
-*   Fix marshalling of unsaved associated records in 7.1 format.
-    The 7.1 format would only marshal associated records if the association was loaded.
-    But associations that would only contain unsaved records would be skipped.
-    *Jean Boussier*
-*   Fix incorrect SQL query when passing an empty hash to `ActiveRecord::Base.insert`.
-    *David Stosik*
-*   Allow to save records with polymorphic join tables that have `inverse_of`
-    specified.
-    *Markus Doits*
-*   Fix association scopes applying on the incorrect join when using a polymorphic `has_many through:`.
-    *Joshua Young*
-*   Fix `dependent: :destroy` for bi-directional has one through association.
-    Fixes #50948.
-    ```ruby
-    class Left < ActiveRecord::Base
-      has_one :middle, dependent: :destroy
-      has_one :right, through: :middle
-    end
-    class Middle < ActiveRecord::Base
-      belongs_to :left, dependent: :destroy
-      belongs_to :right, dependent: :destroy
-    end
-    class Right < ActiveRecord::Base
-      has_one :middle, dependent: :destroy
-      has_one :left, through: :middle
-    end
-    ```
-    In the above example `left.destroy` wouldn't destroy its associated `Right`
-    record.
-    *Andy Stewart*
+    Previously, the `db:prepare` task would load seeds whenever a new database
+    is created, leading to potential loss of data if a database is added to an
+    existing environment.
-*   Properly handle lazily pinned connection pools.
+    Introduces a new database config property `seeds` to control whether seeds
+    are loaded during `db:prepare` which defaults to `true` for primary database
+    configs and `false` otherwise.
-    Fixes #53147.
-    When using transactional fixtures with system tests to similar tools
-    such as capybara, it could happen that a connection end up pinned by the
-    server thread rather than the test thread, causing
-    `"Cannot expire connection, it is owned by a different thread"` errors.
-    *Jean Boussier*
-*   Fix `ActiveRecord::Base.with` to accept more than two sub queries.
-    Fixes #53110.
-    ```ruby
-    User.with(foo: [User.select(:id), User.select(:id), User.select(:id)]).to_sql
-    undefined method `union' for an instance of Arel::Nodes::UnionAll (NoMethodError)
-    ```
-    The above now works as expected.
-    *fatkodima*
-*   Properly release pinned connections with non joinable connections.
-    Fixes #52973
-    When running system tests with transactional fixtures on, it could happen that
-    the connection leased by the Puma thread wouldn't be properly released back to the pool,
-    causing "Cannot expire connection, it is owned by a different thread" errors in later tests.
-    *Jean Boussier*
-*   Make Float distinguish between `float4` and `float8` in PostgreSQL.
-    Fixes #52742
-    *Ryota Kitazawa*, *Takayuki Nagatomi*
-*   Fix an issue where `.left_outer_joins` used with multiple associations that have
-    the same child association but different parents does not join all parents.
-    Previously, using `.left_outer_joins` with the same child association would only join one of the parents.
-    Now it will correctly join both parents.
-    Fixes #41498.
+    Fixes #53348.
-    *Garrett Blehm*
-*   Ensure `ActiveRecord::Encryption.config` is always ready before access.
-    Previously, `ActiveRecord::Encryption` configuration was deferred until `ActiveRecord::Base`
-    was loaded. Therefore, accessing `ActiveRecord::Encryption.config` properties before
-    `ActiveRecord::Base` was loaded would give incorrect results.
-    `ActiveRecord::Encryption` now has its own loading hook so that its configuration is set as
-    soon as needed.
-    When `ActiveRecord::Base` is loaded, even lazily, it in turn triggers the loading of
-    `ActiveRecord::Encryption`, thus preserving the original behavior of having its config ready
-    before any use of `ActiveRecord::Base`.
-    *Maxime Réty*
-*   Add `TimeZoneConverter#==` method, so objects will be properly compared by
-    their type, scale, limit & precision.
-    Address #52699.
-    *Ruy Rocha*
+    *Mike Dalessio*
+*   `PG::UnableToSend: no connection to the server` is now retryable as a connection-related exception
-## Rails 7.2.1.2 (October 23, 2024) ##
+    *Kazuma Watanabe*
-*   No changes.
+*   Fix strict loading propagation even if statement cache is not used.
+    *Ryuta Kamizono*
-## Rails 7.2.1.1 (October 15, 2024) ##
+*   Allow `rename_enum` accepts two from/to name arguments as `rename_table` does so.
-*   No changes.
+    *Ryuta Kamizono*
-## Rails 7.2.1 (August 22, 2024) ##
+## Rails 8.0.0.rc1 (October 19, 2024) ##
-*   Fix detection for `enum` columns with parallelized tests and PostgreSQL.
+*   Remove deprecated support to setting `ENV["SCHEMA_CACHE"]`.
     *Rafael Mendonça França*
-*   Allow to eager load nested nil associations.
-    *fatkodima*
-*   Fix swallowing ignore order warning when batching using `BatchEnumerator`.
-    *fatkodima*
-*   Fix memory bloat on the connection pool when using the Fiber `IsolatedExecutionState`.
-    *Jean Boussier*
-*   Restore inferred association class with the same modularized name.
-    *Justin Ko*
-*   Fix `ActiveRecord::Base.inspect` to properly explain how to load schema information.
-    *Jean Boussier*
-*   Check invalid `enum` options for the new syntax.
-    The options using `_` prefix in the old syntax are invalid in the new syntax.
+*   Remove deprecated support to passing a database name to `cache_dump_filename`.
     *Rafael Mendonça França*
-*   Fix `ActiveRecord::Encryption::EncryptedAttributeType#type` to return
-    actual cast type.
-    *Vasiliy Ermolovich*
-*   Fix `create_table` with `:auto_increment` option for MySQL adapter.
+*   Remove deprecated `ActiveRecord::ConnectionAdapters::ConnectionPool#connection`.
-    *fatkodima*
-## Rails 7.2.0 (August 09, 2024) ##
-*   Handle commas in Sqlite3 default function definitions.
-    *Stephen Margheim*
-*   Fixes `validates_associated` raising an exception when configured with a
-    singular association and having `index_nested_attribute_errors` enabled.
-    *Martin Spickermann*
-*   The constant `ActiveRecord::ImmutableRelation` has been deprecated because
-    we want to reserve that name for a stronger sense of "immutable relation".
-    Please use `ActiveRecord::UnmodifiableRelation` instead.
+    *Rafael Mendonça França*
-    *Xavier Noria*
+*   Remove deprecated `config.active_record.sqlite3_deprecated_warning`.
-*   Add condensed `#inspect` for `ConnectionPool`, `AbstractAdapter`, and
-    `DatabaseConfig`.
+    *Rafael Mendonça França*
-    *Hartley McGuire*
+*   Remove deprecated `config.active_record.warn_on_records_fetched_greater_than`.
-*   Fixed a memory performance issue in Active Record attribute methods definition.
+    *Rafael Mendonça França*
-    *Jean Boussier*
+*   Remove deprecated support for defining `enum` with keyword arguments.
-*   Define the new Active Support notification event `start_transaction.active_record`.
+    *Rafael Mendonça França*
-    This event is fired when database transactions or savepoints start, and
-    complements `transaction.active_record`, which is emitted when they finish.
+*   Remove deprecated support to finding database adapters that aren't registered to Active Record.
-    The payload has the transaction (`:transaction`) and the connection (`:connection`).
+    *Rafael Mendonça França*
-    *Xavier Noria*
+*   Remove deprecated `config.active_record.allow_deprecated_singular_associations_name`.
-*   Fix an issue where the IDs reader method did not return expected results
-    for preloaded associations in models using composite primary keys.
+    *Rafael Mendonça França*
-    *Jay Ang*
+*   Remove deprecated `config.active_record.commit_transaction_on_non_local_return`.
-*   The payload of `sql.active_record` Active Support notifications now has the current transaction in the `:transaction` key.
+    *Rafael Mendonça França*
-    *Xavier Noria*
+*   Fix incorrect SQL query when passing an empty hash to `ActiveRecord::Base.insert`.
-*   The payload of `transaction.active_record` Active Support notifications now has the transaction the event is related to in the `:transaction` key.
+    *David Stosik*
-    *Xavier Noria*
+*   Allow to save records with polymorphic join tables that have `inverse_of`
+    specified.
-*   Define `ActiveRecord::Transaction#uuid`, which returns a UUID for the database transaction. This may be helpful when tracing database activity. These UUIDs are generated only on demand.
+    *Markus Doits*
-    *Xavier Noria*
+*   Fix association scopes applying on the incorrect join when using a polymorphic `has_many through:`.
-*   Fix inference of association model on nested models with the same demodularized name.
+    *Joshua Young*
-    E.g. with the following setup:
+*   Allow `ActiveRecord::Base#pluck` to accept hash arguments with symbol and string values.
     ```ruby
-    class Nested::Post < ApplicationRecord
-      has_one :post, through: :other
-    end
+    Post.joins(:comments).pluck(:id, comments: :id)
+    Post.joins(:comments).pluck("id", "comments" => "id")
     ```
-    Before, `#post` would infer the model as `Nested::Post`, but now it correctly infers `Post`.
     *Joshua Young*
-*   PostgreSQL `Cidr#change?` detects the address prefix change.
+*   Make Float distinguish between `float4` and `float8` in PostgreSQL.
-    *Taketo Takashima*
+    Fixes #52742
-*   Change `BatchEnumerator#destroy_all` to return the total number of affected rows.
+    *Ryota Kitazawa*, *Takayuki Nagatomi*
-    Previously, it always returned `nil`.
-    *fatkodima*
+## Rails 8.0.0.beta1 (September 26, 2024) ##
-*   Support `touch_all` in batches.
+*   Allow `drop_table` to accept an array of table names.
+    This will let you to drop multiple tables in a single call.
     ```ruby
-    Post.in_batches.touch_all
+    ActiveRecord::Base.lease_connection.drop_table(:users, :posts)
     ```
-    *fatkodima*
-*   Add support for `:if_not_exists` and `:force` options to `create_schema`.
-    *fatkodima*
-*   Fix `index_errors` having incorrect index in association validation errors.
-    *lulalala*
-*   Add `index_errors: :nested_attributes_order` mode.
+    *Gabriel Sobrinho*
-    This indexes the association validation errors based on the order received by nested attributes setter, and respects the `reject_if` configuration. This enables API to provide enough information to the frontend to map the validation errors back to their respective form fields.
+*   Add support for PostgreSQL `IF NOT EXISTS` via the `:if_not_exists` option
+    on the `add_enum_value` method.
-    *lulalala*
+    *Ariel Rzezak*
-*   Add `Rails.application.config.active_record.postgresql_adapter_decode_dates` to opt out of decoding dates automatically with the postgresql adapter. Defaults to true.
+*   When running `db:migrate` on a fresh database, load the databases schemas before running migrations.
-    *Joé Dupuis*
+    *Andrew Novoselac*, *Marek Kasztelnik*
-*   Association option `query_constraints` is deprecated in favor of `foreign_key`.
-    *Nikita Vasilevsky*
+*   Fix an issue where `.left_outer_joins` used with multiple associations that have
+    the same child association but different parents does not join all parents.
-*   Add `ENV["SKIP_TEST_DATABASE_TRUNCATE"]` flag to speed up multi-process test runs on large DBs when all tests run within default transaction.
+    Previously, using `.left_outer_joins` with the same child association would only join one of the parents.
-    This cuts ~10s from the test run of HEY when run by 24 processes against the 178 tables, since ~4,000 table truncates can then be skipped.
+    Now it will correctly join both parents.
-    *DHH*
+    Fixes #41498.
-*   Added support for recursive common table expressions.
+    *Garrett Blehm*
-    ```ruby
-    Post.with_recursive(
-      post_and_replies: [
-        Post.where(id: 42),
-        Post.joins('JOIN post_and_replies ON posts.in_reply_to_id = post_and_replies.id'),
-      ]
-    )
-    ```
+*   Deprecate `unsigned_float` and `unsigned_decimal` short-hand column methods.
-    Generates the following SQL:
+    As of MySQL 8.0.17, the UNSIGNED attribute is deprecated for columns of type FLOAT, DOUBLE,
+    and DECIMAL. Consider using a simple CHECK constraint instead for such columns.
-    ```sql
-    WITH RECURSIVE "post_and_replies" AS (
-      (SELECT "posts".* FROM "posts" WHERE "posts"."id" = 42)
-      UNION ALL
-      (SELECT "posts".* FROM "posts" JOIN post_and_replies ON posts.in_reply_to_id = post_and_replies.id)
-    )
-    SELECT "posts".* FROM "posts"
-    ```
+    https://dev.mysql.com/doc/refman/8.0/en/numeric-type-syntax.html
-    *ClearlyClaire*
+    *Ryuta Kamizono*
-*   `validate_constraint` can be called in a `change_table` block.
+*   Drop MySQL 5.5 support.
-    ex:
-    ```ruby
-    change_table :products do |t|
-      t.check_constraint "price > discounted_price", name: "price_check", validate: false
-      t.validate_check_constraint "price_check"
-    end
-    ```
+    MySQL 5.5 is the only version that does not support datetime with precision,
+    which we have supported in the core. Now we support MySQL 5.6.4 or later, which
+    is the first version to support datetime with precision.
-    *Cody Cutrer*
+    *Ryuta Kamizono*
-*   `PostgreSQLAdapter` now decodes columns of type date to `Date` instead of string.
+*   Make Active Record asynchronous queries compatible with transactional fixtures.
-    Ex:
-    ```ruby
-    ActiveRecord::Base.connection
-         .select_value("select '2024-01-01'::date").class #=> Date
-    ```
+    Previously transactional fixtures would disable asynchronous queries, because transactional
+    fixtures impose all queries use the same connection.
-    *Joé Dupuis*
+    Now asynchronous queries will use the connection pinned by transactional fixtures, and behave
+    much closer to production.
-*   Strict loading using `:n_plus_one_only` does not eagerly load child associations.
+    *Jean Boussier*
-    With this change, child associations are no longer eagerly loaded, to
-    match intended behavior and to prevent non-deterministic order issues caused
-    by calling methods like `first` or `last`. As `first` and `last` don't cause
-    an N+1 by themselves, calling child associations will no longer raise.
-    Fixes #49473.
+*   Deserialize binary data before decrypting
-    Before:
+    This ensures that we call `PG::Connection.unescape_bytea` on PostgreSQL before decryption.
-    ```ruby
-    person = Person.find(1)
-    person.strict_loading!(mode: :n_plus_one_only)
-    person.posts.first
-    # SELECT * FROM posts WHERE person_id = 1; -- non-deterministic order
-    person.posts.first.firm # raises ActiveRecord::StrictLoadingViolationError
-    ```
+    *Donal McBreen*
-    After:
+*   Ensure `ActiveRecord::Encryption.config` is always ready before access.
-    ```ruby
-    person = Person.find(1)
-    person.strict_loading!(mode: :n_plus_one_only)
-    person.posts.first # this is 1+1, not N+1
-    # SELECT * FROM posts WHERE person_id = 1 ORDER BY id LIMIT 1;
-    person.posts.first.firm # no longer raises
-    ```
+    Previously, `ActiveRecord::Encryption` configuration was deferred until `ActiveRecord::Base`
+    was loaded. Therefore, accessing `ActiveRecord::Encryption.config` properties before
+    `ActiveRecord::Base` was loaded would give incorrect results.
-    *Reid Lynch*
+    `ActiveRecord::Encryption` now has its own loading hook so that its configuration is set as
+    soon as needed.
-*   Allow `Sqlite3Adapter` to use `sqlite3` gem version `2.x`.
+    When `ActiveRecord::Base` is loaded, even lazily, it in turn triggers the loading of
+    `ActiveRecord::Encryption`, thus preserving the original behavior of having its config ready
+    before any use of `ActiveRecord::Base`.
-    *Mike Dalessio*
+    *Maxime Réty*
-*   Allow `ActiveRecord::Base#pluck` to accept hash values.
+*   Add `TimeZoneConverter#==` method, so objects will be properly compared by
+    their type, scale, limit & precision.
-    ```ruby
-    # Before
-    Post.joins(:comments).pluck("posts.id", "comments.id", "comments.body")
+    Address #52699.
-    # After
-    Post.joins(:comments).pluck(posts: [:id], comments: [:id, :body])
-    ```
+    *Ruy Rocha*
-    *fatkodima*
+*   Add support for SQLite3 full-text-search and other virtual tables.
-*   Raise an `ActiveRecord::ActiveRecordError` error when the MySQL database returns an invalid version string.
+    Previously, adding sqlite3 virtual tables messed up `schema.rb`.
-    *Kevin McPhillips*
+    Now, virtual tables can safely be added using `create_virtual_table`.
-*   `ActiveRecord::Base.transaction` now yields an `ActiveRecord::Transaction` object.
+    *Zacharias Knudsen*
-    This allows to register callbacks on it.
+*   Support use of alternative database interfaces via the `database_cli` ActiveRecord configuration option.
     ```ruby
-    Article.transaction do |transaction|
-      article.update(published: true)
-      transaction.after_commit do
-        PublishNotificationMailer.with(article: article).deliver_later
-      end
+    Rails.application.configure do
+      config.active_record.database_cli = { postgresql: "pgcli" }
     end
     ```
-    *Jean Boussier*
-*   Add `ActiveRecord::Base.current_transaction`.
+    *T S Vallender*
-    Returns the current transaction, to allow registering callbacks on it.
+*   Add support for dumping table inheritance and native partitioning table definitions for PostgeSQL adapter
-    ```ruby
-    Article.current_transaction.after_commit do
-      PublishNotificationMailer.with(article: article).deliver_later
-    end
-    ```
+    *Justin Talbott*
-    *Jean Boussier*
+*   Add support for `ActiveRecord::Point` type casts using `Hash` values
-*   Add `ActiveRecord.after_all_transactions_commit` callback.
-    Useful for code that may run either inside or outside a transaction and needs
-    to perform work after the state changes have been properly persisted.
+    This allows `ActiveRecord::Point` to be cast or serialized from a hash
+    with `:x` and `:y` keys of numeric values, mirroring the functionality of
+    existing casts for string and array values. Both string and symbol keys are
+    supported.
     ```ruby
-    def publish_article(article)
-      article.update(published: true)
-      ActiveRecord.after_all_transactions_commit do
-        PublishNotificationMailer.with(article: article).deliver_later
-      end
+    class PostgresqlPoint < ActiveRecord::Base
+      attribute :x, :point
+      attribute :y, :point
+      attribute :z, :point
     end
-    ```
-    In the above example, the block is either executed immediately if called outside
-    of a transaction, or called after the open transaction is committed.
-    If the transaction is rolled back, the block isn't called.
-    *Jean Boussier*
-*   Add the ability to ignore counter cache columns until they are backfilled.
-    Starting to use counter caches on existing large tables can be troublesome, because the column
-    values must be backfilled separately of the column addition (to not lock the table for too long)
-    and before the use of `:counter_cache` (otherwise methods like `size`/`any?`/etc, which use
-    counter caches internally, can produce incorrect results). People usually use database triggers
-    or callbacks on child associations while backfilling before introducing a counter cache
-    configuration to the association.
-    Now, to safely backfill the column, while keeping the column updated with child records added/removed, use:
-    ```ruby
-    class Comment < ApplicationRecord
-      belongs_to :post, counter_cache: { active: false }
-    end
+    val = PostgresqlPoint.new({
+      x: '(12.34, -43.21)',
+      y: [12.34, '-43.21'],
+      z: {x: '12.34', y: -43.21}
+    })
+    ActiveRecord::Point.new(12.32, -43.21) == val.x == val.y == val.z
     ```
-    While the counter cache is not "active", the methods like `size`/`any?`/etc will not use it,
-    but get the results directly from the database. After the counter cache column is backfilled, simply
-    remove the `{ active: false }` part from the counter cache definition, and it will now be used by the
-    mentioned methods.
-    *fatkodima*
-*   Retry known idempotent SELECT queries on connection-related exceptions.
-    SELECT queries we construct by walking the Arel tree and / or with known model attributes
-    are idempotent and can safely be retried in the case of a connection error. Previously,
-    adapters such as `TrilogyAdapter` would raise `ActiveRecord::ConnectionFailed: Trilogy::EOFError`
-    when encountering a connection error mid-request.
-    *Adrianna Chang*
-*   Allow association's `foreign_key` to be composite.
-    `query_constraints` option was the only way to configure a composite foreign key by passing an `Array`.
-    Now it's possible to pass an Array value as `foreign_key` to achieve the same behavior of an association.
-    *Nikita Vasilevsky*
-*   Allow association's `primary_key` to be composite.
-    Association's `primary_key` can be composite when derived from associated model `primary_key` or `query_constraints`.
-    Now it's possible to explicitly set it as composite on the association.
+    *Stephen Drew*
-    *Nikita Vasilevsky*
+*   Replace `SQLite3::Database#busy_timeout` with `#busy_handler_timeout=`.
-*   Add `config.active_record.permanent_connection_checkout` setting.
+    Provides a non-GVL-blocking, fair retry interval busy handler implementation.
-    Controls whether `ActiveRecord::Base.connection` raises an error, emits a deprecation warning, or neither.
-    `ActiveRecord::Base.connection` checkouts a database connection from the pool and keeps it leased until the end of
-    the request or job. This behavior can be undesirable in environments that use many more threads or fibers than there
-    is available connections.
-    This configuration can be used to track down and eliminate code that calls `ActiveRecord::Base.connection` and
-    migrate it to use `ActiveRecord::Base.with_connection` instead.
-    The default behavior remains unchanged, and there is currently no plans to change the default.
-    *Jean Boussier*
-*   Add dirties option to uncached.
-    This adds a `dirties` option to `ActiveRecord::Base.uncached` and
-    `ActiveRecord::ConnectionAdapters::ConnectionPool#uncached`.
-    When set to `true` (the default), writes will clear all query caches belonging to the current thread.
-    When set to `false`, writes to the affected connection pool will not clear any query cache.
-    This is needed by Solid Cache so that cache writes do not clear query caches.
-    *Donal McBreen*
-*   Deprecate `ActiveRecord::Base.connection` in favor of `.lease_connection`.
+    *Stephen Margheim*
-    The method has been renamed as `lease_connection` to better reflect that the returned
-    connection will be held for the duration of the request or job.
+*   SQLite3Adapter: Translate `SQLite3::BusyException` into `ActiveRecord::StatementTimeout`.
-    This deprecation is a soft deprecation, no warnings will be issued and there is no
-    current plan to remove the method.
+    *Matthew Nguyen*
-    *Jean Boussier*
+*   Include schema name in `enable_extension` statements in `db/schema.rb`.
-*   Deprecate `ActiveRecord::ConnectionAdapters::ConnectionPool#connection`.
+    The schema dumper will now include the schema name in generated
+    `enable_extension` statements if they differ from the current schema.
-    The method has been renamed as `lease_connection` to better reflect that the returned
-    connection will be held for the duration of the request or job.
-    *Jean Boussier*
-*   Expose a generic fixture accessor for fixture names that may conflict with Minitest.
+    For example, if you have a migration:
     ```ruby
-    assert_equal "Ruby on Rails", web_sites(:rubyonrails).name
-    assert_equal "Ruby on Rails", fixture(:web_sites, :rubyonrails).name
+    enable_extension "heroku_ext.pgcrypto"
+    enable_extension "pg_stat_statements"
     ```
-    *Jean Boussier*
-*   Using `Model.query_constraints` with a single non-primary-key column used to raise as expected, but with an
-    incorrect error message.
-    This has been fixed to raise with a more appropriate error message.
-    *Joshua Young*
-*   Fix `has_one` association autosave setting the foreign key attribute when it is unchanged.
-    This behavior is also inconsistent with autosaving `belongs_to` and can have unintended side effects like raising
-    an `ActiveRecord::ReadonlyAttributeError` when the foreign key attribute is marked as read-only.
-    *Joshua Young*
-*   Remove deprecated behavior that would rollback a transaction block when exited using `return`, `break` or `throw`.
-    *Rafael Mendonça França*
-*   Deprecate `Rails.application.config.active_record.commit_transaction_on_non_local_return`.
-    *Rafael Mendonça França*
-*   Remove deprecated support to pass `rewhere` to `ActiveRecord::Relation#merge`.
-    *Rafael Mendonça França*
-*   Remove deprecated support to pass `deferrable: true` to `add_foreign_key`.
-    *Rafael Mendonça França*
-*   Remove deprecated support to quote `ActiveSupport::Duration`.
-    *Rafael Mendonça França*
-*   Remove deprecated `#quote_bound_value`.
-    *Rafael Mendonça França*
-*   Remove deprecated `ActiveRecord::ConnectionAdapters::ConnectionPool#connection_klass`.
-    *Rafael Mendonça França*
-*   Remove deprecated support to apply `#connection_pool_list`, `#active_connections?`, `#clear_active_connections!`,
-    `#clear_reloadable_connections!`, `#clear_all_connections!` and `#flush_idle_connections!` to the connections pools
-    for the current role when the `role` argument isn't provided.
-    *Rafael Mendonça França*
-*   Remove deprecated `#all_connection_pools`.
-    *Rafael Mendonça França*
-*   Remove deprecated `ActiveRecord::ConnectionAdapters::SchemaCache#data_sources`.
-    *Rafael Mendonça França*
-*   Remove deprecated `ActiveRecord::ConnectionAdapters::SchemaCache.load_from`.
-    *Rafael Mendonça França*
-*   Remove deprecated `#all_foreign_keys_valid?` from database adapters.
-    *Rafael Mendonça França*
-*   Remove deprecated support to passing coder and class as second argument to `serialize`.
-    *Rafael Mendonça França*
-*   Remove deprecated support to `ActiveRecord::Base#read_attribute(:id)` to return the custom primary key value.
-    *Rafael Mendonça França*
-*   Remove deprecated `TestFixtures.fixture_path`.
-    *Rafael Mendonça França*
-*   Remove deprecated behavior to support referring to a singular association by its plural name.
-    *Rafael Mendonça França*
-*   Deprecate `Rails.application.config.active_record.allow_deprecated_singular_associations_name`.
-    *Rafael Mendonça França*
-*   Remove deprecated support to passing `SchemaMigration` and `InternalMetadata` classes as arguments to
-    `ActiveRecord::MigrationContext`.
-    *Rafael Mendonça França*
-*   Remove deprecated `ActiveRecord::Migration.check_pending!` method.
-    *Rafael Mendonça França*
-*   Remove deprecated `ActiveRecord::LogSubscriber.runtime` method.
-    *Rafael Mendonça França*
-*   Remove deprecated `ActiveRecord::LogSubscriber.runtime=` method.
-    *Rafael Mendonça França*
-*   Remove deprecated `ActiveRecord::LogSubscriber.reset_runtime` method.
-    *Rafael Mendonça França*
-*   Remove deprecated support to define `explain` in the connection adapter with 2 arguments.
-    *Rafael Mendonça França*
-*   Remove deprecated `ActiveRecord::ActiveJobRequiredError`.
-    *Rafael Mendonça França*
-*   Remove deprecated `ActiveRecord::Base.clear_active_connections!`.
-    *Rafael Mendonça França*
-*   Remove deprecated `ActiveRecord::Base.clear_reloadable_connections!`.
-    *Rafael Mendonça França*
-*   Remove deprecated `ActiveRecord::Base.clear_all_connections!`.
-    *Rafael Mendonça França*
-*   Remove deprecated `ActiveRecord::Base.flush_idle_connections!`.
-    *Rafael Mendonça França*
-*   Remove deprecated `name` argument from `ActiveRecord::Base.remove_connection`.
-    *Rafael Mendonça França*
-*   Remove deprecated support to call `alias_attribute` with non-existent attribute names.
-    *Rafael Mendonça França*
-*   Remove deprecated `Rails.application.config.active_record.suppress_multiple_database_warning`.
-    *Rafael Mendonça França*
-*   Add `ActiveRecord::Encryption::MessagePackMessageSerializer`.
-    Serialize data to the MessagePack format, for efficient storage in binary columns.
-    The binary encoding requires around 30% less space than the base64 encoding
-    used by the default serializer.
-    *Donal McBreen*
-*   Add support for encrypting binary columns.
-    Ensure encryption and decryption pass `Type::Binary::Data` around for binary data.
-    Previously encrypting binary columns with the `ActiveRecord::Encryption::MessageSerializer`
-    incidentally worked for MySQL and SQLite, but not PostgreSQL.
-    *Donal McBreen*
-*   Deprecated `ENV["SCHEMA_CACHE"]` in favor of `schema_cache_path` in the database configuration.
-    *Rafael Mendonça França*
-*   Add `ActiveRecord::Base.with_connection` as a shortcut for leasing a connection for a short duration.
-    The leased connection is yielded, and for the duration of the block, any call to `ActiveRecord::Base.connection`
-    will yield that same connection.
-    This is useful to perform a few database operations without causing a connection to be leased for the
-    entire duration of the request or job.
-    *Jean Boussier*
-*   Deprecate `config.active_record.warn_on_records_fetched_greater_than` now that `sql.active_record`
-    notification includes `:row_count` field.
-    *Jason Nochlin*
-*   The fix ensures that the association is joined using the appropriate join type
-    (either inner join or left outer join) based on the existing joins in the scope.
-    This prevents unintentional overrides of existing join types and ensures consistency in the generated SQL queries.
-    Example:
+    then the generated schema dump will also contain:
     ```ruby
-    # `associated` will use `LEFT JOIN` instead of using `JOIN`
-    Post.left_joins(:author).where.associated(:author)
+    enable_extension "heroku_ext.pgcrypto"
+    enable_extension "pg_stat_statements"
     ```
-    *Saleh Alhaddad*
+    *Tony Novak*
-*   Fix an issue where `ActiveRecord::Encryption` configurations are not ready before the loading
-    of Active Record models, when an application is eager loaded. As a result, encrypted attributes
-    could be misconfigured in some cases.
+*   Fix `ActiveRecord::Encryption::EncryptedAttributeType#type` to return
+    actual cast type.
-    *Maxime Réty*
+    *Vasiliy Ermolovich*
-*   Deprecate defining an `enum` with keyword arguments.
+*   SQLite3Adapter: Bulk insert fixtures.
-    ```ruby
-    class Function > ApplicationRecord
-      # BAD
-      enum color: [:red, :blue],
-           type: [:instance, :class]
-      # GOOD
-      enum :color, [:red, :blue]
-      enum :type, [:instance, :class]
-    end
-    ```
+    Previously one insert command was executed for each fixture, now they are
+    aggregated in a single bulk insert command.
-    *Hartley McGuire*
+    *Lázaro Nixon*
-*   Add `config.active_record.validate_migration_timestamps` option for validating migration timestamps.
+*   PostgreSQLAdapter: Allow `disable_extension` to be called with schema-qualified name.
-    When set, validates that the timestamp prefix for a migration is no more than a day ahead of
-    the timestamp associated with the current time. This is designed to prevent migrations prefixes
-    from being hand-edited to future timestamps, which impacts migration generation and other
-    migration commands.
+    For parity with `enable_extension`, the `disable_extension` method can be called with a schema-qualified
+    name (e.g. `disable_extension "myschema.pgcrypto"`). Note that PostgreSQL's `DROP EXTENSION` does not
+    actually take a schema name (unlike `CREATE EXTENSION`), so the resulting SQL statement will only name
+    the extension, e.g. `DROP EXTENSION IF EXISTS "pgcrypto"`.
-    *Adrianna Chang*
+    *Tony Novak*
-*   Properly synchronize `Mysql2Adapter#active?` and `TrilogyAdapter#active?`.
+*   Make `create_schema` / `drop_schema` reversible in migrations.
-    As well as `disconnect!` and `verify!`.
+    Previously, `create_schema` and `drop_schema` were irreversible migration operations.
-    This generally isn't a big problem as connections must not be shared between
-    threads, but is required when running transactional tests or system tests
-    and could lead to a SEGV.
+    *Tony Novak*
-    *Jean Boussier*
-*   Support `:source_location` tag option for query log tags.
+*   Support batching using custom columns.
     ```ruby
-    config.active_record.query_log_tags << :source_location
+    Product.in_batches(cursor: [:shop_id, :id]) do |relation|
+      # do something with relation
+    end
     ```
-    Calculating the caller location is a costly operation and should be used primarily in development
-    (note, there is also a `config.active_record.verbose_query_logs` that serves the same purpose)
-    or occasionally on production for debugging purposes.
     *fatkodima*
-*   Add an option to `ActiveRecord::Encryption::Encryptor` to disable compression.
-    Allow compression to be disabled by setting `compress: false`
-    ```ruby
-      class User
-        encrypts :name, encryptor: ActiveRecord::Encryption::Encryptor.new(compress: false)
-      end
-    ```
-    *Donal McBreen*
-*   Deprecate passing strings to `ActiveRecord::Tasks::DatabaseTasks.cache_dump_filename`.
-    A `ActiveRecord::DatabaseConfigurations::DatabaseConfig` object should be passed instead.
-    *Rafael Mendonça França*
-*   Add `row_count` field to `sql.active_record` notification.
+*   Use SQLite `IMMEDIATE` transactions when possible.
-    This field returns the amount of rows returned by the query that emitted the notification.
+    Transactions run against the SQLite3 adapter default to IMMEDIATE mode to improve concurrency support and avoid busy exceptions.
-    This metric is useful in cases where one wants to detect queries with big result sets.
-    *Marvin Bitterlich*
-*   Consistently raise an `ArgumentError` when passing an invalid argument to a nested attributes association writer.
-    Previously, this would only raise on collection associations and produce a generic error on singular associations.
-    Now, it will raise on both collection and singular associations.
-    *Joshua Young*
-*   Fix single quote escapes on default generated MySQL columns.
-    MySQL 5.7.5+ supports generated columns, which can be used to create a column that is computed from an expression.
-    Previously, the schema dump would output a string with double escapes for generated columns with single quotes in the default expression.
-    This would result in issues when importing the schema on a fresh instance of a MySQL database.
-    Now, the string will not be escaped and will be valid Ruby upon importing of the schema.
-    *Yash Kapadia*
-*   Fix Migrations with versions older than 7.1 validating options given to
-    `add_reference` and `t.references`.
-    *Hartley McGuire*
+    *Stephen Margheim*
-*   Add `<role>_types` class method to `ActiveRecord::DelegatedType` so that the delegated types can be introspected.
+*   Raise specific exception when a connection is not defined.
-    *JP Rosevear*
+    The new `ConnectionNotDefined` exception provides connection name, shard and role accessors indicating the details of the connection that was requested.
-*   Make `schema_dump`, `query_cache`, `replica` and `database_tasks` configurable via `DATABASE_URL`.
+    *Hana Harencarova*, *Matthew Draper*
-    This wouldn't always work previously because boolean values would be interpreted as strings.
+*   Delete the deprecated constant `ActiveRecord::ImmutableRelation`.
-    e.g. `DATABASE_URL=postgres://localhost/foo?schema_dump=false` now properly disable dumping the schema
-    cache.
+    *Xavier Noria*
-    *Mike Coutermarsh*, *Jean Boussier*
+*   Fix duplicate callback execution when child autosaves parent with `has_one` and `belongs_to`.
-*   Introduce `ActiveRecord::Transactions::ClassMethods#set_callback`.
+    Before, persisting a new child record with a new associated parent record would run `before_validation`,
+    `after_validation`, `before_save` and `after_save` callbacks twice.
-     It is identical to `ActiveSupport::Callbacks::ClassMethods#set_callback`
-     but with support for `after_commit` and `after_rollback` callback options.
+    Now, these callbacks are only executed once as expected.
     *Joshua Young*
-*   Make `ActiveRecord::Encryption::Encryptor` agnostic of the serialization format used for encrypted data.
-    Previously, the encryptor instance only allowed an encrypted value serialized as a `String` to be passed to the message serializer.
-    Now, the encryptor lets the configured `message_serializer` decide which types of serialized encrypted values are supported. A custom serialiser is therefore allowed to serialize `ActiveRecord::Encryption::Message` objects using a type other than `String`.
-    The default `ActiveRecord::Encryption::MessageSerializer` already ensures that only `String` objects are passed for deserialization.
-    *Maxime Réty*
-*   Fix `encrypted_attribute?` to take into account context properties passed to `encrypts`.
-    *Maxime Réty*
-*   The object returned by `explain` now responds to `pluck`, `first`,
-    `last`, `average`, `count`, `maximum`, `minimum`, and `sum`. Those
-    new methods run `EXPLAIN` on the corresponding queries:
+*   `ActiveRecord::Encryption::Encryptor` now supports a `:compressor` option to customize the compression algorithm used.
     ```ruby
-    User.all.explain.count
-    # EXPLAIN SELECT COUNT(*) FROM `users`
-    # ...
-    User.all.explain.maximum(:id)
-    # EXPLAIN SELECT MAX(`users`.`id`) FROM `users`
-    # ...
-    ```
-    *Petrik de Heus*
-*   Fixes an issue where `validates_associated` `:on`  option wasn't respected
-    when validating associated records.
-    *Austen Madden*, *Alex Ghiculescu*, *Rafał Brize*
-*   Allow overriding SQLite defaults from `database.yml`.
+    module ZstdCompressor
+      def self.deflate(data)
+        Zstd.compress(data)
+      end
-    Any PRAGMA configuration set under the `pragmas` key in the configuration
-    file takes precedence over Rails' defaults, and additional PRAGMAs can be
-    set as well.
+      def self.inflate(data)
+        Zstd.decompress(data)
+      end
+    end
-    ```yaml
-    database: storage/development.sqlite3
-    timeout: 5000
-    pragmas:
-      journal_mode: off
-      temp_store: memory
+    class User
+      encrypts :name, compressor: ZstdCompressor
+    end
     ```
-    *Stephen Margheim*
-*   Remove warning message when running SQLite in production, but leave it unconfigured.
-    There are valid use cases for running SQLite in production. However, it must be done
-    with care, so instead of a warning most users won't see anyway, it's preferable to
-    leave the configuration commented out to force them to think about having the database
-    on a persistent volume etc.
-    *Jacopo Beschi*, *Jean Boussier*
-*   Add support for generated columns to the SQLite3 adapter.
-    Generated columns (both stored and dynamic) are supported since version 3.31.0 of SQLite.
-    This adds support for those to the SQLite3 adapter.
+    You disable compression by passing `compress: false`.
     ```ruby
-    create_table :users do |t|
-      t.string :name
-      t.virtual :name_upper, type: :string, as: 'UPPER(name)'
-      t.virtual :name_lower, type: :string, as: 'LOWER(name)', stored: true
+    class User
+      encrypts :name, compress: false
     end
     ```
-    *Stephen Margheim*
-*   TrilogyAdapter: ignore `host` if `socket` parameter is set.
+    *heka1024*
-    This allows to configure a connection on a UNIX socket via `DATABASE_URL`:
-    ```
-    DATABASE_URL=trilogy://does-not-matter/my_db_production?socket=/var/run/mysql.sock
-    ```
-    *Jean Boussier*
+*   Add condensed `#inspect` for `ConnectionPool`, `AbstractAdapter`, and
+    `DatabaseConfig`.
-*   Make `assert_queries_count`, `assert_no_queries`, `assert_queries_match`, and
-    `assert_no_queries_match` assertions public.
+    *Hartley McGuire*
-    To assert the expected number of queries are made, Rails internally uses `assert_queries_count` and
-    `assert_no_queries`. To assert that specific SQL queries are made, `assert_queries_match` and
-    `assert_no_queries_match` are used. These assertions can now be used in applications as well.
+*   Add `.shard_keys`, `.sharded?`, & `.connected_to_all_shards` methods.
     ```ruby
-    class ArticleTest < ActiveSupport::TestCase
-      test "queries are made" do
-        assert_queries_count(1) { Article.first }
-      end
+    class ShardedBase < ActiveRecord::Base
+        self.abstract_class = true
-      test "creates a foreign key" do
-        assert_queries_match(/ADD FOREIGN KEY/i, include_schema: true) do
-          @connection.add_foreign_key(:comments, :posts)
-        end
-      end
+        connects_to shards: {
+          shard_one: { writing: :shard_one },
+          shard_two: { writing: :shard_two }
+        }
     end
-    ```
-    *Petrik de Heus*, *fatkodima*
-*   Fix `has_secure_token` calls the setter method on initialize.
-    *Abeid Ahmed*
-*   When using a `DATABASE_URL`, allow for a configuration to map the protocol in the URL to a specific database
-    adapter. This allows decoupling the adapter the application chooses to use from the database connection details
-    set in the deployment environment.
+    class ShardedModel < ShardedBase
+    end
-    ```ruby
-    # ENV['DATABASE_URL'] = "mysql://localhost/example_database"
-    config.active_record.protocol_adapters.mysql = "trilogy"
-    # will connect to MySQL using the trilogy adapter
+    ShardedModel.shard_keys => [:shard_one, :shard_two]
+    ShardedModel.sharded? => true
+    ShardedBase.connected_to_all_shards { ShardedModel.current_shard } => [:shard_one, :shard_two]
     ```
-    *Jean Boussier*, *Kevin McPhillips*
-*   In cases where MySQL returns `warning_count` greater than zero, but returns no warnings when
-    the `SHOW WARNINGS` query is executed, `ActiveRecord.db_warnings_action` proc will still be
-    called with a generic warning message rather than silently ignoring the warning(s).
+    *Nony Dutton*
-    *Kevin McPhillips*
+*   Add a `filter` option to `in_order_of` to prioritize certain values in the sorting without filtering the results
+    by these values.
-*   `DatabaseConfigurations#configs_for` accepts a symbol in the `name` parameter.
+    *Igor Depolli*
-    *Andrew Novoselac*
-*   Fix `where(field: values)` queries when `field` is a serialized attribute
-    (for example, when `field` uses `ActiveRecord::Base.serialize` or is a JSON
-    column).
-    *João Alves*
-*   Make the output of `ActiveRecord::Core#inspect` configurable.
-    By default, calling `inspect` on a record will yield a formatted string including just the `id`.
-    ```ruby
-    Post.first.inspect #=> "#<Post id: 1>"
-    ```
-    The attributes to be included in the output of `inspect` can be configured with
-    `ActiveRecord::Core#attributes_for_inspect`.
-    ```ruby
-    Post.attributes_for_inspect = [:id, :title]
-    Post.first.inspect #=> "#<Post id: 1, title: "Hello, World!">"
-    ```
+*   Fix an issue where the IDs reader method did not return expected results
+    for preloaded associations in models using composite primary keys.
-    With `attributes_for_inspect` set to `:all`, `inspect` will list all the record's attributes.
+    *Jay Ang*
-    ```ruby
-    Post.attributes_for_inspect = :all
-    Post.first.inspect #=> "#<Post id: 1, title: "Hello, World!", published_at: "2023-10-23 14:28:11 +0000">"
-    ```
+*   Allow to configure `strict_loading_mode` globally or within a model.
-    In `development` and `test` mode, `attributes_for_inspect` will be set to `:all` by default.
+    Defaults to `:all`, can be changed to `:n_plus_one_only`.
-    You can also call `full_inspect` to get an inspection with all the attributes.
+    *Garen Torikian*
-    The attributes in `attribute_for_inspect` will also be used for `pretty_print`.
+*   Add `ActiveRecord::Relation#readonly?`.
-    *Andrew Novoselac*
+    Reflects if the relation has been marked as readonly.
-*   Don't mark attributes as changed when reassigned to `Float::INFINITY` or
-    `-Float::INFINITY`.
+    *Theodor Tonum*
-    *Maicol Bentancor*
+*   Improve `ActiveRecord::Store` to raise a descriptive exception if the column is not either
+    structured (e.g., PostgreSQL +hstore+/+json+, or MySQL +json+) or declared serializable via
+    `ActiveRecord.store`.
-*   Support the `RETURNING` clause for MariaDB.
+    Previously, a `NoMethodError` would be raised when the accessor was read or written:
-    *fatkodima*, *Nikolay Kondratyev*
+        NoMethodError: undefined method `accessor' for an instance of ActiveRecord::Type::Text
-*   The SQLite3 adapter now implements the `supports_deferrable_constraints?` contract.
+    Now, a descriptive `ConfigurationError` is raised:
-    Allows foreign keys to be deferred by adding the `:deferrable` key to the `foreign_key` options.
+        ActiveRecord::ConfigurationError: the column 'metadata' has not been configured as a store.
+          Please make sure the column is declared serializable via 'ActiveRecord.store' or, if your
+          database supports it, use a structured column type like hstore or json.
-    ```ruby
-    add_reference :person, :alias, foreign_key: { deferrable: :deferred }
-    add_reference :alias, :person, foreign_key: { deferrable: :deferred }
-    ```
+    *Mike Dalessio*
-    *Stephen Margheim*
+*   Fix inference of association model on nested models with the same demodularized name.
-*   Add the `set_constraints` helper to PostgreSQL connections.
+    E.g. with the following setup:
     ```ruby
-    Post.create!(user_id: -1) # => ActiveRecord::InvalidForeignKey
-    Post.transaction do
-      Post.connection.set_constraints(:deferred)
-      p = Post.create!(user_id: -1)
-      u = User.create!
-      p.user = u
-      p.save!
+    class Nested::Post < ApplicationRecord
+      has_one :post, through: :other
     end
     ```
-    *Cody Cutrer*
-*   Include `ActiveModel::API` in `ActiveRecord::Base`.
-    *Sean Doyle*
-*   Ensure `#signed_id` outputs `url_safe` strings.
-    *Jason Meller*
+    Before, `#post` would infer the model as `Nested::Post`, but now it correctly infers `Post`.
-*   Add `nulls_last` and working `desc.nulls_first` for MySQL.
+    *Joshua Young*
-    *Tristan Fellows*
+*   Add public method for checking if a table is ignored by the schema cache.
-*   Allow for more complex hash arguments for `order` which mimics `where` in `ActiveRecord::Relation`.
+    Previously, an application would need to reimplement `ignored_table?` from the schema cache class to check if a table was set to be ignored. This adds a public method to support this and updates the schema cache to use that directly.
     ```ruby
-    Topic.includes(:posts).order(posts: { created_at: :desc })
+    ActiveRecord.schema_cache_ignored_tables = ["developers"]
+    ActiveRecord.schema_cache_ignored_table?("developers")
+    => true
     ```
-    *Myles Boone*
+    *Eileen M. Uchitelle*
-Please check [7-1-stable](https://github.com/rails/rails/blob/7-1-stable/activerecord/CHANGELOG.md) for previous changes.
+Please check [7-2-stable](https://github.com/rails/rails/blob/7-2-stable/activerecord/CHANGELOG.md) for previous changes.