db.getCollectionNames() (método mongosh)

Definición

db.getCollectionNames(): Devuelve un arreglo que contiene los nombres de todas las colecciones y vistas en la base de datos actual, o si se ejecuta con control de acceso, los nombres de las colecciones según los privilegios del usuario. Para más detalles, consulta Acceso requerido.

Compatibilidad

Este método está disponible en implementaciones alojadas en los siguientes entornos:

MongoDB Atlas: El servicio totalmente gestionado para implementaciones de MongoDB en la nube

Nota

This command is supported in all MongoDB Atlas clusters. For information on Atlas support for all commands, see Unsupported Commands.

MongoDB Enterprise: La versión basada en suscripción y autogestionada de MongoDB
MongoDB Community: La versión de MongoDB con código fuente disponible, de uso gratuito y autogestionada.

Acceso requerido

The db.getCollectionNames() is equivalent to:

db.runCommand(
   {
       listCollections: 1.0,
       authorizedCollections: true,
       nameOnly: true
   }
)

Para los usuarios con los privilegios requeridos (privilegios que otorgan acción listCollections en la base de datos), el método lista los nombres de todas las colecciones de la base de datos.
Para los usuarios sin el acceso requerido, el método solo muestra las colecciones para las cuales los usuarios tienen privilegios. Por ejemplo, si un usuario tiene find en una colección específica en una base de datos, el método sólo devolvería esa colección.

Comportamiento

Desconexión del cliente

If the client that issued db.getCollectionNames() disconnects before the operation completes, MongoDB marks db.getCollectionNames() for termination using killOp.

Restricción del estado del set de réplicas

Para que se ejecuten en un set de réplicas, las operaciones de listCollections requieren que el nodo esté en estado PRIMARY o SECONDARY. Si el nodo se encuentra en otro estado, como STARTUP2, se produce un error en la operación.

Ejemplo

Lo siguiente devuelve los nombres de todas las colecciones en la base de datos records:

use records
db.getCollectionNames()

El método devuelve los nombres de las colecciones en un arreglo:

[ "employees", "products", "mylogs", "system.indexes" ]

Volver

db.getCollectionInfos

db.getLogComponents