Como personalizar a pontuação dos documentos nos resultados

Conecte-se ao seu cluster no mongosh.

Abra o mongosh em uma janela do terminal e conecte ao seu cluster. Para obter instruções detalhadas sobre a conexão, consulte Conectar-se a um cluster via mongosh.

Use o banco de dados sample_mflix.

Execute o seguinte comando no prompt mongosh:

use sample_mflix

Execute as seguintes queries do MongoDB Search com o operador compound na coleção movies.

Os exemplos a seguir usam o operador compound com subqueries para pesquisar filmes entre os anos de 2013 e 2015 com o termo snow no campo title.

db.movies.aggregate([
  {
    "$search": {
      "index": "default",
      "compound": {
        "filter": [{
          "range": {
            "path": "year",
            "gte": 2013,
            "lte": 2015
          }
        }],
        "should": [{
          "text": {
            "query": "snow",
            "path": "title",
            "score": {"constant": {"value": 5}}
          }
        }]
      },
      "highlight": {
        "path": "title"
      }
    }
  },
  {
    "$limit": 10
  },
  {
    "$project": {
      "_id": 0,
      "title": 1,
      "year": 1,
      "score": { "$meta": "searchScore" },
      "highlights": { "$meta": "searchHighlights" }
    }
  }
])

 [
  {
    title: 'Snow in Paradise',
    year: 2014,
    score: 5,
    highlights: [
      {
        score: 1.382846713066101,
        path: 'title',
        texts: [
          { value: 'Snow', type: 'hit' },
          { value: ' in Paradise', type: 'text' }
        ]
      }
    ]
  },
  {
    title: 'Dead Snow 2: Red vs. Dead',
    year: 2014,
    score: 5,
    highlights: [
      {
        score: 1.3924485445022583,
        path: 'title',
        texts: [
          { value: 'Dead ', type: 'text' },
          { value: 'Snow', type: 'hit' },
          { value: ' 2: Red vs. ', type: 'text' }
        ]
      }
    ]
  },
  {
    title: 'The Snow White Murder Case',
    year: 2014,
    score: 5,
    highlights: [
      {
        score: 1.3525336980819702,
        path: 'title',
        texts: [
          { value: 'The ', type: 'text' },
          { value: 'Snow', type: 'hit' },
          { value: ' White Murder Case', type: 'text' }
        ]
      }
    ]
  },
  {
    title: 'Snow on the Blades',
    year: 2014,
    score: 5,
    highlights: [
      {
        score: 1.3766303062438965,
        path: 'title',
        texts: [
          { value: 'Snow', type: 'hit' },
          { value: ' on the Blades', type: 'text' }
        ]
      }
    ]
  },
  { year: 2013, title: 'The Secret Life of Walter Mitty', score: 0, highlights: [] },
  { title: 'Jurassic World', year: 2015, score: 0, highlights: [] },
  { title: 'Action Jackson', year: 2014, score: 0, highlights: [] },
  { year: 2013, title: 'In Secret', score: 0, highlights: [] },
  { title: 'The Stanford Prison Experiment', year: 2015, score: 0, highlights: [] },
  { year: 2014, title: 'The Giver', score: 0, highlights: [] }
]

db.movies.aggregate([
  {
    "$search": {
      "index": "default",
      "compound": {
        "must": [{
          "range": {
            "path": "year",
            "gte": 2013,
            "lte": 2015
          }
        }],
        "should": [{
          "text": {
            "query": "snow",
            "path": "title",
            "score": {"boost": {"value": 2}}
          }
        }]
      },
      "highlight": {
        "path": "title"
      }
    }
  },
  {
    "$limit": 10
  },
  {
    "$project": {
      "_id": 0,
      "title": 1,
      "year": 1,
      "score": { "$meta": "searchScore" },
      "highlights": { "$meta": "searchHighlights" }
    }
  }
])

[
  {
    title: 'Snow in Paradise',
    year: 2014,
    score: 6.7722930908203125,
    highlights: [
     {
       score: 1.382846713066101,
       path: 'title',
       texts: [
         { value: 'Snow', type: 'hit' },
         { value: ' in Paradise', type: 'text' }
       ]
     }
    ]
  },
  {
    title: 'Snow on the Blades',
    year: 2014,
    score: 6.063445568084717,
    highlights: [
      {
        score: 1.3766303062438965,
        path: 'title',
        texts: [
          { value: 'Snow', type: 'hit' },
          { value: ' on the Blades', type: 'text' }
        ]
      }
    ]
  },
  {
    title: 'The Snow White Murder Case',
    year: 2014,
    score: 5.509652137756348,
    highlights: [
      {
        score: 1.3525336980819702,
        path: 'title',
        texts: [
          { value: 'The ', type: 'text' },
          { value: 'Snow', type: 'hit' },
          { value: ' White Murder Case', type: 'text' }
        ]
      }
    ]
  },
  {
    title: 'Dead Snow 2: Red vs. Dead',
    year: 2014,
    score: 5.065053939819336,
    highlights: [
      {
        score: 1.3924485445022583,
        path: 'title',
        texts: [
          { value: 'Dead ', type: 'text' },
          { value: 'Snow', type: 'hit' },
          { value: ' 2: Red vs. ', type: 'text' }
        ]
      }
    ]
  },
  { year: 2013, title: 'The Secret Life of Walter Mitty', score: 1, highlights: [] },
  { title: 'Jurassic World', year: 2015, score: 1, highlights: [] },
  { title: 'Action Jackson', year: 2014, score: 1, highlights: [] },
  { year: 2013, title: 'In Secret', score: 1, highlights: [] },
  { title: 'The Stanford Prison Experiment', year: 2015, score: 1,  highlights: [] },
  { year: 2014, title: 'The Giver', score: 1, highlights: [] }
]

db.movies.aggregate([
    {
      "$search": {
        "index": "default",
        "compound": {
          "must": [{
            "text": {
              "path": "genres",
              "query": "comedy",
              "score": {"boost": {"value": 9}}
            }
          },
          {
            "text": {
              "path": "title",
              "query": "snow",
              "score": {"boost": {"value": 5}}
            }
          }],
          "should": [{
            "range": {
              "path": "year",
              "gte": 2013,
              "lte": 2015,
              "score": {"boost": {"value": 3}}
            }
          }]
        }
      }
    },
    {
      "$limit": 10
    },
    {
      "$project": {
        "_id": 0,
        "title": 1,
        "year": 1,
        "genres": 1,
        "score": { "$meta": "searchScore" }
      }
    }
])

  [
    {
      genres: [ 'Comedy', 'Horror' ],
      title: 'Dead Snow',
      year: 2009,
      score: 21.872983932495117
    },
    {
      year: 2000,
      genres: [ 'Adventure', 'Comedy', 'Family' ],
      title: 'Snow Day',
      score: 21.043487548828125
    },
    {
      genres: [ 'Adventure', 'Comedy', 'Family' ],
      title: 'Snow Dogs',
      year: 2002,
      score: 21.043487548828125
    },
    {
      year: 1999,
      genres: [ 'Comedy', 'Romance' ],
      title: 'Let It Snow',
      score: 19.523927688598633
    },
    {
      genres: [ 'Action', 'Comedy', 'Horror' ],
      title: 'Dead Snow 2: Red vs. Dead',
      year: 2014,
      score: 17.426334381103516
    },
    {
      genres: [ 'Comedy', 'Drama' ],
      title: 'Snow White and Russian Red',
      year: 2009,
      score: 16.367326736450195
    },
    {
      genres: [ 'Comedy', 'Drama', 'Romance' ],
      title: 'The Tiger and the Snow',
      year: 2005,
      score: 15.537829399108887
    },
    {
      genres: [ 'Adventure', 'Comedy', 'Family' ],
      title: 'Snow White and the Three Stooges',
      year: 1961,
      score: 14.4263334274292
    }
  ]

db.movies.aggregate([
  {
    "$search": {
      "index": "default",
      "compound": {
        "must": [{
          "range": {
            "path": "year",
            "gte": 2013,
            "lte": 2015
          }
        }],
        "should": [{
          "text": {
            "query": "snow",
            "path": "title",
            "score": {
              "function": {
                "add": [{
                  "path": {
                    "value": "imdb.rating",
                    "undefined": 2
                  }
                },
                {
                  "score": "relevance"
                }]
              }
            }
          }
        }]
      },
      "highlight": {
        "path": "title"
      }
    }
  },
  {
    "$limit": 10
  },
  {
    "$project": {
      "_id": 0,
      "title": 1,
      "year": 1,
      "score": { "$meta": "searchScore" },
      "highlights": { "$meta": "searchHighlights" }
    }
  }
])

 [
  {
    title: 'The Snow White Murder Case',
    year: 2014,
    score: 10.454826354980469,
    highlights: [
      {
        score: 1.3525336980819702,
        path: 'title',
        texts: [
          { value: 'The ', type: 'text' },
          { value: 'Snow', type: 'hit' },
          { value: ' White Murder Case', type: 'text' }
        ]
      }
    ]
  },
  {
    title: 'Snow on the Blades',
    year: 2014,
    score: 10.3317232131958,
    highlights: [
      {
        score: 1.3766303062438965,
        path: 'title',
        texts: [
          { value: 'Snow', type: 'hit' },
          { value: ' on the Blades', type: 'text' }
        ]
      }
    ]
  },
  {
    title: 'Dead Snow 2: Red vs. Dead',
    year: 2014,
    score: 10.032526969909668,
    highlights: [
      {
        score: 1.3924485445022583,
        path: 'title',
        texts: [
          { value: 'Dead ', type: 'text' },
          { value: 'Snow', type: 'hit' },
          { value: ' 2: Red vs. ', type: 'text' }
        ]
      }
    ]
  },
  {
    title: 'Snow in Paradise',
    year: 2014,
    score: 8.386146545410156,
    highlights: [
      {
        score: 1.382846713066101,
        path: 'title',
        texts: [
          { value: 'Snow', type: 'hit' },
          { value: ' in Paradise', type: 'text' }
        ]
      }
    ]
  },
  { year: 2013, title: 'The Secret Life of Walter Mitty', score: 1, highlights: [] },
  { title: 'Jurassic World', year: 2015, score: 1, highlights: [] },
  { title: 'Action Jackson', year: 2014, score: 1, highlights: [] },
  { year: 2013, title: 'In Secret', score: 1, highlights: [] },
  { title: 'The Stanford Prison Experiment', year: 2015, score: 1, highlights: [] },
  { year: 2014, title: 'The Giver', score: 1, highlights: [] }
]

Conecte-se ao seu cluster no MongoDB Compass.

Abra o MongoDB Compass e conecte-se ao cluster. Para obter instruções detalhadas sobre a conexão, consulte Conectar-se a um cluster via Compass.

Utilize a coleção movies no banco de dados sample_mflix.

Na tela Database, clique no banco de dados sample_mflix e, em seguida, clique na coleção movies.

Execute uma query composta do MongoDB Search que altere a pontuação usando a opção constant.

A query executa as seguintes tarefas:

• Utiliza as seguintes cláusulas do operador compound:

  • filter cláusula com o operador de faixa para pesquisar filmes entre os anos 2013 a 2015.

  • should cláusula com o operador text para fazer query no termo snow no campo title e alterar o score com a opção constant. A opção constant substitui todos os resultados de pontuação do termo de pesquisa por 5.

• Especifica a opção highlight para retornar trechos de texto do campo title que correspondem à query. Os trechos contêm texto correspondente especificado com type: 'hit' e texto adjacente especificado com type: 'text'.

• Utiliza os seguintes estágios do pipeline:

  • Estágio $limit para limitar a saída a 10 resultados.

  • $fase de projeto para:

    • Excluir todos os campos, exceto title e year

    • Adicionar dois campos denominados score e highlights

Para executar esta consulta no MongoDB Compass:

1. Clique na aba Aggregations.

2. Clique em Select... e, em seguida, configure cada um dos seguintes estágios do pipeline, selecionando o estágio no menu suspenso e adicionando a consulta para esse estágio. Clique em Add Stage para adicionar estágios adicionais.

   estágio do pipeline	Query
   $search	{ "index": "default", "compound": { "filter": [{ "range": { "path": "year", "gte": 2013, "lte": 2015 } }], "should": [{ "text": { "query": "snow", "path": "title", "score": {"constant": {"value": 5}} } }] }, "highlight": { "path": "title" } }
   $limit	10
   $project	{ "_id": 0, "title": 1, "year": 1, "score": { "$meta": "searchScore" }, "highlights": { "$meta": "searchHighlights" } }

   Se você habilitou Auto Preview, o MongoDB Compass exibe os seguintes documentos ao lado da etapa de pipeline do $project:

   {
     title: 'Snow in Paradise',
     year: 2014,
     score: 5,
     highlights: [{
       score: 1.382846713066101,
       path: 'title',
       texts: [
         { value: 'Snow', type: 'hit' },
         { value: ' in Paradise', type: 'text' }
       ]
     }]
   },
   {
     title: 'Dead Snow 2: Red vs. Dead',
     year: 2014,
     score: 5,
     highlights: [{
       score: 1.3924485445022583,
       path: 'title',
       texts: [
         { value: 'Dead ', type: 'text' },
         { value: 'Snow', type: 'hit' },
         { value: ' 2: Red vs. ', type: 'text' }
       ]
     }]
   },
   {
     title: 'The Snow White Murder Case',
     year: 2014,
     score: 5,
     highlights: [{
       score: 1.3525336980819702,
       path: 'title',
       texts: [
         { value: 'The ', type: 'text' },
         { value: 'Snow', type: 'hit' },
         { value: ' White Murder Case', type: 'text' }
       ]
     }]
   },
   {
     title: 'Snow on the Blades',
     year: 2014,
     score: 5,
     highlights: [{
       score: 1.3766303062438965,
       path: 'title',
       texts: [
         { value: 'Snow', type: 'hit' },
         { value: ' on the Blades', type: 'text' }
       ]
     }]
   },
   { year: 2013, title: 'The Secret Life of Walter Mitty', score: 0, highlights: [] },
   { title: 'Jurassic World', year: 2015, score: 0, highlights: [] },
   { title: 'Action Jackson', year: 2014, score: 0, highlights: [] },
   { year: 2013, title: 'In Secret', score: 0, highlights: [] },
   { title: 'The Stanford Prison Experiment', year: 2015, score: 0, highlights: [] },
   { year: 2014, title: 'The Giver', score: 0, highlights: [] }

   Os primeiros quatro documentos dos resultados têm uma pontuação mais alta porque a cláusula should na query especifica uma preferência por documentos com snow no título. A cláusula should também altera a pontuação do termo de query snow usando a opção constant.

Execute queries compostas do MongoDB Search que alterem a pontuação usando a opção boost.

1. Clique na aba Aggregations.

2. Clique em Select... e, em seguida, configure cada um dos seguintes estágios do pipeline, selecionando o estágio no menu suspenso e adicionando a consulta para esse estágio. Clique em Add Stage para adicionar estágios adicionais.

   Exemplo simples

   Exemplo de múltiplos pesos

   A consulta utiliza os seguintes estágios de pipeline:

   • $search para executar as seguintes tarefas:

     • Consultas usando as seguintes cláusulas do operador compound:

       • must cláusula com o operador de faixa para pesquisar filmes entre os anos 2013 a 2015.

       • should cláusula com o operador de texto para consultar o termo snow no campo title e alterar o score com a opção boost . A opção boost multiplica a pontuação base nos resultados do termo de pesquisa por 2.

     • Especifica a opção highlight para retornar trechos de texto do campo title que correspondem à query. Os trechos contêm texto correspondente especificado com type: 'hit' e texto adjacente especificado com type: 'text'.

   • Estágio $limit para limitar a saída a 10 resultados.

   • $fase de projeto para:

     • Excluir todos os campos, exceto title e year

     • Adicionar dois campos denominados score e highlights

   estágio do pipeline	Query
   $search	{ "index": "default", "compound": { "must": [{ "range": { "path": "year", "gte": 2013, "lte": 2015 } }], "should": [{ "text": { "query": "snow", "path": "title", "score": {"boost": {"value": 2}} } }] }, "highlight": { "path": "title" } }
   $limit	10
   $project	{ "_id": 0, "title": 1, "year": 1, "score": { "$meta": "searchScore" }, "highlights": { "$meta": "searchHighlights" } }

   Essa query usa os estágios de pipeline a seguir

   • $search para executar as seguintes tarefas:

     • Consultas usando as sentenças de operador compound com a opção boost para priorizar alguns campos mais do que outros campos:

       • must cláusula com o operador de texto para priorizar o gênero comedy , seguido pelo termo snow no campo title . A opção boost aplica pesos aos campos.

       • should cláusula com o operador de faixa para pesquisar filmes entre os anos 2013 a 2015.

       Observação

       A opção boost aplica diferentes pesos aos campos para priorizar os campos.

   • Estágio $limit para limitar a saída a 10 resultados.

   • $fase de projeto para:

     • Excluir todos os campos, exceto title e year

     • Adicionar dois campos denominados score e highlights

   • must cláusula com o operador de texto para priorizar o gênero comedy , seguido pelo termo snow no campo title . A opção boost aplica pesos aos campos.

   • should cláusula com o operador de faixa para pesquisar filmes entre os anos 2013 a 2015.

   Observação

   A opção boost aplica diferentes pesos aos campos para priorizar os campos.

   estágio do pipeline	Query
   $search	{ "index": "default", "compound": { "must": [{ "text": { "path": "genres", "query": "comedy", "score": {"boost": {"value": 9}} } }, { "text": { "path": "title", "query": "snow", "score": {"boost": {"value": 5}} } }], "should": [{ "range": { "path": "year", "gte": 2013, "lte": 2015, "score": {"boost": {"value": 3}} } }] } }
   $limit	10
   $project	{ "_id": 0, "title": 1, "year": 1, "genres": 1, "score": { "$meta": "searchScore" } }

   Se você habilitou Auto Preview, o MongoDB Compass exibe os seguintes documentos ao lado da etapa de pipeline do $project:

   Exemplo simples

   Exemplo de múltiplos pesos

   {
     title: 'Snow in Paradise',
     year: 2014,
     score: 6.7722930908203125,
     highlights: [{
       score: 1.382846713066101,
       path: 'title',
       texts: [
         { value: 'Snow', type: 'hit' },
         { value: ' in Paradise', type: 'text' }
       ]
     }]
   },
   {
     title: 'Snow on the Blades',
     year: 2014,
     score: 6.063445568084717,
     highlights: [{
       score: 1.3766303062438965,
       path: 'title',
       texts: [
         { value: 'Snow', type: 'hit' },
         { value: ' on the Blades', type: 'text' }
       ]
     }]
   },
   {
     title: 'The Snow White Murder Case',
     year: 2014,
     score: 5.509652137756348,
     highlights: [{
       score: 1.3525336980819702,
       path: 'title',
       texts: [
         { value: 'The ', type: 'text' },
         { value: 'Snow', type: 'hit' },
         { value: ' White Murder Case', type: 'text' }
       ]
     }]
   },
   {
     title: 'Dead Snow 2: Red vs. Dead',
     year: 2014,
     score: 5.065053939819336,
     highlights: [{
       score: 1.3924485445022583,
       path: 'title',
       texts: [
         { value: 'Dead ', type: 'text' },
         { value: 'Snow', type: 'hit' },
         { value: ' 2: Red vs. ', type: 'text' }
       ]
     }]
   },
   { year: 2013, title: 'The Secret Life of Walter Mitty',score: 1, highlights: [] },
   { title: 'Jurassic World', year: 2015, score: 1, highlights: [] },
   { title: 'Action Jackson', year: 2014, score: 1, highlights: [] },
   { year: 2013, title: 'In Secret', score: 1, highlights: [] },
   { title: 'The Stanford Prison Experiment', year: 2015, score: 1,  highlights: [] },
   { year: 2014, title: 'The Giver', score: 1, highlights: [] }

   Os primeiros quatro documentos dos resultados têm uma pontuação mais alta porque a cláusula should na query especifica uma preferência por documentos com snow no título. A cláusula should também altera a pontuação do termo de query snow usando a opção boost.

     [
       {
         genres: [ 'Comedy', 'Horror' ],
         title: 'Dead Snow',
         year: 2009,
         score: 21.872983932495117
       },
       {
         year: 2000,
         genres: [ 'Adventure', 'Comedy', 'Family' ],
         title: 'Snow Day',
         score: 21.043487548828125
       },
       {
         genres: [ 'Adventure', 'Comedy', 'Family' ],
         title: 'Snow Dogs',
         year: 2002,
         score: 21.043487548828125
       },
       {
         year: 1999,
         genres: [ 'Comedy', 'Romance' ],
         title: 'Let It Snow',
         score: 19.523927688598633
       },
       {
         genres: [ 'Action', 'Comedy', 'Horror' ],
         title: 'Dead Snow 2: Red vs. Dead',
         year: 2014,
         score: 17.426334381103516
       },
       {
         genres: [ 'Comedy', 'Drama' ],
         title: 'Snow White and Russian Red',
         year: 2009,
         score: 16.367326736450195
       },
       {
         genres: [ 'Comedy', 'Drama', 'Romance' ],
         title: 'The Tiger and the Snow',
         year: 2005,
         score: 15.537829399108887
       },
       {
         genres: [ 'Adventure', 'Comedy', 'Family' ],
         title: 'Snow White and the Three Stooges',
         year: 1961,
         score: 14.4263334274292
       }
     ]

Execute uma query composta do MongoDB Search que altere a pontuação usando a opção function.

A consulta utiliza os seguintes estágios de pipeline:

• $search estágio para executar as seguintes tarefas:

  • Consultas usando as seguintes cláusulas do operador compound:

    • must cláusula com o operador de faixa para pesquisar filmes entre os anos 2013 a 2015.

    • should cláusula com o operador de texto para consultar o termo snow no campo title e alterar o score com a opção function . A opção function adiciona o seguinte utilizando uma expressão aritmética:

      • A pontuação de relevância da consulta para o termo de pesquisa

      • O valor do campo numérico denominado imdb.rating ou o número 2 para os documentos que não têm o campo imdb.rating.

  • Especifica a opção highlight para retornar trechos de texto do campo title que correspondem à query. Os trechos contêm texto correspondente especificado com type: 'hit' e texto adjacente especificado com type: 'text'.

• Estágio $limit para limitar a saída a 10 resultados.

• $fase de projeto para:

  • Excluir todos os campos, exceto title e year

  • Adicionar dois campos denominados score e highlights

Para executar esta consulta no MongoDB Compass:

1. Clique na aba Aggregations.

2. Clique em Select... e, em seguida, configure cada um dos seguintes estágios do pipeline, selecionando o estágio no menu suspenso e adicionando a consulta para esse estágio. Clique em Add Stage para adicionar estágios adicionais.

   estágio do pipeline	Query
   $search	{ "index": "default", "compound": { "must": [{ "range": { "path": "year", "gte": 2013, "lte": 2015 } }], "should": [{ "text": { "query": "snow", "path": "title", "score": { "function": { "add": [{ "path": { "value": "imdb.rating", "undefined": 2 } }, { "score": "relevance" }] } } } }]}, "highlight":{ "path": "title" } }
   $limit	10
   $project	{ "_id": 0, "title": 1, "year": 1, "score": { "$meta": "searchScore" }, "highlights": { "$meta": "searchHighlights" } }

   Se você habilitou Auto Preview, o MongoDB Compass exibe os seguintes documentos ao lado da etapa de pipeline do $project:

   {
     title: 'The Snow White Murder Case',
     year: 2014,
     score: 10.454826354980469,
     highlights: [{
         score: 1.3525336980819702,
         path: 'title',
         texts: [
           { value: 'The ', type: 'text' },
           { value: 'Snow', type: 'hit' },
           { value: ' White Murder Case', type: 'text' }
         ]
     }]
   },
   {
     title: 'Snow on the Blades',
     year: 2014,
     score: 10.3317232131958,
     highlights: [{
       score: 1.3766303062438965,
       path: 'title',
       texts: [
         { value: 'Snow', type: 'hit' },
         { value: ' on the Blades', type: 'text' }
       ]
     }]
   },
   {
     title: 'Dead Snow 2: Red vs. Dead',
     year: 2014,
     score: 10.032526969909668,
     highlights: [{
       score: 1.3924485445022583,
       path: 'title',
       texts: [
         { value: 'Dead ', type: 'text' },
         { value: 'Snow', type: 'hit' },
         { value: ' 2: Red vs. ', type: 'text' }
       ]
     }]
   },
   {
     title: 'Snow in Paradise',
     year: 2014,
     score: 8.386146545410156,
     highlights: [{
       score: 1.382846713066101,
       path: 'title',
       texts: [
         { value: 'Snow', type: 'hit' },
         { value: ' in Paradise', type: 'text' }
       ]
     }]
   },
   { year: 2013, title: 'The Secret Life of Walter Mitty', score: 1, highlights: [] },
   { title: 'Jurassic World', year: 2015, score: 1, highlights: [] },
   { title: 'Action Jackson', year: 2014, score: 1, highlights: [] },
   { year: 2013, title: 'In Secret', score: 1, highlights: [] },
   { title: 'The Stanford Prison Experiment', year: 2015, score: 1, highlights: [] },
   { year: 2014, title: 'The Giver', score: 1, highlights: [] }

   Os primeiros quatro documentos dos resultados têm uma pontuação mais alta porque a cláusula should na query especifica uma preferência por documentos com snow no título. A cláusula should também altera a pontuação do termo de query snow usando a opção function.

Execute uma query composta do MongoDB Search que altere a pontuação usando a opção constant.

1. Crie um novo diretório chamado compound-constant-example e inicialize seu projeto com o comando dotnet new.

   mkdir compound-constant-example
   cd compound-constant-example
   dotnet new console

2. Adicione o driver .NET/C# ao seu projeto como uma dependência.

   dotnet add package MongoDB.Driver

3. Substitua o conteúdo do arquivo Program.cs pelo seguinte código.

   O exemplo de código executa as seguintes tarefas:

   • Importa pacotes e dependências do mongodb .

   • Estabelece uma conexão com seu cluster.

   • Utiliza as seguintes cláusulas compostas para fazer query da collection:

     • filter cláusula com o operador de faixa para pesquisar filmes entre os anos 2013 a 2015.

     • should cláusula com o operador text para fazer query no termo snow no campo title e alterar o score com a opção constant. A opção constant substitui todos os resultados de pontuação do termo de pesquisa por 5.

   • Especifica a opção highlight para retornar trechos de texto do campo title que correspondem à query. Os trechos contêm texto correspondente especificado com type: 'hit' e texto adjacente especificado com type: 'text'.

   • Utiliza os seguintes estágios do pipeline:

     • Estágio $limit para limitar a saída a 10 resultados.

     • $fase de projeto para:

       • Excluir todos os campos, exceto title e year

       • Adicionar dois campos denominados score e highlights

   • Itera sobre o cursor para imprimir os documentos que correspondem à consulta.

   1
   using MongoDB.Bson;
   2
   using MongoDB.Bson.Serialization.Attributes;
   3
   using MongoDB.Bson.Serialization.Conventions;
   4
   using MongoDB.Driver;
   5
   using MongoDB.Driver.Search;
   6
   7
   public class CompoundConstantExample
   8
   {
   9
       private const string MongoConnectionString = "<connection-string>";
   10
   11
       public static void Main(string[] args)
   12
       {
   13
           // allow automapping of the camelCase database fields to our MovieDocument
   14
           var camelCaseConvention = new ConventionPack { new CamelCaseElementNameConvention() };
   15
           ConventionRegistry.Register("CamelCase", camelCaseConvention, type => true);
   16
   17
           // connect to your Atlas cluster
   18
           var mongoClient = new MongoClient(MongoConnectionString);
   19
           var mflixDatabase = mongoClient.GetDatabase("sample_mflix");
   20
           var moviesCollection = mflixDatabase.GetCollection<MovieDocument>("movies");
   21
   22
           // define and run pipeline
   23
           var results = moviesCollection.Aggregate()
   24
               .Search(Builders<MovieDocument>.Search.Compound()
   25
                   .Filter(Builders<MovieDocument>.Search.Range(movie => movie.Year, SearchRangeBuilder.Gte(2013).Lte(2015)))
   26
                   .Should(Builders<MovieDocument>.Search.Text(movie => movie.Title, "snow", score: new SearchScoreDefinitionBuilder<MovieDocument>().Constant(5))), 
   27
                   new SearchHighlightOptions<MovieDocument>(movie => movie.Title),
   28
                   indexName: "default")
   29
               .Project<MovieDocument>(Builders<MovieDocument>.Projection
   30
                   .Include(movie => movie.Title)
   31
                   .Include(movie => movie.Year)
   32
                   .Exclude(movie => movie.Id)
   33
                   .MetaSearchScore(movie => movie.Score)
   34
                   .MetaSearchHighlights("highlights"))
   35
               .Limit(10)
   36
               .ToList();
   37
   38
           // print results
   39
           foreach (var movie in results)
   40
           {
   41
               Console.WriteLine(movie.ToJson());
   42
           }
   43
       }
   44
   }
   45
   46
   [BsonIgnoreExtraElements]
   47
   public class MovieDocument
   48
   {
   49
       [BsonIgnoreIfDefault]
   50
       public ObjectId Id { get; set; }
   51
       public string Title { get; set; }
   52
       public int Year { get; set; }
   53
       [BsonElement("highlights")]
   54
       public List<SearchHighlight> Highlights { get; set; }
   55
       public double Score { get; set; }
   56
   }

4. Antes de executar a amostra, substitua <connection-string> por sua string de conexão do Atlas. Certifique-se de que a string de conexão inclua as credenciais do usuário de banco de dados. Para saber mais, consulte Conectar-se a um cluster por meio de bibliotecas de clientes.

5. Compile e execute o arquivo Program.cs .

   dotnet run compound-constant-example.csproj

   OCULTAR SAÍDA

   {
     "title" : "Snow in Paradise",
     "year" : 2014,
     "highlights" : [{
       "path" : "title",
       "score" : 1.3828467130661011,
       "texts" : [{ "type" : "Hit", "value" : "Snow" }, { "type" : "Text", "value" : " in Paradise" }]
     }],
     "score" : 5.0
   }
   {
     "title" : "Dead Snow 2: Red vs. Dead",
     "year" : 2014,
     "highlights" : [{
       "path" : "title",
       "score" : 1.3924485445022583,
       "texts" : [{ "type" : "Text", "value" : "Dead " }, { "type" : "Hit", "value" : "Snow" }, { "type" : "Text", "value" : " 2: Red vs. " }]
     }],
     "score" : 5.0
   }
   {
     "title" : "The Snow White Murder Case",
     "year" : 2014,
     "highlights" : [{
       "path" : "title",
       "score" : 1.3525336980819702,
       "texts" : [{ "type" : "Text", "value" : "The " }, { "type" : "Hit", "value" : "Snow" }, { "type" : "Text", "value" : " White Murder Case" }]
     }],
     "score" : 5.0
   }
   {
     "title" : "Snow on the Blades",
     "year" : 2014,
     "highlights" : [{
       "path" : "title",
       "score" : 1.3766303062438965,
       "texts" : [{ "type" : "Hit", "value" : "Snow" }, { "type" : "Text", "value" : " on the Blades" }]
     }],
     "score" : 5.0
   }
   { "title" : "The Secret Life of Walter Mitty", "year" : 2013, "highlights" : [], "score" : 0.0 }
   { "title" : "Jurassic World", "year" : 2015, "highlights" : [], "score" : 0.0 }
   { "title" : "Action Jackson", "year" : 2014, "highlights" : [], "score" : 0.0 }
   { "title" : "In Secret", "year" : 2013, "highlights" : [], "score" : 0.0 }
   { "title" : "The Stanford Prison Experiment", "year" : 2015, "highlights" : [], "score" : 0.0 }
   { "title" : "The Giver", "year" : 2014, "highlights" : [], "score" : 0.0 }

   Os primeiros quatro documentos dos resultados têm uma pontuação mais alta porque a cláusula should na query especifica uma preferência por documentos com snow no título. A cláusula should também altera a pontuação do termo de query snow usando a opção constant.

Execute queries compostas do MongoDB Search que alterem a pontuação usando a opção boost.

1. Crie um novo diretório chamado compound-boost-example e inicialize seu projeto com o comando dotnet new.

   mkdir compound-boost-example
   cd compound-boost-example
   dotnet new console

2. Adicione o driver .NET/C# ao seu projeto como uma dependência.

   dotnet add package MongoDB.Driver

3. Substitua o conteúdo do arquivo Program.cs pelo seguinte código.

   O exemplo de código executa as seguintes tarefas:

   • Importa pacotes e dependências do mongodb .

   • Estabelece uma conexão com seu cluster.

   • Itera sobre o cursor para imprimir os documentos que correspondem à consulta.

   Exemplo simples

   Exemplo de múltiplos pesos

   A consulta utiliza os seguintes estágios de pipeline:

   • $search estágio para fazer query na collection. A query:

     • Utiliza as seguintes cláusulas do operador compound:

       • must cláusula com o operador de faixa para pesquisar filmes entre os anos 2013 a 2015.

       • should cláusula com o operador de texto para consultar o termo snow no campo title e alterar o score com a opção boost . A opção boost multiplica a pontuação base nos resultados do termo de pesquisa por 2.

     Especifica a opção highlight para retornar trechos de texto do campo title que correspondem à query. Os trechos contêm texto correspondente especificado com type: 'hit' e texto adjacente especificado com type: 'text'.

   • Estágio $limit para limitar a saída a 10 resultados.

   • $fase de projeto para:

     • Excluir todos os campos, exceto title e year

     • Adicionar dois campos denominados score e highlights

   1
   using MongoDB.Bson;
   2
   using MongoDB.Bson.Serialization.Attributes;
   3
   using MongoDB.Bson.Serialization.Conventions;
   4
   using MongoDB.Driver;
   5
   using MongoDB.Driver.Search;
   6
   7
   public class CompoundBoostSingleExample
   8
   {
   9
       private const string MongoConnectionString = "<connection-string>";
   10
   11
       public static void Main(string[] args)
   12
       {
   13
           // allow automapping of the camelCase database fields to our MovieDocument
   14
           var camelCaseConvention = new ConventionPack { new CamelCaseElementNameConvention() };
   15
           ConventionRegistry.Register("CamelCase", camelCaseConvention, type => true);
   16
   17
           // connect to your Atlas cluster
   18
           var mongoClient = new MongoClient(MongoConnectionString);
   19
           var mflixDatabase = mongoClient.GetDatabase("sample_mflix");
   20
           var moviesCollection = mflixDatabase.GetCollection<MovieDocument>("movies");
   21
   22
           // define and run pipeline
   23
           var results = moviesCollection.Aggregate()
   24
               .Search(Builders<MovieDocument>.Search.Compound()
   25
                   .Must(Builders<MovieDocument>.Search.Range(movie => movie.Year, SearchRangeBuilder.Gte(2013).Lte(2015)))
   26
                   .Should(Builders<MovieDocument>.Search.Text(movie => movie.Title, "snow", score: new SearchScoreDefinitionBuilder<MovieDocument>().Boost(2))), 
   27
                   new SearchHighlightOptions<MovieDocument>(movie => movie.Title),
   28
                   indexName: "default")
   29
               .Project<MovieDocument>(Builders<MovieDocument>.Projection
   30
                   .Include(movie => movie.Title)
   31
                   .Include(movie => movie.Year)
   32
                   .Exclude(movie => movie.Id)
   33
                   .MetaSearchScore(movie => movie.Score)
   34
                   .MetaSearchHighlights("highlights"))
   35
               .Limit(10)
   36
               .ToList();
   37
   38
           // print results
   39
           foreach (var movie in results)
   40
           {
   41
               Console.WriteLine(movie.ToJson());
   42
           }
   43
       }
   44
   }
   45
   46
   [BsonIgnoreExtraElements]
   47
   public class MovieDocument
   48
   {
   49
       [BsonIgnoreIfDefault]
   50
       public ObjectId Id { get; set; }
   51
       public string Title { get; set; }
   52
       public int Year { get; set; }
   53
       [BsonElement("highlights")]
   54
       public List<SearchHighlight> Highlights { get; set; }
   55
       public double Score { get; set; }
   56
   }

   Esta query usa as seguintes cláusulas do operador compound com a opção boost para priorizar alguns campos mais do que outros campos:

   • must cláusula com o operador de texto para priorizar o gênero comedy , seguido pelo termo snow no campo title . A opção boost aplica pesos aos campos.

   • should cláusula com o operador de faixa para pesquisar filmes entre os anos 2013 a 2015.

   Observação

   A opção boost aplica diferentes pesos aos campos para priorizar os campos.

   1
   using MongoDB.Bson;
   2
   using MongoDB.Bson.Serialization.Attributes;
   3
   using MongoDB.Bson.Serialization.Conventions;
   4
   using MongoDB.Driver;
   5
   using MongoDB.Driver.Search;
   6
   7
   public class CompoundBoostMultipleExample
   8
   {
   9
       private const string MongoConnectionString = "<connection-string>";
   10
   11
       public static void Main(string[] args)
   12
       {
   13
           // allow automapping of the camelCase database fields to our MovieDocument
   14
           var camelCaseConvention = new ConventionPack { new CamelCaseElementNameConvention() };
   15
           ConventionRegistry.Register("CamelCase", camelCaseConvention, type => true);
   16
   17
           // connect to your Atlas cluster
   18
           var mongoClient = new MongoClient(MongoConnectionString);
   19
           var mflixDatabase = mongoClient.GetDatabase("sample_mflix");
   20
           var moviesCollection = mflixDatabase.GetCollection<MovieDocument>("movies");
   21
   22
           // define and run pipeline
   23
           var results = moviesCollection.Aggregate()
   24
               .Search(Builders<MovieDocument>.Search.Compound()
   25
                   .Must(Builders<MovieDocument>.Search.Text(movie => movie.Genres, "comedy", score: new SearchScoreDefinitionBuilder<MovieDocument>().Boost(9)))
   26
                   .Must(Builders<MovieDocument>.Search.Text(movie => movie.Title, "snow", score: new SearchScoreDefinitionBuilder<MovieDocument>().Boost(5)))
   27
                   .Should(Builders<MovieDocument>.Search.Range(movie => movie.Year, SearchRangeBuilder.Gte(2013).Lte(2015), score: new SearchScoreDefinitionBuilder<MovieDocument>().Boost(3))),
   28
                   indexName: "default")
   29
               .Project<MovieDocument>(Builders<MovieDocument>.Projection
   30
                   .Include(movie => movie.Genres)
   31
                   .Include(movie => movie.Title)
   32
                   .Include(movie => movie.Year)
   33
                   .Exclude(movie => movie.Id)
   34
                   .MetaSearchScore(movie => movie.Score))
   35
               .Limit(10)
   36
               .ToList();
   37
           
   38
           // print results
   39
           foreach (var movie in results)
   40
           {
   41
               Console.WriteLine(movie.ToJson());
   42
           }
   43
       }
   44
   }
   45
   46
   [BsonIgnoreExtraElements]
   47
   public class MovieDocument
   48
   {
   49
       [BsonIgnoreIfDefault]
   50
       public ObjectId Id { get; set; }
   51
       public string [] Genres { get; set; }
   52
       public string Title { get; set; }
   53
       public int Year { get; set; }
   54
       public double Score { get; set; }
   55
   }

4. Antes de executar a amostra, substitua <connection-string> por sua string de conexão do Atlas. Certifique-se de que a string de conexão inclua as credenciais do usuário de banco de dados. Para saber mais, consulte Conectar-se a um cluster por meio de bibliotecas de clientes.

5. Compile e execute o arquivo Program.cs .

   Exemplo simples

   Exemplo de múltiplos pesos

   dotnet run compound-boost-example.csproj

   OCULTAR SAÍDA

   {
     "title" : "Snow in Paradise",
     "year" : 2014,
     "highlights" : [{
       "path" : "title",
       "score" : 1.3828467130661011,
       "texts" : [{ "type" : "Hit", "value" : "Snow" }, { "type" : "Text", "value" : " in Paradise" }]
     }],
     "score" : 6.7722930908203125
   }
   {
     "title" : "Snow on the Blades",
     "year" : 2014,
     "highlights" : [{
       "path" : "title",
       "score" : 1.3766303062438965,
       "texts" : [{ "type" : "Hit", "value" : "Snow" }, { "type" : "Text", "value" : " on the Blades" }]
     }],
     "score" : 6.0634455680847168
   }
   {
     "title" : "The Snow White Murder Case",
     "year" : 2014,
     "highlights" : [{
       "path" : "title",
       "score" : 1.3525336980819702,
       "texts" : [{ "type" : "Text", "value" : "The " }, { "type" : "Hit", "value" : "Snow" }, { "type" : "Text", "value" : " White Murder Case" }]
     }],
     "score" : 5.5096521377563477
   }
   {
     "title" : "Dead Snow 2: Red vs. Dead",
     "year" : 2014,
     "highlights" : [{
       "path" : "title",
       "score" : 1.3924485445022583,
       "texts" : [{ "type" : "Text", "value" : "Dead " }, { "type" : "Hit", "value" : "Snow" }, { "type" : "Text", "value" : " 2: Red vs. " }]
     }],
     "score" : 5.0650539398193359
   }
   { "title" : "The Secret Life of Walter Mitty", "year" : 2013, "highlights" : [], "score" : 1.0 }
   { "title" : "Jurassic World", "year" : 2015, "highlights" : [], "score" : 1.0 }
   { "title" : "Action Jackson", "year" : 2014, "highlights" : [], "score" : 1.0 }
   { "title" : "In Secret", "year" : 2013, "highlights" : [], "score" : 1.0 }
   { "title" : "The Stanford Prison Experiment", "year" : 2015, "highlights" : [], "score" : 1.0 }
   { "title" : "The Giver", "year" : 2014, "highlights" : [], "score" : 1.0 }

   Os primeiros quatro documentos dos resultados têm uma pontuação mais alta porque a cláusula should na query especifica uma preferência por documentos com snow no título. A cláusula should também altera a pontuação do termo de query snow usando a opção boost.

   dotnet run compound-boost-example.csproj

   OCULTAR SAÍDA

   { "genres" : ["Comedy", "Horror"], "title" : "Dead Snow", "year" : 2009, "score" : 21.872983932495117 }
   { "genres" : ["Adventure", "Comedy", "Family"], "title" : "Snow Day", "year" : 2000, "score" : 21.043487548828125 }
   { "genres" : ["Adventure", "Comedy", "Family"], "title" : "Snow Dogs", "year" : 2002, "score" : 21.043487548828125 }
   { "genres" : ["Comedy", "Romance"], "title" : "Let It Snow", "year" : 1999, "score" : 19.523927688598633 }
   { "genres" : ["Action", "Comedy", "Horror"], "title" : "Dead Snow 2: Red vs. Dead", "year" : 2014, "score" : 17.426334381103516 }
   { "genres" : ["Comedy", "Drama"], "title" : "Snow White and Russian Red", "year" : 2009, "score" : 16.367326736450195 }
   { "genres" : ["Comedy", "Drama", "Romance"], "title" : "The Tiger and the Snow", "year" : 2005, "score" : 15.537829399108887 }
   { "genres" : ["Adventure", "Comedy", "Family"], "title" : "Snow White and the Three Stooges", "year" : 1961, "score" : 14.426333427429199 }