Texto da query

Esta versão da documentação foi arquivada e não é mais suportada. Consulte a documentação atual do para saber como atualizar sua versão do driver Scala.

MongoDB supports query operations that perform a text query on string content in documents. To perform a text query, MongoDB uses a text index and the $text query operator. To learn more about full-text search options, see Text Search in the Server manual.

O driver fornece o método assistente Filters.text() para facilitar a criação de filtros de query de texto.

Pré-requisitos

Você deve configurar os seguintes componentes para executar os exemplos de código neste guia:

Uma test.restaurants coleção preenchida com documentos do restaurants.json arquivo nos ativos de documentação do Github.
As seguintes declarações de importação:

import org.mongodb.scala._
import org.mongodb.scala.model._

Observação

Este guia usa as implicações do Observable como abordadas no Quick Start Primary.

Conecte-se a um MongoDB deployment

Primeiro, conecte a um MongoDB deployment e, em seguida, declare e defina as instâncias MongoDatabase e MongoCollection .

O código a seguir se conecta a uma MongoDB deployment standalone em execução em localhost na porta 27017. Em seguida, define a variável database para fazer referência ao banco de dados test e a variável collection para fazer referência à coleção restaurants :

val mongoClient: MongoClient = MongoClient()
val database: MongoDatabase = mongoClient.getDatabase("test")
val collection: MongoCollection[Document] = database.getCollection("restaurants")

Para saber mais sobre como se conectar a sistemas do MongoDB, consulte o tutorial Conectar ao MongoDB .

Criar o índice de texto

Para criar um índice de texto, utilize o auxiliar estático Indexes.text() para criar uma especificação para um índice de texto e passar a especificação para o método MongoCollection.createIndex() para criar o índice.

O exemplo seguinte cria um índice de texto no campo name em documentos na coleção:

collection.createIndex(Indexes.text("name")).printResults()

Realizar uma query de texto

Para executar uma query de texto, use o método assistente Filters.text() para especificar o filtro de queries de texto.

Por exemplo, o código a seguir executa uma query de texto no campo name para corresponder às strings "bakery" ou "coffee":

collection.countDocuments(Filters.text("bakery coffee")).printResults("Text query matches: ")

Text query matches: [2]

Pontuação de texto

Para cada documento correspondente, uma query de texto atribui uma pontuação que representa a relevância de um documento para o filtro de query de texto especificado. Para retornar e classificar por pontuação, use o operador $meta no documento de projeção e a expressão de classificação:

collection.find(Filters.text("bakery cafe"))
                       .projection(Projections.metaTextScore("score"))
                       .sort(Sorts.metaTextScore("score"))
                       .printResults()

Especificar uma opção de query de texto

O assistente Filters.text() pode aceitar várias opções de query de texto. O driver fornece a classe TextSearchOptions para especificar essas opções.

Por exemplo, a seguinte consulta de texto especifica a opção de idioma da consulta de texto ao executar uma consulta de texto para a palavra "cafe":

collection.countDocuments(Filters.text("cafe", TextSearchOptions().language("english")))
                                 .printResults("Text query matches (english): ")

Text query matches (english): [1]

Para saber mais sobre queries de texto, consulte as seguintes seções no manual do MongoDB Server :

Voltar

Fluxos de alterações

Atlas Searchgeoespacial