activerecord 7.2.3 → 8.0.0.beta1

data/CHANGELOG.md

@@ -1,1415 +1,346 @@
-## Rails 7.2.3 (October 28, 2025) ##
+## Rails 8.0.0.beta1 (September 26, 2024) ##
 
-*   Fix SQLite3 data loss during table alterations with CASCADE foreign keys.
+*   Allow `drop_table` to accept an array of table names.
 
-    When altering a table in SQLite3 that is referenced by child tables with
-    `ON DELETE CASCADE` foreign keys, ActiveRecord would silently delete all
-    data from the child tables. This occurred because SQLite requires table
-    recreation for schema changes, and during this process the original table
-    is temporarily dropped, triggering CASCADE deletes on child tables.
-
-    The root cause was incorrect ordering of operations. The original code
-    wrapped `disable_referential_integrity` inside a transaction, but
-    `PRAGMA foreign_keys` cannot be modified inside a transaction in SQLite -
-    attempting to do so simply has no effect. This meant foreign keys remained
-    enabled during table recreation, causing CASCADE deletes to fire.
-
-    The fix reverses the order to follow the official SQLite 12-step ALTER TABLE
-    procedure: `disable_referential_integrity` now wraps the transaction instead
-    of being wrapped by it. This ensures foreign keys are properly disabled
-    before the transaction starts and re-enabled after it commits, preventing
-    CASCADE deletes while maintaining data integrity through atomic transactions.
-
-    *Ruy Rocha*
-
-*   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,
-    only the optional part of the key should be cleared.
-
-    *zzak*
-
-*   Fix invalid records being autosaved when distantly associated records are marked for deletion.
-
-    *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*
-
-*   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.
-
-    This improve accuracy of system tests, and any test using multiple threads.
-
-    *Heinrich Lee Yu*, *Jean Boussier*
-
-*   Don't add `id_value` attribute alias when attribute/column with that name already exists.
-
-    *Rob Lewis*
-
-*   Fix false positive change detection involving STI and polymorhic 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`.
-
-    *Florent Beaurain*, *Thomas Crambert*
-
-*   Fix removal of PostgreSQL version comments in `structure.sql` for latest PostgreSQL versions which include `\restrict`.
-
-    *Brendan Weibrecht*
-
-*   Fix `#merge` with `#or` or `#and` and a mixture of attributes and SQL strings resulting in an incorrect query.
-
-    ```ruby
-    base = Comment.joins(:post).where(user_id: 1).where("recent = 1")
-    puts base.merge(base.where(draft: true).or(Post.where(archived: true))).to_sql
-    ```
-
-    Before:
-
-    ```SQL
-    SELECT "comments".* FROM "comments"
-    INNER JOIN "posts" ON "posts"."id" = "comments"."post_id"
-    WHERE (recent = 1)
-    AND (
-      "comments"."user_id" = 1
-      AND (recent = 1)
-      AND "comments"."draft" = 1
-      OR "posts"."archived" = 1
-    )
-    ```
-
-    After:
-
-    ```SQL
-    SELECT "comments".* FROM "comments"
-    INNER JOIN "posts" ON "posts"."id" = "comments"."post_id"
-    WHERE "comments"."user_id" = 1
-    AND (recent = 1)
-    AND (
-      "comments"."user_id" = 1
-      AND (recent = 1)
-      AND "comments"."draft" = 1
-      OR "posts"."archived" = 1
-    )
-    ```
-
-    *Joshua Young*
-
-*   Fix inline `has_and_belongs_to_many` fixtures for tables with composite primary keys.
-
-    *fatkodima*
-
-*   Fix `annotate` comments to propagate to `update_all`/`delete_all`.
-
-    *fatkodima*
-
-*   Fix checking whether an unpersisted record is `include?`d in a strictly
-    loaded `has_and_belongs_to_many` association.
-
-    *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
-    in a `after_save` callback had no effect, the transaction was committed
-    and a record created.
-
-    *Edouard Chin*
-
-*   Gracefully handle `Timeout.timeout` firing during connection configuration.
-
-    Use of `Timeout.timeout` could result in improperly initialized database connection.
-
-    This could lead to a partially configured connection being used, resulting in various exceptions,
-    the most common being with the PostgreSQLAdapter raising `undefined method 'key?' for nil`
-    or `TypeError: wrong argument type nil (expected PG::TypeMap)`.
-
-    *Jean Boussier*
-
-*   The SQLite3 adapter quotes non-finite Numeric values like "Infinity" and "NaN".
-
-    *Mike Dalessio*
-
-*   Handle libpq returning a database version of 0 on no/bad connection in `PostgreSQLAdapter`.
-
-    Before, this version would be cached and an error would be raised during connection configuration when
-    comparing it with the minimum required version for the adapter. This meant that the connection could
-    never be successfully configured on subsequent reconnection attempts.
-
-    Now, this is treated as a connection failure consistent with libpq, raising a `ActiveRecord::ConnectionFailed`
-    and ensuring the version isn't cached, which allows the version to be retrieved on the next connection attempt.
-
-    *Joshua Young*, *Rian McGuire*
-
-*   Fix error handling during connection configuration.
-
-    Active Record wasn't properly handling errors during the connection configuration phase.
-    This could lead to a partially configured connection being used, resulting in various exceptions,
-    the most common being with the PostgreSQLAdapter raising `undefined method `key?' for nil`
-    or `TypeError: wrong argument type nil (expected PG::TypeMap)`.
-
-    *Jean Boussier*
-
-*   Fix a case where a non-retryable query could be marked retryable.
-
-    *Hartley McGuire*
-
-*   Handle circular references when autosaving associations.
-
-    *zzak*
-
-*   Prevent persisting invalid record.
-
-    *Edouard Chin*
-
-*   Fix support for PostgreSQL enum types with commas in their name.
-
-    *Arthur Hess*
-
-*   Fix inserts on MySQL with no RETURNING support for a table with multiple auto populated columns.
-
-    *Nikita Vasilevsky*
-
-*   Fix joining on a scoped association with string joins and bind parameters.
-
-    ```ruby
-    class Instructor < ActiveRecord::Base
-      has_many :instructor_roles, -> { active }
-    end
-
-    class InstructorRole < ActiveRecord::Base
-      scope :active, -> {
-        joins("JOIN students ON instructor_roles.student_id = students.id")
-        .where(students { status: 1 })
-      }
-    end
-
-    Instructor.joins(:instructor_roles).first
-    ```
-
-    The above example would result in `ActiveRecord::StatementInvalid` because the
-    `active` scope bind parameters would be lost.
-
-    *Jean Boussier*
-
-*   Fix a potential race condition with system tests and transactional fixtures.
-
-    *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
-    weren't created nor modified as part of the transaction:
-
-    ```ruby
-    Post.create!(author: User.find(1)) # Fail if user is invalid
-    ```
-
-    *Jean Boussier*
-
-*   Remember when a database connection has recently been verified (for
-    two seconds, by default), to avoid repeated reverifications during a
-    single request.
-
-    This should recreate a similar rate of verification as in Rails 7.1,
-    where connections are leased for the duration of a request, and thus
-    only verified once.
-
-    *Matthew Draper*
-
-*   Fix prepared statements on mysql2 adapter.
-
-    *Jean Boussier*
-
-*   Fix a race condition in `ActiveRecord::Base#method_missing` when lazily defining attributes.
-
-    If multiple thread were concurrently triggering attribute definition on the same model,
-    it could result in a `NoMethodError` being raised.
-
-    *Jean Boussier*
-
-*   Fix MySQL default functions getting dropped when changing a column's nullability.
-
-    *Bastian Bartmann*
-
-*   Fix `add_unique_constraint`/`add_check_constraint`/`/`add_foreign_key` to be revertible when
-    given invalid options.
-
-    *fatkodima*
-
-*   Fix asynchronous destroying of polymorphic `belongs_to` associations.
-
-    *fatkodima*
-
-*   NOT VALID constraints should not dump in `create_table`.
-
-    *Ryuta Kamizono*
-
-*   Fix finding by nil composite primary key association.
-
-    *fatkodima*
-
-*   Fix parsing of SQLite foreign key names when they contain non-ASCII characters
-
-    *Zacharias Knudsen*
-
-*   Fix parsing of MySQL 8.0.16+ CHECK constraints when they contain new lines.
-
-    *Steve Hill*
-
-*   Ensure normalized attribute queries use `IS NULL` consistently for `nil` and normalized `nil` values.
-
-    *Joshua Young*
-
-*   Restore back the ability to pass only database name for `DATABASE_URL`.
-
-    *fatkodima*
-
-*   Fix `order` with using association name as an alias.
-
-    *Ryuta Kamizono*
-
-*   Improve invalid argument error for with.
-
-    *Ryuta Kamizono*
-
-*   Deduplicate `with` CTE expressions.
-
-    *fatkodima*
-
-
-## Rails 7.2.2.2 (August 13, 2025) ##
-
-*   Call inspect on ids in RecordNotFound error
-
-    [CVE-2025-55193]
-
-    *Gannon McGibbon*, *John Hawthorn*
-
-
-## Rails 7.2.2.1 (December 10, 2024) ##
-
-*   No changes.
-
-
-## Rails 7.2.2 (October 30, 2024) ##
-
-*   Fix support for `query_cache: false` in `database.yml`.
-
-    `query_cache: false` would no longer entirely disable the Active Record query cache.
-
-    *zzak*
-
-*   Set `.attributes_for_inspect` to `:all` by default.
-
-    For new applications it is set to `[:id]` in config/environment/production.rb.
-
-    In the console all the attributes are always shown.
-
-    *Andrew Novoselac*
-
-*   `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*
-
-*   Properly handle lazily pinned connection pools.
-
-    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.
-
-    *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*
-
-
-## Rails 7.2.1.2 (October 23, 2024) ##
-
-*   No changes.
-
-
-## Rails 7.2.1.1 (October 15, 2024) ##
-
-*   No changes.
-
-
-## Rails 7.2.1 (August 22, 2024) ##
-
-*   Fix detection for `enum` columns with parallelized tests and PostgreSQL.
-
-    *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.
-
-    *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.
-
-    *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.
-
-    *Xavier Noria*
-
-*   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:
-
-    ```ruby
-    class Nested::Post < ApplicationRecord
-      has_one :post, through: :other
-    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`.
-
-    *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.
-
-    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
-    ```
-
-    *Reid Lynch*
-
-*   Allow `Sqlite3Adapter` to use `sqlite3` gem version `2.x`.
-
-    *Mike Dalessio*
-
-*   Allow `ActiveRecord::Base#pluck` to accept hash values.
-
-    ```ruby
-    # Before
-    Post.joins(:comments).pluck("posts.id", "comments.id", "comments.body")
-
-    # After
-    Post.joins(:comments).pluck(posts: [:id], comments: [:id, :body])
-    ```
-
-    *fatkodima*
-
-*   Raise an `ActiveRecord::ActiveRecordError` error when the MySQL database returns an invalid version string.
-
-    *Kevin McPhillips*
-
-*   `ActiveRecord::Base.transaction` now yields an `ActiveRecord::Transaction` object.
-
-    This allows to register callbacks on it.
-
-    ```ruby
-    Article.transaction do |transaction|
-      article.update(published: true)
-      transaction.after_commit do
-        PublishNotificationMailer.with(article: article).deliver_later
-      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
-      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:
+    This will let you to drop multiple tables in a single call.
 
     ```ruby
-    class Comment < ApplicationRecord
-      belongs_to :post, counter_cache: { active: false }
-    end
+    ActiveRecord::Base.lease_connection.drop_table(:users, :posts)
     ```
 
-    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.
+    *Gabriel Sobrinho*
 
-    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.
+*   Add support for PostgreSQL `IF NOT EXISTS` via the `:if_not_exists` option
+    on the `add_enum_value` method.
 
-    *Nikita Vasilevsky*
+    *Ariel Rzezak*
 
-*   Add `config.active_record.permanent_connection_checkout` setting.
+*   When running `db:migrate` on a fresh database, load the database schema before running migrations.
 
-    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.
+    *Andrew Novoselac*
 
-    *Jean Boussier*
+*   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 dirties option to uncached.
+    Previously, using `.left_outer_joins` with the same child association would only join one of the parents.
 
-    This adds a `dirties` option to `ActiveRecord::Base.uncached` and
-    `ActiveRecord::ConnectionAdapters::ConnectionPool#uncached`.
+    Now it will correctly join both parents.
 
-    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.
+    Fixes #41498.
 
-    This is needed by Solid Cache so that cache writes do not clear query caches.
+    *Garrett Blehm*
 
-    *Donal McBreen*
+*   Deprecate `unsigned_float` and `unsigned_decimal` short-hand column methods.
 
-*   Deprecate `ActiveRecord::Base.connection` in favor of `.lease_connection`.
+    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.
 
-    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.
+    https://dev.mysql.com/doc/refman/8.0/en/numeric-type-syntax.html
 
-    This deprecation is a soft deprecation, no warnings will be issued and there is no
-    current plan to remove the method.
+    *Ryuta Kamizono*
 
-    *Jean Boussier*
+*   Drop MySQL 5.5 support.
 
-*   Deprecate `ActiveRecord::ConnectionAdapters::ConnectionPool#connection`.
+    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.
 
-    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.
+    *Ryuta Kamizono*
 
-    *Jean Boussier*
+*   Make Active Record asynchronous queries compatible with transactional fixtures.
 
-*   Expose a generic fixture accessor for fixture names that may conflict with Minitest.
+    Previously transactional fixtures would disable asynchronous queries, because transactional
+    fixtures impose all queries use the same connection.
 
-    ```ruby
-    assert_equal "Ruby on Rails", web_sites(:rubyonrails).name
-    assert_equal "Ruby on Rails", fixture(:web_sites, :rubyonrails).name
-    ```
+    Now asynchronous queries will use the connection pinned by transactional fixtures, and behave
+    much closer to production.
 
     *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!`.
+*   Deserialize binary data before decrypting
 
-    *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.
+    This ensures that we call `PG::Connection.unescape_bytea` on PostgreSQL before decryption.
 
     *Donal McBreen*
 
-*   Add support for encrypting binary columns.
-
-    Ensure encryption and decryption pass `Type::Binary::Data` around for binary data.
+*   Ensure `ActiveRecord::Encryption.config` is always ready before access.
 
-    Previously encrypting binary columns with the `ActiveRecord::Encryption::MessageSerializer`
-    incidentally worked for MySQL and SQLite, but not PostgreSQL.
+    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.
 
-    *Donal McBreen*
+    `ActiveRecord::Encryption` now has its own loading hook so that its configuration is set as
+    soon as needed.
 
-*   Deprecated `ENV["SCHEMA_CACHE"]` in favor of `schema_cache_path` in the database configuration.
+    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`.
 
-    *Rafael Mendonça França*
+    *Maxime Réty*
 
-*   Add `ActiveRecord::Base.with_connection` as a shortcut for leasing a connection for a short duration.
+*   Add `TimeZoneConverter#==` method, so objects will be properly compared by
+    their type, scale, limit & precision.
 
-    The leased connection is yielded, and for the duration of the block, any call to `ActiveRecord::Base.connection`
-    will yield that same connection.
+    Address #52699.
 
-    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.
+    *Ruy Rocha*
 
-    *Jean Boussier*
+*   Add support for SQLite3 full-text-search and other virtual tables.
 
-*   Deprecate `config.active_record.warn_on_records_fetched_greater_than` now that `sql.active_record`
-    notification includes `:row_count` field.
+    Previously, adding sqlite3 virtual tables messed up `schema.rb`.
 
-    *Jason Nochlin*
+    Now, virtual tables can safely be added using `create_virtual_table`.
 
-*   Fix an issue with `where.associated` losing the current join type scope.
+    *Zacharias Knudsen*
 
-    Example:
+*   Support use of alternative database interfaces via the `database_cli` ActiveRecord configuration option.
 
     ```ruby
-    Post.left_joins(:author).where.associated(:author)
+    Rails.application.configure do
+      config.active_record.database_cli = { postgresql: "pgcli" }
+    end
     ```
 
-    Previously, the `LEFT OUTER JOIN` would be lost and converted to an `INNER JOIN`.
+    *T S Vallender*
 
-    *Saleh Alhaddad*
+*   Add support for dumping table inheritance and native partitioning table definitions for PostgeSQL adapter
 
-*   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.
+    *Justin Talbott*
 
-    *Maxime Réty*
+*   Add support for `ActiveRecord::Point` type casts using `Hash` values
 
-*   Deprecate defining an `enum` with keyword arguments.
+    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
-    class Function > ApplicationRecord
-      # BAD
-      enum color: [:red, :blue],
-           type: [:instance, :class]
-
-      # GOOD
-      enum :color, [:red, :blue]
-      enum :type, [:instance, :class]
+    class PostgresqlPoint < ActiveRecord::Base
+      attribute :x, :point
+      attribute :y, :point
+      attribute :z, :point
     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
     ```
 
-    *Hartley McGuire*
+    *Stephen Drew*
 
-*   Add `config.active_record.validate_migration_timestamps` option for validating migration timestamps.
+*   Replace `SQLite3::Database#busy_timeout` with `#busy_handler_timeout=`.
 
-    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.
+    Provides a non-GVL-blocking, fair retry interval busy handler implementation.
 
-    *Adrianna Chang*
+    *Stephen Margheim*
 
-*   Properly synchronize `Mysql2Adapter#active?` and `TrilogyAdapter#active?`.
+*   SQLite3Adapter: Translate `SQLite3::BusyException` into `ActiveRecord::StatementTimeout`.
 
-    As well as `disconnect!` and `verify!`.
+    *Matthew Nguyen*
 
-    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.
+*   Include schema name in `enable_extension` statements in `db/schema.rb`.
 
-    *Jean Boussier*
+    The schema dumper will now include the schema name in generated
+    `enable_extension` statements if they differ from the current schema.
 
-*   Support `:source_location` tag option for query log tags.
+    For example, if you have a migration:
 
     ```ruby
-    config.active_record.query_log_tags << :source_location
+    enable_extension "heroku_ext.pgcrypto"
+    enable_extension "pg_stat_statements"
     ```
 
-    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`
+    then the generated schema dump will also contain:
 
     ```ruby
-      class User
-        encrypts :name, encryptor: ActiveRecord::Encryption::Encryptor.new(compress: false)
-      end
+    enable_extension "heroku_ext.pgcrypto"
+    enable_extension "pg_stat_statements"
     ```
 
-    *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.
-
-    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*
-
-*   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.
+    *Tony Novak*
 
-    e.g. `DATABASE_URL=postgres://localhost/foo?schema_dump=false` now properly disable dumping the schema
-    cache.
-
-    *Mike Coutermarsh*, *Jean Boussier*
+*   Fix `ActiveRecord::Encryption::EncryptedAttributeType#type` to return
+    actual cast type.
 
-*   Introduce `ActiveRecord::Transactions::ClassMethods#set_callback`.
+    *Vasiliy Ermolovich*
 
-     It is identical to `ActiveSupport::Callbacks::ClassMethods#set_callback`
-     but with support for `after_commit` and `after_rollback` callback options.
+*   SQLite3Adapter: Bulk insert fixtures.
 
-    *Joshua Young*
+    Previously one insert command was executed for each fixture, now they are
+    aggregated in a single bulk insert command.
 
-*   Make `ActiveRecord::Encryption::Encryptor` agnostic of the serialization format used for encrypted data.
+    *Lázaro Nixon*
 
-    Previously, the encryptor instance only allowed an encrypted value serialized as a `String` to be passed to the message serializer.
+*   PostgreSQLAdapter: Allow `disable_extension` to be called with schema-qualified name.
 
-    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`.
+    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"`.
 
-    The default `ActiveRecord::Encryption::MessageSerializer` already ensures that only `String` objects are passed for deserialization.
+    *Tony Novak*
 
-    *Maxime Réty*
+*   Make `create_schema` / `drop_schema` reversible in migrations.
 
-*   Fix `encrypted_attribute?` to take into account context properties passed to `encrypts`.
+    Previously, `create_schema` and `drop_schema` were irreversible migration operations.
 
-    *Maxime Réty*
+    *Tony Novak*
 
-*   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:
+*   Support batching using custom columns.
 
     ```ruby
-    User.all.explain.count
-    # EXPLAIN SELECT COUNT(*) FROM `users`
-    # ...
-
-    User.all.explain.maximum(:id)
-    # EXPLAIN SELECT MAX(`users`.`id`) FROM `users`
-    # ...
+    Product.in_batches(cursor: [:shop_id, :id]) do |relation|
+      # do something with relation
+    end
     ```
 
-    *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`.
+    *fatkodima*
 
-    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.
+*   Use SQLite `IMMEDIATE` transactions when possible.
 
-    ```yaml
-    database: storage/development.sqlite3
-    timeout: 5000
-    pragmas:
-      journal_mode: off
-      temp_store: memory
-    ```
+    Transactions run against the SQLite3 adapter default to IMMEDIATE mode to improve concurrency support and avoid busy exceptions.
 
     *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*
+*   Raise specific exception when a connection is not defined.
 
-*   Add support for generated columns to the SQLite3 adapter.
+    The new `ConnectionNotDefined` exception provides connection name, shard and role accessors indicating the details of the connection that was requested.
 
-    Generated columns (both stored and dynamic) are supported since version 3.31.0 of SQLite.
-    This adds support for those to the SQLite3 adapter.
+    *Hana Harencarova*, *Matthew Draper*
 
-    ```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
-    end
-    ```
-
-    *Stephen Margheim*
+*   Delete the deprecated constant `ActiveRecord::ImmutableRelation`.
 
-*   TrilogyAdapter: ignore `host` if `socket` parameter is set.
+    *Xavier Noria*
 
-    This allows to configure a connection on a UNIX socket via `DATABASE_URL`:
+*   Fix duplicate callback execution when child autosaves parent with `has_one` and `belongs_to`.
 
-    ```
-    DATABASE_URL=trilogy://does-not-matter/my_db_production?socket=/var/run/mysql.sock
-    ```
+    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.
 
-    *Jean Boussier*
+    Now, these callbacks are only executed once as expected.
 
-*   Make `assert_queries_count`, `assert_no_queries`, `assert_queries_match`, and
-    `assert_no_queries_match` assertions public.
+    *Joshua Young*
 
-    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.
+*   `ActiveRecord::Encryption::Encryptor` now supports a `:compressor` option to customize the compression algorithm used.
 
     ```ruby
-    class ArticleTest < ActiveSupport::TestCase
-      test "queries are made" do
-        assert_queries_count(1) { Article.first }
+    module ZstdCompressor
+      def self.deflate(data)
+        Zstd.compress(data)
       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
+      def self.inflate(data)
+        Zstd.decompress(data)
       end
     end
-    ```
-
-    *Petrik de Heus*, *fatkodima*
 
-*   Fix `has_secure_token` calls the setter method on initialize.
-
-    *Abeid Ahmed*
+    class User
+      encrypts :name, compressor: ZstdCompressor
+    end
+    ```
 
-*   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.
+    You disable compression by passing `compress: false`.
 
     ```ruby
-    # ENV['DATABASE_URL'] = "mysql://localhost/example_database"
-    config.active_record.protocol_adapters.mysql = "trilogy"
-    # will connect to MySQL using the trilogy adapter
+    class User
+      encrypts :name, compress: false
+    end
     ```
 
-    *Jean Boussier*, *Kevin McPhillips*
+    *heka1024*
 
-*   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).
+*   Add condensed `#inspect` for `ConnectionPool`, `AbstractAdapter`, and
+    `DatabaseConfig`.
 
-    *Kevin McPhillips*
+    *Hartley McGuire*
 
-*   `DatabaseConfigurations#configs_for` accepts a symbol in the `name` parameter.
+*   Add `.shard_keys`, `.sharded?`, & `.connected_to_all_shards` methods.
 
-    *Andrew Novoselac*
+    ```ruby
+    class ShardedBase < ActiveRecord::Base
+        self.abstract_class = true
 
-*   Fix `where(field: values)` queries when `field` is a serialized attribute
-    (for example, when `field` uses `ActiveRecord::Base.serialize` or is a JSON
-    column).
+        connects_to shards: {
+          shard_one: { writing: :shard_one },
+          shard_two: { writing: :shard_two }
+        }
+    end
 
-    *João Alves*
+    class ShardedModel < ShardedBase
+    end
 
-*   Make the output of `ActiveRecord::Core#inspect` configurable.
+    ShardedModel.shard_keys => [:shard_one, :shard_two]
+    ShardedModel.sharded? => true
+    ShardedBase.connected_to_all_shards { ShardedModel.current_shard } => [:shard_one, :shard_two]
+    ```
 
-    By default, calling `inspect` on a record will yield a formatted string including just the `id`.
+    *Nony Dutton*
 
-    ```ruby
-    Post.first.inspect #=> "#<Post id: 1>"
-    ```
+*   Add a `filter` option to `in_order_of` to prioritize certain values in the sorting without filtering the results
+    by these values.
 
-    The attributes to be included in the output of `inspect` can be configured with
-    `ActiveRecord::Core#attributes_for_inspect`.
+    *Igor Depolli*
 
-    ```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.