スキーマ検証

Overview

このガイドでは、Rust ドライバーを使用して MongoDB コレクションのスキーマ検証を実装する方法を学習できます。

スキーマ検証を実装するには、一連の検証ルールで構成される JSON schema を提供する必要があります。 スキーマ検証を実装すると、サーバーは検証ルールに従う書込み操作のみを実行できるようになります。 スキーマ検証 を使用して、指定されたコレクション内のドキュメント フィールドのデータ型と値の範囲を制限します。

ドライバー メソッドを使用してコレクションを作成するときにスキーマ検証ルールを定義することも、 collMod MongoDB コマンドを使用して既存のコレクションに追加することもできます。 このガイドでは、コレクションの作成時にスキーマ検証を有効にする方法のみについて説明します。 既存のコレクションでスキーマ検証を有効にする方法の詳細については、サーバー マニュアルの collModを参照してください。

JSON スキーマ検証

スキーマ検証ルールを使用してコレクションを作成する前に、 JSON schemaを定義する必要があります。

JSON schema は、コレクションの 検証ルールを指定するキーと値のペアを含む JSON オブジェクトです。 最上位では、このオブジェクトには$jsonSchemaオブジェクトが含まれている必要があります。 $jsonSchemaオブジェクトには次のフィールドが含まれます。

• title : スキーマの説明を任意に設定します。

• 必須: コレクション内の各ドキュメントの必須 フィールドのリストを指定します。

• properties : 個々のフィールドのプロパティ要件を設定します。

JSON schemaオブジェクト フィールドの完全なリストについては、サーバー マニュアルの「 JSON schema 」を参照してください。

スキーマ検証の実装

スキーマと関連するオプションをCreateCollectionOptionsオプション ビルダ メソッドに渡すことで、スキーマ検証を実装できます。

新しいコレクションの検証オプションを指定するには、次のCreateCollectionOptionsメソッドを呼び出します。

let validator =
    doc! {
        "$jsonSchema": doc! {
           "bsonType": "object",
           "title": "Answer Value Validation",
           "properties": doc! {
              "answer": doc! {
                 "enum": vec! [ "yes", "no" ],
              }
           }
        }
    };
db.create_collection("survey_answers")
    .validator(validator)
    .validation_action(ValidationAction::Error)
    .validation_level(ValidationLevel::Moderate)
    .await?;

{
  "_id": { ... },
  "question": "Do you like to exercise?",
  "answer": "yes"
},
{
  "_id": { ... },
  "question": "Do you like to play computer games?",
  "answer": "no"
}

{
  "_id": { ... },
  "question": "Do you like to exercise?",
  "answer": "depends on my mood"
}

Error: Error { kind: Write(WriteError(WriteError { code: 121, code_name:
None, message: "Document failed validation", details:
Some(Document({"failingDocumentId":
ObjectId("..."), "details":
Document({"operatorName": String("$jsonSchema"), "title": String("Answer
Value Validation"), ... })})) })), ... }

詳細情報

このページで言及されている MongoDB Server 操作の詳細については、サーバー マニュアルの次のドキュメントを参照してください。

• collMod コマンドの検証操作

• スキーマ検証

• Specify JSON Schema Validation