既存のドキュメントの検証レベルを指定する

検証レベルが moderate の検証ルールを指定します。

moderate validationLevelを使用してmoviesコレクションにバリデーターを追加する:

db.runCommand( {
   collMod: "movies",
   validator: { $jsonSchema: {
      bsonType: "object",
      required: [ "title" ],
      properties: {
         title: {
            bsonType: "string",
            description: "title must be a string and is required"
         }
      }
   } },
   validationLevel: "moderate"
} )

validationLevel が moderate であるため、 MongoDB はすべてのドキュメント挿入と、すでにルールを満たしている既存のドキュメントのアップデートに検証ルールを適用します。

Insert a valid document.

次の挿入コマンドは、検証ルールを満たす string 値を持つ titleフィールドを含むドキュメントを追加します。

db.movies.insertOne(
   { title: "Wings", year: 1927 }
)

結果を確認します。

ドキュメントが検証ルールを満たすため、挿入は成功します。 MongoDB は、次のような出力を返します。

{
  acknowledged: true,
  insertedId: ...
}

検証レベルが strict の検証ルールを指定します。

strict validationLevelを使用してmoviesコレクションにバリデーターを追加する:

db.runCommand( {
   collMod: "movies",
   validator: { $jsonSchema: {
      bsonType: "object",
      required: [ "title" ],
      properties: {
         title: {
            bsonType: "string",
            description: "title must be a string and is required"
         }
      }
   } },
   validationLevel: "strict"
} )

validationLevel が strict であるため、 MongoDB はすべてのドキュメントの挿入とアップデートに検証ルールを適用します。

Insert a valid document.

次の挿入コマンドは、検証ルールを満たす string 値を持つ titleフィールドを含むドキュメントを追加します。

db.movies.insertOne(
   { title: "The Conversation", year: 1974 }
)

結果を確認します。

ドキュメントが検証ルールを満たすため、挿入は成功します。 MongoDB は、次のような出力を返します。

{
  acknowledged: true,
  insertedId: ...
}

（条件付き） をvalidationLevel strictに設定します。

コレクションのvalidationLevel がまだstrict でない場合は、手順に従って厳密な検証を指定します。

レベルのコレクションを準備します。constraint

を collModprepareConstraintValidationLevelに設定して を実行します。true

db.runCommand( {
   collMod: "movies",
   prepareConstraintValidationLevel: true
} )

このコマンドは、bypassDocumentValidation をブロックし、バリデーターへの変更を防ぐことで、コレクションをアップグレード用に準備します。

検証レベルをconstraint に設定します。

を実行して、 を collModに設定します。 はvalidationLevelconstraintvalidationAction errorまたは である必要があります。errorAndLog

db.runCommand( {
   collMod: "movies",
   validationLevel: "constraint",
   validationAction: "error"
} )

validationLevel を constraint にアップグレードする同じ collMod操作で validator を変更することはできません。このコマンドを実行する前に検証ルールを設定します。後でルールを変更するには、レベルを strict にダウングレードし、ルールを変更してから constraint にアップグレードします。

validationLevel が constraint であるため、 MongoDB は、アップグレード前に既存のドキュメントがルールを満たしているかどうかに関係なく、すべてのドキュメントの挿入とアップデートに検証ルールを適用します。

レベルを constraint に設定すると、 MongoDB はコレクション内の既存のドキュメントをすべてスキャンし、バリデーターに違反するドキュメントがある場合は collMod操作を失敗させます。このスキャンは、大規模なコレクションでは計算コストが高くなる可能性があります。操作が失敗した場合は、続行する前に、違反しているドキュメントを更新してバリデーターに合格してください。

Insert a valid document.

次の挿入コマンドは、検証ルールを満たす string 値を持つ titleフィールドを含むドキュメントを追加します。

db.movies.insertOne(
   { title: "Sunrise", year: 1927 }
)

結果を確認します。

ドキュメントが検証ルールを満たすため、挿入は成功します。 MongoDB は、次のような出力を返します。

{
  acknowledged: true,
  insertedId: ...
}