RubyGems - activerecord - Versions diffs - 7.2.1.1 → 8.0.0.rc1 - Mend

activerecord 7.2.1.1 → 8.0.0.rc1

Files changed (123) hide show

data/CHANGELOG.md CHANGED Viewed

@@ -1,949 +1,413 @@
-## Rails 7.2.1.1 (October 15, 2024) ##
+## Rails 8.0.0.rc1 (October 19, 2024) ##
-*   No changes.
-## Rails 7.2.1 (August 22, 2024) ##
-*   Fix detection for `enum` columns with parallelized tests and PostgreSQL.
+*   Remove deprecated support to setting `ENV["SCHEMA_CACHE"]`.
     *Rafael Mendonça França*
-*   Allow to eager load nested nil associations.
-    *fatkodima*
-*   Fix swallowing ignore order warning when batching using `BatchEnumerator`.
-    *fatkodima*
-*   Fix memory bloat on the connection pool when using the Fiber `IsolatedExecutionState`.
-    *Jean Boussier*
-*   Restore inferred association class with the same modularized name.
-    *Justin Ko*
-*   Fix `ActiveRecord::Base.inspect` to properly explain how to load schema information.
-    *Jean Boussier*
-*   Check invalid `enum` options for the new syntax.
-    The options using `_` prefix in the old syntax are invalid in the new syntax.
+*   Remove deprecated support to passing a database name to `cache_dump_filename`.
     *Rafael Mendonça França*
-*   Fix `ActiveRecord::Encryption::EncryptedAttributeType#type` to return
-    actual cast type.
-    *Vasiliy Ermolovich*
-*   Fix `create_table` with `:auto_increment` option for MySQL adapter.
-    *fatkodima*
-## Rails 7.2.0 (August 09, 2024) ##
-*   Handle commas in Sqlite3 default function definitions.
-    *Stephen Margheim*
+*   Remove deprecated `ActiveRecord::ConnectionAdapters::ConnectionPool#connection`.
-*   Fixes `validates_associated` raising an exception when configured with a
-    singular association and having `index_nested_attribute_errors` enabled.
+    *Rafael Mendonça França*
-    *Martin Spickermann*
+*   Remove deprecated `config.active_record.sqlite3_deprecated_warning`.
-*   The constant `ActiveRecord::ImmutableRelation` has been deprecated because
-    we want to reserve that name for a stronger sense of "immutable relation".
-    Please use `ActiveRecord::UnmodifiableRelation` instead.
+    *Rafael Mendonça França*
-    *Xavier Noria*
+*   Remove deprecated `config.active_record.warn_on_records_fetched_greater_than`.
-*   Add condensed `#inspect` for `ConnectionPool`, `AbstractAdapter`, and
-    `DatabaseConfig`.
+    *Rafael Mendonça França*
-    *Hartley McGuire*
+*   Remove deprecated support for defining `enum` with keyword arguments.
-*   Fixed a memory performance issue in Active Record attribute methods definition.
+    *Rafael Mendonça França*
-    *Jean Boussier*
+*   Remove deprecated support to finding database adapters that aren't registered to Active Record.
-*   Define the new Active Support notification event `start_transaction.active_record`.
+    *Rafael Mendonça França*
-    This event is fired when database transactions or savepoints start, and
-    complements `transaction.active_record`, which is emitted when they finish.
+*   Remove deprecated `config.active_record.allow_deprecated_singular_associations_name`.
-    The payload has the transaction (`:transaction`) and the connection (`:connection`).
+    *Rafael Mendonça França*
-    *Xavier Noria*
+*   Remove deprecated `config.active_record.commit_transaction_on_non_local_return`.
-*   Fix an issue where the IDs reader method did not return expected results
-    for preloaded associations in models using composite primary keys.
+    *Rafael Mendonça França*
-    *Jay Ang*
+*   Fix incorrect SQL query when passing an empty hash to `ActiveRecord::Base.insert`.
-*   The payload of `sql.active_record` Active Support notifications now has the current transaction in the `:transaction` key.
+    *David Stosik*
-    *Xavier Noria*
+*   Allow to save records with polymorphic join tables that have `inverse_of`
+    specified.
-*   The payload of `transaction.active_record` Active Support notifications now has the transaction the event is related to in the `:transaction` key.
+    *Markus Doits*
-    *Xavier Noria*
+*   Fix association scopes applying on the incorrect join when using a polymorphic `has_many through:`.
-*   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.
+    *Joshua Young*
-    E.g. with the following setup:
+*   Allow `ActiveRecord::Base#pluck` to accept hash arguments with symbol and string values.
     ```ruby
-    class Nested::Post < ApplicationRecord
-      has_one :post, through: :other
-    end
+    Post.joins(:comments).pluck(:id, comments: :id)
+    Post.joins(:comments).pluck("id", "comments" => "id")
     ```
-    Before, `#post` would infer the model as `Nested::Post`, but now it correctly infers `Post`.
     *Joshua Young*
-*   PostgreSQL `Cidr#change?` detects the address prefix change.
+*   Make Float distinguish between `float4` and `float8` in PostgreSQL.
-    *Taketo Takashima*
+    Fixes #52742
-*   Change `BatchEnumerator#destroy_all` to return the total number of affected rows.
+    *Ryota Kitazawa*, *Takayuki Nagatomi*
-    Previously, it always returned `nil`.
-    *fatkodima*
+## Rails 8.0.0.beta1 (September 26, 2024) ##
-*   Support `touch_all` in batches.
+*   Allow `drop_table` to accept an array of table names.
+    This will let you to drop multiple tables in a single call.
     ```ruby
-    Post.in_batches.touch_all
+    ActiveRecord::Base.lease_connection.drop_table(:users, :posts)
     ```
-    *fatkodima*
-*   Add support for `:if_not_exists` and `:force` options to `create_schema`.
+    *Gabriel Sobrinho*
-    *fatkodima*
-*   Fix `index_errors` having incorrect index in association validation errors.
+*   Add support for PostgreSQL `IF NOT EXISTS` via the `:if_not_exists` option
+    on the `add_enum_value` method.
-    *lulalala*
+    *Ariel Rzezak*
-*   Add `index_errors: :nested_attributes_order` mode.
+*   When running `db:migrate` on a fresh database, load the database schema before running migrations.
-    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.
+    *Andrew Novoselac*
-    *lulalala*
+*   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 `Rails.application.config.active_record.postgresql_adapter_decode_dates` to opt out of decoding dates automatically with the postgresql adapter. Defaults to true.
+    Previously, using `.left_outer_joins` with the same child association would only join one of the parents.
-    *Joé Dupuis*
+    Now it will correctly join both parents.
-*   Association option `query_constraints` is deprecated in favor of `foreign_key`.
+    Fixes #41498.
-    *Nikita Vasilevsky*
+    *Garrett Blehm*
-*   Add `ENV["SKIP_TEST_DATABASE_TRUNCATE"]` flag to speed up multi-process test runs on large DBs when all tests run within default transaction.
+*   Deprecate `unsigned_float` and `unsigned_decimal` short-hand column methods.
-    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.
+    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.
-    *DHH*
+    https://dev.mysql.com/doc/refman/8.0/en/numeric-type-syntax.html
-*   Added support for recursive common table expressions.
+    *Ryuta Kamizono*
-    ```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'),
-      ]
-    )
-    ```
+*   Drop MySQL 5.5 support.
-    Generates the following SQL:
+    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.
-    ```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"
-    ```
+    *Ryuta Kamizono*
-    *ClearlyClaire*
+*   Make Active Record asynchronous queries compatible with transactional fixtures.
-*   `validate_constraint` can be called in a `change_table` block.
+    Previously transactional fixtures would disable asynchronous queries, because transactional
+    fixtures impose all queries use the same connection.
-    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
-    ```
+    Now asynchronous queries will use the connection pinned by transactional fixtures, and behave
+    much closer to production.
-    *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.
+    *Jean Boussier*
-    With this change, child associations are no longer eagerly loaded, to
-    match intended behavior and to prevent non-deterministic order issues caused
-    by calling methods like `first` or `last`. As `first` and `last` don't cause
-    an N+1 by themselves, calling child associations will no longer raise.
-    Fixes #49473.
+*   Deserialize binary data before decrypting
-    Before:
+    This ensures that we call `PG::Connection.unescape_bytea` on PostgreSQL before decryption.
-    ```ruby
-    person = Person.find(1)
-    person.strict_loading!(mode: :n_plus_one_only)
-    person.posts.first
-    # SELECT * FROM posts WHERE person_id = 1; -- non-deterministic order
-    person.posts.first.firm # raises ActiveRecord::StrictLoadingViolationError
-    ```
+    *Donal McBreen*
-    After:
+*   Ensure `ActiveRecord::Encryption.config` is always ready before access.
-    ```ruby
-    person = Person.find(1)
-    person.strict_loading!(mode: :n_plus_one_only)
-    person.posts.first # this is 1+1, not N+1
-    # SELECT * FROM posts WHERE person_id = 1 ORDER BY id LIMIT 1;
-    person.posts.first.firm # no longer raises
-    ```
+    Previously, `ActiveRecord::Encryption` configuration was deferred until `ActiveRecord::Base`
+    was loaded. Therefore, accessing `ActiveRecord::Encryption.config` properties before
+    `ActiveRecord::Base` was loaded would give incorrect results.
-    *Reid Lynch*
+    `ActiveRecord::Encryption` now has its own loading hook so that its configuration is set as
+    soon as needed.
-*   Allow `Sqlite3Adapter` to use `sqlite3` gem version `2.x`.
+    When `ActiveRecord::Base` is loaded, even lazily, it in turn triggers the loading of
+    `ActiveRecord::Encryption`, thus preserving the original behavior of having its config ready
+    before any use of `ActiveRecord::Base`.
-    *Mike Dalessio*
+    *Maxime Réty*
-*   Allow `ActiveRecord::Base#pluck` to accept hash values.
+*   Add `TimeZoneConverter#==` method, so objects will be properly compared by
+    their type, scale, limit & precision.
-    ```ruby
-    # Before
-    Post.joins(:comments).pluck("posts.id", "comments.id", "comments.body")
+    Address #52699.
-    # After
-    Post.joins(:comments).pluck(posts: [:id], comments: [:id, :body])
-    ```
+    *Ruy Rocha*
-    *fatkodima*
+*   Add support for SQLite3 full-text-search and other virtual tables.
-*   Raise an `ActiveRecord::ActiveRecordError` error when the MySQL database returns an invalid version string.
+    Previously, adding sqlite3 virtual tables messed up `schema.rb`.
-    *Kevin McPhillips*
+    Now, virtual tables can safely be added using `create_virtual_table`.
-*   `ActiveRecord::Base.transaction` now yields an `ActiveRecord::Transaction` object.
+    *Zacharias Knudsen*
-    This allows to register callbacks on it.
+*   Support use of alternative database interfaces via the `database_cli` ActiveRecord configuration option.
     ```ruby
-    Article.transaction do |transaction|
-      article.update(published: true)
-      transaction.after_commit do
-        PublishNotificationMailer.with(article: article).deliver_later
-      end
+    Rails.application.configure do
+      config.active_record.database_cli = { postgresql: "pgcli" }
     end
     ```
-    *Jean Boussier*
-*   Add `ActiveRecord::Base.current_transaction`.
-    Returns the current transaction, to allow registering callbacks on it.
+    *T S Vallender*
-    ```ruby
-    Article.current_transaction.after_commit do
-      PublishNotificationMailer.with(article: article).deliver_later
-    end
-    ```
+*   Add support for dumping table inheritance and native partitioning table definitions for PostgeSQL adapter
-    *Jean Boussier*
+    *Justin Talbott*
-*   Add `ActiveRecord.after_all_transactions_commit` callback.
+*   Add support for `ActiveRecord::Point` type casts using `Hash` values
-    Useful for code that may run either inside or outside a transaction and needs
-    to perform work after the state changes have been properly persisted.
+    This allows `ActiveRecord::Point` to be cast or serialized from a hash
+    with `:x` and `:y` keys of numeric values, mirroring the functionality of
+    existing casts for string and array values. Both string and symbol keys are
+    supported.
     ```ruby
-    def publish_article(article)
-      article.update(published: true)
-      ActiveRecord.after_all_transactions_commit do
-        PublishNotificationMailer.with(article: article).deliver_later
-      end
+    class PostgresqlPoint < ActiveRecord::Base
+      attribute :x, :point
+      attribute :y, :point
+      attribute :z, :point
     end
-    ```
-    In the above example, the block is either executed immediately if called outside
-    of a transaction, or called after the open transaction is committed.
-    If the transaction is rolled back, the block isn't called.
-    *Jean Boussier*
-*   Add the ability to ignore counter cache columns until they are backfilled.
-    Starting to use counter caches on existing large tables can be troublesome, because the column
-    values must be backfilled separately of the column addition (to not lock the table for too long)
-    and before the use of `:counter_cache` (otherwise methods like `size`/`any?`/etc, which use
-    counter caches internally, can produce incorrect results). People usually use database triggers
-    or callbacks on child associations while backfilling before introducing a counter cache
-    configuration to the association.
-    Now, to safely backfill the column, while keeping the column updated with child records added/removed, use:
-    ```ruby
-    class Comment < ApplicationRecord
-      belongs_to :post, counter_cache: { active: false }
-    end
+    val = PostgresqlPoint.new({
+      x: '(12.34, -43.21)',
+      y: [12.34, '-43.21'],
+      z: {x: '12.34', y: -43.21}
+    })
+    ActiveRecord::Point.new(12.32, -43.21) == val.x == val.y == val.z
     ```
-    While the counter cache is not "active", the methods like `size`/`any?`/etc will not use it,
-    but get the results directly from the database. After the counter cache column is backfilled, simply
-    remove the `{ active: false }` part from the counter cache definition, and it will now be used by the
-    mentioned methods.
-    *fatkodima*
-*   Retry known idempotent SELECT queries on connection-related exceptions.
-    SELECT queries we construct by walking the Arel tree and / or with known model attributes
-    are idempotent and can safely be retried in the case of a connection error. Previously,
-    adapters such as `TrilogyAdapter` would raise `ActiveRecord::ConnectionFailed: Trilogy::EOFError`
-    when encountering a connection error mid-request.
-    *Adrianna Chang*
-*   Allow association's `foreign_key` to be composite.
-    `query_constraints` option was the only way to configure a composite foreign key by passing an `Array`.
-    Now it's possible to pass an Array value as `foreign_key` to achieve the same behavior of an association.
-    *Nikita Vasilevsky*
-*   Allow association's `primary_key` to be composite.
-    Association's `primary_key` can be composite when derived from associated model `primary_key` or `query_constraints`.
-    Now it's possible to explicitly set it as composite on the association.
-    *Nikita Vasilevsky*
+    *Stephen Drew*
-*   Add `config.active_record.permanent_connection_checkout` setting.
+*   Replace `SQLite3::Database#busy_timeout` with `#busy_handler_timeout=`.
-    Controls whether `ActiveRecord::Base.connection` raises an error, emits a deprecation warning, or neither.
+    Provides a non-GVL-blocking, fair retry interval busy handler implementation.
-    `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.
+    *Stephen Margheim*
-    *Jean Boussier*
+*   SQLite3Adapter: Translate `SQLite3::BusyException` into `ActiveRecord::StatementTimeout`.
-*   Deprecate `ActiveRecord::ConnectionAdapters::ConnectionPool#connection`.
+    *Matthew Nguyen*
-    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.
+*   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.
-*   Expose a generic fixture accessor for fixture names that may conflict with Minitest.
+    For example, if you have a migration:
     ```ruby
-    assert_equal "Ruby on Rails", web_sites(:rubyonrails).name
-    assert_equal "Ruby on Rails", fixture(:web_sites, :rubyonrails).name
+    enable_extension "heroku_ext.pgcrypto"
+    enable_extension "pg_stat_statements"
     ```
-    *Jean Boussier*
-*   Using `Model.query_constraints` with a single non-primary-key column used to raise as expected, but with an
-    incorrect error message.
-    This has been fixed to raise with a more appropriate error message.
-    *Joshua Young*
-*   Fix `has_one` association autosave setting the foreign key attribute when it is unchanged.
-    This behavior is also inconsistent with autosaving `belongs_to` and can have unintended side effects like raising
-    an `ActiveRecord::ReadonlyAttributeError` when the foreign key attribute is marked as read-only.
-    *Joshua Young*
-*   Remove deprecated behavior that would rollback a transaction block when exited using `return`, `break` or `throw`.
-    *Rafael Mendonça França*
-*   Deprecate `Rails.application.config.active_record.commit_transaction_on_non_local_return`.
-    *Rafael Mendonça França*
-*   Remove deprecated support to pass `rewhere` to `ActiveRecord::Relation#merge`.
-    *Rafael Mendonça França*
-*   Remove deprecated support to pass `deferrable: true` to `add_foreign_key`.
-    *Rafael Mendonça França*
-*   Remove deprecated support to quote `ActiveSupport::Duration`.
-    *Rafael Mendonça França*
-*   Remove deprecated `#quote_bound_value`.
-    *Rafael Mendonça França*
-*   Remove deprecated `ActiveRecord::ConnectionAdapters::ConnectionPool#connection_klass`.
-    *Rafael Mendonça França*
-*   Remove deprecated support to apply `#connection_pool_list`, `#active_connections?`, `#clear_active_connections!`,
-    `#clear_reloadable_connections!`, `#clear_all_connections!` and `#flush_idle_connections!` to the connections pools
-    for the current role when the `role` argument isn't provided.
-    *Rafael Mendonça França*
-*   Remove deprecated `#all_connection_pools`.
-    *Rafael Mendonça França*
-*   Remove deprecated `ActiveRecord::ConnectionAdapters::SchemaCache#data_sources`.
-    *Rafael Mendonça França*
-*   Remove deprecated `ActiveRecord::ConnectionAdapters::SchemaCache.load_from`.
-    *Rafael Mendonça França*
-*   Remove deprecated `#all_foreign_keys_valid?` from database adapters.
-    *Rafael Mendonça França*
-*   Remove deprecated support to passing coder and class as second argument to `serialize`.
-    *Rafael Mendonça França*
-*   Remove deprecated support to `ActiveRecord::Base#read_attribute(:id)` to return the custom primary key value.
-    *Rafael Mendonça França*
-*   Remove deprecated `TestFixtures.fixture_path`.
-    *Rafael Mendonça França*
-*   Remove deprecated behavior to support referring to a singular association by its plural name.
-    *Rafael Mendonça França*
-*   Deprecate `Rails.application.config.active_record.allow_deprecated_singular_associations_name`.
-    *Rafael Mendonça França*
-*   Remove deprecated support to passing `SchemaMigration` and `InternalMetadata` classes as arguments to
-    `ActiveRecord::MigrationContext`.
-    *Rafael Mendonça França*
-*   Remove deprecated `ActiveRecord::Migration.check_pending!` method.
-    *Rafael Mendonça França*
-*   Remove deprecated `ActiveRecord::LogSubscriber.runtime` method.
-    *Rafael Mendonça França*
-*   Remove deprecated `ActiveRecord::LogSubscriber.runtime=` method.
-    *Rafael Mendonça França*
-*   Remove deprecated `ActiveRecord::LogSubscriber.reset_runtime` method.
-    *Rafael Mendonça França*
-*   Remove deprecated support to define `explain` in the connection adapter with 2 arguments.
-    *Rafael Mendonça França*
-*   Remove deprecated `ActiveRecord::ActiveJobRequiredError`.
-    *Rafael Mendonça França*
-*   Remove deprecated `ActiveRecord::Base.clear_active_connections!`.
-    *Rafael Mendonça França*
-*   Remove deprecated `ActiveRecord::Base.clear_reloadable_connections!`.
-    *Rafael Mendonça França*
-*   Remove deprecated `ActiveRecord::Base.clear_all_connections!`.
-    *Rafael Mendonça França*
-*   Remove deprecated `ActiveRecord::Base.flush_idle_connections!`.
-    *Rafael Mendonça França*
-*   Remove deprecated `name` argument from `ActiveRecord::Base.remove_connection`.
-    *Rafael Mendonça França*
-*   Remove deprecated support to call `alias_attribute` with non-existent attribute names.
-    *Rafael Mendonça França*
-*   Remove deprecated `Rails.application.config.active_record.suppress_multiple_database_warning`.
-    *Rafael Mendonça França*
-*   Add `ActiveRecord::Encryption::MessagePackMessageSerializer`.
-    Serialize data to the MessagePack format, for efficient storage in binary columns.
-    The binary encoding requires around 30% less space than the base64 encoding
-    used by the default serializer.
-    *Donal McBreen*
-*   Add support for encrypting binary columns.
-    Ensure encryption and decryption pass `Type::Binary::Data` around for binary data.
-    Previously encrypting binary columns with the `ActiveRecord::Encryption::MessageSerializer`
-    incidentally worked for MySQL and SQLite, but not PostgreSQL.
-    *Donal McBreen*
-*   Deprecated `ENV["SCHEMA_CACHE"]` in favor of `schema_cache_path` in the database configuration.
-    *Rafael Mendonça França*
-*   Add `ActiveRecord::Base.with_connection` as a shortcut for leasing a connection for a short duration.
-    The leased connection is yielded, and for the duration of the block, any call to `ActiveRecord::Base.connection`
-    will yield that same connection.
-    This is useful to perform a few database operations without causing a connection to be leased for the
-    entire duration of the request or job.
-    *Jean Boussier*
-*   Deprecate `config.active_record.warn_on_records_fetched_greater_than` now that `sql.active_record`
-    notification includes `:row_count` field.
-    *Jason Nochlin*
-*   The fix ensures that the association is joined using the appropriate join type
-    (either inner join or left outer join) based on the existing joins in the scope.
-    This prevents unintentional overrides of existing join types and ensures consistency in the generated SQL queries.
-    Example:
+    then the generated schema dump will also contain:
     ```ruby
-    # `associated` will use `LEFT JOIN` instead of using `JOIN`
-    Post.left_joins(:author).where.associated(:author)
+    enable_extension "heroku_ext.pgcrypto"
+    enable_extension "pg_stat_statements"
     ```
-    *Saleh Alhaddad*
+    *Tony Novak*
-*   Fix an issue where `ActiveRecord::Encryption` configurations are not ready before the loading
-    of Active Record models, when an application is eager loaded. As a result, encrypted attributes
-    could be misconfigured in some cases.
-    *Maxime Réty*
+*   Fix `ActiveRecord::Encryption::EncryptedAttributeType#type` to return
+    actual cast type.
-*   Deprecate defining an `enum` with keyword arguments.
+    *Vasiliy Ermolovich*
-    ```ruby
-    class Function > ApplicationRecord
-      # BAD
-      enum color: [:red, :blue],
-           type: [:instance, :class]
-      # GOOD
-      enum :color, [:red, :blue]
-      enum :type, [:instance, :class]
-    end
-    ```
+*   SQLite3Adapter: Bulk insert fixtures.
-    *Hartley McGuire*
+    Previously one insert command was executed for each fixture, now they are
+    aggregated in a single bulk insert command.
-*   Add `config.active_record.validate_migration_timestamps` option for validating migration timestamps.
+    *Lázaro Nixon*
-    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.
+*   PostgreSQLAdapter: Allow `disable_extension` to be called with schema-qualified name.
-    *Adrianna Chang*
+    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"`.
-*   Properly synchronize `Mysql2Adapter#active?` and `TrilogyAdapter#active?`.
+    *Tony Novak*
-    As well as `disconnect!` and `verify!`.
+*   Make `create_schema` / `drop_schema` reversible in migrations.
-    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.
+    Previously, `create_schema` and `drop_schema` were irreversible migration operations.
-    *Jean Boussier*
+    *Tony Novak*
-*   Support `:source_location` tag option for query log tags.
+*   Support batching using custom columns.
     ```ruby
-    config.active_record.query_log_tags << :source_location
+    Product.in_batches(cursor: [:shop_id, :id]) do |relation|
+      # do something with relation
+    end
     ```
-    Calculating the caller location is a costly operation and should be used primarily in development
-    (note, there is also a `config.active_record.verbose_query_logs` that serves the same purpose)
-    or occasionally on production for debugging purposes.
     *fatkodima*
-*   Add an option to `ActiveRecord::Encryption::Encryptor` to disable compression.
-    Allow compression to be disabled by setting `compress: false`
-    ```ruby
-      class User
-        encrypts :name, encryptor: ActiveRecord::Encryption::Encryptor.new(compress: false)
-      end
-    ```
-    *Donal McBreen*
-*   Deprecate passing strings to `ActiveRecord::Tasks::DatabaseTasks.cache_dump_filename`.
-    A `ActiveRecord::DatabaseConfigurations::DatabaseConfig` object should be passed instead.
-    *Rafael Mendonça França*
+*   Use SQLite `IMMEDIATE` transactions when possible.
-*   Add `row_count` field to `sql.active_record` notification.
+    Transactions run against the SQLite3 adapter default to IMMEDIATE mode to improve concurrency support and avoid busy exceptions.
-    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*
+    *Stephen Margheim*
-*   Add `<role>_types` class method to `ActiveRecord::DelegatedType` so that the delegated types can be introspected.
+*   Raise specific exception when a connection is not defined.
-    *JP Rosevear*
+    The new `ConnectionNotDefined` exception provides connection name, shard and role accessors indicating the details of the connection that was requested.
-*   Make `schema_dump`, `query_cache`, `replica` and `database_tasks` configurable via `DATABASE_URL`.
+    *Hana Harencarova*, *Matthew Draper*
-    This wouldn't always work previously because boolean values would be interpreted as strings.
+*   Delete the deprecated constant `ActiveRecord::ImmutableRelation`.
-    e.g. `DATABASE_URL=postgres://localhost/foo?schema_dump=false` now properly disable dumping the schema
-    cache.
+    *Xavier Noria*
-    *Mike Coutermarsh*, *Jean Boussier*
+*   Fix duplicate callback execution when child autosaves parent with `has_one` and `belongs_to`.
-*   Introduce `ActiveRecord::Transactions::ClassMethods#set_callback`.
+    Before, persisting a new child record with a new associated parent record would run `before_validation`,
+    `after_validation`, `before_save` and `after_save` callbacks twice.
-     It is identical to `ActiveSupport::Callbacks::ClassMethods#set_callback`
-     but with support for `after_commit` and `after_rollback` callback options.
+    Now, these callbacks are only executed once as expected.
     *Joshua Young*
-*   Make `ActiveRecord::Encryption::Encryptor` agnostic of the serialization format used for encrypted data.
-    Previously, the encryptor instance only allowed an encrypted value serialized as a `String` to be passed to the message serializer.
-    Now, the encryptor lets the configured `message_serializer` decide which types of serialized encrypted values are supported. A custom serialiser is therefore allowed to serialize `ActiveRecord::Encryption::Message` objects using a type other than `String`.
-    The default `ActiveRecord::Encryption::MessageSerializer` already ensures that only `String` objects are passed for deserialization.
-    *Maxime Réty*
-*   Fix `encrypted_attribute?` to take into account context properties passed to `encrypts`.
-    *Maxime Réty*
-*   The object returned by `explain` now responds to `pluck`, `first`,
-    `last`, `average`, `count`, `maximum`, `minimum`, and `sum`. Those
-    new methods run `EXPLAIN` on the corresponding queries:
+*   `ActiveRecord::Encryption::Encryptor` now supports a `:compressor` option to customize the compression algorithm used.
     ```ruby
-    User.all.explain.count
-    # EXPLAIN SELECT COUNT(*) FROM `users`
-    # ...
-    User.all.explain.maximum(:id)
-    # EXPLAIN SELECT MAX(`users`.`id`) FROM `users`
-    # ...
-    ```
-    *Petrik de Heus*
-*   Fixes an issue where `validates_associated` `:on`  option wasn't respected
-    when validating associated records.
-    *Austen Madden*, *Alex Ghiculescu*, *Rafał Brize*
-*   Allow overriding SQLite defaults from `database.yml`.
+    module ZstdCompressor
+      def self.deflate(data)
+        Zstd.compress(data)
+      end
-    Any PRAGMA configuration set under the `pragmas` key in the configuration
-    file takes precedence over Rails' defaults, and additional PRAGMAs can be
-    set as well.
+      def self.inflate(data)
+        Zstd.decompress(data)
+      end
+    end
-    ```yaml
-    database: storage/development.sqlite3
-    timeout: 5000
-    pragmas:
-      journal_mode: off
-      temp_store: memory
+    class User
+      encrypts :name, compressor: ZstdCompressor
+    end
     ```
-    *Stephen Margheim*
-*   Remove warning message when running SQLite in production, but leave it unconfigured.
-    There are valid use cases for running SQLite in production. However, it must be done
-    with care, so instead of a warning most users won't see anyway, it's preferable to
-    leave the configuration commented out to force them to think about having the database
-    on a persistent volume etc.
-    *Jacopo Beschi*, *Jean Boussier*
-*   Add support for generated columns to the SQLite3 adapter.
-    Generated columns (both stored and dynamic) are supported since version 3.31.0 of SQLite.
-    This adds support for those to the SQLite3 adapter.
+    You disable compression by passing `compress: false`.
     ```ruby
-    create_table :users do |t|
-      t.string :name
-      t.virtual :name_upper, type: :string, as: 'UPPER(name)'
-      t.virtual :name_lower, type: :string, as: 'LOWER(name)', stored: true
+    class User
+      encrypts :name, compress: false
     end
     ```
-    *Stephen Margheim*
-*   TrilogyAdapter: ignore `host` if `socket` parameter is set.
-    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
-    ```
+    *heka1024*
-    *Jean Boussier*
+*   Add condensed `#inspect` for `ConnectionPool`, `AbstractAdapter`, and
+    `DatabaseConfig`.
-*   Make `assert_queries_count`, `assert_no_queries`, `assert_queries_match`, and
-    `assert_no_queries_match` assertions public.
+    *Hartley McGuire*
-    To assert the expected number of queries are made, Rails internally uses `assert_queries_count` and
-    `assert_no_queries`. To assert that specific SQL queries are made, `assert_queries_match` and
-    `assert_no_queries_match` are used. These assertions can now be used in applications as well.
+*   Add `.shard_keys`, `.sharded?`, & `.connected_to_all_shards` methods.
     ```ruby
-    class ArticleTest < ActiveSupport::TestCase
-      test "queries are made" do
-        assert_queries_count(1) { Article.first }
-      end
+    class ShardedBase < ActiveRecord::Base
+        self.abstract_class = true
-      test "creates a foreign key" do
-        assert_queries_match(/ADD FOREIGN KEY/i, include_schema: true) do
-          @connection.add_foreign_key(:comments, :posts)
-        end
-      end
+        connects_to shards: {
+          shard_one: { writing: :shard_one },
+          shard_two: { writing: :shard_two }
+        }
     end
-    ```
-    *Petrik de Heus*, *fatkodima*
-*   Fix `has_secure_token` calls the setter method on initialize.
-    *Abeid Ahmed*
-*   When using a `DATABASE_URL`, allow for a configuration to map the protocol in the URL to a specific database
-    adapter. This allows decoupling the adapter the application chooses to use from the database connection details
-    set in the deployment environment.
+    class ShardedModel < ShardedBase
+    end
-    ```ruby
-    # ENV['DATABASE_URL'] = "mysql://localhost/example_database"
-    config.active_record.protocol_adapters.mysql = "trilogy"
-    # will connect to MySQL using the trilogy adapter
+    ShardedModel.shard_keys => [:shard_one, :shard_two]
+    ShardedModel.sharded? => true
+    ShardedBase.connected_to_all_shards { ShardedModel.current_shard } => [:shard_one, :shard_two]
     ```
-    *Jean Boussier*, *Kevin McPhillips*
-*   In cases where MySQL returns `warning_count` greater than zero, but returns no warnings when
-    the `SHOW WARNINGS` query is executed, `ActiveRecord.db_warnings_action` proc will still be
-    called with a generic warning message rather than silently ignoring the warning(s).
-    *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).
-    *João Alves*
+    *Nony Dutton*
-*   Make the output of `ActiveRecord::Core#inspect` configurable.
+*   Add a `filter` option to `in_order_of` to prioritize certain values in the sorting without filtering the results
+    by these values.
-    By default, calling `inspect` on a record will yield a formatted string including just the `id`.
-    ```ruby
-    Post.first.inspect #=> "#<Post id: 1>"
-    ```
+    *Igor Depolli*
-    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.