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

検証レベルが 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.

次のinsertコマンドは、文字列値を持つ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.

次のinsertコマンドは、文字列値を持つtitleフィールドを含むドキュメントを追加します。これは検証ルールを満たしています。

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

結果を確認します。

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

{  acknowledged: true,  insertedId: ...}

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

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

constraint レベルに向けてコレクションを準備します。

prepareConstraintValidationLevel を true に設定して collMod を実行する:

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

このコマンドは、bypassDocumentValidationをブロックし、バリデーターへの変更を防止することで、アップグレードに向けてコレクションを準備します。MongoDBがバイパスを制限することを学ぶには、「スキーマ検証のバイパス」を参照してください。

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

collMod を実行して、validationLevel を constraint に設定します。validationAction は 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.

次のinsertコマンドは、文字列値を持つtitleフィールドを含むドキュメントを追加します。これは検証ルールを満たしています。

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

結果を確認します。

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

{  acknowledged: true,  insertedId: ...}