listCollections (comando de base de datos)

Definición

listCollections

Recupere información, incluidos los nombres y las opciones de creación, para las colecciones y vistas en una base de datos.

El comando listCollections devuelve una lista sin ordenar de todas las colección y vistas en la base de datos. Utilice el documento devuelto para crear un cursor en la colección.

mongosh proporciona los métodos auxiliares db.getCollectionInfos() y, así como db.getCollectionNames() el comando show collections.

Compatibilidad

Este comando 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.

Sintaxis

El comando tiene la siguiente sintaxis:

db.runCommand(
   {
     listCollections: 1,
     filter: <document>,
     nameOnly: <boolean>,
     authorizedCollections: <boolean>,
     comment: <any>
   }
)

Campos de comandos

El comando puede aceptar los siguientes campos opcionales:

Comportamiento

Acceso requerido

El comandolistCollectionsy su contenedordb.getCollectionInfos()requieren la acciónlistCollectionscuando se aplica el control de acceso. Los usuarios deben tener privilegios que otorguen la acción listCollections en la base de datos para ejecutar listCollections.

Por ejemplo, el siguiente comando otorga el privilegio de ejecutar db.getCollectionInfos() en la base de datos test:

{ resource: { db: "test", collection: "" }, actions: [ "listCollections" ] }

El rol con funcionalidad incorporada read proporciona el privilegio de ejecutar listCollections para una base de datos específica.

Los usuarios sin el privilegio read necesario pueden ejecutar listCollections cuando authorizedCollections y nameOnly están configurados en true. En este caso, el comando devuelve los nombres y tipos de las colecciones donde el usuario tiene privilegios.

Por ejemplo, considere a un usuario con un rol que concede el siguiente privilegio find:

{ resource: { db: "sales", collection: "currentQuarter" }, actions: [ "find" ] }

El usuario puede ejecutar listCollections si authorizedCollections y nameOnly están configurados en true.

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

La operación devuelve el nombre y el tipo de la colección currentQuarter.

Sin embargo, las siguientes operaciones devuelven un error si el usuario no tiene la autorización de acceso requerida:

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

Salida

listCollections.cursor

Un documento que contiene la información necesaria para crear un cursor a documentos que contienen nombres de colecciones y opciones. La información del cursor incluye el cursor id, el grupo completo para el comando y el primer agrupar de resultados. Cada documento en la salida por grupos contiene los siguientes campos:

Campo	Tipo	Descripción
Nombre	String	Nombre de la colección.
tipo	String	Tipo de almacén de datos. Devuelve collection para colecciones, view para vistas y timeseries para colecciones de series temporales.
opciones	Documento	Opciones de colección. Estas opciones corresponden a las opciones disponibles en db.createCollection(). Para obtener descripciones de las opciones, consulte db.createCollection().
información	Documento	Enumere los siguientes campos relacionados con la colección: Solo lectura boolean. Si true, el almacén de datos es de solo lectura. uuid UUID. Una vez establecido, el UUID de la colección no cambia. El UUID de la colección permanece igual entre los nodos del set de réplicas y las particiones en un clúster.
idIndex	Documento	Proporciona información sobre el índice _id de la colección.

listCollections.ok

El valor de retorno del comando. Un valor de 1 indica el éxito.

Si no requiere una respuesta de comando sin procesar, utiliza el db.getCollectionInfos() o los métodos del asistente db.getCollectionNames().

Ejemplo

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

{
  cursor: {
    id: Long('0'),
    ns: 'sample_mflix.$cmd.listCollections',
    firstBatch: [
      { name: 'movies', type: 'collection' },
      { name: 'theaters', type: 'collection' },
      { name: 'users', type: 'collection' },
      { name: 'embedded_movies', type: 'collection' },
      { name: 'sessions', type: 'collection' },
      { name: 'comments', type: 'collection' },
      { name: 'system.views', type: 'collection' }
    ]
  },
  ok: 1
}

db.runCommand(
   {
      listCollections: 1.0
   }
)

{
  cursor: {
    id: Long('0'),
    ns: 'sample_mflix.$cmd.listCollections',
    firstBatch: [
      {
        name: 'movies',
        type: 'collection',
        options: {},
        info: { ... },
        idIndex: { v: 2, key: { _id: 1 }, name: '_id_' }
      },
      {
        name: 'theaters',
        type: 'collection',
        options: {},
        info: { ... },
        idIndex: { v: 2, key: { _id: 1 }, name: '_id_' }
      },
      {
        name: 'users',
        type: 'collection',
        options: {},
        info: { ... },
        idIndex: { v: 2, key: { _id: 1 }, name: '_id_' }
      },
      {
        name: 'embedded_movies',
        type: 'collection',
        options: {},
        info: { ... },
        idIndex: { v: 2, key: { _id: 1 }, name: '_id_' }
      },
      {
        name: 'sessions',
        type: 'collection',
        options: {},
        info: { ... },
        idIndex: { v: 2, key: { _id: 1 }, name: '_id_' }
      },
      {
        name: 'comments',
        type: 'collection',
        options: {},
        info: { ... },
        idIndex: { v: 2, key: { _id: 1 }, name: '_id_' }
      },
      {
        name: 'system.views',
        type: 'collection',
        options: {},
        info: { ... },
        idIndex: { v: 2, key: { _id: 1 }, name: '_id_' }
      }
    ]
  },
  ok: 1
}

Obtén más información

Para las opciones de colección:

• db.createCollection()

• create

Para obtener información sobre la colección:

• db.getCollectionInfos()

• comandos con funcionalidad incorporada de mongosh