データベース参照: 手動参照と DBRefs

バックグラウンド

手動参照には、あるドキュメントの _idフィールドが別のドキュメントに含まれます。その後、アプリケーションは必要に応じて 2 番目のクエリを実行して、参照されたフィールドを解決できます。

MongoDB Atlas UIでの手動参照の作成

MongoDB Atlas の UI で手動参照を作成するには、次の手順に従います。

ターミナルでの手動参照の作成

以下のように、1 つ目のドキュメントの _id フィールドを2 つ目のドキュメントの参照として使用して、2つのドキュメントを挿入する操作を考えてみましょう。

const original_id = db.movies.insertOne({
    title: "Reference Demo Film 2099"
}).insertedId
db.comments.insertOne({
    name: "Reference Demo Viewer",
    movie_id: original_id,
    text: "A thrilling adventure set in the future."
})

movie_idフィールドが参照するドキュメントを取得するには、moviesコレクション内のドキュメントに対して 2 つ目のクエリを実行します。

db.comments.findOne(
    { movie_id: original_id },
    { name: 1, text: 1, _id: 0 }
)

{
  name: 'Reference Demo Viewer',
  text: 'A thrilling adventure set in the future.'
}

使用

2 つのドキュメントの関係の保存が必要なほとんどの場合に、 手動参照 を使用します。作成は簡単で、アプリケーションは必要に応じて解決できます。

バックグラウンド

DBRef は、特定の参照タイプというよりは、むしろドキュメントを表現するための規則です。DBRef には _id フィールドの値に加え、コレクション名、場合によってはデータベース名が含まれます。

オプションとして、DBRef には任意の数の他のフィールドを含めることができます。追加のフィールド名は、サーバーバージョンによって課せられているフィールド名の規則に従う必要があります。

DBRefs を解決するには、参照先のドキュメントが返されるよう、アプリケーションで追加のクエリが実行されなければなりません。一部のMongoDBドライバーでは、DBRef をドキュメントに変換するヘルパーメソッドが提供されていますが、解決は自動ではありません。

形式

DBRef には、次のフィールドがあります。

$ref

$ref フィールドは、参照先のドキュメントが存在するコレクションの名前を保持します。

$id

$id フィールドは、参照先のドキュメントの _id フィールドの値を含みます。

$db

任意。

参照先のドキュメントが存在するデータベースの名前を含みます。

例

DBRef ドキュメントは下記のドキュメントに近似します。

{ "$ref" : <value>, "$id" : <value>, "$db" : <value> }

creator フィールドに DBRef を格納したコレクションのドキュメントを例にとります。

{
  "_id" : ObjectId("5126bbf64aed4daf9e2ab771"),
  // .. application fields
  "creator" : {
    "$ref" : "creators",
    "$id" : ObjectId("5126bc054aed4daf9e2ab772"),
    "$db" : "users",
    "extraField" : "anything"
  }
}

この例の DBRef は、users データベースの creators コレクションにある、_id フィールドに ObjectId("5126bc054aed4daf9e2ab772") を持つドキュメントを指しています。さらに任意のフィールドも含まれています。

DBRefs のドライバー サポート