dropAllUsersFromDatabase.txt

========================
dropAllUsersFromDatabase
========================

.. default-domain:: mongodb

.. contents:: On this page
   :local:
   :backlinks: none
   :depth: 1
   :class: singlecol

Definition
----------

.. dbcommand:: dropAllUsersFromDatabase

   Removes all users from the database on which you run the
   command.

   .. warning::

      The :dbcommand:`dropAllUsersFromDatabase` removes all users from the database.

   The :dbcommand:`dropAllUsersFromDatabase` command has the following
   syntax:

   .. code-block:: javascript

      { dropAllUsersFromDatabase: 1,
        writeConcern: { <write concern> }
      }

   The :dbcommand:`dropAllUsersFromDatabase` document has the following
   fields:


   .. list-table::
      :header-rows: 1
      :widths: 20 20 80
   
      * - Field
   
        - Type
   
        - Description
   
      * - ``dropAllUsersFromDatabase``
   
        - integer
   
        - Specify ``1`` to drop all the users from the current database.
          
          
   
      * - ``writeConcern``
   
        - document
   
        - Optional. The level of :doc:`write concern </reference/write-concern>` for the
          removal operation. The ``writeConcern`` document takes the same
          fields as the :dbcommand:`getLastError` command.
          
          
   


Required Access
---------------

.. |local-cmd-name| replace:: :command:`dropAllUsersFromDatabase`

.. include:: /includes/access-drop-user.rst

Example
-------

The following sequence of operations in the :binary:`~bin.mongo` shell drops
every user from the ``products`` database:

.. code-block:: javascript

   use products
   db.runCommand( { dropAllUsersFromDatabase: 1, writeConcern: { w: "majority" } } )

The ``n`` field in the results document shows the number of users
removed:

.. code-block:: javascript

   { "n" : 12, "ok" : 1 }