Skip to content

Commit d02f5d9

Browse files
committed
DOCS-5672 clarify --drop for mongorestore
1 parent 6fa54c1 commit d02f5d9

File tree

1 file changed

+12
-9
lines changed

1 file changed

+12
-9
lines changed

source/includes/options-mongorestore.yaml

Lines changed: 12 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -236,16 +236,19 @@ name: drop
236236
directive: option
237237
args: null
238238
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.
241251
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.
249252
optional: true
250253
---
251254
program: mongorestore

0 commit comments

Comments
 (0)