extensão

Sintaxe

O operador posicional contains tem a seguinte sintaxe:

{
  "$search": {
    "span": {
      "contains": {
        "spanToReturn": "inner"|"outer",
        "little": { <positional-or-term-operator-specification> },
        "big": { <positional-or-term-operator-specification> }
      }
    }
  }
}

Campos

O operador posicional contains usa os seguintes campos:

Exemplo

A consulta de exemplo a seguir usa span.contains para localizar documentos nos quais o termo train aparece com os termos great e robbery, onde great e robbery podem ter até 5 posições de diferença no title Campo .

1
db.movies.aggregate([
2
  {
3
    "$search": {
4
      "span": {
5
        "contains": {
6
          "spanToReturn": "outer",
7
          "little": {
8
            "term": {
9
              "path": "title",
10
              "query": "train"
11
            }
12
          },
13
          "big": {
14
            "near": {
15
              "clauses": [
16
                {
17
                  "term": {
18
                    "path": "title",
19
                    "query": "great"
20
                  }
21
                },
22
                {
23
                  "term": {
24
                    "path": "title",
25
                    "query": "robbery"
26
                  }
27
                }
28
              ],
29
              "slop": 5
30
            }
31
          }
32
        }
33
      }
34
    }
35
  },
36
  {
37
    "$limit": 5
38
  },
39
  {
40
    "$project": {
41
      "_id": 0,
42
      "title": 1
43
    }
44
  }
45
])

[
  { title: 'The Great Train Robbery' },
  { title: 'The Great Train Robbery' },
  { title: "The Great St. Trinian's Train Robbery" }
]

O Atlas Search retorna documentos que contêm o termo train (especificado usando little) dentro dos termos great e robbery (especificados usando big). Se você configurar spanToReturn na linha 6 para inner, o Atlas Search retornará os mesmos documentos porque o termo train (especificado utilizando little) aparece dentro dos termos great e robbery (especificados utilizando big).

Sintaxe

O operador posicional first tem a seguinte sintaxe:

{
  "$search": {
    "span": {
      "first": {
        "endPositionLte": <term-position>,
        "operator": { <span-positional-or-term-operator-specification> },
        "score": { <score-options> }
      }
    }
  }
}

Campos

O operador posicional first usa os seguintes campos:

Exemplo

As seguintes queries de exemplo utilizam span.first para encontrar documentos nos quais a string especificada aparece no campo title . O parâmetro endPositionLte tem um valor de 2, o que significa que o termo do Atlas Search especificado utilizando o operador term deve ser a primeira ou segunda palavra no campo.

1
db.movies.aggregate([
2
  {
3
    "$search": {
4
      "span": {
5
        "first": {
6
          "endPositionLte": 2,
7
          "operator": {
8
            "term": {
9
              "path": "title",
10
              "query": "dance"
11
            }
12
          }
13
        }
14
      }
15
    }
16
  },
17
  {
18
    "$limit": 5
19
  },
20
  {
21
    "$project": {
22
      "_id": 0,
23
      "title": 1
24
    }
25
  }
26
])

[
  { title: 'Dance Program' },
  { title: 'Slam Dance' },
  { title: 'Last Dance' },
  { title: 'War Dance' },
  { title: 'Delhi Dance' }
]

1
db.movies.aggregate([
2
  {
3
    "$search": {
4
      "span": {
5
        "first": {
6
          "endPositionLte": 2,
7
          "operator": {
8
            "or": {
9
              "clauses": [
10
                { "term": { "path": "title", "query": "man" } },
11
                { "term": { "path": "title", "query": "woman" } }
12
              ]
13
            }
14
          }
15
        }
16
      }
17
    }
18
  },
19
  {
20
    "$limit": 5
21
  },
22
  {
23
    "$project": {
24
      "_id": 0,
25
      "title": 1
26
    }
27
  }
28
])

[
  { title: "Everybody's Woman" },
  { title: 'Marked Woman' },
  { title: 'Wonder Man' },
  { title: 'Designing Woman' },
  { title: 'Watermelon Man' }
]

Sintaxe

O operador posicional near tem a seguinte sintaxe:

{
  "$search": {
    "span": {
      "near": {
        "clauses": [
          { <span-positional-or-term-operator-specification> },
          ...
        ],
        "slop": <distance-number>,
        "inOrder": true|false
      }
    }
  }
}

Campos

O operador posicional near usa os seguintes campos:

Exemplo

O exemplo de query a seguir usa span.near para o Atlas Search para documentos nos quais as strings prince e pauper são encontradas próximas uma da outra. O parâmetro inOrder é definido como false, para que os termos do Atlas Search possam estar em qualquer ordem. O parâmetro slop é definido como 4, de modo que os termos do Atlas Search possam ser separados por apenas 4 palavras.

1
db.movies.aggregate([
2
  {
3
    "$search" : {
4
      "span": {
5
        "near": {
6
          "clauses": [
7
            { "term": { "path": "title", "query": "prince" } },
8
            { "term": { "path": "title", "query": "pauper" } }
9
          ],
10
          "slop": 4,
11
          "inOrder": false
12
        }
13
      }
14
    }
15
  },
16
  {
17
    "$limit": 5
18
  },
19
  {
20
    "$project": {
21
      "_id": 0,
22
      "title": 1
23
    }
24
  }
25
])

[ { title: 'The Prince and the Pauper' } ]

Atlas Search Atlas Search um documento que contém as palavras prince e pauper, separadas por menos de quatro palavras, no campo title.

Sintaxe

O operador posicional or tem a seguinte sintaxe:

{
  "$search": {
    "span": {
      "or": {
        "clauses": [
          { <span-positional-or-term-operator-specification> },
          ...
        ],
        "score": { <scoring-options> }
      }
    }
  }
}

Campos

O operador posicional or usa os seguintes campos:

Exemplo

A query de exemplo a seguir usa cláusulas span.or para especificar duas queries de operador de termo que o Atlas Search para documentos nos quais o campo title tenha city ou country.

1
db.movies.aggregate([
2
  {
3
    "$search" : {
4
      "span": {
5
        "or": {
6
          "clauses": [
7
            { "term": { "path": "title", "query": "city" } },
8
            { "term": { "path": "title", "query": "country" } }
9
          ],
10
        }
11
      }
12
    }
13
  },
14
  {
15
    "$limit": 5
16
  },
17
  {
18
    "$project": {
19
      "_id": 0,
20
      "title": 1
21
    }
22
  }
23
])

[
  { title: 'Country' },
  { title: 'City Lights' },
  { title: 'King & Country' },
  { title: 'Fat City' },
  { title: 'Atlantic City' }
]

O Atlas Search retorna os documentos que contêm as palavras city ou country do Atlas Search no campo title, mas não ambas no mesmo title.

Sintaxe

O operador posicional subtract tem a seguinte sintaxe:

{
  "$search": {
    "span": {
      "subtract": {
        "include": { <span-positional-or-term-operator-specification> },
        "exclude": { <span-positional-or-term-operator-specification> }
      }
    }
  }
}

Campos

O operador posicional subtract usa os seguintes campos:

Exemplo

O exemplo de query a seguir usa span.subtract para o Atlas Search para documentos nos quais o campo title contém as palavras father e son, em qualquer ordem, dentro de 3 palavras uma da outra. Exclui qualquer documento no qual a palavra like ocorra entre father e son.

1
db.movies.aggregate([
2
  {
3
    "$search" : {
4
      "span": {
5
        "subtract": {
6
          "include": {
7
            "near": {
8
              "clauses": [
9
                { "term": { "path": "title", "query": "father" } },
10
                { "term": { "path": "title", "query": "son" } }
11
              ],
12
              "inOrder": false,
13
              "slop": 3
14
            }
15
          },
16
          "exclude": { "term": { "path": "title", "query": "like" } }
17
        }
18
      }
19
    }
20
  },
21
  {
22
    "$limit": 5
23
  },
24
  {
25
    "$project": {
26
      "_id": 0,
27
      "title": 1
28
    }
29
  }
30
])

[
  { title: 'Father, Son & Holy Cow' },
  { title: 'My Father and My Son' },
  { title: 'Jimmy Rosenberg: The Father, the Son & the Talent' }
]

O Atlas Search não retorna o documento com o título Like Father Like Son porque, embora o campo title inclua as palavras father e son, ele também tem like entre elas, que está nos critérios exclude de a query.