Overview
En esta guía, puede aprender cómo ejecutar una text query en el driver Java de MongoDB.
Puede utilizar una query de texto para recuperar documentos que contengan un término o una frase en un campo especificado. Un término es una secuencia de caracteres que excluye los caracteres de espacio en blanco. Una frase es una secuencia de términos con cualquier número de caracteres de espacio en blanco.
Las siguientes secciones muestran cómo realizar los siguientes tipos de consultas de texto:
Query texto por un término
Query texto por una frase
Query de texto con términos excluidos
Si quieres ordenar los resultados de tu query de texto, consulta el Sección de text query de nuestra guía Ordenar resultados.
Documentos de muestra
Las siguientes secciones incluyen ejemplos de text query en la
fast_and_furious_movies colección. Cada sección utiliza una variable llamada collection para referirse a la instancia MongoCollection de la colección fast_and_furious_movies.
La colección fast_and_furious_movies contiene documentos que describen una de las varias películas que forman parte de la franquicia de películas Rápidos y Furiosos. Cada documento contiene un campo de título y un campo de etiquetas.
{ "_id": 1, "title": "2 Fast 2 Furious ", "tags": ["undercover", "drug dealer"] } { "_id": 2, "title": "Fast 5", "tags": ["bank robbery", "full team"] } { "_id": 3, "title": "Furious 7", "tags": ["emotional"] } { "_id": 4, "title": "The Fate of the Furious", "tags": ["betrayal"] }
Text Index
Debe crear un índice de texto antes de ejecutar una query de texto. Un índice de texto especifica el campo de string o arreglo de strings en el que se realiza una búsqueda de texto.
En los siguientes ejemplos, ejecuta consultas de texto en el campo title en la colección fast_and_furious_movies. Para habilitar búsquedas de texto en el campo title, crea un índice de texto usando el generador de Índices con el siguiente snippet:
collection.createIndex(Indexes.text("title"));
Para obtener más información, consulta los siguientes recursos:
Sección Índices de texto de nuestra guía de Índices
Índices de Texto Entrada del Manual del Servidor
Text query
Utilice el método Filters.text() para especificar una consulta de texto.
El método Filters.text() usa el constructor de Filtros para definir un filtro de query que especifique qué buscar en la query de texto. El filtro de query se representa mediante una instancia BSON. Pasa el filtro de query al método find() para ejecutar una query de texto.
Cuando ejecutas el método find(), MongoDB realiza una query de texto en todos los campos indexados con el índice de texto en la colección. MongoDB devuelve documentos que contienen uno o más de los términos de búsqueda y un puntaje de relevancia para cada resultado. Para obtener más información sobre las puntuaciones de relevancia, consulta la sección Consulta de texto en nuestra guía Ordenar resultados.
Especificar opciones
Puede incluir TextSearchOptions como segundo parámetro del método Filters.text() para especificar opciones de consulta de texto como la sensibilidad a mayúsculas y minúsculas. Por defecto, las consultas de texto se ejecutan sin distinción entre mayúsculas y minúsculas, lo que significa que la búsqueda coincide con valores en minúsculas y en mayúsculas.
Para especificar una búsqueda que distinga entre mayúsculas y minúsculas, utiliza el siguiente snippet:
TextSearchOptions options = new TextSearchOptions().caseSensitive(true); Bson filter = Filters.text("SomeText", options);
Para obtener más información sobre los métodos y clases mencionados en esta sección, consulte la siguiente documentación de la API:
Buscar texto por un término
Pase un término como string al método Filters.text() para especificar el término en su text query.
Ejemplo
El siguiente ejemplo ejecuta una query de texto en los documentos de la colección fast_and_furious_movies para los títulos que contienen el término "rápido":
Bson filter = Filters.text("fast"); collection.find(filter).forEach(doc -> System.out.println(doc.toJson()));
A continuación se muestra el resultado del código anterior:
{ "_id": 1, "title": "2 Fast 2 Furious ", "tags": ["undercover", "drug dealer"] } { "_id": 2, "title": "Fast 5", "tags": ["bank robbery", "full team"] }
Para hacer coincidir varios términos en tu query de texto, separa cada término con espacios en el método generador Filters.text(). El método builder devuelve la query de texto como una instancia de Bson. Cuando pasas esto al método find(), devuelve documentos que coinciden con cualquiera de los términos.
Ejemplo
El siguiente ejemplo ejecuta una query de texto en los documentos de la colección fast_and_furious_movies para títulos que contienen los términos "destino" o "7":
Bson filter = Filters.text("fate 7"); collection.find(filter).forEach(doc -> System.out.println(doc.toJson()));
A continuación se muestra el resultado del código anterior:
{ "_id": 3, "title": "Furious 7", "tags": ["emotional"] } { "_id": 4, "title": "The Fate of the Furious", "tags": ["betrayal"] }
Búsqueda de texto por frase
Pasa una frase con comillas escapadas al método Filters.text() para especificar la frase en tu query de texto. Las comillas escapadas son caracteres de comillas dobles precedidos de una barra invertida. Si no añades comillas escapadas alrededor de la frase, el método find() ejecuta una búsqueda de términos.
Ejemplo
El siguiente ejemplo ejecuta una query de texto en los documentos de la colección fast_and_furious_movies en busca de títulos que contengan la frase "el destino de los furiosos":
Bson filter = Filters.text("\"fate of the furious\""); collection.find(filter).forEach(doc -> System.out.println(doc.toJson()));
A continuación se muestra el resultado del código anterior:
{ "_id": 4, "title": "The Fate of the Furious", "tags": ["betrayal"] }
Buscar texto con términos excluidos
Para cada término que desees excluir de tu query de texto, anteponle un signo menos en la cadena que envíes al método generador Filters.text().
Ninguno de los documentos devueltos por la búsqueda contiene el término excluido en tu campo de índice de texto.
Importante
Debes tener al menos un término de query de texto si deseas excluir términos de tu búsqueda.
Ejemplo
El siguiente ejemplo ejecuta una query de texto en los documentos de la colección fast_and_furious_movies para títulos que contengan el término "furioso", pero no contengan el término "rápido":
Bson filter = Filters.text("furious -fast"); collection.find(filter).forEach(doc -> System.out.println(doc.toJson()));
A continuación se muestra el resultado del código anterior:
{ "_id": 3, "title": "Furious 7", "tags": ["emotional"] } { "_id": 4, "title": "The Fate of the Furious", "tags": ["betrayal"] }