applyOps¶

On this page

Definition
Behavior

Definition¶

applyOps¶

Applies specified oplog entries to a mongod instance. The applyOps command is primarily an internal command.

If authorization is enabled, you must have access to all actions on all resources in order to run applyOps. Providing such access is not recommended, but if your organization requires a user to run applyOps, create a role that grants anyAction on anyResource. Do not assign this role to any other user.

The applyOps command has the following prototype form:

db.runCommand( { applyOps: [ <operations> ],
                 preCondition: [ { ns: <namespace>, q: <query>, res: <result> } ],
                 bypassDocumentValidation: <boolean> } )

The applyOps command takes a document with the following fields:

Field	Type	Description
`applyOps`	array	The oplog entries to apply.
`preCondition`	array	Optional. An array of documents that contain the conditions that must be true in order to apply the oplog entry. Each document contains a set of conditions, as described in the next table.
`alwaysUpsert`	boolean	Optional. A flag that indicates whether to apply update operations in the oplog as upserts. When `true`, all updates become upserts to prevent failures as a results of sequences of updates followed by deletes: this is the same mode of operation as normal replication in secondaries. When `false`, updates are applied unmodified: this is the same mode of operation used during initial sync operations. `true` by default.
`bypassDocumentValidation`	boolean	Optional. Enables `applyOps` to bypass document validation during the operation. This lets you insert or update documents that do not meet the validation requirements. 3.2 新版功能.

The preCondition array takes one or more documents with the following fields:

Field	Type	Description
`ns`	string	A namespace. If you use this field, `applyOps` applies oplog entries only for the collection described by this namespace.
`q`	string	Specifies the query that produces the results specified in the `res` field.
`res`	string	The results of the query in the `q` field that must match to apply the oplog entry.

Behavior¶

警告

This command obtains a global write lock and will block other operations until it has completed.

← resync isMaster →