activerecord 7.2.3.1 → 8.0.5.1

data/CHANGELOG.md

@@ -1,9 +1,105 @@
-## Rails 7.2.3.1 (March 23, 2026) ##
+## Rails 8.0.5.1 (July 29, 2026) ##
 
 *   No changes.
 
 
-## Rails 7.2.3 (October 28, 2025) ##
+## Rails 8.0.5 (March 24, 2026) ##
+
+*   Fix `insert_all` and `upsert_all` log message when called on anonymous classes.
+
+    *Gabriel Sobrinho*
+
+*   Respect `ActiveRecord::SchemaDumper.ignore_tables` when dumping SQLite virtual tables.
+
+    *Hans Schnedlitz*
+
+*   Restore previous instrumenter after `execute_or_skip`
+
+    `FutureResult#execute_or_skip` replaces the thread's instrumenter with an
+    `EventBuffer` to collect events published during async query execution.
+    If the global async executor is saturated and the `caller_runs` fallback
+    executes the task on the calling thread, we need to make sure the previous
+    instrumenter is restored or the stale `EventBuffer` would stay in place and
+    permanently swallow all subsequent `sql.active_record` notifications on
+    that thread.
+
+    *Rosa Gutierrez*
+
+*   Fix Ruby 4.0 delegator warning when calling inspect on ActiveRecord::Type::Serialized.
+
+    *Hammad Khan*
+
+*   Fix support for table names containing hyphens.
+
+    *Evgeniy Demin*
+
+*   Fix column deduplication for SQLite3 and PostgreSQL virtual (generated) columns.
+
+    `Column#==` and `Column#hash` now account for `virtual?` so that the
+    `Deduplicable` registry does not treat a generated column and a regular
+    column with the same name and type as identical. Previously, if a
+    generated column was registered first, a regular column on a different
+    table could be deduplicated to the generated instance, silently
+    excluding it from INSERT/UPDATE statements.
+
+    *Jay Huber*
+
+*   Fix merging relations with arel equality predicates with null relations.
+
+    *fatkodima*
+
+*   Fix SQLite3 schema dump for non-autoincrement integer primary keys.
+
+    Previously, `schema.rb` should incorrectly restore that table with an auto incrementing
+    primary key.
+
+    *Chris Hasiński*
+
+*   Fix PostgreSQL `schema_search_path` not being reapplied after `reset!` or `reconnect!`.
+
+    The `schema_search_path` configured in `database.yml` is now correctly
+    reapplied instead of falling back to PostgreSQL defaults.
+
+    *Tobias Egli*
+
+*   Ensure batched preloaded associations accounts for klass when grouping to avoid issues with STI.
+
+    *zzak*, *Stjepan Hadjic*
+
+*   Fix `ActiveRecord::SoleRecordExceeded#record` to return the relation.
+
+    This was the case until Rails 7.2, but starting from 8.0 it
+    started mistakenly returning the model class.
+
+    *Jean Boussier*
+
+*   Improve PostgreSQLAdapter resilience to Timeout.timeout.
+
+    Better handle asynchronous exceptions being thrown inside
+    the `reconnect!` method.
+
+    This may fixes some deep errors such as:
+
+    ```
+    undefined method `key?' for nil:NilClass (NoMethodError)
+              if !type_map.key?(oid)
+    ```
+
+    *Jean Boussier*
+
+*   Fix `eager_load` when loading `has_many` assocations with composite primary keys.
+
+    This would result in some records being loaded multiple times.
+
+    *Martin-Alexander*
+
+
+## Rails 8.0.4.1 (March 23, 2026) ##
+
+*   No changes.
+
+
+## Rails 8.0.4 (October 28, 2025) ##
 
 *   Fix SQLite3 data loss during table alterations with CASCADE foreign keys.
 
@@ -27,6 +123,10 @@
 
     *Ruy Rocha*
 
+*   Add support for bound SQL literals in CTEs.
+
+    *Nicolas Bachschmidt*
+
 *   Fix `belongs_to` associations not to clear the entire composite primary key.
 
     When clearing a `belongs_to` association that references a model with composite primary key,
@@ -38,23 +138,10 @@
 
     *Ian Terrell*, *axlekb AB*
 
-*   Prevent persisting invalid record.
-
-    *Edouard Chin*
-
-*   Fix count with group by qualified name on loaded relation.
-
-    *Ryuta Kamizono*
-
-*   Fix `sum` with qualified name on loaded relation.
-
-    *Chris Gunther*
-
-*   Fix prepared statements on mysql2 adapter.
 
-    *Jean Boussier*
+## Rails 8.0.3 (September 22, 2025) ##
 
-*   Fix query cache for pinned connections in multi threaded transactional tests.
+*   Fix query cache for pinned connections in multi threaded transactional tests
 
     When a pinned connection is used across separate threads, they now use a separate cache store
     for each thread.
@@ -67,21 +154,42 @@
 
     *Rob Lewis*
 
-*   Fix false positive change detection involving STI and polymorhic has one relationships.
+*   Fix false positive change detection involving STI and polymorphic has one relationships.
 
     Polymorphic `has_one` relationships would always be considered changed when defined in a STI child
     class, causing nedless extra autosaves.
 
     *David Fritsch*
 
-*   Fix stale associaton detection for polymophic `belong_to`.
+*   Skip calling `PG::Connection#cancel` in `cancel_any_running_query`
+    when using libpq >= 18 with pg < 1.6.0, due to incompatibility.
+    Rollback still runs, but may take longer.
+
+    *Yasuo Honda*, *Lars Kanis*
+
+*   Fix stale association detection for polymorphic `belongs_to`.
 
     *Florent Beaurain*, *Thomas Crambert*
 
-*   Fix removal of PostgreSQL version comments in `structure.sql` for latest PostgreSQL versions which include `\restrict`.
+*   Fix removal of PostgreSQL version comments in `structure.sql` for latest PostgreSQL versions which include `\restrict`
 
     *Brendan Weibrecht*
 
+*   Allow setting `schema_format` in database configuration.
+
+    ```
+    primary:
+      schema_format: ruby
+    ```
+
+    Useful in multi-database setups to have different formats per-database.
+
+    *T S Vallender*
+
+*   Use ntuples to populate row_count instead of count for Postgres
+
+    *Jonathan Calvert*
+
 *   Fix `#merge` with `#or` or `#and` and a mixture of attributes and SQL strings resulting in an incorrect query.
 
     ```ruby
@@ -124,6 +232,18 @@
 
     *fatkodima*
 
+*   Fix migration log message for down operations.
+
+    *Bernardo Barreto*
+
+*   Prepend `extra_flags` in postgres' `structure_load`
+
+    When specifying `structure_load_flags` with a postgres adapter, the flags
+    were appended to the default flags, instead of prepended.
+    This caused issues with flags not being taken into account by postgres.
+
+    *Alice Loeser*
+
 *   Fix `annotate` comments to propagate to `update_all`/`delete_all`.
 
     *fatkodima*
@@ -133,10 +253,6 @@
 
     *Hartley McGuire*
 
-*   Fix inline has_and_belongs_to_many fixtures for tables with composite primary keys.
-
-    *fatkodima*
-
 *   `create_or_find_by` will now correctly rollback a transaction.
 
     When using `create_or_find_by`, raising a ActiveRecord::Rollback error
@@ -155,6 +271,42 @@
 
     *Jean Boussier*
 
+*   Fix stale state for composite foreign keys in belongs_to associations.
+
+    *Varun Sharma*
+
+
+## Rails 8.0.2.1 (August 13, 2025) ##
+
+*   Call inspect on ids in RecordNotFound error
+
+    [CVE-2025-55193]
+
+    *Gannon McGibbon*, *John Hawthorn*
+
+
+## Rails 8.0.2 (March 12, 2025) ##
+
+*   Fix inverting `rename_enum_value` when `:from`/`:to` are provided.
+
+    *fatkodima*
+
+*   Prevent persisting invalid record.
+
+    *Edouard Chin*
+
+*   Fix inverting `drop_table` without options.
+
+    *fatkodima*
+
+*   Fix count with group by qualified name on loaded relation.
+
+    *Ryuta Kamizono*
+
+*   Fix `sum` with qualified name on loaded relation.
+
+    *Chris Gunther*
+
 *   The SQLite3 adapter quotes non-finite Numeric values like "Infinity" and "NaN".
 
     *Mike Dalessio*
@@ -187,7 +339,25 @@
 
     *zzak*
 
-*   Prevent persisting invalid record.
+*   PoolConfig no longer keeps a reference to the connection class.
+
+    Keeping a reference to the class caused subtle issues when combined with reloading in
+    development. Fixes #54343.
+
+    *Mike Dalessio*
+
+*   Fix SQL notifications sometimes not sent when using async queries.
+
+    ```ruby
+    Post.async_count
+    ActiveSupport::Notifications.subscribed(->(*) { "Will never reach here" }) do
+      Post.count
+    end
+    ```
+
+    In rare circumstances and under the right race condition, Active Support notifications
+    would no longer be dispatched after using an asynchronous query.
+    This is now fixed.
 
     *Edouard Chin*
 
@@ -225,14 +395,6 @@
 
     *Sjoerd Lagarde*
 
-*   Fix count with group by qualified name on loaded relation.
-
-    *Ryuta Kamizono*
-
-*   Fix sum with qualified name on loaded relation.
-
-    *Chris Gunther*
-
 *   Fix autosave associations to no longer validated unmodified associated records.
 
     Active Record was incorrectly performing validation on associated record that
@@ -254,9 +416,12 @@
 
     *Matthew Draper*
 
-*   Fix prepared statements on mysql2 adapter.
 
-    *Jean Boussier*
+## Rails 8.0.1 (December 13, 2024) ##
+
+*   Fix removing foreign keys with :restrict action for MySQL.
+
+    *fatkodima*
 
 *   Fix a race condition in `ActiveRecord::Base#method_missing` when lazily defining attributes.
 
@@ -269,8 +434,7 @@
 
     *Bastian Bartmann*
 
-*   Fix `add_unique_constraint`/`add_check_constraint`/`/`add_foreign_key` to be revertible when
-    given invalid options.
+*   Fix `add_unique_constraint`/`add_check_constraint`/`add_foreign_key` to be revertible when given invalid options.
 
     *fatkodima*
 
@@ -278,7 +442,11 @@
 
     *fatkodima*
 
-*   NOT VALID constraints should not dump in `create_table`.
+*   Fix `insert_all` to not update existing records.
+
+    *fatkodima*
+
+*   `NOT VALID` constraints should not dump in `create_table`.
 
     *Ryuta Kamizono*
 
@@ -286,6 +454,16 @@
 
     *fatkodima*
 
+*   Properly reset composite primary key configuration when setting a primary key.
+
+    *fatkodima*
+
+*   Fix Mysql2Adapter support for prepared statements
+
+    Using prepared statements with MySQL could result in a `NoMethodError` exception.
+
+    *Jean Boussier*, *Leo Arnold*, *zzak*
+
 *   Fix parsing of SQLite foreign key names when they contain non-ASCII characters
 
     *Zacharias Knudsen*
@@ -298,63 +476,101 @@
 
     *Joshua Young*
 
-*   Restore back the ability to pass only database name for `DATABASE_URL`.
+*   Fix `sum` when performing a grouped calculation.
+
+    `User.group(:friendly).sum` no longer worked. This is fixed.
+
+    *Edouard Chin*
+
+*   Restore back the ability to pass only database name to `DATABASE_URL`.
 
     *fatkodima*
 
-*   Fix `order` with using association name as an alias.
 
-    *Ryuta Kamizono*
+## Rails 8.0.0.1 (December 10, 2024) ##
 
-*   Improve invalid argument error for with.
+*   No changes.
+
+
+## Rails 8.0.0 (November 07, 2024) ##
+
+*   Fix support for `query_cache: false` in `database.yml`.
+
+    `query_cache: false` would no longer entirely disable the Active Record query cache.
+
+    *zzak*
+
+
+## Rails 8.0.0.rc2 (October 30, 2024) ##
+
+*   NULLS NOT DISTINCT works with UNIQUE CONSTRAINT as well as UNIQUE INDEX.
 
     *Ryuta Kamizono*
 
-*   Deduplicate `with` CTE expressions.
+*   The `db:prepare` task no longer loads seeds when a non-primary database is created.
 
-    *fatkodima*
+    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.
 
+    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.
 
-## Rails 7.2.2.2 (August 13, 2025) ##
+    Fixes #53348.
 
-*   Call inspect on ids in RecordNotFound error
+    *Mike Dalessio*
 
-    [CVE-2025-55193]
+*   `PG::UnableToSend: no connection to the server` is now retryable as a connection-related exception
 
-    *Gannon McGibbon*, *John Hawthorn*
+    *Kazuma Watanabe*
 
+*   Fix strict loading propagation even if statement cache is not used.
 
-## Rails 7.2.2.1 (December 10, 2024) ##
+    *Ryuta Kamizono*
 
-*   No changes.
+*   Allow `rename_enum` accepts two from/to name arguments as `rename_table` does so.
 
+    *Ryuta Kamizono*
 
-## Rails 7.2.2 (October 30, 2024) ##
 
-*   Fix support for `query_cache: false` in `database.yml`.
+## Rails 8.0.0.rc1 (October 19, 2024) ##
 
-    `query_cache: false` would no longer entirely disable the Active Record query cache.
+*   Remove deprecated support to setting `ENV["SCHEMA_CACHE"]`.
 
-    *zzak*
+    *Rafael Mendonça França*
 
-*   Set `.attributes_for_inspect` to `:all` by default.
+*   Remove deprecated support to passing a database name to `cache_dump_filename`.
+
+    *Rafael Mendonça França*
 
-    For new applications it is set to `[:id]` in config/environment/production.rb.
+*   Remove deprecated `ActiveRecord::ConnectionAdapters::ConnectionPool#connection`.
 
-    In the console all the attributes are always shown.
+    *Rafael Mendonça França*
 
-    *Andrew Novoselac*
+*   Remove deprecated `config.active_record.sqlite3_deprecated_warning`.
 
-*   `PG::UnableToSend: no connection to the server` is now retryable as a connection-related exception
+    *Rafael Mendonça França*
 
-    *Kazuma Watanabe*
+*   Remove deprecated `config.active_record.warn_on_records_fetched_greater_than`.
 
-*   Fix marshalling of unsaved associated records in 7.1 format.
+    *Rafael Mendonça França*
 
-    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.
+*   Remove deprecated support for defining `enum` with keyword arguments.
 
-    *Jean Boussier*
+    *Rafael Mendonça França*
+
+*   Remove deprecated support to finding database adapters that aren't registered to Active Record.
+
+    *Rafael Mendonça França*
+
+*   Remove deprecated `config.active_record.allow_deprecated_singular_associations_name`.
+
+    *Rafael Mendonça França*
+
+*   Remove deprecated `config.active_record.commit_transaction_on_non_local_return`.
+
+    *Rafael Mendonça França*
 
 *   Fix incorrect SQL query when passing an empty hash to `ActiveRecord::Base.insert`.
 
@@ -369,70 +585,42 @@
 
     *Joshua Young*
 
-*   Fix `dependent: :destroy` for bi-directional has one through association.
-
-    Fixes #50948.
+*   Allow `ActiveRecord::Base#pluck` to accept hash arguments with symbol and string values.
 
     ```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
+    Post.joins(:comments).pluck(:id, comments: :id)
+    Post.joins(:comments).pluck("id", "comments" => "id")
     ```
-    In the above example `left.destroy` wouldn't destroy its associated `Right`
-    record.
 
-    *Andy Stewart*
+    *Joshua Young*
+
+*   Make Float distinguish between `float4` and `float8` in PostgreSQL.
 
-*   Properly handle lazily pinned connection pools.
+    Fixes #52742
 
-    Fixes #53147.
+    *Ryota Kitazawa*, *Takayuki Nagatomi*
 
-    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*
+## Rails 8.0.0.beta1 (September 26, 2024) ##
 
-*   Fix `ActiveRecord::Base.with` to accept more than two sub queries.
+*   Allow `drop_table` to accept an array of table names.
 
-    Fixes #53110.
+    This will let you to drop multiple tables in a single call.
 
     ```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)
+    ActiveRecord::Base.lease_connection.drop_table(:users, :posts)
     ```
 
-    The above now works as expected.
+    *Gabriel Sobrinho*
 
-    *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.
+*   Add support for PostgreSQL `IF NOT EXISTS` via the `:if_not_exists` option
+    on the `add_enum_value` method.
 
-    *Jean Boussier*
-
-*   Make Float distinguish between `float4` and `float8` in PostgreSQL.
+    *Ariel Rzezak*
 
-    Fixes #52742
+*   When running `db:migrate` on a fresh database, load the databases schemas before running migrations.
 
-    *Ryota Kitazawa*, *Takayuki Nagatomi*
+    *Andrew Novoselac*, *Marek Kasztelnik*
 
 *   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.
@@ -445,6 +633,39 @@
 
     *Garrett Blehm*
 
+*   Deprecate `unsigned_float` and `unsigned_decimal` short-hand column methods.
+
+    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.
+
+    https://dev.mysql.com/doc/refman/8.0/en/numeric-type-syntax.html
+
+    *Ryuta Kamizono*
+
+*   Drop MySQL 5.5 support.
+
+    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.
+
+    *Ryuta Kamizono*
+
+*   Make Active Record asynchronous queries compatible with transactional fixtures.
+
+    Previously transactional fixtures would disable asynchronous queries, because transactional
+    fixtures impose all queries use the same connection.
+
+    Now asynchronous queries will use the connection pinned by transactional fixtures, and behave
+    much closer to production.
+
+    *Jean Boussier*
+
+*   Deserialize binary data before decrypting
+
+    This ensures that we call `PG::Connection.unescape_bytea` on PostgreSQL before decryption.
+
+    *Donal McBreen*
+
 *   Ensure `ActiveRecord::Encryption.config` is always ready before access.
 
     Previously, `ActiveRecord::Encryption` configuration was deferred until `ActiveRecord::Base`
@@ -467,954 +688,262 @@
 
     *Ruy Rocha*
 
+*   Add support for SQLite3 full-text-search and other virtual tables.
 
-## Rails 7.2.1.2 (October 23, 2024) ##
+    Previously, adding sqlite3 virtual tables messed up `schema.rb`.
 
-*   No changes.
+    Now, virtual tables can safely be added using `create_virtual_table`.
 
+    *Zacharias Knudsen*
 
-## Rails 7.2.1.1 (October 15, 2024) ##
+*   Support use of alternative database interfaces via the `database_cli` ActiveRecord configuration option.
 
-*   No changes.
+    ```ruby
+    Rails.application.configure do
+      config.active_record.database_cli = { postgresql: "pgcli" }
+    end
+    ```
 
+    *T S Vallender*
 
-## Rails 7.2.1 (August 22, 2024) ##
+*   Add support for dumping table inheritance and native partitioning table definitions for PostgeSQL adapter
 
-*   Fix detection for `enum` columns with parallelized tests and PostgreSQL.
+    *Justin Talbott*
 
-    *Rafael Mendonça França*
+*   Add support for `ActiveRecord::Point` type casts using `Hash` values
 
-*   Allow to eager load nested nil associations.
+    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.
 
-    *fatkodima*
+    ```ruby
+    class PostgresqlPoint < ActiveRecord::Base
+      attribute :x, :point
+      attribute :y, :point
+      attribute :z, :point
+    end
 
-*   Fix swallowing ignore order warning when batching using `BatchEnumerator`.
+    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
+    ```
 
-    *fatkodima*
+    *Stephen Drew*
 
-*   Fix memory bloat on the connection pool when using the Fiber `IsolatedExecutionState`.
+*   Replace `SQLite3::Database#busy_timeout` with `#busy_handler_timeout=`.
 
-    *Jean Boussier*
+    Provides a non-GVL-blocking, fair retry interval busy handler implementation.
 
-*   Restore inferred association class with the same modularized name.
+    *Stephen Margheim*
 
-    *Justin Ko*
+*   SQLite3Adapter: Translate `SQLite3::BusyException` into `ActiveRecord::StatementTimeout`.
 
-*   Fix `ActiveRecord::Base.inspect` to properly explain how to load schema information.
+    *Matthew Nguyen*
 
-    *Jean Boussier*
+*   Include schema name in `enable_extension` statements in `db/schema.rb`.
 
-*   Check invalid `enum` options for the new syntax.
+    The schema dumper will now include the schema name in generated
+    `enable_extension` statements if they differ from the current schema.
 
-    The options using `_` prefix in the old syntax are invalid in the new syntax.
+    For example, if you have a migration:
 
-    *Rafael Mendonça França*
+    ```ruby
+    enable_extension "heroku_ext.pgcrypto"
+    enable_extension "pg_stat_statements"
+    ```
+
+    then the generated schema dump will also contain:
+
+    ```ruby
+    enable_extension "heroku_ext.pgcrypto"
+    enable_extension "pg_stat_statements"
+    ```
+
+    *Tony Novak*
 
 *   Fix `ActiveRecord::Encryption::EncryptedAttributeType#type` to return
     actual cast type.
 
     *Vasiliy Ermolovich*
 
-*   Fix `create_table` with `:auto_increment` option for MySQL adapter.
-
-    *fatkodima*
+*   SQLite3Adapter: Bulk insert fixtures.
 
+    Previously one insert command was executed for each fixture, now they are
+    aggregated in a single bulk insert command.
 
-## Rails 7.2.0 (August 09, 2024) ##
+    *Lázaro Nixon*
 
-*   Handle commas in Sqlite3 default function definitions.
+*   PostgreSQLAdapter: Allow `disable_extension` to be called with schema-qualified name.
 
-    *Stephen Margheim*
+    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"`.
 
-*   Fixes `validates_associated` raising an exception when configured with a
-    singular association and having `index_nested_attribute_errors` enabled.
+    *Tony Novak*
 
-    *Martin Spickermann*
+*   Make `create_schema` / `drop_schema` reversible in migrations.
 
-*   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.
+    Previously, `create_schema` and `drop_schema` were irreversible migration operations.
 
-    *Xavier Noria*
+    *Tony Novak*
 
-*   Add condensed `#inspect` for `ConnectionPool`, `AbstractAdapter`, and
-    `DatabaseConfig`.
-
-    *Hartley McGuire*
-
-*   Fixed a memory performance issue in Active Record attribute methods definition.
-
-    *Jean Boussier*
-
-*   Define the new Active Support notification event `start_transaction.active_record`.
-
-    This event is fired when database transactions or savepoints start, and
-    complements `transaction.active_record`, which is emitted when they finish.
-
-    The payload has the transaction (`:transaction`) and the connection (`:connection`).
-
-    *Xavier Noria*
-
-*   Fix an issue where the IDs reader method did not return expected results
-    for preloaded associations in models using composite primary keys.
-
-    *Jay Ang*
-
-*   The payload of `sql.active_record` Active Support notifications now has the current transaction in the `:transaction` key.
-
-    *Xavier Noria*
-
-*   The payload of `transaction.active_record` Active Support notifications now has the transaction the event is related to in the `:transaction` key.
-
-    *Xavier Noria*
-
-*   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.
-
-    *Xavier Noria*
-
-*   Fix inference of association model on nested models with the same demodularized name.
-
-    E.g. with the following setup:
+*   Support batching using custom columns.
 
     ```ruby
-    class Nested::Post < ApplicationRecord
-      has_one :post, through: :other
+    Product.in_batches(cursor: [:shop_id, :id]) do |relation|
+      # do something with relation
     end
     ```
 
-    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.
-
-    *Taketo Takashima*
-
-*   Change `BatchEnumerator#destroy_all` to return the total number of affected rows.
-
-    Previously, it always returned `nil`.
-
     *fatkodima*
 
-*   Support `touch_all` in batches.
-
-    ```ruby
-    Post.in_batches.touch_all
-    ```
-
-    *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.
-
-    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.
-
-    *lulalala*
-
-*   Add `Rails.application.config.active_record.postgresql_adapter_decode_dates` to opt out of decoding dates automatically with the postgresql adapter. Defaults to true.
-
-    *Joé Dupuis*
-
-*   Association option `query_constraints` is deprecated in favor of `foreign_key`.
+*   Use SQLite `IMMEDIATE` transactions when possible.
 
-    *Nikita Vasilevsky*
-
-*   Add `ENV["SKIP_TEST_DATABASE_TRUNCATE"]` flag to speed up multi-process test runs on large DBs when all tests run within default transaction.
-
-    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.
-
-    *DHH*
-
-*   Added support for recursive common table expressions.
-
-    ```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'),
-      ]
-    )
-    ```
-
-    Generates the following SQL:
-
-    ```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"
-    ```
-
-    *ClearlyClaire*
-
-*   `validate_constraint` can be called in a `change_table` block.
-
-    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
-    ```
-
-    *Cody Cutrer*
-
-*   `PostgreSQLAdapter` now decodes columns of type date to `Date` instead of string.
-
-    Ex:
-    ```ruby
-    ActiveRecord::Base.connection
-         .select_value("select '2024-01-01'::date").class #=> Date
-    ```
-
-    *Joé Dupuis*
-
-*   Strict loading using `:n_plus_one_only` does not eagerly load child associations.
-
-    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.
+    Transactions run against the SQLite3 adapter default to IMMEDIATE mode to improve concurrency support and avoid busy exceptions.
 
-    Before:
-
-    ```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
-    ```
-
-    After:
-
-    ```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
-    ```
+    *Stephen Margheim*
 
-    *Reid Lynch*
+*   Raise specific exception when a connection is not defined.
 
-*   Allow `Sqlite3Adapter` to use `sqlite3` gem version `2.x`.
+    The new `ConnectionNotDefined` exception provides connection name, shard and role accessors indicating the details of the connection that was requested.
 
-    *Mike Dalessio*
+    *Hana Harencarova*, *Matthew Draper*
 
-*   Allow `ActiveRecord::Base#pluck` to accept hash values.
+*   Delete the deprecated constant `ActiveRecord::ImmutableRelation`.
 
-    ```ruby
-    # Before
-    Post.joins(:comments).pluck("posts.id", "comments.id", "comments.body")
-
-    # After
-    Post.joins(:comments).pluck(posts: [:id], comments: [:id, :body])
-    ```
+    *Xavier Noria*
 
-    *fatkodima*
+*   Fix duplicate callback execution when child autosaves parent with `has_one` and `belongs_to`.
 
-*   Raise an `ActiveRecord::ActiveRecordError` error when the MySQL database returns an invalid version string.
+    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.
 
-    *Kevin McPhillips*
+    Now, these callbacks are only executed once as expected.
 
-*   `ActiveRecord::Base.transaction` now yields an `ActiveRecord::Transaction` object.
+    *Joshua Young*
 
-    This allows to register callbacks on it.
+*   `ActiveRecord::Encryption::Encryptor` now supports a `:compressor` option to customize the compression algorithm used.
 
     ```ruby
-    Article.transaction do |transaction|
-      article.update(published: true)
-      transaction.after_commit do
-        PublishNotificationMailer.with(article: article).deliver_later
+    module ZstdCompressor
+      def self.deflate(data)
+        Zstd.compress(data)
       end
-    end
-    ```
-
-    *Jean Boussier*
-
-*   Add `ActiveRecord::Base.current_transaction`.
-
-    Returns the current transaction, to allow registering callbacks on it.
-
-    ```ruby
-    Article.current_transaction.after_commit do
-      PublishNotificationMailer.with(article: article).deliver_later
-    end
-    ```
 
-    *Jean Boussier*
-
-*   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.
-
-    ```ruby
-    def publish_article(article)
-      article.update(published: true)
-      ActiveRecord.after_all_transactions_commit do
-        PublishNotificationMailer.with(article: article).deliver_later
+      def self.inflate(data)
+        Zstd.decompress(data)
       end
     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 }
+    class User
+      encrypts :name, compressor: ZstdCompressor
     end
     ```
 
-    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.
-
-    *Nikita Vasilevsky*
-
-*   Add `config.active_record.permanent_connection_checkout` setting.
-
-    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`.
-
-    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.
-
-    This deprecation is a soft deprecation, no warnings will be issued and there is no
-    current plan to remove the method.
-
-    *Jean Boussier*
-
-*   Deprecate `ActiveRecord::ConnectionAdapters::ConnectionPool#connection`.
-
-    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.
+    You disable compression by passing `compress: false`.
 
     ```ruby
-    assert_equal "Ruby on Rails", web_sites(:rubyonrails).name
-    assert_equal "Ruby on Rails", fixture(:web_sites, :rubyonrails).name
-    ```
-
-    *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*
-
-*   Fix an issue with `where.associated` losing the current join type scope.
-
-    Example:
-
-    ```ruby
-    Post.left_joins(:author).where.associated(:author)
-    ```
-
-    Previously, the `LEFT OUTER JOIN` would be lost and converted to an `INNER JOIN`.
-
-    *Saleh Alhaddad*
-
-*   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.
-
-    *Maxime Réty*
-
-*   Deprecate defining an `enum` with keyword arguments.
-
-    ```ruby
-    class Function > ApplicationRecord
-      # BAD
-      enum color: [:red, :blue],
-           type: [:instance, :class]
-
-      # GOOD
-      enum :color, [:red, :blue]
-      enum :type, [:instance, :class]
+    class User
+      encrypts :name, compress: false
     end
     ```
 
-    *Hartley McGuire*
-
-*   Add `config.active_record.validate_migration_timestamps` option for validating migration timestamps.
-
-    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.
-
-    *Adrianna Chang*
-
-*   Properly synchronize `Mysql2Adapter#active?` and `TrilogyAdapter#active?`.
-
-    As well as `disconnect!` and `verify!`.
-
-    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.
-
-    *Jean Boussier*
-
-*   Support `:source_location` tag option for query log tags.
-
-    ```ruby
-    config.active_record.query_log_tags << :source_location
-    ```
-
-    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.
-
-    This field returns the amount of rows returned by the query that emitted the notification.
-
-    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.
+    *heka1024*
 
-    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`.
+*   Add condensed `#inspect` for `ConnectionPool`, `AbstractAdapter`, and
+    `DatabaseConfig`.
 
     *Hartley McGuire*
 
-*   Add `<role>_types` class method to `ActiveRecord::DelegatedType` so that the delegated types can be introspected.
-
-    *JP Rosevear*
-
-*   Make `schema_dump`, `query_cache`, `replica` and `database_tasks` configurable via `DATABASE_URL`.
-
-    This wouldn't always work previously because boolean values would be interpreted as strings.
-
-    e.g. `DATABASE_URL=postgres://localhost/foo?schema_dump=false` now properly disable dumping the schema
-    cache.
-
-    *Mike Coutermarsh*, *Jean Boussier*
-
-*   Introduce `ActiveRecord::Transactions::ClassMethods#set_callback`.
-
-     It is identical to `ActiveSupport::Callbacks::ClassMethods#set_callback`
-     but with support for `after_commit` and `after_rollback` callback options.
-
-    *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:
+*   Add `.shard_keys`, `.sharded?`, & `.connected_to_all_shards` methods.
 
     ```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.
+    class ShardedBase < ActiveRecord::Base
+        self.abstract_class = true
 
-    *Austen Madden*, *Alex Ghiculescu*, *Rafał Brize*
-
-*   Allow overriding SQLite defaults from `database.yml`.
-
-    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.
-
-    ```yaml
-    database: storage/development.sqlite3
-    timeout: 5000
-    pragmas:
-      journal_mode: off
-      temp_store: memory
-    ```
-
-    *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.
-
-    ```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
+        connects_to shards: {
+          shard_one: { writing: :shard_one },
+          shard_two: { writing: :shard_two }
+        }
     end
-    ```
-
-    *Stephen Margheim*
-
-*   TrilogyAdapter: ignore `host` if `socket` parameter is set.
-
-    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*
-
-*   Make `assert_queries_count`, `assert_no_queries`, `assert_queries_match`, and
-    `assert_no_queries_match` assertions public.
 
-    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.
-
-    ```ruby
-    class ArticleTest < ActiveSupport::TestCase
-      test "queries are made" do
-        assert_queries_count(1) { Article.first }
-      end
-
-      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
+    class ShardedModel < ShardedBase
     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.
 
-    ```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).
-
-    *Kevin McPhillips*
-
-*   `DatabaseConfigurations#configs_for` accepts a symbol in the `name` parameter.
-
-    *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).
+    *Nony Dutton*
 
-    *João Alves*
+*   Add a `filter` option to `in_order_of` to prioritize certain values in the sorting without filtering the results
+    by these values.
 
-*   Make the output of `ActiveRecord::Core#inspect` configurable.
+    *Igor Depolli*
 
-    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.