ドキュメントのシャードキー値の変更

項目一覧

MongoDB5.0 は 10 月2024 をもってサポートを終了します。このバージョンのドキュメントはサポート対象外になりました。配置をアップグレードするには、 MongoDB を参照してください。5.0 60アップグレード手順。

シャードキーフィールドが不変の _idフィールドでない限り、ドキュメントのシャードキー値を更新できます。

重要

シャードキー値の更新時

を使用している必要mongos があります。シャードに直接操作を実行しないでください。
トランザクション内で、または再試行可能な書き込みとして実行する必要があります。
クエリフィルターの完全なシャードキーに等価条件を含める必要があります。たとえば、 { activityid: 1, userid : 1 }をシャードキーとして使用するmessagesコレクションで考えてみましょう。ドキュメントのシャードキー値を更新するには、クエリフィルターにactivityid: <value>, userid: <value>を含める必要があります。必要に応じて、クエリに追加のフィールドを含めることができます。

シャーディングされたコレクションに対して実行される場合のその他の操作固有の要件については、特定の書込みコマンド/メソッドも参照してください。

シャードキー値を更新するには、次の操作を使用します。

コマンド	方式
`multi: false`で更新	db.collection.replaceOne() db.collection.updateOne() を`null`以外の値に設定するには、更新がトランザクション内で、または再試行可能な書き込みとして実行される必要があります。
findAndModify	db.collection.findOneAndReplace() db.collection.findOneAndUpdate() db.collection.findAndModify() を`null`以外の値に設定するには、更新がトランザクション内で、または再試行可能な書き込みとして実行される必要があります。
	`db.collection.bulkWrite()` `Bulk.find.updateOne()` シャードキーの変更によってドキュメントが別のシャードに移動される場合は、一括操作で複数のシャードキーの変更を指定できません。バッチサイズは 1 である必要があります。シャードキーの変更によってドキュメントが別のシャードに移動されない場合は、一括操作で複数のシャードキーの変更を指定できます。を`null`以外の値に設定するには、操作がトランザクション内で、または再試行可能な書き込みとして実行される必要があります。

警告

シャーディングされたコレクション内のドキュメントには、シャードキーフィールドがないことがあります。ドキュメントのシャードキーの値を変更するときに、誤ってシャードキーを削除しないように注意してください。

例

locationフィールドでシャーディングされているsalesコレクションについて考えてみましょう。コレクションには、 _id 12345とlocation ""を持つドキュメントが含まれています。このドキュメントのフィールド値をアップデートするには、次のコマンドを実行します。

db.sales.updateOne(
  { _id: 12345, location: "" },
  { $set: { location: "New York"} }
)

Tip

以下も参照してください。

欠落しているシャードキーフィールドの設定

戻る

コレクションの再シャーディング

欠落しているシャードキーフィールドの設定