MongoDB - 文書の挿入

こんにちは、未来のデータベース魔術師たち！今日は、MongoDBの魔法の世界に飛び込み、コレクションに文書をどのように挿入するかを学びます。プログラミングが初めてであっても心配しないでください。私は知恵に満ちた古老の魔術師のように、若い弟子に一つ一つ丁寧に教えます。那么、魔杖（またはキーボード）を手に取り、始めましょう！

MongoDB - Insert Document

MongoDBにおける文書の理解

文書を挿入する前に、MongoDBにおける文書とは何かを簡単に復習しましょう。文書は情報を保持する特別な羊皮紙のように考えてください。非魔法的な（マグルの）世界では、この情報を「データ」と呼びます。各文書は、特定のアイテムや存在に関するさまざまな詳細を含む、あなたの魔術の本のユニークなエントリです。

例えば、魔法的な生物に関する文書は以下のようになります：

{
"name": "Dragon",
"type": "Fire-breathing",
"dangerLevel": 10,
"abilities": ["Flying", "Breathing Fire", "Treasure Hoarding"]
}

文書が何かを理解したら、これらの魔法のエントリをMongoDBのコレクションに追加する方法を学びましょう！

insert()メソッド

insert()メソッドは、MongoDBの「Wingardium Leviosa」として、コレクションに文書を追加する基本的な魔法です。しかし、同じように「Wingardium Leviosa」がより具体的な浮遊魔法に置き換えられたように、insert()メソッドもより正確なメソッドに置き換えられました。でも心配しないでください、若い魔術師たち。私は現代の方法を教えます！

insertOne()メソッド

insertOne()メソッドは、コレクションに単一の文書を追加したいときに最適です。これは、魔法の金庫に一つの貴重なアーティファクトを慎重に配置することに似ています。

シntax

db.collection.insertOne(document)

例

「Hogwarts」コレクションに新しい生徒を追加してみましょう：

db.hogwarts.insertOne({
name: "Harry Potter",
house: "Gryffindor",
year: 1,
subjects: ["Potions", "Defense Against the Dark Arts", "Charms"]
})

この魔法（つまりコード）を実行すると、MongoDBはこの文書を「Hogwarts」コレクションに追加します。それほど簡単ではありません！

結果の理解

insertOne()メソッドを唱えると、MongoDBは默默無言で文書を追加するのではなく、フィードバックを返します。まるで魔法の鏡があなたの魔法の結果を見せてくれるようにです。以下は、あなたが見るかもしれないものです：

{
"acknowledged": true,
"insertedId": ObjectId("60d5ec9d7c213e8456b1b2d4")
}

acknowledged: これは挿入が成功したかどうかを教えてくれます。trueは「はい、あなたの魔法が効いた！」を意味します。
insertedId: これは新規挿入された文書のユニークな識別子です。文書の魔法の署名のように考えてください。

insertMany()メソッド

一度に複数の文書を追加したい場合はどうしますか？那就是 insertMany()メソッドが便利です。まるで一連のオブジェクトに対して集団浮遊魔法を唱えるようなものです！

シntax

db.collection.insertMany([document1, document2, ...])

例

「Hogwarts」コレクションに複数の生徒を追加しましょう：

db.hogwarts.insertMany([
{
name: "Hermione Granger",
house: "Gryffindor",
year: 1,
subjects: ["Arithmancy", "Muggle Studies", "Ancient Runes"]
},
{
name: "Ron Weasley",
house: "Gryffindor",
year: 1,
subjects: ["Divination", "Care of Magical Creatures"]
},
{
name: "Draco Malfoy",
house: "Slytherin",
year: 1,
subjects: ["Potions", "Dark Arts"]
}
])

この魔法により、一度にすべての生徒がコレクションに追加されます。効率的ですね！

結果の理解

この強力な魔法を唱えた後、MongoDBは再びフィードバックを提供します：

{
"acknowledged": true,
"insertedIds": [
ObjectId("60d5ec9d7c213e8456b1b2d5"),
ObjectId("60d5ec9d7c213e8456b1b2d6"),
ObjectId("60d5ec9d7c213e8456b1b2d7")
]
}

acknowledged: これはあなたの魔法が成功したかどうかを確認します。
insertedIds: これは追加された各文書のユニークな識別子の配列です。

実用的なヒントとコツ

スペルチェック（データバリデーション）: 挿入する前に文書を必ず二度見してください。スペルミスされたフィールド名は予期しない結果をもたらす可能性があります。まるで魔法の言葉を間違えたように！
重複キー: 既存の文書と同じ_idを持つ文書を挿入しようとすると、MongoDBはエラーを発生させます。まるで二つの生徒が同じ魔法の署名を持つことを試みるように、それは機能しません！
バッチ挿入: insertMany()を使用する際、一つの文書が失敗すると（おそらく重複キーのため）、操作は停止します。しかし、エラーの前に挿入された文書はコレクションに残ります。まるで一つの生徒が入学試験に失敗しても、他の合格した生徒はホグワーツに通うことができるように！
パフォーマンスの考慮: 単一の文書を一つずつ挿入するよりも、バッチで挿入する方が遅いことがあります。多くの文書を挿入する場合は、insertMany()を使用することを検討してください。

挿入メソッドのまとめ

ここで学んだ挿入メソッドの簡単な参照表を以下に示します：

メソッド	説明	使用シーン
`insertOne()`	単一文書の挿入	一つの文書を追加したいとき
`insertMany()`	複数の文書の挿入	一連の文書を追加したいとき

若い魔術師たち、練習は成功の鍵です。これらのメソッドを自分のMongoDBのサンドボックスで試してみてください。間もなく、あなたはデータベースの魔術師としての腕前を磨き上げるでしょう！そして、力には責任が伴います。これらの魔法を賢く使い、データベースを常に整理整頓された状態に保ちましょう！

Credits: Image by storyset