Docs Menu

db.getCollectionNames()

On this page

  • Definition
  • Considerations
  • Required Access
  • Behavior
  • Example
db.getCollectionNames()

Returns an array containing the names of all collections and views in the current database, or if running with access control, the names of the collections according to user's privilege. For details, see Required Access.

Changed in version 4.0: db.getCollectionNames() no longer locks the collections to return name information.

Starting in version 4.0 of the mongo shell, db.getCollectionNames() is equivalent to:

db.runCommand( { listCollections: 1.0, authorizedCollections: true, nameOnly: true } )
  • For users with the required access (privileges that grant listCollections action on the database), the method lists the names of all collections for the database.
  • For users without the required access, the method lists only the collections for which the users has privileges. For example, if a user has find on a specific collection in a database, the method would return just that collection.

Starting in MongoDB 4.2, if the client that issued the db.getCollectionNames() disconnects before the operation completes, MongoDB marks the db.getCollectionNames() for termination (i.e. killOp on the operation).

Starting in MongoDB 4.4, to run on a replica set member, listCollections operations require the member to be in PRIMARY or SECONDARY state. If the member is in another state, such as STARTUP2, the operation errors.

In previous versions, the operations can also be run when the member is in STARTUP2. However, the operations wait until the member transitions to RECOVERING.

The following returns the names of all collections in the records database:

use records
db.getCollectionNames()

The method returns the names of the collections in an array:

[ "employees", "products", "mylogs", "system.indexes" ]
Give Feedback
© 2021 MongoDB, Inc.

About

  • Careers
  • Legal Notices
  • Privacy Notices
  • Security Information
  • Trust Center
© 2021 MongoDB, Inc.