更新（データベースコマンド）

アップデート ステートメント

updates配列の各要素は、アップデート ステートメント ドキュメントです。各ドキュメントには、次のフィールドが含まれています。

{
  <variable_name_1>: <expression_1>,
  ...,
  <variable_name_n>: <expression_n>
}

collation: {
   locale: <string>,
   caseLevel: <boolean>,
   caseFirst: <string>,
   strength: <int>,
   numericOrdering: <boolean>,
   alternate: <string>,
   maxVariable: <string>,
   backwards: <boolean>
}

// INVALID
[
  { "x.a": { $gt: 85 } },
  { "x.b": { $gt: 80 } }
]

// Example 1
[
  { $or: [{"x.a": {$gt: 85}}, {"x.b": {$gt: 80}}] }
]
// Example 2
[
  { $and: [{"x.a": {$gt: 85}}, {"x.b": {$gt: 80}}] }
]
// Example 3
[
  { "x.a": { $gt: 85 }, "x.b": { $gt: 80 } }
]

戻り値

このコマンドは、操作のステータスを含むドキュメントを返します。例：

{
   "ok" : 1,
   "nModified" : 0,
   "n" : 1,
   "upserted" : [
      {
         "index" : 0,
         "_id" : ObjectId("52ccb2118908ccd753d65882")
      }
   ]
}

出力フィールドの詳細については、「出力」を参照してください。

制限

multi: true を設定した場合、update コマンドは冪等な操作にのみ使用してください。

更新演算子式ドキュメントを使用したアップデート

アップデートステートメントフィールド u は、 アップデート演算子式のみを含むドキュメントを受け入れることができます。例：

updates: [
   {
     q: <query>,
     u: { $set: { status: "D" }, $inc: { quantity: 2 } },
      ...
   },
   ...
]

次に、 updateコマンドはドキュメント内の対応するフィールドのみを更新します。

置換ドキュメントによる更新

アップデート ステートメント フィールドuフィールドは置換ドキュメントを受け入れることができます。つまり、ドキュメントにはfield:value式のみが含まれます。 例:

updates: [
   {
      q: <query>,
      u: { status: "D", quantity: 4 },
      ...
   },
   ...
]

次に、 updateコマンドは一致するドキュメントをアップデート ドキュメントに置き換えます。 updateコマンドは一致するドキュメントを1 つだけ置き換えることができます。つまり、 multiフィールドはtrueにできません。 updateコマンドは_id値を置き換えません。

Multi アップデートの失敗

multi パラメータがtrue に設定されたアップデートコマンドで 1 つのドキュメントのアップデートに失敗した場合、それ以上のドキュメントはそのコマンドの一部としてはアップデートされません。

例、sample_mflix.movies コレクションには フィールドを持つ映画が含まれています。imdb.rating moviesimdb.ratingの値が 以下であるというルールで、 コレクションにドキュメント検証を作成します。10

db.runCommand( 
   { 
      update: "movies",
      updates: [
      {
         q: { 
            year: { $gte: 2000, $lte: 2005 },
            "imdb.rating": { $type: "number" }
         }, 
         u: { $inc: { "imdb.rating": 1 } },
         multi: true
      }
      ]
   }
)

すでに評価が 10 になっている映画がある場合、増加させると検証ルール（評価は > 10）に違反します。こうした場合、数千のドキュメントがクエリに一致した場合でも更新は停止し、それ以上のドキュメントは更新されません。

集計パイプラインによる更新

アップデート ステートメント フィールド u フィールドでは、集計パイプライン[ <stage1>, <stage2>, ... ]を受け入れて、実行する変更を指定できます。パイプラインは、次のステージで構成できます。

• $addFields およびそのエイリアス $set

• $project およびそのエイリアス $unset

• $replaceRoot およびそのエイリアス $replaceWith

集計パイプラインを使用すると、現在のフィールド値に基づいて条件付きのアップデートを表現したり、あるフィールドを他のフィールドの値を使用してアップデートするなど、より表現内容の多いアップデート ステートメントが可能になります。

以下に例を挙げます。

updates: [
   {
      q: <query>,
      u: [
        { $set: { status: "Modified", comments: [ "$misc1", "$misc2" ] } },
        { $unset: [ "misc1", "misc2" ] }
      ],
      ...
   },
   ...
]

例については、「集計パイプラインによる更新」を参照してください。

一意なインデックスを使用したアップサート

重複を防ぐためのユニークインデックスがない限り、アップサートによって重複したドキュメントが作成されることがあります。

Andy という名前のドキュメントが存在せず、複数のクライアントがほぼ同時に次のコマンドを発行する例を考えます。

db.runCommand(
   {
     update: "people",
     updates: [
       { q: { name: "Andy" }, u: { $inc: { score: 1 } }, multi: true, upsert: true }
     ]
   }
)

いずれかのクライアントがデータを正常に挿入する前にすべての update 操作がクエリ フェーズを終了し、かつ name フィールドにユニークインデックスがない場合、各 update 操作によって挿入が行われて、name: Andyを含む複数のドキュメントが作成される可能性があります。

name フィールドに一意なインデックスを設定すると、ドキュメントが 1 つだけ作成されるようになります。一意なインデックスが設定されると、複数の update 操作で次の動作が見られるようになります。

• 正確に 1 つの update 操作で新しいドキュメントが正常に挿入されます。

• その他の update 操作は、新しく挿入されたドキュメントを更新するか、一意なキーの競合が原因で失敗します。

  他の update 操作で新しく挿入されたドキュメントを更新するには、次の条件がすべて満たされている必要があります。

  • ターゲット コレクションに一意なインデックスがあるため、重複キー エラーが発生。

  • 更新操作が updateMany ではない、または multi が false。

  • アップデートの一致条件は、次のいずれかです。

    • 単一の等価述語。例: { "fieldA" : "valueA" }

    • 等価述語の論理 AND。例: { "fieldA" : "valueA", "fieldB" : "valueB" }

  • 等価述語内のフィールドが、一意なインデックス キー パターン内のフィールドと一致。

  • 更新操作が、一意なインデックス キー パターン内のフィールドを変更しない。

次の表に示す upsert 操作の例では、キーの衝突が発生した場合に更新されるか失敗します。

{ name : 1 }

db.people.updateOne(
   { name: "Andy" },
   { $inc: { score: 1 } },
   { upsert: true }
)

{ name : 1 }

db.people.updateOne(
   { name: { $ne: "Joe" } },
   { $set: { name: "Andy" } },
   { upsert: true }
 )

{ name : 1 }

db.people.updateOne(
  { name: "Andy", email: "andy@xyz.com" },
  { $set: { active: false } },
  { upsert: true }
)

制限

updates 配列内の各アップデート要素について、クエリと更新サイズの合計（qおよびu ）は、最大 BSON ドキュメント サイズ以下である必要があります。

updates 配列内の更新ステートメントの総数は、最大バルクサイズ以下である必要があります。

スキーマ検証

update コマンドは、bypassDocumentValidation オプションのサポートを追加します。これにより、検証ルールがあるコレクション内でドキュメントを挿入または更新する際に、スキーマ検証をバイパスできます。

シャーディングされたコレクション

トランザクション

update は分散トランザクション内で使用できます。

1 つのドキュメントの特定のフィールドのアップデート

アップデート演算子を使用して、ドキュメントの指定されたフィールドのみを更新します。

例、sample_mflixデータベースの moviesコレクション内のドキュメントには、title、year、num_mflix_comments などのフィールドが含まれています。

次のコマンドは、 $setおよび$incアップデート演算子を使用して、 titleが"The Godfather"に等しいドキュメントのyearフィールドとnum_mflix_commentsフィールドを更新します。

db.runCommand(
   {
      update: "movies",
      updates: [
         {
            q: { title: "The Godfather" }, u: { $set: { year: 1972 }, $inc: { num_mflix_comments: 1 } }
         }
      ],
      ordered: false,
      writeConcern: { w: "majority", wtimeout: 5000 }
   }
)

<update>ドキュメントではオプションの multi フィールドが指定されていないため、q一致条件に一致するドキュメントが複数ある場合でも、更新によって変更されるのは 1 つのドキュメントのみです。

詳細については「出力」を参照してください。

1 つのドキュメントの特定のフィールドのアップデート

アップデート演算子を使用して、ドキュメントの指定されたフィールドのみを更新し、アップデート演算子に true に設定された multi フィールドを含めます。

例、sample_mflixデータベースの moviesコレクション内のドキュメントには、year や num_mflix_comments などのフィールドが含まれています。

次のコマンドは、$inc 更新演算子を使用して、num_mflix_comments でリリースされたすべての映画の1924 フィールドを増加させます。

db.runCommand(
   {
      update: "movies",
      updates: [
         { 
            q: { year: 1924 }, 
            u: { $inc: { num_mflix_comments: 1 }, $set: { classic: true, era: "silent" } }, 
            multi: true 
         }
      ],
      ordered: false,
      writeConcern: { w: "majority", wtimeout: 5000 }
   }
)

multiフィールドが true に設定されているため、アップデートにより、qフィールドで指定されたクエリに一致するすべての 6 ドキュメントが変更され、次の出力が返されます。

{ n: 6, nModified: 6, ok: 1 }

詳細については「出力」を参照してください。

集約パイプラインによるアップデート

updateコマンドは、更新に集計パイプラインを使用できます。 このパイプラインには次のステージが含まれる可能性があります。

• $addFields およびそのエイリアス $set

• $project およびそのエイリアス $unset

• $replaceRoot およびそのエイリアス $replaceWith

集計パイプラインを使用すると、現在のフィールド値に基づいて条件付きのアップデートを表現したり、あるフィールドを他のフィールドの値を使用してアップデートするなど、より表現内容の多いアップデート ステートメントが可能になります。

db.runCommand(
   {
      update: "users",
      updates: [
         { 
            q: { name: "Robert Baratheon" },  
            u: [ 
               { $set: { full_info: { $concat: [ "$name", " - ", "$email" ] } } },
               { $set: { status: "active" } }
            ], 
            multi: false
         }
      ],
      ordered: false,
      writeConcern: { w: "majority", wtimeout: 5000 }
   }
)

db.runCommand(
   {
      update: "movies",
      updates: [
         { 
            q: { title: "The Great Train Robbery" },  
            u: [ 
                  { $set: { age: { $subtract: [ 2026, "$year" ] } } },
                  { $set: { era: { $switch: { 
                                       branches: [
                                             { case: { $lt: [ "$year", 1960 ] }, then: "Classic" },
                                             { case: { $lt: [ "$year", 1980 ] }, then: "Golden Age" },
                                             { case: { $lt: [ "$year", 2000 ] }, then: "Modern" },                                                   
                                             { case: { $gte: [ "$year", 2000 ] }, then: "Contemporary" }
                                       ],
                                       default: "Unknown" 
                  } } } } 
            ], 
            multi: false
         }
      ],
      ordered: false,
      writeConcern: { w: "majority", wtimeout: 5000 }
   }
)

一括アップデート

次の例では、既存のドキュメントの更新と新しいドキュメントの挿入の両方を行うために、1 つのコマンドで複数の更新操作を実行します。操作:

• 2015 の高評価のアクション映画を としてマークします featured

• は 2012 の短いタイトルの映画とロールの映画を として分類します melodrama

• データベースが存在しない場合は、2024 から新しいSF映画をアップサートします

db.runCommand(
   {
      update: "movies",
      updates: [
         // Update highly-rated Horror movies from 2015
         { 
            q: { year: 2015, genres: "Horror", "imdb.rating": { $gte: 7 } }, 
            u: { $set: { featured: true } },
            multi: true
         },
         // Update short Drama/Romance movies from 2012
         { 
            q: { year: 2012, genres: { $all: ["Drama", "Romance"] }, runtime: { $lt: 90 } }, 
            u: { $set: { category: "melodrama" } },
            multi: true
         },
         // Upsert a new movie from 2026
         { 
            q: { title: "A New Movie", year: 2026 }, 
            u: { 
               $set: { 
                  genres: ["Sci-Fi", "Adventure"],
                  runtime: 142,
                  "imdb.rating": 8.5,
                  featured: true
               }
            },
            upsert: true
         }
      ],
      ordered: false,
      writeConcern: { w: "majority", wtimeout: 5000 }
   }
)

返されたドキュメントは、コマンドが既存のドキュメントを変更し、アップサートによって新しいドキュメントを挿入したことを示しています。詳細については、「 出力 」を参照してください。

{
  n: 16,
  upserted: [
    {
      index: 2,
      _id: ObjectId('69861e680e6ea1f51160fe1c')
    }
  ],
  nModified: 15,
  ok: 1,
  '...': '...'
}

照合の指定

照合を指定すると、大文字・小文字やアクセント記号など、文字列を比較するための言語独自のルールを指定できます。

sample_mflixデータベースの moviesコレクション内のドキュメントには、title や year などのフィールドがあります。

次の操作では、照合を使用して、大文字と小文字を区別しない検索を実行します。クエリは小文字で "the godfather" を検索しますが、strength: 1 照合では、大文字と小文字に関係なく、クエリは "The Godfather" と一致します。

db.runCommand({
  update: "movies",
  updates: [
    {
      q: { title: "the godfather" },
      u: { $set: { featured: true } },
      collation: { locale: "en", strength: 1 }
    }
  ]
})

arrayFilters配列更新操作に を指定する

配列フィールドを更新するときに、どの配列要素を更新するかを決定するためのarrayFiltersを指定できます。

db.runCommand( {
   update: "movies",
   updates: [
      { q: { languages: "English" }, u: { $set: { "languages.$[element]" : "EN" } }, arrayFilters: [ { "element": "English" } ], multi: true}
   ]
} )

db.runCommand({
   update: "movies",
   updates: [
      { q: { cast: "Al Pacino" }, u: { $set: { "cast.$[elem]" : "REDACTED" } }, arrayFilters: [ { "elem": "Al Pacino" } ], multi: true }
   ]
})

hint更新操作に を指定する

sample_mflixデータベースの moviesコレクション内のドキュメントには、year や num_mflix_comments などのフィールドがあります。

コレクションに次のインデックスを作成します。

[
   db.movies.createIndex( { year: 1 } ),
   db.movies.createIndex( { num_mflix_comments: 1 } )
]

次のアップデート操作では、「Thegreat書式コレクション」のnum_mflix_commentsフィールドを増加させ、インデックス{ year: 1 }を使用することを明示的に示します。

db.runCommand({
   update: "movies",
   updates: [
      { q: { title: "The Great Train Robbery" }, u: { $inc: { "num_mflix_comments": 1 } }, hint: { year: 1 }, multi: false }
   ]
})

使用されたインデックスを確認するには、 更新操作でexplain を実行します。例、次の例では、num_mflix_comments 5以降にリリースされたコメントが 以下の映画の2000 を増加させるアップデートについて説明しています。

db.runCommand(
   {
      explain: {
         update: "movies",
         updates: [ 
         { q: { "num_mflix_comments": { $lte: 5 }, "year": { $gte: 2000 } }, u: { $inc: { "num_mflix_comments": 1 } }, hint: { year: 1 }, multi: true }
         ]
      },
      verbosity: "queryPlanner"
   }
)

explainはドキュメントを変更しません。

オプションまたは フィールドでの変数の使用letc

変数はletオプションまたはcフィールドで定義し、 updates配列でアクセスできます。

sample_mflixデータベースの moviesコレクション内のドキュメントには、title や year などのフィールドがあります。

次の例では、let オプションを使用して、映画に新しいフィールドを検索して追加するための変数を定義します。

db.runCommand( {
   update: "movies",
   updates: [
      { q: { $expr: { $eq: [ "$title", "$$movieTitle" ] } },
         u: [ { $set: { franchise: "$$franchiseName" } } ] }
   ],
   let : { movieTitle: "The Godfather", franchiseName: "The Godfather Trilogy" }
} )

次の例では、c で movieTitle 変数と franchiseName 変数を定義し、その変数を使用して franchiseフィールドを追加します。

db.runCommand( {
   update: "movies",
   updates: [
      { q: { $expr: { $eq: [ "$title", "$$movieTitle" ] } },
         u: [ { $set: { franchise: "$$franchiseName" } } ],
         c: { movieTitle: "The Godfather", franchiseName: "The Godfather Trilogy" } }
      ]
} )

ソートを伴う更新操作

sample_mflixデータベースの moviesコレクション内のドキュメントには、year、title、num_mflix_comments などのフィールドがあります。

次の例では、1972 からすべての映画を検索し、最もコメントが多い映画を更新します。

db.runCommand( {
   update: "movies",
   updates: [ {
      // Find movies from 1972
      q: { year: 1972 },
      // Add a classic_status field to the found movie
      u: { $set: { classic_status: "Most Discussed 1972 Film" } },
      // Only update one movie
      multi: false,
      // Sort movies by comment count in descending order
      sort: { num_mflix_comments: -1 }
   } ]
} )

この操作では、最もコメント数が多い 1972 映画のみが更新されます。