/ /

/ /

Librerías de clientes

Fundamentals

Operaciones CRUD

Lea

Contabilizar documentos

Overview

En esta guía, puedes aprender cómo obtener un preciso y estimado recuento del número de documentos en tu colección.

Datos de muestra

Los ejemplos de esta sección usan lo siguiente Tea struct como modelo para documentos en la colección tea:

type Tea struct {
	Type   string
	Rating int32
}

Para ejecutar los ejemplos en esta guía, cargue los datos de muestra en la colección tea de la base de datos db con el siguiente snippet:

coll := client.Database("db").Collection("tea")
docs := []interface{}{
	Tea{Type: "Masala", Rating: 10},
	Tea{Type: "Matcha", Rating: 7},
	Tea{Type: "Assam", Rating: 4},
	Tea{Type: "Oolong", Rating: 9},
	Tea{Type: "Chrysanthemum", Rating: 5},
	Tea{Type: "Earl Grey", Rating: 8},
	Tea{Type: "Jasmine", Rating: 3},
	Tea{Type: "English Breakfast", Rating: 6},
	Tea{Type: "White Peony", Rating: 4},
}
result, err := coll.InsertMany(context.TODO(), docs)

Tip

Bases de datos y colecciones inexistentes

Si la base de datos y la colección necesarias no existen cuando realizas una operación de guardar, el servidor las crea implícitamente.

Cada documento describe un tipo de té y su calificación. Estos elementos corresponden a los campos type y rating.

Conteo preciso

Para contar el número de documentos que coinciden con el filtro de query, use el método CountDocuments(). Si pasas un filtro de query vacío, este método devuelve el número total de documentos en la colección.

Tip

Cuando usas CountDocuments() para devolver el número total de documentos en una colección, MongoDB realiza un escaneo de la colección. Puedes evitar un escaneo de colección y mejorar el rendimiento de este método usando una sugerencia para aprovechar la funcionalidad incorporada en el índice en el campo _id. Usa esta técnica solo cuando llames a CountDocuments() con un parámetro de query vacío.

opts := options.Count().SetHint("_id_")
count, err := coll.CountDocuments(context.TODO(), bson.D{}, opts)
if err != nil {
     panic(err)
}

Modificar comportamiento

Puedes modificar el comportamiento de CountDocuments() pasando un tipo CountOptions. Si no se especifican opciones, el driver utiliza sus valores por defecto.

El tipo CountOptions te permite configurar opciones con los siguientes métodos:

Método	Descripción
`SetCollation()`	The type of language collation to use when sorting results. Default: `nil`
`SetHint()`	The index to use to scan for documents to count. Default: `nil`
`SetLimit()`	The maximum number of documents to count. Default: `0`
`SetMaxTime()`	The maximum amount of time that the query can run on the server. Default: `nil`
`SetSkip()`	The number of documents to skip before counting. Default: `0`

Ejemplo

El siguiente ejemplo cuenta el número de documentos donde el rating es menor que 6:

filter := bson.D{{"rating", bson.D{{"$lt", 6}}}}
count, err := coll.CountDocuments(context.TODO(), filter)
if err != nil {
    panic(err)
}
fmt.Printf("Number of documents with a rating less than six: %d\n", count)

Number of documents with a rating less than six: 4

Agregación

También puedes incluir la etapa $count para contar el número de documentos en una pipeline de agregación.

Ejemplo

El siguiente ejemplo realiza las siguientes acciones:

Cuenta el número de documentos en los que el valor del campo rating es mayor que 5
Asigna el recuento al campo counted_documents

matchStage := bson.D{{"$match", bson.D{{"rating", bson.D{{"$gt", 5}}}}}}
countStage := bson.D{{"$count", "counted_documents"}}
cursor, err := coll.Aggregate(context.TODO(), mongo.Pipeline{matchStage, countStage})
if err != nil {
   panic(err)
}
var results []bson.D
if err = cursor.All(context.TODO(), &results); err != nil {
   panic(err)
}
for _, result := range results {
   fmt.Println(result)
}

[{counted_documents 5}]

Recuento estimado

Para estimar el número de documentos en tu colección, usa el método EstimatedDocumentCount().

Nota

El método EstimatedDocumentCount() es más rápido que el método CountDocuments() porque utiliza los metadatos de la colección en lugar de escanear toda la colección.

Modificar comportamiento

Puedes modificar el comportamiento de EstimatedDocumentCount() pasando un tipo EstimatedDocumentCountOptions. Si no especificas ninguna opción, el driver utiliza sus valores por defecto.

El tipo EstimatedDocumentCountOptions te permite configurar opciones con los siguientes métodos:

Método	Descripción
`SetMaxTime()`	The maximum amount of time that the query can run on the server. Default: `nil`

Ejemplo

El siguiente ejemplo estima el número de documentos en la colección tea:

count, err := coll.EstimatedDocumentCount(context.TODO())
if err != nil {
   panic(err)
}
fmt.Printf("Estimated number of documents in the tea collection: %d\n", count)

Estimated number of documents in the tea collection: 9

Información Adicional

Para aprender más sobre las operaciones mencionadas, consulte las siguientes guías:

Documentación de la API

Para obtener más información sobre cualquiera de los métodos o tipos discutidos en esta guía, consultar la siguiente documentación de la API:

Volver

Retrieve Data

Cursores de datos