AI エージェント向け: ドキュメントインデックスは https://www.mongodb.com/ja-jp/docs/llms.txt で利用できます。すべてのページの markdown バージョンは、いずれかの URL パスに .md を追加することで利用できます。

シャードキーではないフィールドに一意性を強制する

一意のフィールドをシャードキーとして使用できない場合や、複数のフィールドに一意性を強制する必要がある場合は、プロキシコレクションとして機能する別のコレクションを作成してください。

シャーディングされたクラスターがシャード間でユニーク制約を強制するのは、ユニークインデックスがシャードキー上にあるか、またはシャードキーをプレフィックスとして含む場合のみです。プロキシコレクションはその制約を回避します。プロキシコレクションには元のドキュメントへの参照とユニークキーの両方が含まれており、アプリケーションは最初にプロキシコレクションに書き込み (write)を行います。

プロキシコレクションを使用する場合は、次の点に注意してください。

  • アプリケーションは、ドキュメントをプロキシコレクションに挿入する際にエラーをキャッチする必要があります。いずれかの挿入が失敗した場合にコレクションが分岐しないように、トランザクションで両方のコレクションに書き込み (write)を行います。

  • プロキシ コレクションでシャーディングが必要な場合は、一意性を強制したい単一フィールドでシャードする必要があります。

  • 各フィールドには、独自のプロキシ コレクションが必要です。シャーディングされたプロキシ コレクションを使用して複数のフィールドに一意性を強制するには、フィールドごとに 1 つのプロキシ コレクションが必要です。1 つのプロキシ コレクションに複数のユニークインデックスを作成した場合、プロキシ コレクションをシャードすることはできません。

  • このアプローチでは、ドキュメントの挿入時にMongoDBが自動的に作成するのではなく、アプリケーションで_id値を生成する必要があります。これにより、両方のドキュメントが同じ_idを共有できるようになります。

シャーディングされたコレクションのユニークインデックスに適用される制約の全セットについては、「シャーディングされたクラスターでの一意性の維持」を参照してください。

  • 一意制約が必要だが、シャードキーの一部にすることはできないフィールドを特定します。

  • 既存のドキュメントの中に、そのフィールドのユニーク制約に違反するものがないことを確認します。

  • mongosh を mongos インスタンスに接続します。

ユーザー情報を保存するコレクション records を考慮します。フィールド email はシャードキーではありませんが、一意である必要があります。proxyコレクションには、次のフィールドが含まれています。

{ "_id" : ObjectId("..."), "email" : "<string>"}
1

proxy コレクションの email フィールドにユニークインデックスを作成します。

db.proxy.createIndex( { "email" : 1 }, { unique : true } )
email_1
2

ターゲット フィールドと生成された一意の ID を含むドキュメントを proxy コレクションに挿入し、次に完全なドキュメントを records コレクションに挿入します。MongoDB が両方の書き込み (write) を適用するか、どちらも適用しないように、トランザクションで両方の挿入を実行します。

// Start a sessionsession = db.getMongo().startSession( { readPreference: { mode: "primary" } } );proxy = session.getDatabase( db.getName() ).proxy;records = session.getDatabase( db.getName() ).records; var primary_id = ObjectId(); // Start a transactionsession.startTransaction( { readConcern: { level: "local" }, writeConcern: { w: "majority" } } ); // Operations inside the transactiontry { proxy.insertOne( { "_id" : primary_id, "email" : "example@example.net" } ); records.insertOne( { "_id" : primary_id, "email" : "example@example.net", // additional information... } );} catch (error) { // A duplicate email value fails the proxy insert and // cancels the transaction session.abortTransaction(); throw error;}// Commit the transaction using write concern set at transaction startsession.commitTransaction();session.endSession();

email の値が proxy コレクションに既に存在する場合、ユニークインデックスは挿入を拒否し、トランザクションは中止されるため、records にドキュメントは追加されません。