$ifNull (operador de expresión)

Definición

$ifNull

La expresión $ifNull evalúa las expresiones de entrada para valores nulos y devuelve:

• El primer valor de expresión de entrada no nulo que se encontró.

• Un valor de expresión de reemplazo si todas las expresiones de entrada se evalúan como nulas.

$ifNull trata los valores indefinidos y los campos faltantes como nulos.

Compatibilidad

Puedes usar $ifNull para 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

{
   $ifNull: [
      <input-expression-1>,
      ...
      <input-expression-n>,
      <replacement-expression-if-null>
   ]
}

Ejemplos

Los ejemplos de esta página utilizan datos del conjunto de datos sample_mflix. Para obtener más información sobre cómo cargar este conjunto de datos en su implementación autogestionada de MongoDB, consulte Cargar el conjunto de datos de ejemplo. Si realizó alguna modificación en las bases de datos de ejemplo, es posible que deba eliminarlas y volver a crearlas para ejecutar los ejemplos de esta página.

db.movies.aggregate(
   [
      { $match: { year: { $lt: 1910 } } },
      {
         $project: {
            _id: 0,
            title: 1,
            rated: { $ifNull: [ "$rated", "Not Rated" ] }
         }
      },
      { $sort: { title: 1 } }
   ]
)

[
  { title: 'A Corner in Wheat', rated: 'G' },
  { title: 'The Great Train Robbery', rated: 'TV-G' },
  { title: 'The Kiss', rated: 'Not Rated' },
  { title: 'The Kiss', rated: 'Not Rated' }
]

db.movies.aggregate(
   [
      { $match: { year: { $lt: 1910 } } },
      {
         $project: {
            _id: 0,
            title: 1,
            rating: { $ifNull: [ "$tomatoes.critic.rating", "$tomatoes.viewer.rating", 0 ] }
         }
      },
      { $sort: { title: 1 } }
   ]
)

[
  { title: 'A Corner in Wheat', rating: 3.6 },
  { title: 'The Great Train Robbery', rating: 7.6 },
  { title: 'The Kiss', rating: 4 },
  { title: 'The Kiss', rating: 0 }
]