@@ -236,16 +236,19 @@ name: drop
236
236
directive : option
237
237
args : null
238
238
description : |
239
- Modifies the restoration procedure to drop every collection from the
240
- target database before restoring the collection from the dumped backup.
239
+ Before restoring the collections from the dumped backup, drops the
240
+ collections from the target database. {{role}} does not drop
241
+ collections that are not in the backup.
242
+
243
+ When the restore includes the ``admin`` database, {{program}} with
244
+ {{role}} removes all user credentials and replaces them with the
245
+ users defined in the dump file. Therefore, in systems with
246
+ :setting:`~security.authorization` enabled, {{program}} must be able
247
+ to authenticate to an existing user *and* to a user defined in the
248
+ dump file. If {{program}} can't authenticate to a user defined in the
249
+ dump file, the restoration process will fail, leaving an empty
250
+ database.
241
251
242
- With {{role}} specified, {{program}} removes all user
243
- credentials and replaces them with users defined in the dump
244
- file. Therefore, in systems with :setting:`~security.authorization`
245
- enabled, {{program}} must be able to authenticate to an existing
246
- user *and* to a user defined in the dump file. If {{program}} can't
247
- authenticate to a user defined in the dump file, the restoration
248
- process will fail, leaving an empty database.
249
252
optional : true
250
253
---
251
254
program : mongorestore
0 commit comments