Rails 7.2.0 Active Record CHANGELOG（全項目リンク付き）
更新103件（うち非推奨削除29件）
sql.active_recordのActive Support通知のペイロードが、:transactionキー内の現在のトランザクションを含むようになった
Xavier Noria
transaction.active_recordののActive Support通知のペイロードが、:transactionキーに関連するイベントのトランザクションを含むようになった
Xavier Noria
- データベーストランザクションのUUIDを返す
ActiveRecord::Transaction#uuidを定義した
これは、データベースの活動をトレースするときに役立つ可能性がある。これらのUUIDはオンデマンドでのみ生成される。
Xavier Noria
- 名前空間ありのモデルに関連付けられる、名前空間のない同じ名前のモデル名を正しく推論できるよう修正
以下のセットアップ例で考える。
class Nested::Post < ApplicationRecord
has_one :post, through: :other
end
修正前は、この#postがNested::Postと推論されてしまっていたが、修正後は正しくPostと推論されるようになった。
Joshua Young
- PostgreSQLの
Cidr#change?でIPアドレスのプレフィックスの変更を検出するよう修正。
Taketo Takashima
BatchEnumerator#destroy_allが、影響を受ける行の総数を返すよう変更。
修正前は常にnilを返していた。
fatkodima
in_batchesでtouch_allをサポート。
Post.in_batches.touch_all
fatkodima
参考: Rails API in_batches -- ActiveRecord::Batches
参考: Rails API touch_all -- ActiveRecord::Relation
- （PostgreSQL）
create_schemaで:if_not_existsオプションと:forceオプションをサポート。
fatkodima
index_errorsが関連付けのバリデーションエラーでインデックスが無効になっていたのを修正。
lulalala
index_errors: :nested_attributes_orderモードを追加。
この変更によって、ネステッド属性セッターで受け取った順序に基づく関連付けバリデーションエラーのインデックスが作成され、reject_if設定を尊重するようになる。これにより、バリデーションエラーをフォームの個別のフィールドにマッピングするのに十分な情報をAPIからフロントエンドに提供可能になる。
lulalala
Rails.application.config.active_record.postgresql_adapter_decode_datesコンフィグを追加。これはPostgreSQLアダプタでdatesの自動デコードをオプトアウトする（デフォルトはtrue）。
Joé Dupuis
- 関連付けの
query_constraintsオプションが非推奨化。今後はforeign_keyを使うこと。
Nikita Vasilevsky
参考: 週刊Railsウォッチ20240514: Active Recordで再帰的CTEをサポート
ENV["SKIP_TEST_DATABASE_TRUNCATE"]フラグを追加。すべてのテストがデフォルトのトランザクション内で実行される場合に、大規模DBでのマルチプロセステストの実行を高速化する。
これにより、HEYのテストが178個のテーブルに対して24個のプロセスで実行され、最大4,000個のテーブルでtruncate_tablesがスキップ可能になり、テスト実行が約10秒短縮される。
DHH
- Active Recordで再帰的CTE（common table expressions）のサポートを追加。
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'),
]
)
上によって以下の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
- マイグレーションの
change_tableでvalidate_constraintを呼び出し可能になった。
例:
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
参考: 週刊Railsウォッチ20240514: PostgreSQLアダプタにDateへのデコード機能が追加
PostgreSQLAdapterがdate型のカラムを文字列ではなくDateにデコードするようになった。
例:
ActiveRecord::Base.connection
.select_value("select '2024-01-01'::date").class #=> Date
Joé Dupuis
strict_loading!にmode: :n_plus_one_onlyオプションを指定することで、子の関連付けをeager loadingしないようになった。
この変更によって子の関連付けがeager loadingされなくなって振る舞いが期待通りになり、firstやlastなどのメソッド呼び出しで順序が一定にならない問題を防止する。firstやlastそれ自体はN+1問題を引き起こさないので、子の関連付けを呼び出してもraiseしなくなる。
修正: #49473
改修前:
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 # ActiveRecord::StrictLoadingViolationErrorをraiseする
改修後:
person = Person.find(1)
person.strict_loading!(mode: :n_plus_one_only)
person.posts.first # これは1+1（N+1ではない）
# SELECT * FROM posts WHERE person_id = 1 ORDER BY id LIMIT 1;
person.posts.first.firm # raiseしなくなる
Reid Lynch
参考: Rails API strict_loading! -- ActiveRecord::Core
Sqlite3Adapterでsqlite3 gemの2.xを利用可能になった。
Mike Dalessio
ActiveRecord::Base#pluckにハッシュ値を渡せるようになった。
# 改修前
Post.joins(:comments).pluck("posts.id", "comments.id", "comments.body")
# 改修後
Post.joins(:comments).pluck(posts: [:id], comments: [:id, :body])
fatkodima
Rails 7.2: ActiveRecord::Base#pluckにハッシュ値を渡せるようになった（翻訳）
週刊Railsウォッチ20240416: AbstractMysqlAdapterで適切なエラーがraiseされるよう修正
- MySQLデータベースが返すバージョン文字列が無効な場合は
ActiveRecord::ActiveRecordErrorをraiseするよう修正。
Kevin McPhillips
参考: 週刊Railsウォッチ20240416: トランザクションブロックの中で当該トランザクションのコールバックを登録可能になった
ActiveRecord::Base.transactionがActiveRecord::Transactionオブジェクトをyieldするようになった。
Article.transaction do |transaction|
article.update(published: true)
transaction.after_commit do
PublishNotificationMailer.with(article: article).deliver_later
end
end
Jean Boussier
ActiveRecord::Base.current_transactionが追加された。
現在のトランザクションを返すことで、そこにコールバックを登録可能にする。
Article.current_transaction.after_commit do
PublishNotificationMailer.with(article: article).deliver_later
end
Jean Boussier
参考: 週刊Railsウォッチ20240416: ジョブのエンキューをトランザクション完了時まで自動先延ばしするようになった
ActiveRecord.after_all_transactions_commitコールバックを追加。
トランザクションの内部か外部のどちらかで実行される可能性のあるコードで、ステートの変更が適切に永続化されてから処理を実行しなければならない場合に有用。
def publish_article(article)
article.update(published: true)
ActiveRecord.after_all_transactions_commit do
PublishNotificationMailer.with(article: article).deliver_later
end
end
上のコード例のブロックは、トランザクションの外で呼び出されるとただちに実行されるか、オープントランザクションがコミットされた後に呼び出されるか、のどちらかになる。
トランザクションがロールバックした場合、ブロックは呼び出されない。
Jean Boussier
参考: 週刊Railsウォッチ20240416: カウンタキャッシュからの読み出しをcounter_cache: { active: false }で制御できるようになった
- カウンタキャッシュがバックフィルされるまでカウンタキャッシュカラムを無視できる機能を追加。
既存の巨大なテーブルでカウンタキャッシュを使い始めると厄介になることがある。カラムの追加とは別に、 :counter_cacheを使う前にはカラムの値をバックフィル（埋め戻し）しておかなければならない(テーブルが長時間ロックされないようにするために必要)。さもないと、内部カウンタキャッシュを利用しているsizeやany?などのメソッドが誤った結果を生成する可能性がある。関連付けにカウンタキャッシュ構成を導入する前には、バックフィル中に子関連付けでデータベーストリガーまたはコールバックを使うことが多い。
改修の結果、子レコードの追加や削除のときに次のように書いておくことで、カラムを更新済みのままカラムを安全にバックフィルできるようになった。
class Comment < ApplicationRecord
belongs_to :post, counter_cache: { active: false }
end
カウンタキャッシュが"active"でない場合、sizeやany?などのメソッドはカウンタキャッシュを使わなくなり、データベースから直接結果を取得する。カウンタキャッシュのカラムでバックフィルが完了した後は、カウンタキャッシュの定義から{ active: false }を削除するだけで、sizeやany?などのメソッドでカウンタキャッシュが使われるようになる。
fatkodima
参考: 週刊Railsウォッチ20240409: 特定のクエリメソッドやArelでallow_retryオプションを指定可能になった
- コネクションに関連する例外で、冪等（べきとう: idempotent）であることがわかっているSELECTクエリをリトライできるようになった。
自分たち開発者がArelツリーをたどってビルドしたSELECTクエリや、モデルの既知の属性を用いてビルドしたSELECTクエリは冪等であり、コネクションエラー時でも安全にリトライできる。従来は、リクエスト中にコネクションエラーが発生するとTrilogyAdapterでActiveRecord::ConnectionFailed: Trilogy::EOFErrorが発生することがあった。
Adrianna Chang
- 関連付けの
foreign_keyが複合可能になった。
従来、複合外部キーを設定するには、query_constraintsオプションにArrayを渡すしか方法がなかった。
この改修によって、Array値をforeign_keyとして渡すことで関連付けで同じ振る舞いを得られる。
Nikita Vasilevsky
- 関連付けの
primary_keyが複合可能になった（配列を渡せるようになった）。
関連付けのprimary_keyは、関連付けられるモデルのprimary_keyまたはquery_constraintsから導出されたときに複合可能になる。
改修によって、関連付けのprimary_keyに明示的に複合として設定可能になった。
Nikita Vasilevsky
参考: 週刊Railsウォッチ20240409: config.active_record.permanent_connection_checkoutが追加
config.active_record.permanent_connection_checkout設定が追加された。これは、ActiveRecord::Base.connectionが「エラーを発生させる」「非推奨警告を表示する」「どちらも行わない」のどれにするかを制御する。
ActiveRecord::Base.connectionは、そのコネクションのプールからデータベースコネクションをチェックアウトして、リクエストやジョブが完了するまでリース中（貸出中、専有中）のままにする。この振る舞いは、利用可能なコネクション数よりも多くのスレッドやfiberが使われる環境では望ましくない場合がある。
このActiveRecord::Base.connectionコンフィグを使うと、ActiveRecord::Base.connectionをトラッキングして削除し、ActiveRecord::Base.with_connectionを代わりに使う形で移行しようと思えばできるようになる。
このコンフィグのデフォルトの振る舞いは変更されておらず、現時点ではデフォルトの振る舞いを変更する予定はない。
Jean Boussier
参考: 週刊Railsウォッチ20240312: uncachedメソッドにdirtiesオプションを追加
uncachedメソッドにdirtiesオプションを追加。
true（デフォルト）に設定すると、書き込みで現在のスレッドに属するすべてのクエリキャッシュがクリアされる。
falseに設定すると、影響を受けるコネクションプールへの書き込みでクエリキャッシュがクリアされなくなる。
これは、Solid Cacheでキャッシュ書き込みによってクエリキャッシュがクリアされないようにするために必要。
Donal McBreen
参考: 週刊Railsウォッチ20240312: RailsのテストスイートにあるBase.connectionをwith_connectionやlease_connectionに置き換えた
ActiveRecord::Base.connectionが非推奨化、今後は.lease_connectionを利用すること。
メソッド名がlease_connectionにリネームされ、返されたコネクションがリクエストやジョブの処理中は維持されることがより明確になった。
これはソフトな非推奨化であり、警告は表示されない。また、このメソッドを削除する予定も今のところない。
Jean Boussier
ActiveRecord::ConnectionAdapters::ConnectionPool#connectionを非推奨化。
メソッド名がlease_connectionにリネームされ、返されたコネクションがリクエストやジョブの処理中は維持されることがより明確になった。
Jean Boussier
参考: 週刊Railsウォッチ20240312: 汎用のfixtureアクセサを追加
- minitestと競合する可能性のあるfixture名に対応するため、汎用の
fixtureアクセサを公開する。
assert_equal "Ruby on Rails", web_sites(:rubyonrails).name
assert_equal "Ruby on Rails", fixture(:web_sites, :rubyonrails).name
Jean Boussier
参考: 週刊Railsウォッチ20240312: 主キーでない単一のカラムでModel.query_constraintsのエラーメッセージを修正
- 主キーでない単一のカラムで
Model.query_constraintsをraiseされるのは期待通りだが、そのエラーメッセージが正しくなかった。
適切なエラーメッセージを表示するよう修正した。
Joshua Young
参考: 週刊Railsウォッチ20240306: has_one関連付けの自動保存のバグを修正
外部キー属性が変更されていない場合に設定されるhas_one関連付けの自動保存を修正。
この振る舞いはbelongs_toの自動保存とも一貫しておらず、外部キー属性がread-onlyとマーキングされている場合にActiveRecord::ReadOnlyAttributeErrorなどの意図しない副作用が発生する可能性がある。
Joshua Young
参考: Rails 7.1.0 Active Record CHANGELOG（翻訳）
参考: 週刊Railsウォッチ20230809: トランザクションがreturn、break、throwでコミットするようになった
- トランザクションブロックを
return、break、またはthrowで終了したときにロールバックする非推奨の振る舞いを削除。
Rafael Mendonça França
Rails.application.config.active_record.commit_transaction_on_non_local_returnを非推奨化。
Rafael Mendonça França
ActiveRecord::Relation#mergeにrewhereオプションを渡す非推奨化サポートを削除。
Rafael Mendonça França
参考: 週刊Railsウォッチ20230913: mergeにrewhereオプションを渡すことが非推奨化された
add_foreign_keyにdeferrable: trueを渡せる非推奨化サポートを削除。
Rafael Mendonça França
参考: 週刊Railsウォッチ20230524: add_foreign_keyのdeferrable: trueオプションを非推奨化する
参考: Rails 7.1.0 Active Record CHANGELOG（翻訳） -- ActiveSupport::Durationを整数値として式展開することを非推奨化
ActiveSupport::Durationを整数値として式展開する非推奨化サポートを削除。
Rafael Mendonça França
- 非推奨化されていた
#quote_bound_valueを削除。
Rafael Mendonça França
- 非推奨化されていた
ActiveRecord::ConnectionAdapters::ConnectionPool#connection_klassを削除。
Rafael Mendonça França
role引数が指定されていない場合に以下を現在のロールのコネクションプールに適用する非推奨サポートを削除。
#connection_pool_list#active_connections?#clear_active_connections!#clear_reloadable_connections!#clear_all_connections!#flush_idle_connections!
Rafael Mendonça França
- 非推奨化されていた
#all_connection_poolsを削除。
Rafael Mendonça França
- 非推奨化されていた
ActiveRecord::ConnectionAdapters::SchemaCache#data_sourcesを削除。
Rafael Mendonça França
- 非推奨化されていた
ActiveRecord::ConnectionAdapters::SchemaCache.load_fromを削除。
Rafael Mendonça França
参考: 週刊Railsウォッチ20230502: fixture読み込み時の外部キーエラーの理由を表示するようになった
- 非推奨化されていた
#all_foreign_keys_valid?をデータベースアダプタから削除。
Rafael Mendonça França
参考: 週刊Railsウォッチ20230314: デフォルトのカラムシリアライザを定義可能になった
serializeの第2引数にコーダーやクラスを渡せる非推奨化サポートを削除。
Rafael Mendonça França
参考: 週刊Railsウォッチ20230906: 主キーが:idでない場合に主キーを返すread_attribute(:id)を非推奨化
ActiveRecord::Base#read_attribute(:id)がカスタム主キーの値を返す非推奨化サポートを削除。
Rafael Mendonça França
参考: 週刊Railsウォッチ20230405: fixtureパスをRailsエンジン単位で指定可能になった
参考: 週刊Railsウォッチ20230412: TestFixturesをincludeするたびにloadフックを実行するように修正
参考: 週刊Railsウォッチ20230613: fixture_pathsにエンジンのtest/fixturesを自動追加するようになった
- 非推奨化されていた
TestFixtures.fixture_path（単数形）を削除。
Rafael Mendonça França
参考: 週刊Railsウォッチ20220704: 関連付け先の単数形の名前をwhere内から複数形で参照すると警告を出す
- 単数形の関連付け名を複数形の名前で参照できる非推奨化された振る舞いを削除。
Rafael Mendonça França
Rails.application.config.active_record.allow_deprecated_singular_associations_nameを非推奨化。
Rafael Mendonça França
ActiveRecord::MigrationContextの第2引数にSchemaMigrationクラスやInternalMetadataクラスを渡せる非推奨サポートを削除。
Rafael Mendonça França
- 非推奨化されていた
ActiveRecord::Migration.check_pendingメソッドを削除。
Rafael Mendonça França
- 非推奨化されていた
ActiveRecord::LogSubscriber.runtimeメソッドを削除。
Rafael Mendonça França
- 非推奨化されていた
ActiveRecord::LogSubscriber.runtime=メソッドを削除。
Rafael Mendonça França
- 非推奨化されていた
ActiveRecord::LogSubscriber.reset_runtimeメソッドを削除。
Rafael Mendonça França
- コネクションアダプタ内で
explainに2つの引数を渡せる非推奨化サポートを削除。
Rafael Mendonça França
- 非推奨化されていた
ActiveRecord::ActiveJobRequiredErrorを削除。
Rafael Mendonça França
- 非推奨化されていた
ActiveRecord::Base.clear_active_connections!を削除。
Rafael Mendonça França
- 非推奨化されていた
ActiveRecord::Base.clear_reloadable_connections!を削除。
Rafael Mendonça França
- 非推奨化されていた
ActiveRecord::Base.clear_all_connections!を削除。
Rafael Mendonça França
- 非推奨化されていた
ActiveRecord::Base.flush_idle_connections!を削除。
Rafael Mendonça França
ActiveRecord::Base.remove_connectionで非推奨化されていたname引数を削除。
Rafael Mendonça França
alias_attributeに存在しない属性名を渡して呼び出せる非推奨化サポートを削除。
Rafael Mendonça França
- 非推奨化されていた
Rails.application.config.active_record.suppress_multiple_database_warningを削除。
Rafael Mendonça França
ActiveRecord::Encryption::MessagePackMessageSerializerを追加。
データをMessagePack形式にシリアライズする（バイナリカラムに効率よく保存できるため）。
このバイナリエンコーディングで必要な容量は、デフォルトのシリアライザで使われるBase64エンコーディングと比較して30%少なく済む。
Donal McBreen
参考: 週刊Railsウォッチ20240228: バイナリカラムの暗号化をサポート
暗号化と復号でバイナリデータをType::Binary::Dataで受け渡しするようにする。
従来は、バイナリカラムをActiveRecord::Encryption::MessageSerializerで暗号化すると、MySQLやSQLiteでは動作するがPostgreSQLでは動作しなかった。
Donal McBreen
- データベース設定での
ENV["SCHEMA_CACHE"]の利用が非推奨化された。今後は schema_cache_pathを使うこと。
Rafael Mendonça França
参考: 週刊Railsウォッチ20240228: ActiveRecord::Base.with_connectionを追加
- コネクションを短い時間だけリースするショートカットとして
ActiveRecord::Base.with_connectionを追加する。
リースされたコネクションがyieldされると、ブロックの実行中はActiveRecord::Base.connectionで同じコネクションがyieldされる。
これは、リクエストやジョブの継続中コネクションをリースし続けることなく、複数のデータベース操作を実行したい場合に有用。
Jean Boussier
config.active_record.warn_on_records_fetched_greater_than を非推奨化（sql.active_recordの通知に:row_countフィールドが含まれるようになったことを受けて）。
Jason Nochlin
参考: 週刊Railsウォッチ20240306: where.associatedのバグを修正
この修正によって、スコープ内の既存のJOINに基づいて、適切なJOIN種別（INNER JOINまたはLEFT OUTER JOIN）を用いて関連付けがJOINされるようになる。
これにより、既存のJOIN種別が意図せずオーバーライドされることを防ぎ、一貫したSQLクエリが生成されるようになる。
例:
# `associated`では`JOIN`ではなく`LEFT JOIN`が使われる
Post.left_joins(:author).where.associated(:author)
Saleh Alhaddad
アプリケーションがeager loadingされるときに、Active Recordモデルが読み込まれる前にActiveRecord::Encryptionコンフィグが準備されない問題を修正。このために暗号化属性が誤って設定されるケースが生じていた。
Maxime Réty
enumの定義でキーワード引数を利用することが非推奨化された。
class Function > ApplicationRecord
# BAD
enum color: [:red, :blue],
type: [:instance, :class]
# GOOD
enum :color, [:red, :blue]
enum :type, [:instance, :class]
end
Hartley McGuire
config.active_record.validate_migration_timestampsオプションを追加（マイグレーションのタイムスタンプをバリデーションするかどうかを指定）
このオプションが設定されると、マイグレーションのタイムスタンプのプレフィックスが、現在の時刻に関連付けられたタイムスタンプから1日以内に収まることをバリデーションする。これは、マイグレーションのプレフィックスを手動で未来のタイムスタンプに編集したときに、マイグレーションの生成などのマイグレーションコマンドに影響するのを防ぐために設計されている。
Adrianna Chang
参考: 週刊Railsウォッチ20240221: Mysql2Adapter#active?とTrilogyAdapter#active?が正しく同期するよう修正
Mysql2Adapter#active?とTrilogyAdapter#active?が正しく同期するよう修正
disconnect!とverify!についても同様。
コネクションはスレッド間で共有されないはずなので、これは一般に大きな問題ではないが、トランザクションテストやシステムテストを実行する場合にはこれが要求されるため、SEGVが発生する可能性がある。
Jean Boussier
参考: 週刊Railsウォッチ20240221: クエリログで:source_locationをサポート
- クエリログのタグで
:source_locationタグオプションをサポート
config.active_record.query_log_tags << :source_location
呼び出し元の計算はコストの高い操作なので、基本的にdevelopment環境で使う（同じ目的を果たすconfig.active_record.verbose_query_logsもあることに注意）べき。production環境でデバッグ目的に使う場合は短期間にとどめるべき。
fatkodima
参考: 週刊Railsウォッチ20240221: ActiveRecord::Encryptionの暗号化で圧縮をオフにできるようになった
- 圧縮を無効にするオプションを
ActiveRecord::Encryption::Encryptorに追加する。
compress: falseを設定することで、圧縮を無効にできる
class User
encrypts :name, encryptor: ActiveRecord::Encryption::Encryptor.new(compress: false)
end
Donal McBreen
ActiveRecord::Tasks::DatabaseTasks.https://github.com/marvin-bitterlichcache_dump_filenameに文字列を渡すことを非推奨化
ActiveRecord::DatabaseConfigurations::DatabaseConfigオブジェクトを渡すべき。
Rafael Mendonça França
参考: 週刊Railsウォッチ20240221: ActiveSupport::Notificationsのsql.active_recordにrow_countフィールドを追加
sql.active_record通知にrow_countフィールドを追加
このフィールドは、通知を発行したクエリによって返された行数を返す。
このメトリクスは、大きな結果セットを含むクエリを検出したい場合に有用。
Marvin Bitterlich
参考: 週刊Railsウォッチ20240215: NestedAttributesで、渡した引数の種類によってエラーメッセージが異なっていたのを修正
- ネステッド属性関連付けライター（writer）に無効な引数を渡すと、常に
ArgumentErrorが発生するよう修正
従来、このエラーはコレクション（複数形）の関連付けでしか発生せず、単数形の関連付けでは一般的なエラーを発生していた。
修正後は、コレクションと単数形の両方の関連付けでArgumentErrorが発生するようになった。
Joshua Young
- デフォルトで生成されるMySQLカラムの一重引用符が二重エスケープされていたのを修正。
MySQL 5.7.5 以降では、式から計算されるカラム作成に利用可能な生成カラム（generated column）がサポートされている。
修正前のスキーマダンプでは、デフォルトの式で生成カラムが一重引用符''を含んでいると、二重エスケープされた文字列を出力していた。
これにより、MySQLデータベースの新しいインスタンスにスキーマをインポートするときに問題が発生していた。
修正後は文字列がエスケープされず、スキーマのインポート時に有効な Rubyコードになる。
Yash Kapadia
注: この修正はRails 7.1.3で既にリリースされていますが、このChangelogに修正が加えられています。
- マイグレーションのバージョンが7.1よりも古い場合に
add_referenceや t.referencesで指定されるオプションがバリデーションされていたのを修正
Hartley McGuire
参考: 週刊Railsウォッチ20240215: ActiveRecord::DelegatedTypeに<role>_typesクラスメソッドが追加
DelegatedTypeのイントロスペクションを可能にするため、<role>_typesクラスメソッドを ActiveRecord::DelegatedTypeに追加する
JP Rosevear
参考: 週刊Railsウォッチ20240215: schema_dumpなどをDATABASE_URLでコンフィグ可能になった
DATABASE_URLでschema_dump、query_cache、replica、database_tasksを設定可能になった
従来は、ブーリアン値が文字列として解釈されたせいで設定できない場合があった。
改修後は、DATABASE_URL=postgres://localhost/foo?schema_dump=falseのように書けばスキーマキャッシュのダンプを正しく無効にできるようになった。
Mike Coutermarsh, Jean Boussier
参考: 週刊Railsウォッチ20240206: after_commitコールバックやafter_rollbackコールバックでon: :updateなどを指定可能になった
ActiveRecord::Transactions::ClassMethods#set_callbackを導入
このクラスメソッドは、after_commitコールバックやafter_rollbackコールバックで:onオプションをサポートする他は、ActiveSupport::Callbacks::ClassMethods#set_callbackと同一。
Joshua Young
ActiveRecord::Encryption::Encryptorが、暗号化データで使われるシリアライズ形式に影響されないようになった
修正前の暗号化インスタンスでは、Stringとしてシリアライズされた暗号化済み値でなければメッセージシリアライザに渡せなかった。
修正後は、でサポートされる暗号化済みシリアライズ値の型が、指定したmessage_serializerによって決定されるようになった。これにより、カスタムシリアライザがString以外の型を指定してActiveRecord::Encryption::Messageオブジェクトをシリアライズ可能になった。
既にデフォルトのActiveRecord::Encryption::MessageSerializerでは、デシリアライズでStringオブジェクトだけが渡されるようになっている。
Maxime Réty
注: この修正はRails 7.1.3で既にリリースされています。
encryptsに渡したコンテキストプロパティがencrypted_attribute?で考慮されるよう修正。
Maxime Réty
参考: 週刊Railsウォッチ20240206: last、pluck、countなどでもexplainを使えるようになった
explainが返すオブジェクトがpluck、first、last、average、count、maximum、minimum、sumに応答するようになった
これらの新しいメソッドは、対応するクエリでEXPLAINを実行する。
User.all.explain.count
# EXPLAIN SELECT COUNT(*) FROM `users`
# ...
User.all.explain.maximum(:id)
# EXPLAIN SELECT MAX(`users`.`id`) FROM `users`
# ...
Petrik de Heus
-validates_associatedが使われる場合は:onオプションでバリデーションするよう修正
関連付けられるレコードのバリデーションでvalidates_associated :onオプションが考慮されていなかった問題を修正。
Austen Madden, Alex Ghiculescu, Rafał Brize
database.ymlでSQLiteのデフォルト設定をオーバーライド可能になった
database.yml設定ファイル内のpragmasキー以下に書いたPRAGMA設定がRailsのデフォルトより優先されるようになり、追加のPRAGMAも設定されるようになった。
database: storage/development.sqlite3
timeout: 5000
pragmas:
journal_mode: off
temp_store: memory
Stephen Margheim
- SQLiteをproduction環境で実行するときの警告メッセージを表示するのをやめ、SQLiteを未設定のままにするようになった
SQliteをproduction環境で実行する有効なユースケースはいくつもあるが、利用は慎重に行わなければならない。そこで、ほとんどのユーザーが見ることのない警告を表示するよりも、SQLiteコンフィグをコメントアウトしたままにすることで、データベースを何らかの永続化ボリュームに置くことをユーザーに強制的に考えさせる方が望ましい。
Jacopo Beschi, Jean Boussier
参考: 週刊Railsウォッチ20240117: SQLite3アダプタに生成カラム（generated columns）のサポートを追加
- SQLite3アダプタに生成カラムのサポートを追加
生成カラムは（storedおよびdynamicの両方について）SQLite 3.31.0以降でサポートされている。
このプルリクは、SQLite3アダプタにそうしたサポートを追加する。
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
参考: 週刊Railsウォッチ20240117: TrilogyAdapterでDATABASE_URLにUNIXソケットを指定可能になった
- TrilogyAdapterで
socketパラメータが設定済みの場合はhostを無視するようになった
これにより、DATABASE_URL経由でUNIXソケット上にコネクションを設定可能になる。
DATABASE_URL=trilogy://does-not-matter/my_db_production?socket=/var/run/mysql.sock
Jean Boussier
参考: 週刊Railsウォッチ20240123: assert_queries_count、assert_no_queries、assert_queries_match、assert_no_queries_matchアサーションを公開
以下のアサーションをpublicにした:
assert_queries_countassert_no_queriesassert_queries_matchassert_no_queries_match
期待される件数のクエリが作成されるというアサーションのため、Rails 内部で assert_queries_countやassert_no_queriesが使われている。特定のSQLクエリが作成されたというアサーションには、assert_queries_matchやassert_no_queries_matchが使われている。これらのアサーションがアプリケーションでも利用可能になった。
class ArticleTest < ActiveSupport::TestCase
test "queries are made" do
assert_queries_count(1) { Article.first }
end
test "creates a foreign key" do
assert_queries_match(/ADD FOREIGN KEY/i, include_schema: true) do
@connection.add_foreign_key(:comments, :posts)
end
end
end
Petrik de Heus, fatkodima
注: この修正はRails 7.1.3でリリース済みです。
- 初期化時に
has_secure_tokenがセッターメソッドを呼び出すよう修正。
Abeid Ahmed
参考: 週刊Railsウォッチ20231222: MySQLでDATABASE_URLを変えずにconfig.active_record.protocol_adapters.mysqlでアダプタを指定できるようになった
DATABASE_URL環境変数を使う場合、URLに含まれるプロトコル名を特定のデータベースアダプタにマッピングする設定を有効にした。これにより、アプリケーションで利用するために選択するアダプタを、デプロイ環境で設定されるデータベースコネクションの詳細から分離できるようになる。
# ENV['DATABASE_URL'] = "mysql://localhost/example_database"
config.active_record.protocol_adapters.mysql = "trilogy"
# will connect to MySQL using the trilogy adapter
Jean Boussier, Kevin McPhillips
参考: 週刊Railsウォッチ20231213: MySQLクエリでwarningが発生してもActiveRecord.db_warnings_actionが呼び出されないケースを修正
MySQLが返すwarning_countがゼロより大きく、SHOW WARNINGSクエリを実行しても警告が表示されない場合に、ActiveRecord.db_warnings_actionを呼び出しても警告を無視せずに一般的な警告メッセージを表示するよう修正。
Kevin McPhillips
DatabaseConfigurations#configs_forのnameパラメータにシンボルを渡せるようになった
Andrew Novoselac
参考: 週刊Railsウォッチ20231122: Arelのproc_for_bindsの振る舞いを修正
where(field: values)クエリで、fieldがシリアライズド属性の場合（fieldでActiveRecord::Base.serializeを使っている場合や、fieldがJSONカラムの場合など）の振る舞いを修正した。
João Alves
参考: 週刊Railsウォッチ20231122: ActiveRecord::Core#inspectの出力をカスタマイズ可能になった
ActiveRecord::Core#inspectの出力をカスタマイズ可能になった
デフォルトでは、あるレコードでinspectを呼び出すと、idのみを含むフォーマット済み文字列が生成される。
Post.first.inspect #=> "#<Post id: 1>"
inspectの出力に含めたい属性があれば、ActiveRecord::Core#attributes_for_inspectで設定できる。
Post.attributes_for_inspect = [:id, :title]
Post.first.inspect #=> "#<Post id: 1, title: "Hello, World!">"
attributes_for_inspectを:allに設定すると、inspectでレコードの全属性が出力される。
Post.attributes_for_inspect = :all
Post.first.inspect #=> "#<Post id: 1, title: "Hello, World!", published_at: "2023-10-23 14:28:11 +0000">"
attributes_for_inspectは、development環境とtest環境ではデフォルトで:allに設定される。
full_inspectを呼び出すことで全属性をinspectすることも可能。
attribute_for_inspectで設定した属性はpretty_printでも使われる。
Andrew Novoselac
参考: 週刊Railsウォッチ20231122: 変更されていないFloat::INFINITY値をchangedとして保存しないよう修正
Float::INFINITYや-Float::INFINITYに再代入したときに属性をchangedにしないようになった
Maicol Bentancor
参考: 週刊Railsウォッチ20231114: MariaDBでRETURNINGをサポート
fatkodima, Nikolay Kondratyev
参考: 週刊Railsウォッチ20231114: SQLite3にsupports_deferrable_constraints?を追加
- SQLite3アダプタで
supports_deferrable_constraints?コントラクトを実装
これにより、foreign_keyオプションに:deferrableキーを追加すれば外部キーをdeferredにできる。
add_reference :person, :alias, foreign_key: { deferrable: :deferred }
add_reference :alias, :person, foreign_key: { deferrable: :deferred }
Stephen Margheim
参考: 週刊Railsウォッチ20231114: PostgreSQL向けのset_constraintsヘルパーを追加
- PostgreSQLコネクションに
set_constraintsヘルパーを追加
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!
end
Cody Cutrer
ActiveModel::APIをActiveRecord::Baseでincludeするようになった
Sean Doyle
#signed_idが出力する文字列がurl_safeになるよう修正
Jason Meller
参考: 週刊Railsウォッチ20240117: MySQLでArelのnulls_firstとnulls_lastが使えるようになった
- MySQLに
nulls_lastを追加し、desc.nulls_firstも動作するようにした
Tristan Fellows
ActiveRecord::Relationのorderで、whereと同様のハッシュ渡しをサポート
Topic.includes(:posts).order(posts: { created_at: :desc })
Myles Boone
関連記事
Rails 7.1.0 Active Record CHANGELOG（翻訳）
The post Rails 7.2.0 Active Record CHANGELOG（全項目リンク付き） first appeared on TechRacho.
概要
元サイトの許諾を得て翻訳・公開いたします。