db.getCollection() (método mongosh)

Definición

db.getCollection(name)

Devuelve una colección o un objeto de vista que es funcionalmente equivalente a usar la db.<collectionName> sintaxis. Este método es útil para una colección o una vista cuyo nombre podría interactuar con, como nombres que comienzan mongosh con _ o que coinciden con un método de la consola de la base de datos.

El método tiene el siguiente db.getCollection() parámetro:

Parameter	Tipo	Descripción
name	string	El nombre de la colección.

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

• 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.

Comportamiento

El objeto puede acceder a db.getCollection() cualquier método de colección.

La colección especificada puede o no existir en el servidor. Si la colección no existe, MongoDB la crea implícitamente como parte de operaciones de guardar como db.collection.insertOne().

Ejemplo

El siguiente ejemplo utiliza para acceder a db.getCollection() la auth colección e insertar un documento en ella.

var authColl = db.getCollection("auth")
authColl.insertOne(
   {
       usrName : "John Doe",
       usrDept : "Sales",
       usrTitle : "Executive Account Manager",
       authLevel : 4,
       authDept : [ "Sales", "Customers"]
   }
)

Esto regresa:

{
   "acknowledged" : true,
   "insertedId" : ObjectId("569525e144fe66d60b772763")
}

El ejemplo anterior requiere el uso dedb.getCollection("auth")debido a un conflicto de nombres con el método de base de datosdb.auth(). Llamar directamente a db.auth para realizar una operación de inserción haría referencia al métododb.auth()y generaría un error.

El siguiente ejemplo intenta realizar la misma operación, pero sin utilizar el db.getCollection() método:

db.auth.insertOne(
   {
       usrName : "John Doe",
       usrDept : "Sales",
       usrTitle : "Executive Account Manager",
       authLevel : 4,
       authDept : [ "Sales", "Customers"]
   }
)

Los errores de la operación como el método db.auth() no tienen método insertOne.