Definição
rangeO operador
rangetem suporte para queries e pontuação de valores numéricos, de data e string. Você pode usar esse operador para localizar resultados que estejam dentro de um determinado intervalo numérico, de data, objectId ou letra (do alfabeto em inglês).rangepode fazer queries dos seguintes tipos de dados:número, incluindo
int32,int64edouble
Sintaxe
range tem a seguinte sintaxe:
{ "$search": { "index": <index name>, // optional, defaults to "default" "range": { "path": "<field-to-search>", "gt | gte": <value-to-search>, "lt | lte": <value-to-search>, "score": <score-options>, "doesNotAffect": "<facet-to-exclude>" | [<array-of-facets>] } }}Opções
range usa os seguintes termos para construir uma consulta:
Campo | Tipo | Descrição | necessidade |
|---|---|---|---|
| Data, número ou string BSON, ou objectId | Localize valores maiores que (
| no |
| Data, número ou string BSON, ou objectId | Localize valores menores que (
| no |
| cadeia de caracteres ou matriz de cadeias de caracteres | Campos indexados a serem pesquisados. | sim |
| objeto | Modifique a pontuação atribuída aos resultados de pesquisa correspondentes. Você pode modificar a pontuação padrão usando as seguintes opções:
Ao executar query de valores de array, o MongoDB Pesquisa atribui pontuações mais altas se mais valores na array corresponderem à query. Para obter informações sobre como utilizar o | no |
| cadeia de caracteres ou matriz de cadeias de caracteres | Faceta ou lista de facetas a serem excluídos do novo cálculo de contagem com base nesta query. O valor deve ser um ou mais nomes de uma faceta definidos em | no |
Exemplos
Os exemplos abaixo usam a coleção nos dados de amostra. Se você carregou os dados de amostra no cluster, poderá criar os índices usando as definições de índice nos exemplos abaixo e executar as queries de exemplo no cluster.
Exemplo de número
Os exemplos a seguir usam índices em campos numéricos nos dados de amostra e executam queries range nos campos indexados.
Para este exemplo, você pode utilizar mapeamentos estáticos ou dinâmicos para indexar o campo runtime na collection sample_mflix.movies. A query utiliza campos gte e lte para definir a faixa numérica para pesquisar.
Índice de amostra
Use uma das seguintes definições de índice:
Amostra de query
A seguinte query pesquisa filmes com um tempo de duração maior ou igual a 2, e menor ou igual a 3. Inclui um estágio $limit para limitar a saída a 5 resultados e um estágio $project para excluir todos os campos, exceto title e runtime.
db.movies.aggregate([ { "$search": { "range": { "path": "runtime", "gte": 2, "lte": 3 } } }, { "$limit": 5 }, { "$project": { "_id": 0, "title": 1, "runtime": 1 } }])Para este exemplo, você pode utilizar mapeamentos estáticos ou dinâmicos para indexar o campo runtime na coleção sample_mflix.movies. A query usa o campo lte para pesquisar todos os valores menores ou iguais ao valor fornecido.
Índice de amostra
Use uma das seguintes definições de índice:
Amostra de query
A seguinte query pesquisa todos os filmes com um tempo de duração menor ou igual a 2. Inclui um estágio $limit para limitar o resultado para 5 resultados e estágio $project para:
Excluir todos os campos, exceto
titleeruntimeAdicione um campo chamado
score
db.movies.aggregate([ { "$search": { "range": { "path": "runtime", "lte": 2 } } }, { "$limit": 5 }, { "$project": { "_id": 0, "title": 1, "runtime": 1, score: { $meta: "searchScore" } } }])O exemplo a seguir indexa dinamicamente todos os campos indexáveis dinamicamente, incluindo campos com array de valores numéricos, na collection sample_analytics.customers . A query de exemplo usa os campos gte e lte para o Atlas Search de todos os valores entre os valores fornecidos em uma array de valores numéricos.
Índice de amostra
A seguinte definição de índice denominada default indexa dinamicamente todos os campos, incluindo o campo accounts , que é uma array de valores numéricos.
{ "mappings": { "dynamic": true }}Amostra de query
A seguinte query pesquisa contas de cliente entre 250000 e 300000. Inclui um estágio $limit para limitar o resultado para 5 resultados e um estágio $project para excluir todos os campos, exceto accounts e name.
db.customers.aggregate([ { "$search": { "range": { "path": "accounts", "gt": 250000, "lt": 400000 } } }, { "$limit": 5 }, { "$project": { "_id": 0, "accounts": 1, "name": 1 } }])Exemplo de data
O exemplo seguinte utiliza o operador range para fazer uma query de um campo de data na collection sample_mflix.movies. Neste exemplo, você pode utilizar mapeamentos estáticos ou dinâmicos para indexar o campo do tipo date denominado released na collection.
Índice de amostra
Use uma das seguintes definições de índice:
Amostra de query
A consulta a seguir pesquisa filmes lançados entre 1 de janeiro de 2010 e 1 de janeiro de 2015. Ela inclui um estágio $limit para limitar a saída a 5 resultados e um estágio $project para excluir todos os campos, exceto title e released.
db.movies.aggregate([ { "$search": { "range": { "path": "released", "gt": ISODate("2010-01-01T00:00:00.000Z"), "lt": ISODate("2015-01-01T00:00:00.000Z") } } }, { "$limit": 5 }, { "$project": { "_id": 0, "title": 1, "released": 1 } }])Exemplo de ObjectId
O exemplo a seguir usa o operador range para consultar um campo objectId na coleção sample_mflix.movies . Neste exemplo, você pode utilizar mapeamentos estáticos ou dinâmicos para indexar o campo do tipo objectId denominado _id na coleção.
Índice de amostra
Use uma das seguintes definições de índice:
Amostra de query
O exemplo a seguir usa o operador range para fazer query no campo _id para um intervalo de valores objectId na coleção sample_mflix.movies.
db.movies.aggregate([ { "$search": { "range": { "path": "_id", "gte": ObjectId("573a1396f29313caabce4a9a"), "lte": ObjectId('573a1396f29313caabce4ae7') } } }, { "$project": { "_id": 1, "title": 1, "released": 1 } }])Exemplo de string
O exemplo seguinte utiliza o operador range para consultar um campo de string na coleção sample_mflix.movies. Neste exemplo, você deve usar mapeamentos estáticos para indexar o campo chamado title na collection como tipo token do MongoDB Search.
Índice de amostra
A seguinte definição de índice denominada default indexa o campo title na collection movies como tipo MongoDB Search token:
{ "mappings": { "dynamic": false, "fields": { "title": { "type": "token", "normalizer": "lowercase" } } }}Amostra de query
A query a seguir pesquisa títulos de filmes que contenham caracteres entre city e country. Ela inclui um estágio $limit para limitar a saída a 5 resultados e um estágio $project para excluir todos os campos, exceto title.
db.movies.aggregate([ { "$search": { "range": { "path": "title", "gt": "city", "lt": "country" } } }, { "$limit": 5 }, { "$project": { "_id": 0, "title": 1 } }])Exemplo de Documentos Incorporados
A seguinte query pesquisa o campo funding_rounds.raised_amount na coleção sample_training.companies por valores maiores ou iguais a 500000 e menores ou iguais a 1000000. Ele usa o returnStoredSource: true e returnScope para recuperar e retornar os campos no array de objetos funding_rounds, que são armazenados em mongot. A query utiliza o índice de amostra do exemplo "Usar caminho relativo para origem armazenada".
➤ Tente isso no Search Playground. Os resultados no MongoDB Search Playground podem variar porque os dados no MongoDB Search Playground são menores do que a coleção de amostra usada no exemplo a seguir.
db.companies.aggregate([ { "$search": { "range": { "path": "funding_rounds.raised_amount", "gte": 500000, "lte": 1000000 }, "returnStoredSource": true, "returnScope": { "path": "funding_rounds" } } }, { "$limit": 5 }])Exemplo de metadados
A seguinte query pesquisa filmes com um tempo de duração maior ou igual a 2, e menor ou igual a 3. A query usa o estágio $searchMeta para recuperar todos os filmes nos seguintes intervalos de anos que atendem aos critérios de pesquisa:
1990, limite inferior inclusivo para este bucket
2000, limite superior exclusivo para o bucket 1990 e limite inferior inclusivo para esse bucket
2010, limite superior exclusivo para o bucket 2000 e limite inferior inclusivo para esse bucket
2020, limite superior exclusivo para o bucket 2010
A consulta usa um índice chamado default que indexa dinamicamente todos os campos no namespace sample_mflix.movies .
db.movies.aggregate([ { "$searchMeta": { "facet": { "operator": { "range": { "path": "runtime", "gte": 2, "lte": 3 } }, "facets": { "yearFacet": { "type": "number", "path": "year", "boundaries": [1990, 2000, 2010, 2020 ] } } } } }])