Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# \$1avg
<a name="avg"></a>

El operador de `$avg` agregación de Amazon DocumentDB calcula el valor medio de la expresión especificada en todos los documentos que se introducen en la etapa. Este operador es útil para calcular el promedio de un campo numérico o una expresión en un conjunto de documentos.

**Parámetros**
+ `expression`: la expresión que se utilizará para calcular el promedio. Puede ser una ruta de campo (p. ej.`"$field"`) o una expresión (p. ej.`{ $multiply: ["$field1", "$field2"] }`).

## Ejemplo (MongoDB Shell)
<a name="avg-examples"></a>

El siguiente ejemplo muestra cómo utilizar el `$avg` operador para calcular la puntuación media de un conjunto de documentos de los estudiantes.

**Cree documentos de muestra**

```
db.students.insertMany([
  { name: "John", score: 85 },
  { name: "Jane", score: 92 },
  { name: "Bob", score: 78 },
  { name: "Alice", score: 90 }
]);
```

**Ejemplo de consulta**

```
db.students.aggregate([
  { $group: { 
    _id: null,
    avgScore: { $avg: "$score" }
  }}
]);
```

**Salida**

```
[
  {
    "_id": null,
    "avgScore": 86.25
  }
]
```

## Ejemplos de código
<a name="avg-code"></a>

Para ver un ejemplo de código para usar el `$avg` comando, elija la pestaña del idioma que desee usar:

------
#### [ Node.js ]

```
const { MongoClient } = require('mongodb');

async function calculateAvgScore() {
  const client = await MongoClient.connect('mongodb://<username>:<password>@<cluster-endpoint>:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
  const db = client.db('test');
  const result = await db.collection('students').aggregate([
    { $group: {
      _id: null,
      avgScore: { $avg: '$score' }
    }}
  ]).toArray();
  console.log(result);
  await client.close();
}

calculateAvgScore();
```

------
#### [ Python ]

```
from pymongo import MongoClient

def calculate_avg_score():
    client = MongoClient('mongodb://<username>:<password>@<cluster-endpoint>:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
    db = client.test
    result = list(db.students.aggregate([
        { '$group': {
            '_id': None,
            'avgScore': { '$avg': '$score' }
        }}
    ]))
    print(result)
    client.close()

calculate_avg_score()
```

------