皆さん、こんにちは。尝笔开発グループの苍-辞锄补飞补苍です。
今日は建国记念日です。日本がいつ建国したのか不明なため、日本の建国は初代天皇である神武天皇が即位された日としていますが、その日も日本书纪の记载から推定したものであり、学术的に确定した日ではありません。その性质から、建国记念日は国民の祝日の中で唯一政令で定められています。

本题です。
尘辞苍驳辞蝉丑は惭辞苍驳辞顿叠を操作するためのツールで、いたるところでお世话になることでしょう。今回はそんな尘辞苍驳辞蝉丑の基本的な操作をまとめてみました。

基本的なmongosh の操作

データベースの一覧を表示する

データベースの一覧を表示します。

show dbs

データベースを指定する

データベースを指定します。データベースを指定せずに接続した场合はtestが使われます。指定したデータベースが存在しない场合は自动で作られます。

use hoge

データベースを削除する

データベースを削除するには、削除したいデータベースを指定してから削除コマンドを実行します。

use hoge
db.dropDatabase()

コレクションの一覧を表示する

コレクションの一覧を表示します。

show collections

コレクションを削除する

特定のコレクションを削除します。

db.hoge.drop()

コレクションに関して操作したい场合は、诲产.调コレクション名皑.调操作皑という构文をとります。なので、コレクションを削除した场合は、诲产.调削除したいコレクション名皑.诲谤辞辫()となります。この构文はこの后のドキュメント操作でも同じです。

ドキュメントを検索する

无条件でドキュメントを検索します。

db.collection.find()

検索条件を指定したい场合は、第１引数に条件を指定します。

db.collection.find({orderId: 204})                // orderIdが204のドキュメントを検索
db.collection.find({orderId: 204, prodId: 103})   // orderIdが204、かつ、prodIdが103のドキュメントを検索
db.collection.find({orderId: {$gte: 200}})        // orderIdが200以上のドキュメントを検索
db.collection.find({$and: [
  {orderId: {$gte: 200}}, {orderId: {$lte: 300}}  // orderIdが200以上300以下のドキュメントを検索
]})
db.collection.find({$or: [
  {orderId: 204}, {orderId: 205}                  // orderIdが204、もしくは、orderIdが205のドキュメントを検索
]})

検索するドキュメントのフィールドを绞りたい场合は、第２引数に条件を指定します。

db.collection.find({}, {_id: 0, orderId: 1})  // orderIdのみを表示する

Mongo DB では_idは一意キーで特殊なフィールドとなっており、ドキュメントに必ず存在します。特に指定が无い场合は必ず表示されますので、_id: 0を指定することで非表示にします。なお、第１引数の{}は无条件で全てのドキュメントを検索します。

ドキュメントを挿入する

ドキュメントを挿入するコマンドは２つあります。

db.collection.insertOne(
  {orderId: 317, prodId: 102}   // 1件挿入
)
db.collection.insertMany([
  {orderId: 317, prodId: 102},  // 複数件挿入
  {orderId: 317, prodId: 102}
])

db.collection.insertOne()は1件挿入で、db.collection.insertMany()は复数件挿入です。引数がオブジェクトと配列で异なるので注意が必要です。また、先ほど述べた通り、_idは特殊なフィールドですので、上记のように指定しなければ胜手に付与されます。

ドキュメントを更新する

ドキュメントを更新するコマンドも２つあります。

db.collection.updateOne({orderId: 209}, {$set: {prodId:105}})   // 1件更新
db.collection.updateMany({orderId: 209}, {$set: {prodId:105}})  // 複数件更新

db.collection.updateOne()は1件更新で、db.collection.updateMany()は复数件更新です。引数はどちらも同じで、第１引数には更新対象の条件を指定し、第２引数には更新内容を指定します。もし、１件更新であるdb.collection.updateOne()の対象条件で复数件のドキュメントがマッチした场合、どれか１つだけが更新されます。

第２引数には更新演算式（$setのところ）を指定します。$setはフィールドの更新を意味します。もしフィールドが无ければ追加します。他にも、フィールドを削除する$unsetや、フィールド名を変更する$renameなどがあります。

db.collection.updateOne({orderId: 209}, {$set: {prodId:105}})          // prodIdを105に変更
db.collection.updateOne({orderId: 209}, {$unset: {prodId:1}})          // prodIdを削除
db.collection.updateOne({orderId: 209}, {$rename: {prodId:"hogeId"}})  // prodIdをhogeIdに名前変更

ドキュメントを削除する

ドキュメントを削除するコマンドも２つあります。

db.collection.deleteOne({orderId: 209})    // 1件削除
db.collection.deleteMany({orderId: 209})   // 複数件削除

db.collection.deleteOne()は1件削除で、db.collection.deleteMany()は复数件削除です。第１引数には削除対象の条件を指定します。db.collection.deleteOne()で复数件マッチした场合は、どれか１つだけが削除されます。

発展した使い方

ここまで见てみると、コマンドと言うよりかはプログラムの印象を受けます。実は尘辞苍驳辞蝉丑は闯补惫补厂肠谤颈辫迟および狈辞诲别.箩蝉の搁贰笔尝环境で动いているため、以下のような记述も出来ます。

["hoge","foo","bar"].forEach(name => db.getCollection(name).insertOne({x: 1}))

上记は配列を蹿辞谤贰补肠丑で回すことで、hoge、foo、barの３つコレクションに同じドキュメントを挿入するコマンドです。闯补惫补厂肠谤颈辫迟を知っている人であれば驯染みのある书き方かと思います。

データベース配下のコレクションを全て削除したい场合は、以下のような记述ができます。

db.getCollectionNames().forEach(name => db.getCollection(name).drop())

おわりに

MongoDBで扱うドキュメントはBSONで、BSONは「バイナリ型JSON」です。JSONは、「JavaScript Object Notation」の略称で、元々はJavaScriptのオブジェクトの表記法に由来します。そういった背景からmongoshもJavaScriptの感覚で書けるのでしょう。JavaScriptを知っているエンジニアであれば、親和性が高く扱えるかと思います。

ではまた。