/ /

Usar vistas con MongoDB Search

Puedes crear un índice de búsqueda de MongoDB en una Vista para transformar documentos y colecciones. Esto le permite indexar parcialmente una colección, admitir tipos de datos o modelos de datos incompatibles, y más.

Los siguientes ejemplos utilizan las bases de datos de muestra sample_mflix y sample_airbnb.

Nota

Desambiguación

Esta página discute las vistas estándar. Para aprender más sobre las vistas materializadas on-demand, consulte Vistas materializadas On-demand.

Para aprender sobre las diferencias entre los tipos de vistas, se puede consultar Comparación con vistas materializadas on-demand.

Requisitos

Debes usar MongoDB 8.0 o superior.

En MongoDB v8.0+:
- Utiliza la interfaz de usuario de Atlas o la API de administración de Atlas para crear índices de MongoDB Search en las vistas.
- Ejecuta las queries de MongoDB Search en la colección de origen. Hace referencia al índice de MongoDB Search que se creó en la Vista. Estas queries devuelven los documentos originales tal como aparecen en la colección de origen.
En MongoDB v8.1+, también puedes:
- Utilice los métodos de mongosh y Driver, db.collection.createSearchIndex(), db.collection.updateSearchIndex(), db.collection.dropSearchIndex(), y $listSearchIndexes para crear y gestionar índices de búsqueda de MongoDB en Vistas.
- Ejecutar las consultas de MongoDB Search contra la vista.
En MongoDB v8.2+, también puedes:
- Utilice $rankFusion en pipeline de agregación en Views.
- Query Views que incluyen sub-pipeline particionados con $lookup y $unionWith.

Para editar una Vista, debes tener el rol de Administrador de Usuario y utilizar el comando collMod comando de base de datos.

Limitaciones

MongoDB Search admite vistas con las siguientes etapas:
Puede utilizar el operador $expr únicamente dentro de la etapa $match.
Los nombres de los índices deben ser únicos en toda una colección de fuente y todas sus vistas.
MongoDB Search no admite definiciones de vistas con operadores que producen resultados dinámicos, como la variable del sistema $$USER_ROLES y el operador de agregación $rand.
MongoDB Search queries devuelven los documentos originales tal como aparecen en la colección de origen.

Para recuperar el documento transformado, use la storedSource opción.

Interfaz

Permisos requeridos

Para crear una Vista, tu rol debe tener el privilegio de createCollection.

Ejemplos

Los siguientes ejemplos muestran cómo crear una vista, crear un índice parcial y ejecutar queries que utilizan el índice. Los ejemplos consultan el índice ejecutando el comando .aggregate contra la colección de origen o la vista. MongoDB Search admite queries en vistas directamente solo en MongoDB v8.1 o posterior.

Editar una Vista

El siguiente ejemplo actualiza la vista movies_ReleasedAfter2000 de MongoDB para las películas anteriores a 2000.

db.runCommand(
{
    collMod: "movies_ReleasedAfter2000",
    viewOn: "movies",
    "pipeline": [
      {
        $match: {
          $expr: {
            $lt: [
              "$released",
              ISODate("2000-01-01T00")
            ]
          }
        }
      }
    ]
  }
)

Después de ejecutar este comando, MongoDB Search detecta automáticamente el cambio en la definición de la Vista y realiza la reindexación sin tiempo de inactividad.

Devolver las pipelines para una vista

El siguiente ejemplo retorna las pipelines en la Vista movies_ReleasedAfter2000.

db.getCollectionInfos({ name: "movies_ReleasedAfter2000" })[0].options.pipeline

[
  {
    '$match': {
      '$expr': { '$gt': [ '$released', ISODate('2000-01-01T00:00:00.000Z') ] }
    }
  }
]

Consideraciones sobre el rendimiento

Las transformaciones de vistas altamente complejas pueden aumentar el tiempo de indexación y query. Esto se debe a que el mongod debe leer la definición de vista cuando filtra y transforma las entradas del oplog durante la indexación (sincronización inicial y replicación en estado estable), y cuando aplica esas transformaciones a los documentos devueltos en tiempo de query.

Considera crear una vista materializada para evitar una carga extra de replicación en Atlas. También puedes query la colección de origen directamente para evitar la latencia de queries que se produce con la transformación de la vista.

Solucionar problemas

Los índices cambian a `FAILED`

Los índices cambian al estado FAILED en los siguientes escenarios:

Creas un índice en una vista que es incompatible con MongoDB Search.
Edita una vista de una manera que no cumple con los requisitos de compatibilidad de MongoDB Search.
Remover o cambiar la colección fuente de una vista.

Por ejemplo, si se crea una vista sobre otra vista y se cambia la fuente de la vista superior a otra colección.

Nota
Esta limitación también se aplica si una Vista es descendiente de otras Vistas. Por ejemplo, no se puede cambiar o remover la colección de origen de la que provienen todos los descendientes.

Los índices cambian a `STALE`

Los índices cambian al estado STALE en los siguientes escenarios:

Advertencia

Si el pipeline de agregación definido en tu Vista es incompatible con los documentos de la colección, la replicación de búsqueda falla. Por ejemplo, si una expresión $toDouble opera sobre un campo del documento que contiene un arreglo, la replicación falla. Asegúrate de que tu Vista funcione con todos los documentos de la colección sin errores.

Si la definición de la vista provoca un fallo de agregación mientras un índice está READY, el índice se convierte en STALE. El índice volverá a READY después de que resuelvas el documento o cambies la definición de vista para que no falle más. Cuando STALE, el índice sigue siendo consultable. Si el índice se cae del oplog, se activa una reconstrucción del índice.
Si la definición de la Vista provoca un fallo en el pipeline de agregación mientras el índice es BUILDING, la creación de índices queda atascada hasta que soluciones el documento. El índice volverá a READY después de que resuelvas el documento o cambies la definición de vista para que no falle más.

Puedes ver los estados de los índices en la Interfaz de Usuario de Atlas en la página de Detalles del estado del índice.

Error: `$search` solo es válido como la primera etapa en un pipeline

Este error aparece cuando se hace una query a una vista usando una versión de MongoDB anterior a 8.1.

Si utiliza una versión de MongoDB anterior a la 8.0, le recomendamos que actualice a la 8.1+ para query la vista directamente. Puedes actualizar a 8.0 para query la colección de origen.
Si usas MongoDB 8.0, deberás query el índice de visualización en la colección de origen. Por ejemplo, ejecuta .aggregate() en la colección en lugar de en la vista.

Proceso de índice

Cuando se crea un índice de MongoDB Search en una vista, el proceso mongot realiza las mismas tareas que cuando se crea un índice de MongoDB Search en una colección normal. El proceso mongot:

Crea índices de MongoDB Search basado en las reglas en la definición del índice para la colección.
Supervisa los flujos de cambio para el estado actual de los documentos e índices de las colecciones para las que hayas definido los índices MongoDB Search.
Procesa consultas de búsqueda de MongoDB Search y devuelve los IDs de los documentos y otros metadatos de búsqueda para los documentos coincidentes a mongod, que luego realiza una búsqueda completa de documentos y devuelve los resultados al cliente.

Cuando creas un índice de MongoDB Search en una vista, la definición de la vista se aplica durante el paso 1 y el 2, y los documentos transformados se indexan según la definición del índice de búsqueda, y luego se almacenan en disco.

Obtén más información

Para obtener más información sobre las Vistas, consulte Vistas.

Para crear un índice de búsqueda vectorial de MongoDB en una Vista, consulta Usar Vistas con búsqueda vectorial de MongoDB.

Volver

Múltiples colecciones

Compatibilidad y limitaciones