Usar a pesquisa de texto

Use os recursos de pesquisa de texto em Cloud Firestore para pesquisar strings específicas em uma coleção.

Antes de começar

Antes de começar a usar as pesquisas de texto, faça o seguinte:

  1. Verifique se você tem acesso a um banco de dados de operações compatível com o MongoDB ou crie e conecte um banco de dados.

  2. Verifique se você tem um índice de texto ou crie um.

As pesquisas de texto usam o operador $text em um filtro. Especifique a string consultada no argumento $search.

Execute o comando a seguir para fazer uma pesquisa geral de texto:

  # Find search
  db.cities.find({ $text: { $search: "french bread" } })

  # Aggregation search
  db.cities.aggregate([
    { $match: { $text: { $search: "french bread" } } }
  ]);

Se o índice for particionado, você poderá filtrar com base na partição incluindo-a em um filtro de igualdade "e" na pesquisa. Por exemplo, se você tiver uma partição city, poderá filtrar uma pesquisa de texto da seguinte maneira:

db.myCollection.find( { $and: [
  { $text: { $search: "french bread" } },
  { "city": "Paris" }
] } )

Também é possível filtrar uma agregação com base em uma partição. Exemplo:

db.myCollection.aggregate([
 { $match: { $text: { $search: "french bread" } } },
 { "city": "Paris" }
] );

O valor da sua partição precisa ser uma string. O filtro de particionamento precisa ser combinado à pesquisa de texto usando um "e".

Definir o idioma da pesquisa de texto

É possível definir o idioma da pesquisa de texto usando o argumento $language. Exemplo:

  db.cities.find({ $text: { $search: "french bread", $language: "en"} })

Se você não definir um idioma, a pesquisa vai usar o idioma do índice de texto.

Pesquisar um termo exato

Para pesquisar um termo exato, configure-o como uma sequência de palavras entre aspas duplas. Exemplo:

  # Find search
  db.cities.find({ $text: { $search: "\"best french bread\"" } })

  # Aggregation search
  db.cities.aggregate([
    { $match: { $text: { $search: "\"best french bread\"" } } },
  ]);

Pesquisar uma combinação de termos

Para tornar sua pesquisa de texto mais precisa, especifique uma cadeia de termos. Por exemplo, a pesquisa a seguir retorna documentos que correspondem à combinação best AND french AND ("bread" OR "is"):

  # Find search
  db.cities.find({ $text: { $search: "\"best\" \"french\" bread is" } })

  # Aggregation search
  db.cities.aggregate([
    { $match: { $text: { $search: "\"best\" \"french\" bread is" } } },
  ]);

Excluir um termo

Para excluir um termo de uma pesquisa de texto, adicione um hífen (-) antes dele:

  # Find search
  db.cities.find({ $text: { $search: "best bread -french"} })

  # Aggregation search
  db.cities.aggregate([
    { $match: { $text: { $search: "best bread -french" } } },
  ]);

Calcular a pontuação de relevância

Use a expressão {$meta: "textScore"} para calcular a pontuação de relevância dos documentos correspondentes à pesquisa de texto. Para classificar os resultados em ordem decrescente de pontuação, use $meta em uma expressão de classificação. Considere os exemplos a seguir, em que SCORE_FIELD é o nome do campo usado para armazenar o valor da pontuação:

  # Find search
  db.cities
    .find({ $text: { $search: "best french bread" } })
    .sort({ SCORE_FIELD: { $meta: "textScore" } })

  # Aggregation search
  db.cities.aggregate([
    { $match: { $text: { $search: "best french bread" } } },
    { $sort: { "SCORE_FIELD": { $meta: "textScore"} } },
  ]);

Você também pode usar a pontuação de texto em expressões de projeção. Exemplo:

  # Find search
  db.cities
    .find({ $text: { $search: "best french bread" } })
    .project({ score: { $meta: "textScore" } })

  # Aggregation search
  db.cities.aggregate([
    { $match: { $text: { $search: "best french bread" } } },
    { $project: { "scoreField": { $meta: "textScore"} } },
  ]);

Para aumentar a relevância dos resultados da pesquisa de texto, o operador $text aumenta a string de pesquisa de acordo com o idioma especificado para incluir correspondências de sinônimos sensíveis ao contexto, formas derivadas, termos com ortografia corrigida, variações de diacríticos e muito mais.

Limitações

  • Não é possível usar operadores $near e $text na mesma pesquisa de texto.
  • É permitido um único operador $text por pesquisa find ou aggregation.
  • Em agregações, a etapa $match com $text precisa ser a primeira etapa do pipeline.
  • $text só pode ser aninhado em $and e $or.
  • Se $text estiver dentro de $or, as disjunções não relacionadas à pesquisa poderão usar índices ordenados existentes para otimizar a pesquisa. Se os outros disjuntos não forem indexados, a pesquisa vai depender de uma verificação da coleção.
  • $text não pode ser usado com dicas.
  • As consultas com pesquisa de texto não podem ser classificadas por $natural.