/ /

Driver de sincronização Java

Página inicial do Docs

Bibliotecas do cliente

Java

Driver de sincronização Java

Página inicial do Docs

Bibliotecas do cliente

Java

Driver de sincronização Java

MongoDB Search

Visão geral

Neste guia, você pode aprender como usar o driver Java para executar consultas do MongoDB Search em uma coleção. O MongoDB Search permite realizar pesquisas de texto completo em collections hospedadas no MongoDB Atlas. Os índices de pesquisa do MongoDB especificam o comportamento da pesquisa e quais campos indexar.

Dados de amostra

Os exemplos deste guia usam a movies coleção no sample_mflix banco de dados dos conjuntos de dados de amostra do Atlas. Para saber como criar um sistema gratuito do MongoDB e carregar os conjuntos de dados de exemplo, consulte o guia de introdução ao MongoDB . Para saber mais sobre operações de agregação e construtores, consulte o guia Agregação.

Executar uma query de pesquisa do MongoDB

Esta seção mostra como criar um pipeline de agregação para executar uma query do MongoDB Search em uma coleção. Você pode usar o método construtor Aggregates.search() para criar um estágio de pipeline $search, que especifica os critérios de pesquisa. Em seguida, chame o método aggregate() e passe seu pipeline como um parâmetro.

Observação

Disponível apenas no Atlas para MongoDB v4.2 e posterior

Esse operador de pipeline de agregação só está disponível para coleções hospedadas em clusters do MongoDB Atlas que executam v4.2 ou posterior que são cobertas por um índice do MongoDB Search. Saiba mais sobre a configuração necessária e a funcionalidade desse operador na documentação do MongoDB Search.

Antes de executar uma query do MongoDB Search, você deve criar um índice do MongoDB Search em sua collection. Para saber como criar programaticamente um índice do MongoDB Search, consulte a seção Índices do MongoDB Search e Vector Search no guia Índices.

Exemplo de pesquisa do MongoDB

Este exemplo executa uma query do MongoDB Search executando as seguintes ações:

Constrói uma etapa $search usando o método construtor Aggregates.search(), instruindo o driver a fazer query de documentos em que o campo title contém a palavra "Alabama"
Constrói um estágio $project usando o método construtor Aggregates.project(), instruindo o driver a incluir o campo title nos resultados da query
Passa as fases do pipeline para o método aggregate() e imprime os resultados

collection.aggregate(
    Arrays.asList(
    	Aggregates.search(SearchOperator.text(
                      SearchPath.fieldPath("title"), "Alabama")),
        Aggregates.project(Projections.include("title"))
    )
).forEach(doc -> System.out.println(doc.toJson()));

{"_id": {"$oid": "..."}, "title": "Alabama Moon"}
{"_id": {"$oid": "..."}, "title": "Crazy in Alabama"}
{"_id": {"$oid": "..."}, "title": "Sweet Home Alabama"}

Dica

Exemplos de pesquisa do MongoDB do driver Java

Para visualizar mais exemplos que utilizam o driver Java para executar queries do MongoDB Search,consulte Tutoriais do MongoDB Search na documentação do Atlas .

Metadados de pesquisa do MongoDB

Use o searchMeta() método para criar um estágio de pipeline $searchMeta, que retorna somente os metadados dos resultados da pesquisa MongoDB .

Dica

Disponível apenas no Atlas para MongoDB v4,4,11 e posterior

Este operador de pipeline de agregação está disponível somente em clusters do MongoDB Atlas executando a versão v4.4.11 ou posterior. Para uma lista detalhada de disponibilidade de versão, consulte a documentação do MongoDB Atlas em $searchMeta.

O exemplo a seguir mostra os metadados near para um estágio de agregação do MongoDB Search:

Aggregates.searchMeta(
        SearchOperator.near(2010, 1, fieldPath("year")));

Para saber mais sobre esse método assistente, consulte a documentação da API searchMeta().

Criar estágios de pesquisa de pipeline

O driver Java fornece métodos assistentes para os seguintes operadores:

Operador	Descrição
autocompletar	Executa uma pesquisa por uma palavra ou frase que contém uma sequência de caracteres de uma string de entrada incompleta.
composto	Combina dois ou mais operadores em uma única query.
é igual a	Verifica se um campo corresponde a um valor que você especificou. Mapeia para os métodos `equals()` e `equalsNull()`.
existe	Testa se existe um caminho para um nome de campo indexado especificado em um documento.
Em	Executa uma pesquisa por uma array de valores de número BSON, data, boolean, ObjectId, uuid ou string no caminho fornecido e retorna documentos em que o valor do campo é igual a qualquer valor na array especificada.
moreLikeThis	Retorna documentos semelhantes aos documentos de entrada.
perto	Suporta a consulta e pontuação de valores numéricos, de data e de ponto GeoJSON .
frase	Executa uma pesquisa de documentos contendo uma sequência ordenada de termos usando o analisador especificado na configuração do índice.
String de query	Suporta a realização de query de uma combinação de campos e valores indexados.
faixa	Suporta a consulta e pontuação de valores numéricos, de data e de cadeia de caracteres. Mapeia para os métodos `numberRange()` e `dateRange()`.
regex	Interpreta o campo de query como uma expressão regular.
text	Executa uma pesquisa de texto completo usando o analisador especificado na configuração do índice.
curinga	Habilita queries que usam caracteres especiais na string de pesquisa que podem corresponder a qualquer caractere.

Exemplo de estágio de pesquisa de pipeline

Observação

Conjunto de Dados de Amostra do Atlas

Este exemplo utiliza a collection sample_mflix.movies a partir do conjunto de dados de amostra do Atlas . Para saber como configurar um Atlas cluster de camada grátis e carregar o conjunto de dados de amostra, consulte o tutorial Introdução ao Atlas na documentação do Atlas.

Antes de executar este exemplo, você deve criar um índice de pesquisa MongoDB na coleção movies que tem a seguinte definição:

{
  "mappings": {
    "dynamic": true,
    "fields": {
      "title": {
        "analyzer": "lucene.keyword",
        "type": "string"
      },
      "genres": {
        "normalizer": "lowercase",
        "type": "token"
      }
    }
  }
}

Para saber mais sobre como criar índices de pesquisa do MongoDB Search, consulte a seção Índices de pesquisa do MongoDB e Vector Search do guia Índices.

O seguinte código cria um estágio $search que tem as seguintes especificações:

Verifica se a array genres inclui "Comedy"
Pesquisa no campo fullplot a frase "new york"
Corresponde a year valores entre 1950 e 2000, inclusive
Pesquisa valores title que começam com o termo "Love"

List<Bson> pipeline = new ArrayList<>();
pipeline.add(Aggregates.search(
        SearchOperator.compound()
                .filter(
                        List.of(
                                SearchOperator.in(fieldPath("genres"), "Comedy"),
                                SearchOperator.phrase(fieldPath("fullplot"), "new york"),
                                SearchOperator.numberRange(fieldPath("year")).gtLt(1950, 2000),
                                SearchOperator.wildcard(fieldPath("title"), "Love *")
                        ))));
pipeline.add(Aggregates.project(
        Projections.include("title", "year", "genres")
));
AggregateIterable<Document> results = collection.aggregate(pipeline);
results.forEach(doc -> System.out.println(doc.toJson()));

{"_id": ..., "genres": ["Comedy", "Romance"], "title": "Love at First Bite", "year": 1979}
{"_id": ..., "genres": ["Comedy", "Drama"], "title": "Love Affair", "year": 1994}

Para saber mais sobre os métodos assistente do MongoDB Search, consulte a referência da interface SearchOperator na documentação da API Driver Core.

Informações adicionais

Para saber mais sobre o MongoDB Search, consulte MongoDB Search na documentação do Atlas .

Documentação da API

Para saber mais sobre os métodos mencionados neste guia, consulte a seguinte documentação da API:

Voltar

Execute um comando

MongoDB Vector Search