$text (operador de predicado da query)

Restrições

• Uma query pode especificar somente uma expressão $text.

• $text não pode aparecer em expressões $nor.

• $text não pode aparecer em expressões de query ou projeção $elemMatch.

• Todas as $or cláusulas devem ser indexadas para usar $text.

• Se uma query incluir uma expressão $text, não sera possível usar hint() para especificar o índice a ser utilizado na query.

• Queries com $text não podem usar a classificação $natural.

• Você não pode combinar a expressão $text, que exige um índice de texto especial, com um operador de consulta que exige um tipo diferente de índice especial. Por exemplo, você não pode combinar a expressão $text com o operador $near .

• As visualizações não suportam $text.

• A Stable API V1 não suporta $text para criação de índice.

Se estiver usando o operador $text na agregação, as restrições a seguir também se aplicam.

• O estágio $match que inclui um $text deve ser o primeiro estágio no pipeline.

• Um operador $text só pode ocorrer uma vez no estágio.

• A expressão do operador $text não pode aparecer em expressões $or ou $not.

• $text, por padrão, não retorna os documentos correspondentes na ordem das pontuações correspondentes. Para classificar por pontuação decrescente, use a expressão de agregação $meta no estágio $sort.

$search Campo

No campo $search, especifique as palavras que o MongoDB utiliza para query o índice de texto.

"\"ssl certificate\""

"\"ssl certificate\" authority key"

Operação de correspondência

Insensibilidade a maiúsculas e minúsculas

$text padroniza para a insensibilidade a maiúsculas e minúsculas do índice de texto:

• O índice de texto 3 é não diferencia maiúsculas de minúsculas para caracteres latinos com ou sem diacríticos e alfabetos não latinos, como o cirílico.

• As versões anteriores não diferenciam maiúsculas de minúsculas para caracteres latinos sem diacríticos ([A-z]).

Insensibilidade a diacríticos

$text O padrão é a insensibilidade a diacríticos do índice de texto:

• Versão 3 índice de texto é insensível a diacríticos. O índice não faz distinção entre caracteres com diacríticos e suas contrapartes sem sinais (é, ê, e).

• As versões anteriores são sensíveis a diacríticos.

Pontuação de texto

O operador $text atribui uma pontuação a cada documento de resultado. A pontuação representa a relevância de um documento para uma determinada query. A pontuação pode ser parte de uma especificação de método sort(), bem como parte da expressão de projeção. A expressão { $meta: "textScore" } apresenta informações sobre o processamento da operação $text. Consulte o operador de projeção $meta para obter detalhes sobre como acessar a pontuação para projeção ou classificação.

Limites de memória

A partir do MongoDB 8.3, o mecanismo de query limita o uso de memória do estágio TextOr a 100 megabytes. O estágio TextOr processa queries$text que leem metadados de pontuação de text. Por exemplo, TextOr processa queries que classificam resultados por pontuação de texto. Se o estágio TextOr exceder este limite:

• Se allowDiskUse for true, o estágio transmitirá resultados intermediários para o disco.

• Se allowDiskUse for false, a query falha com um erro de limite de memória excedido.

Em versões anteriores, o estágio TextOr não tinha limite de memória e consumia RAM sem restrições, arriscando erros de falta de memória (OOM).

Pesquisar uma única palavra

Este exemplo especifica baseball na string $search. A query retorna documentos contendo a versão derivada de baseball nos campos title ou fullplot indexados:

db.movies.find(
   { $text: { $search: "baseball" }, runtime: { $gt: 1000 } },
   { _id: 0, title: 1, year: 1, runtime: 1 }
)

[ { title: 'Baseball', year: 1994, runtime: 1140 } ]

Corresponder a qualquer termo de pesquisa

Uma string $search delimitada por espaço executa um OR lógico em cada termo. O MongoDB retorna documentos contendo qualquer um dos termos.

Este exemplo especifica dois termos delimitados por espaço. A query retorna documentos contendo as versões derivadas de baseball ou colorado nos title fullplot campos ou indexados:

db.movies.find(
   { $text: { $search: "baseball colorado" },
     runtime: { $gt: 1000 } },
   { _id: 0, title: 1, year: 1, runtime: 1, fullplot: 1 }
)

[
  {
    runtime: 1140,
    title: 'Baseball',
    fullplot: 'Ken Burns relates the history of baseball in a fashion similar to that of his Civil War mini series. Old-time photos and illustrations depict the games early years, while newsreels and video clips highlight more recent developments. Players and participants speak in their own words, and sports writers and broadcasters offer commentary on the sport and events they witnessed.',
    year: 1994
  },
  {
    runtime: 1256,
    title: 'Centennial',
    fullplot: 'This is the story of the evolution of the town Centennial, Colorado. It follows the paths of dozens of people who come to the area for many reasons: money, freedom, or crime. It also shows the bigoted treatment of the Native Indians by the advancing US colonists. It is topped off with a murder mystery that takes 100 years to solve.',
    year: 1978
  }
]

Pesquisar uma string exata

Evite as aspas para corresponder a uma string exata de várias palavras.

Este exemplo corresponde à frase exata ken burns:

db.movies.find(
   { $text: { $search: "\"ken burns\"" },
     runtime: { $gt: 1000 } },
   { _id: 0, title: 1, year: 1, runtime: 1, fullplot: 1 }
)

[
  {
    runtime: 1140,
    title: 'Baseball',
    fullplot: 'Ken Burns relates the history of baseball in a fashion similar to that of his Civil War mini series. Old-time photos and illustrations depict the games early years, while newsreels and video clips highlight more recent developments. Players and participants speak in their own words, and sports writers and broadcasters offer commentary on the sport and events they witnessed.',
    year: 1994
  }
]

Este exemplo executa um OR lógico de duas strings exatas:

db.movies.find(
   { $text: { $search: "\'ken burns\' \'centennial\'" },
     runtime: { $gt: 1000 } },
   { _id: 0, title: 1, year: 1, runtime: 1, fullplot: 1 }
)

[
  {
    runtime: 1140,
    title: 'Baseball',
    fullplot: 'Ken Burns relates the history of baseball in a fashion similar to that of his Civil War mini series. Old-time photos and illustrations depict the games early years, while newsreels and video clips highlight more recent developments. Players and participants speak in their own words, and sports writers and broadcasters offer commentary on the sport and events they witnessed.',
    year: 1994
  },
  {
    runtime: 1256,
    title: 'Centennial',
    fullplot: 'This is the story of the evolution of the town Centennial, Colorado. It follows the paths of dozens of people who come to the area for many reasons: money, freedom, or crime. It also shows the bigoted treatment of the Native Indians by the advancing US colonists. It is topped off with a murder mystery that takes 100 years to solve.',
    year: 1978
  }
]

Excluir documentos que contenham um termo

Prefixe um termo com - para excluir documentos que contenham esse termo.

Este exemplo corresponde a documentos contendo baseball ou colorado, mas não sport (versões derivadas):

db.movies.find(
   { $text: { $search: "baseball colorado -sport" },
     runtime: { $gt: 1000 } },
   { _id: 0, title: 1, year: 1, runtime: 1 }
)

[ { title: 'Centennial', year: 1978, runtime: 1256 } ]

Exemplos de pontuação de relevância

db.movies.find(
   { $text: { $search: "baseball" }, runtime: { $gt: 1000 } },
   { _id: 0, title: 1, year: 1,
     score: { $meta: "textScore" } }
)

[
  {
    title: 'Baseball',
    year: 1994,
    score: ...
  }
]

db.movies.find(
   { $text: { $search: "baseball colorado" },
     runtime: { $gt: 1000 } },
   { _id: 0, title: 1, year: 1,
     score: { $meta: "textScore" } }
).sort( { score: { $meta: "textScore" } } ).limit(2)

[
  { title: 'Baseball', year: 1994, score: ... },
  { title: 'Centennial', year: 1978, score: ... }
]

db.movies.find(
   { runtime: { $gt: 1000 },
     $text: { $search: "baseball colorado" } },
   { _id: 0, title: 1, year: 1,
     score: { $meta: "textScore" } }
).sort( { year: 1, score: { $meta: "textScore" } } )

[
  { title: 'Centennial', year: 1978, score: ... },
  { title: 'Baseball', year: 1994, score: ... }
]

Consultar um idioma diferente

O restante dos exemplos nesta página usa uma articles collection com um índice de texto 3 versão subject em:

db.articles.createIndex( { subject: "text" } )

A collection contém os seguintes documentos:

db.articles.insertMany( [
   { _id: 1, subject: "coffee", author: "xyz", views: 50 },
   { _id: 2, subject: "Coffee Shopping", author: "efg", views: 5 },
   { _id: 3, subject: "Baking a cake", author: "abc", views: 90  },
   { _id: 4, subject: "baking", author: "xyz", views: 100 },
   { _id: 5, subject: "Café Con Leche", author: "abc", views: 200 },
   { _id: 6, subject: "Сырники", author: "jkl", views: 80 },
   { _id: 7, subject: "coffee and cream", author: "efg", views: 10 },
   { _id: 8, subject: "Cafe con Leche", author: "xyz", views: 10 }
] )

Use $language para especificar o idioma que determina as regras de palavras vazias, derivações e tokenizador para a string $search.

Se você especificar um valor default_language de none, o índice de texto analisará cada palavra no campo, incluindo palavras vazias, e ignorará a derivação do sufixo.

Este exemplo especifica es (espangal) como o idioma:

db.articles.find(
   { $text: { $search: "leche", $language: "es" } }
)

[
  { _id: 5, subject: 'Café Con Leche', author: 'abc', views: 200 },
  { _id: 8, subject: 'Cafe con Leche', author: 'xyz', views: 10 }
]

Você também pode especificar idiomas por nome, como spanish. Consulte Linguagens de Query $text em Implantações Autogerenciadas para obter os idiomas suportados.

Classificar por pontuação de relevância

Você pode especificar a expressão { $meta: "textScore" } no sort() sem especificar também a expressão na projeção. Por exemplo:

db.articles.find(
   { $text: { $search: "cake" } }
).sort( { score: { $meta: "textScore" } } )

Como resultado, você pode ordenar os documentos resultantes por sua relevância sem projetar o textScore.

Se você incluir a { $meta: "textScore" } expressão na projeção sort()e, os documentos de projeção e classificação poderão ter nomes de campo diferentes para a expressão. Por exemplo, na operação a seguir, a projeção usa um campo chamado score para a expressão , e o usa o sort() campo ignoredName chamado:

db.articles.find(
   { $text: { $search: "cake" } },
   { score: { $meta: "textScore" } }
).sort( { ignoredName: { $meta: "textScore" } } )

Não diferenciação entre maiúsculas e minúsculas e diacríticos

$text O padrão é a insensibilidade a maiúsculas e minúsculas do índice de texto. Os índices de texto da versão 3 são insensíveis a diacríticos e maiúsculas de minúsculas para caracteres latinos com diacríticos e alfabetos não latinos, como o cirílico. Consulte Insensibilidade a maiúsculas e minúsculas do índice de texto e Insensibilidade a diacríticos do índice de texto.

Este exemplo executa uma query sem distinção entre maiúsculas e minúsculas e diacríticos. Usando índices de texto 3, a query corresponde a documentos que contêm as versões derivadas dos termos de pesquisa:

db.articles.find( { $text: { $search: "сы́рники CAFÉS" } } )

[
  { _id: 6, subject: 'Сырники', author: 'jkl', views: 80 },
  { _id: 5, subject: 'Café Con Leche', author: 'abc', views: 200 },
  { _id: 8, subject: 'Cafe con Leche', author: 'xyz', views: 10 }
]

As versões anteriores do índice de texto não correspondiam a nenhum documento.

Diferenciação entre maiúsculas e minúsculas

Habilite a sensibilidade a maiúsculas e minúsculas com $caseSensitive: true. Isso pode reduzir o desempenho.

db.articles.find(
   { $text: { $search: "Coffee", $caseSensitive: true } }
)

[ { _id: 2, subject: 'Coffee Shopping', author: 'efg', views: 5 } ]

db.articles.find( {
   $text: { $search: "\"Café Con Leche\"", $caseSensitive: true }
} )

[ { _id: 5, subject: 'Café Con Leche', author: 'abc', views: 200 } ]

db.articles.find(
   { $text: { $search: "Coffee -shop", $caseSensitive: true } }
)

[ { _id: 2, subject: 'Coffee Shopping', author: 'efg', views: 5 } ]

Sensibilidade a diacríticos

Ative a sensibilidade a diacríticos com índices de texto da versão 3 text usando $diacriticSensitive: true. Isso pode reduzir o desempenho.

db.articles.find(
   { $text: { $search: "CAFÉ", $diacriticSensitive: true } }
)

[ { _id: 5, subject: 'Café Con Leche', author: 'abc', views: 200 } ]

db.articles.find(
   { $text: { $search: "leches -cafés", $diacriticSensitive: true } }
)

[ { _id: 8, subject: 'Cafe con Leche', author: 'xyz', views: 10 } ]