/ /

/ /

Librerías de clientes

Fundamentals

Operaciones CRUD

Lea

Contabilizar documentos

Overview

En esta guía podrás aprender cómo obtener un recuento preciso y estimado del número de documentos de su colección.

Datos de muestra

Los ejemplos de esta sección utilizan lo siguiente: Tea Estructura como modelo para los documentos de la colección tea:

type Tea struct {
	Type   string
	Rating int32
}

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

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 realiza una operación de escritura, el servidor las crea implícitamente.

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

Conteo preciso

Para contar el número de documentos que coinciden con su filtro de consulta, utilice el método CountDocuments(). Si pasa un filtro de consulta vacío, este método devuelve el número total de documentos de la colección.

Tip

Al usar CountDocuments() para devolver el número total de documentos de una colección, MongoDB realiza un escaneo de la colección. Puede evitarlo y mejorar el rendimiento de este método usando una sugerencia para aprovechar el índice integrado en el _id campo. Use esta técnica solo al llamar a CountDocuments() con un parámetro de consulta vacío.

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

Modificar el comportamiento

Puede modificar el comportamiento de CountDocuments() pasando un tipo CountOptions. Si no especifica ninguna opción, el controlador usa sus valores predeterminados.

El tipo CountOptions le 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 la cantidad de documentos donde 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 puede incluir la etapa $count para contar la cantidad de documentos en una canalización 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 la cantidad de documentos en su colección, utilice 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 el comportamiento

Puede modificar el comportamiento de EstimatedDocumentCount() pasando un tipo EstimatedDocumentCountOptions. Si no especifica ninguna opción, el controlador usa sus valores predeterminados.

El tipo EstimatedDocumentCountOptions le 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 la cantidad 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 obtener más información 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