From 7b0bfe64ac5c274d29d278b024050c6985730eee Mon Sep 17 00:00:00 2001 From: hachi8833 Date: Tue, 15 Oct 2024 12:27:15 +0900 Subject: [PATCH] =?UTF-8?q?active=5Frecord=5Fcomposite=5Fprimary=5Fkeys.md?= =?UTF-8?q?=E3=81=AE=E5=8E=9F=E6=96=87=E6=9B=B4=E6=96=B0=E3=82=92=E8=A8=B3?= =?UTF-8?q?=E6=96=87=E3=81=AB=E5=8F=8D=E6=98=A0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit https://github.com/rails/rails/compare/v7.2.0...v8.0.0.beta1 --- .../active_record_composite_primary_keys.md | 31 ++++++++++++++----- 1 file changed, 23 insertions(+), 8 deletions(-) diff --git a/guides/source/ja/active_record_composite_primary_keys.md b/guides/source/ja/active_record_composite_primary_keys.md index 13a1b8db4f0..2c9db400c5c 100644 --- a/guides/source/ja/active_record_composite_primary_keys.md +++ b/guides/source/ja/active_record_composite_primary_keys.md @@ -112,7 +112,9 @@ Product.where(Product.primary_key => [[1, "ABC98765"], [7, "ZZZ11111"]]) 複合主キーを持つモデルの関連付け ------------------------------------------------------- -Railsは多くの場合、追加情報を必要とせずに、複合主キーをモデル間の関連付けで「主キー〜外部キー」情報を推論できます。以下の例をご覧ください。 +Railsは、関連付けられたモデル間の主キーと外部キーのリレーションシップを多くの場合推測できます。ただし複合主キーを扱う場合は、明示的に指示されない限り、デフォルトで複合キーの一部（通常は`id`カラム）のみを使うのが普通です。このデフォルトの振る舞いは、モデルの複合主キーに`:id`カラムが含まれ、**かつ**その列がすべてのレコードに対して一意である場合にのみ機能します。 + +以下の例をご覧ください。 ```ruby class Order < ApplicationRecord @@ -125,23 +127,30 @@ class Book < ApplicationRecord end ``` -ここでRailsは、1件のorder（注文）とそのbooks（本）の関連付けの主キーに`:id`カラムが使われると仮定します。これは、通常の`has_many`関連付けや`belongs_to`関連付けと同様です。Railsは、`books`テーブル上の外部キーカラムが`:order_id`であると推測します。 -ある本の注文に、以下のようにアクセスするとします。 +このセットアップでは、`Order`（注文）モデルには`[:shop_id, :id]`で構成される複合主キーがあり、`Book`（書籍）モデルは`Order`モデルに属しています。このときRailsは、注文とその書籍の関連付けの主キーとして`:id`カラムを使う必要があると推測し、`books`テーブルの外部キーカラムは`:order_id`であると推測します。 + +以下は、`Order`とそれに関連付けられた`Book`を作成します。 ```ruby order = Order.create!(id: [1, 2], status: "pending") book = order.books.create!(title: "A Cool Book") +``` +この`book`の`order`にアクセスするために、以下のように関連付けを`reload`します。 + +```ruby book.reload.order ``` -この場合、以下のSQLを生成してorderにアクセスします。 +このとき、Railsは以下のSQLを生成して`orders`にアクセスします。 ```sql SELECT * FROM orders WHERE id = 2 ``` -これが期待通りに動作するのは、このモデルの複合主キーに`:id`カラムが含まれており、かつ`:id`カラムがすべてのレコードで一意である場合だけです。関連付けで完全な複合主キーを使うには、その関連付けで`foreign_key`オプションを設定してください。このオプションは、関連付けられるレコードをクエリするときに複合外部キーを指定します。例: +このクエリでは、`shop_id`と`id`の両方を使うのではなく、orderの`id`を使っていることがわかります。この場合、モデルの複合主キーには実際に`:id`カラムが含まれており、そのカラムはすべてのレコードに対して一意であるため、`id`で十分です。 + +ただし、上記の要件が満たされていない場合、または関連付けで完全な複合主キーを使う場合は、関連付けに`foreign_key:`オプションを設定できます。このオプションは、関連付けで複合外部キーを指定します。外部キーのすべてのカラムは、以下のように、関連付けられたレコードをクエリするときに使われます。 ```ruby class Author < ApplicationRecord @@ -154,16 +163,22 @@ class Book < ApplicationRecord end ``` -以下のように、ある本のauthor（著者）にアクセスするとします。 +このセットアップでは、`Author`モデルには`[:first_name, :last_name]`で構成される複合主キーがあり、`Book`モデルは複合外部キー`[:author_first_name, :author_last_name]`を持つ`Author`モデルに属します。 + +以下は、`Author`とそれに関連付けられた`Book`を作成します。 ```ruby author = Author.create!(first_name: "Jane", last_name: "Doe") -book = author.books.create!(title: "A Cool Book") +book = author.books.create!(title: "A Cool Book", author_first_name: "Jane", author_last_name: "Doe") +``` +この`book`の`author`にアクセスするために、以下のように関連付けを`reload`します。 + +```ruby book.reload.author ``` -この場合、以下のようにSQLクエリで`:first_name`と`:last_name`が使われます。 +これでRailsは、SQLクエリの複合主キーの`:first_name`と`:last_name`の**両方**を使うようになりました。 ```sql SELECT * FROM authors WHERE first_name = 'Jane' AND last_name = 'Doe'