Como usar sinônimos com o Atlas Search

1. Na barra lateral, clique em Atlas Search sob o título Services.

2. No menu suspenso Select data source, selecione seu cluster e clique em Go to Atlas Search.

   A página Atlas Search é exibida.

1. Clique no botão Browse Collections para o seu cluster.

2. Expanda o banco de dados e selecione a coleção.

3. Clique na guia Search Indexes da coleção.

   A página Atlas Search é exibida.

1. Clique no nome do seu cluster.

2. Clique na aba Atlas Search.

   A página Atlas Search é exibida.

Os resultados da consulta de pesquisa do Atlas variam de acordo com o tipo de mapeamento de palavras definido na coleção de fontes de sinônimos.

[
  {
    $search: {
      index: "synonyms-tutorial",
      text: {
        path: "title",
        query: "automobile",
        synonyms: "transportSynonyms"
      }
    }
  }
]

SCORE: 4.197734832763672  _id:  “573a13a9f29313caabd1f18a”
  fullplot: "While traveling to California for the dispute of the final race of the…"
  imdb: Object
  year: 2006
  ...
  title: "Cars"
SCORE: 3.8511905670166016  _id:  “573a1398f29313caabcea94c”
  plot: "A man must struggle to travel home for Thanksgiving with an obnoxious …"
  genres: Array
  runtime: 93
  ...
  title: "Planes, Trains, and Automobiles"
SCORE: 3.39473032951355  _id:  “573a1397f29313caabce5fb0”
  plot: "Car Wash is about a close-knit group of employees who one day have all…"
  genres: Array
  runtime: 97
  ...
  title: "Car Wash"
SCORE: 3.39473032951355  _id:  “573a1397f29313caabce7bd2”
  plot: "When the owner of a struggling used car lot is killed, it's up to the …"
  genres: Array
  runtime: 113
  ...
  title: "Used Cars"
SCORE: 3.39473032951355  _id:  “573a13a6f29313caabd18bfe”
  fullplot: "Gifted 18-year-old Meg has been abandoned by her father and neglected …"
  imdb: Object
  year: 2002
  ...
  title: "Blue Car"
SCORE: 3.39473032951355  _id:  “573a13c1f29313caabd64e3d”
  fullplot: "After Mater gets his best friend, star race car Lightning McQueen, a s…"
  imdb: Object
  year: 2011
  ...
  title: "Cars 2"
SCORE: 3.39473032951355  _id:  “573a13eaf29313caabdce62c”
  plot: "A rebellious teenager navigates his way through the juvenile court sys…"
  genres: Array
  runtime: 94
  ...
  title: "Stealing Cars"
SCORE: 3.39473032951355  _id:  “573a13f1f29313caabddc93f”
  plot: "A small town sheriff sets out to find the two kids who have taken his …"
  genres: Array
  runtime: 86
  ...
  title: "Cop Car"
SCORE: 2.8496146202087402  _id:  “573a1396f29313caabce5480”
  plot: "The small town of Paris, Australia deliberately causes car accidents, …"
  genres: Array
  runtime: 91
  ...
  title: "The Cars That Eat People"
SCORE: 2.8496146202087402  _id:  “573a139df29313caabcf9636”
  plot: "Military doctor General Klenski is arrested in Stalin's Russia in 1953…"
  genres: Array
  runtime: 137
  ...
  title: "Khrustalyov, My Car!"

[
  {
    $search: {
      index: "synonyms-tutorial",
      text: {
        path: "title",
        query: "boat",
        synonyms: "transportSynonyms"
      }
    }
  }
]

SCORE: 5.373150825500488  _id:  “573a13e9f29313caabdcd013”
  plot: "A fearless sea captain sails a ship through loopholes in international…"
  genres: Array
  runtime: 90
  ...
  title: "Vessel"
SCORE: 4.589139938354492  _id:  “573a13e8f29313caabdc9e72”
  countries: Array
  genres: Array
  runtime: 7
  ...
  title: "Boats"
SCORE: 4.3452959060668945  _id:  “573a1398f29313caabce90b6”
  plot: "In 1914, a luxury ship leaves Italy in order to scatter the ashes of a…"
  genres: Array
  runtime: 128
  ...
  title: "And the Ship Sails On"
SCORE: 4.3452959060668945  _id:  “573a139cf29313caabcf7c75”
  plot: "A young Pennsylvania man moves to Los Angeles to begin work for an amb…"
  genres: Array
  runtime: 90
  ...
  title: "Broken Vessels"
SCORE: 4.3452959060668945  _id:   “573a13f0f29313caabdda2dd”
  plot: "A young man struggling with the death of his parents meets an extrover…"
  genres: Array
  runtime: 80
  ...
  title: "Sailing to Paradise"
SCORE: 3.711261749267578  _id:  “573a1397f29313caabce8796”
  plot: "A Japanese photojournalist revisits Vietnam after the Liberation and l…"
  genres: Array
  runtime: 109
  ...
  title: "Boat People"
SCORE: 3.711261749267578  _id:  “573a13a6f29313caabd17a98”
  plot: "Two straight men mistakenly end up on a "gays only" cruise."
  genres: Array
  runtime: 94
  ...
  title: "Boat Trip"
SCORE: 3.1153182983398438  _id:  “573a1394f29313caabce036c”
  plot: "Three London gentlemen take vacation rowing down the Thames, encounter…"
  genres: Array
  runtime: 84
  ...
  title: "Three Men in a Boat"
SCORE: 3.1153182983398438  _id:  “573a1395f29313caabce2c28”
  plot: "After a series of misunderstandings, the head of an aerospace research…"
  genres: Array
  runtime: 110
  ...
  title: "The Glass Bottom Boat"
SCORE: 3.1153182983398438  _id:  “573a13c2f29313caabd68772”
  fullplot: "Jack is a shy and awkward man who drives a limo and lives an unassumin…"
  imdb: Object
  runtime: 2010
  ...
  title: "Jack Goes Boating"

{ "title" : "Vessel", "score" : 5.373150825500488 }
{ "title" : "Broken Vessels", "score" : 4.3452959060668945 }

{ "title" : "And the Ship Sails On", "score" : 4.3452959060668945 }
{ "title" : "Sailing to Paradise", "score" : 4.3452959060668945 }

Os resultados da consulta de pesquisa do Atlas variam de acordo com o tipo de mapeamento de palavras definido na coleção de fontes de sinônimos.

[
  {
    $search: {
      "index": "synonyms-tutorial",
      "compound": {
        "should": [{
          "text": {
            "path": "title",
            "query": "automobile",
            "synonyms": "transportSynonyms"
          }
        },
        {
          "text": {
            "path": "title",
            "query": "attire",
            "synonyms": "attireSynonyms"
          }
        }]
      }
    }
  }
]

SCORE: 4.812004089355469  _id:  “573a139af29313caabcf003f”
  plot: "The Dress is a tale filled with sex, violence, comedy and drama as it …"
  genres: Array
  runtime: 103
  ...
  title: "The Dress"
SCORE: 4.197734832763672  _id:  “573a13a9f29313caabd1f18a”
  fullplot: "While traveling to California for the dispute of the final race of the…"
  imdb: Object
  year: 2006
  ...
  title: "Cars"
SCORE: 3.891493320465088  _id:  “573a1397f29313caabce77cd”
  plot: "A mysterious blonde woman kills one of a psychiatrist's patients, and …"
  genres: Array
  runtime: 105
  ...
  title: "Dressed to Kill"
SCORE: 3.891493320465088  _id:  “573a13bcf29313caabd57e07”
  fullplot: "Two things about Jane: she never says no to her friends (she's been a …"
  imdb Object
  year: 2008
  ...
  title: "27 Dresses"
SCORE: 3.8511905670166016  _id:  “573a1398f29313caabcea94c”
  plot: "A man must struggle to travel home for Thanksgiving with an obnoxious …"
  genres: Array
  runtime: 93
  ...
  title: "Planes, Trains, and Automobiles"
SCORE: 3.39473032951355  _id:  “573a1397f29313caabce5fb0”
  plot: "Car Wash is about a close-knit group of employees who one day have all…"
  genres: Array
  runtime: 97
  ...
  title: "Car Wash"
SCORE: 3.39473032951355  _id:  “573a1397f29313caabce7bd2”
  plot: "When the owner of a struggling used car lot is killed, it's up to the …"
  genres: Array
  runtime: 113
  ...
  title: "Used Cars"
SCORE: 3.39473032951355  _id:  “573a13a6f29313caabd18bfe”
  fullplot: "Gifted 18-year-old Meg has been abandoned by her father and neglected …"
  imdb: Object
  year: 2002
  ...
  title: "Blue Car"
SCORE: 3.39473032951355  _id:  “573a13c1f29313caabd64e3d”
  fullplot: "After Mater gets his best friend, star race car Lightning McQueen, a s…"
  imdb: Object
  year: 2011
  ...
  title: "Cars 2"
SCORE: 3.39473032951355  _id:  “573a13eaf29313caabdce62c”
  plot: "A rebellious teenager navigates his way through the juvenile court sys…"
  genres: Array
  runtime: 94
  ...
  title: "Stealing Cars"

[
  {
    $search: {
      index: "synonyms-tutorial",
      compound: {
        should: [{
          text: {
            path: "title",
            query: "boat",
            synonyms: "transportSynonyms"
          }
        },
        {
          text: {
            path: "title",
            query: "hat",
            synonyms: "attireSynonyms"
          }
        }]
      }
    }
  }
]

SCORE: 5.673145294189453  _id:  “573a1397f29313caabce6bed”
  plot: "Down-on-his-luck Hollywood producer Barry 'Dutch' Detweiler attempts t…"
  genres: Array
  runtime: 114
  ...
  title: "Fedora"
SCORE: 5.373150825500488  _id:  “573a13e9f29313caabdcd013”
  plot: "A fearless sea captain sails a ship through loopholes in international…"
  genres: Array
  runtime: 90
  ...
  title: "Vessel"
SCORE: 4.589139938354492  _id:  “573a13e8f29313caabdc9e72”
  countries: Array
  genres: Array
  runtime: 7
  ...
  title: "Boats"
SCORE: 4.3452959060668945  _id:  “573a1398f29313caabce90b6”
  plot: "In 1914, a luxury ship leaves Italy in order to scatter the ashes of a…"
  genres: Array
  runtime: 128
  ...
  title: "And the Ship Sails On"
SCORE: 4.3452959060668945  _id:  “573a139cf29313caabcf7c75”
  plot: "A young Pennsylvania man moves to Los Angeles to begin work for an amb…"
  genres: Array
  runtime: 90
  ...
  title: "Broken Vessels"
SCORE: 4.3452959060668945  _id:   “573a13f0f29313caabdda2dd”
  plot: "A young man struggling with the death of his parents meets an extrover…"
  genres: Array
  runtime: 80
  ...
  title: "Sailing to Paradise"
SCORE: 4.066137313842773  _id:  “573a1392f29313caabcdaae8”
  plot: "An American dancer comes to Britain and falls for a model whom he init…"
  genres: Array
  runtime: 101
  ...
  title: "Top Hat"
SCORE: 4.066137313842773  _id:  “573a1394f29313caabce05e8”
  plot: "A Korean War veteran's morphine addiction wreaks havoc upon his family…"
  genres: Array
  runtime: 109
  ...
  title: "A Hatful of Rain"
SCORE: 3.711261749267578  _id:  “573a1397f29313caabce8796”
  plot: "A Japanese photojournalist revisits Vietnam after the Liberation and l…"
  genres: Array
  runtime: 109
  ...
  title: "Boat People"
SCORE: 3.711261749267578  _id:  “573a13a6f29313caabd17a98”
  plot: "Two straight men mistakenly end up on a "gays only" cruise."
  genres: Array
  runtime: 94
  ...
  title: "Boat Trip"

Os resultados da consulta de pesquisa do Atlas variam de acordo com o tipo de mapeamento de palavras definido na coleção de fontes de sinônimos.

db.movies.aggregate([
  {
    $search: {
      "index": "synonyms-tutorial",
      "text": {
        "path": "title",
        "query": "automobile",
        "synonyms": "transportSynonyms"
      }
    }
  },
  {
    $limit: 10
  },
  {
    $project: {
      "_id": 0,
      "title": 1,
      "score": { $meta: "searchScore" }
    }
  }
])

{ "title" : "Cars", "score" : 4.197734832763672 }
{ "title" : "Planes, Trains & Automobiles", "score" : 3.8511905670166016 }
{ "title" : "Car Wash", "score" : 3.39473032951355 }
{ "title" : "Used Cars", "score" : 3.39473032951355 }
{ "title" : "Blue Car", "score" : 3.39473032951355 }
{ "title" : "Cars 2", "score" : 3.39473032951355 }
{ "title" : "Stealing Cars", "score" : 3.39473032951355 }
{ "title" : "Cop Car", "score" : 3.39473032951355 }
{ "title" : "The Cars That Eat People", "score" : 2.8496146202087402 }
{ "title" : "Khrustalyov, My Car!", "score" : 2.8496146202087402 }

db.movies.aggregate([
  {
    $search: {
      "index": "synonyms-tutorial",
      "text": {
        "path": "title",
        "query": "boat",
        "synonyms": "transportSynonyms"
      }
    }
  },
  {
    $limit: 10
  },
  {
    $project: {
      "_id": 0,
      "title": 1,
      "score": { $meta: "searchScore" }
    }
  }
])

{ "title" : "Vessel", "score" : 5.373150825500488 }
{ "title" : "Boats", "score" : 4.589139938354492 }
{ "title" : "And the Ship Sails On", "score" : 4.3452959060668945 }
{ "title" : "Broken Vessels", "score" : 4.3452959060668945 }
{ "title" : "Sailing to Paradise", "score" : 4.3452959060668945 }
{ "title" : "Boat People", "score" : 3.711261749267578 }
{ "title" : "Boat Trip", "score" : 3.711261749267578 }
{ "title" : "Three Men in a Boat", "score" : 3.1153182983398438 }
{ "title" : "The Glass Bottom Boat", "score" : 3.1153182983398438 }
{ "title" : "Jack Goes Boating", "score" : 3.1153182983398438 }

{ "title" : "Vessel", "score" : 5.373150825500488 }
{ "title" : "Broken Vessels", "score" : 4.3452959060668945 }

{ "title" : "And the Ship Sails On", "score" : 4.3452959060668945 }
{ "title" : "Sailing to Paradise", "score" : 4.3452959060668945 }

Os resultados da consulta de pesquisa do Atlas variam de acordo com o tipo de mapeamento de palavras definido na coleção de fontes de sinônimos.

db.movies.aggregate([
  {
    $search: {
      "index": "synonyms-tutorial",
      "compound": {
        "should": [{
          "text": {
            "path": "title",
            "query": "automobile",
            "synonyms": "transportSynonyms"
          }
        },
        {
          "text": {
            "path": "title",
            "query": "attire",
            "synonyms": "attireSynonyms"
          }
        }]
      }
    }
  },
  {
    $limit: 10
  },
  {
    $project: {
      "_id": 0,
      "title": 1,
      "score": { $meta: "searchScore" }
    }
  }
])

[
  { title: 'The Dress', score: 4.812004089355469 },
  { title: 'Cars', score: 4.197734832763672 },
  { title: 'Dressed to Kill', score: 3.891493320465088 },
  { title: '27 Dresses', score: 3.891493320465088 },
  { title: 'Planes, Trains & Automobiles', score: 3.8511905670166016 },
  { title: 'Car Wash', score: 3.39473032951355 },
  { title: 'Used Cars', score: 3.39473032951355 },
  { title: 'Blue Car', score: 3.39473032951355 },
  { title: 'Cars 2', score: 3.39473032951355 },
  { title: 'Stealing Cars', score: 3.39473032951355 }
]

db.movies.aggregate([
  {
    $search: {
      "index": "synonyms-tutorial",
      "compound": {
        "should": [{
          "text": {
            "path": "title",
            "query": "boat",
            "synonyms": "transportSynonyms"
          }
        },
        {
          "text": {
            "path": "title",
            "query": "hat",
            "synonyms": "attireSynonyms"
          }
        }]
      }
    }
  },
  {
    $limit: 10
  },
  {
    $project: {
      "_id": 0,
      "title": 1,
      "score": { $meta: "searchScore" }
    }
  }
])

[
  { title: 'Fedora', score: 5.673145294189453 },
  { title: 'Vessel', score: 5.373150825500488 },
  { title: 'Boats', score: 4.589139938354492 },
  { title: 'And the Ship Sails On', score: 4.3452959060668945 },
  { title: 'Broken Vessels', score: 4.3452959060668945 },
  { title: 'Sailing to Paradise', score: 4.3452959060668945 },
  { title: 'Top Hat', score: 4.066137313842773 },
  { title: 'A Hatful of Rain', score: 4.066137313842773 },
  { title: 'Boat People', score: 3.711261749267578 },
  { title: 'Boat Trip', score: 3.711261749267578 }
]

A query pesquisa o campo title para a palavra automobile e usa a definição de mapeamento de sinônimos chamada transportSynonyms para pesquisar palavras configuradas como sinônimos da palavra de query automobile na coleção de fontes de sinônimos chamada transport_synonyms. A query inclui os seguintes estágios:

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

• Estágio $project para excluir todos os campos, exceto title e adicionar um campo chamado score.

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": "synonyms-tutorial", "text": { "path": "title", "query": "automobile", "synonyms": "transportSynonyms" } }
   $limit	10
   $project	{ "_id": 0, "title": 1, "score": { "$meta": "searchScore" } }

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

   {title Cars} {score 4.197734832763672}
   {title Planes, Trains & Automobiles} {score 3.8511905670166016}
   {title Car Wash} {score 3.39473032951355}
   {title Used Cars} {score 3.39473032951355}
   {title Blue Car} {score 3.39473032951355}
   {title Cars 2} {score 3.39473032951355}
   {title Stealing Cars} {score 3.39473032951355}
   {title Cop Car} {score 3.39473032951355}
   {title The Cars That Eat People} {score 2.8496146202087402}
   {title Khrustalyov, My Car!} {score 2.8496146202087402}

   Os resultados da Pesquisa do Atlas contêm filmes com car e automobile no campo title embora o termo de consulta seja automobile porque configuramos o automobile para ser um sinônimo de car, vehicle e automobile na coleção de origem sinônimos denominada sample_synonyms, que é especificado no índice da coleção. Atlas Search retorna os mesmos resultados para uma pesquisa das palavras car e vehicle. Para testar isto, substitua o valor do campo query na consulta acima por car ou vehicle e execute a consulta.

A consulta pesquisa o campo title para a palavra boat e usa a definição de mapeamento de sinônimos chamada transportSynonyms para pesquisar palavras configuradas como sinônimos da palavra de consulta boat na coleção de fontes de sinônimos chamada transport_synonyms. Inclui os seguintes estágios:

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

• Estágio $project para excluir todos os campos, exceto title e adicionar um campo chamado score.

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": "synonyms-tutorial", "text": { "path": "title", "query": "boat", "synonyms": "transportSynonyms" } }
   $limit	10
   $project	{ "_id": 0, "title": 1, "score": { "$meta": "searchScore" } }

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

   {title Vessel} {score 5.373150825500488}
   {title Boats} {score 4.589139938354492}
   {title And the Ship Sails On} {score 4.3452959060668945}
   {title Broken Vessels} {score 4.3452959060668945}
   {title Sailing to Paradise} {score 4.3452959060668945}
   {title Boat People} {score 3.711261749267578}
   {title Boat Trip} {score 3.711261749267578}
   {title Three Men in a Boat} {score 3.1153182983398438}
   {title The Glass Bottom Boat} {score 3.1153182983398438}
   {title Jack Goes Boating} {score 3.1153182983398438}

   Os resultados do Atlas Search contêm filmes com boat, vessel, e sail no campo title porque configuramos boat, vessel, e sail como sinônimos de boat nos sinônimos coleção de códigos-fonte chamada sample_synonyms, que é especificada no índice para a coleção.

   O Atlas Search retorna os seguintes documentos apenas para uma pesquisa da palavra vessel nos resultados:

   { "title" : "Vessel", "score" : 5.373150825500488 }
   { "title" : "Broken Vessels", "score" : 4.3452959060668945 }

   O Atlas Search não inclui documentos com boat ou sail no campo title nos resultados porque não configuramos vessel como sinônimo de boat ou sail nos sinônimos coleção de códigos-fonte. Para testar isso, substitua o valor do campo query na consulta acima por vessel e execute a consulta novamente.

   Da mesma forma, o Atlas Search retorna apenas os seguintes documentos nos resultados para uma pesquisa do termo sail:

   { "title" : "And the Ship Sails On", "score" : 4.3452959060668945 }
   { "title" : "Sailing to Paradise", "score" : 4.3452959060668945 }

   O Atlas Search não inclui documentos com boat ou vessel no campo title nos resultados porque não configuramos sail como sinônimo de boat ou vessel na coleção de fonte de sinônimos. Para testar este exemplo, substitua o valor do campo query na query acima por sail e execute a query novamente.

A query pesquisa a palavra automobile no campo title e usa a definição de mapeamento de sinônimos chamada transportSynonyms para pesquisar palavras configuradas como sinônimos da palavra de query automobile na coleção de fontes de sinônimos chamada transport_synonyms. A query também pesquisa no campo title a palavra attire e usa a definição de mapeamento de sinônimos denominada attireSynonyms para pesquisar palavras configuradas como sinônimos da palavra de query attire na coleção de fontes de sinônimos denominada attire_synonyms.

A query inclui os seguintes estágios:

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

• Estágio $project para excluir todos os campos, exceto title e adicionar um campo chamado score.

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": "synonyms-tutorial", "compound": { "should": [{ "text": { "path": "title", "query": "automobile", "synonyms": "transportSynonyms" } }, { "text": { "path": "title", "query": "attire", "synonyms": "attireSynonyms" } }] } }
   $limit	10
   $project	{ "_id": 0, "title": 1, "score": { "$meta": "searchScore" } }

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

   { title: 'The Dress', score: 4.812004089355469 },
   { title: 'Cars', score: 4.197734832763672 },
   { title: 'Dressed to Kill', score: 3.891493320465088 },
   { title: '27 Dresses', score: 3.891493320465088 },
   { title: 'Planes, Trains & Automobiles', score: 3.8511905670166016 },
   { title: 'Car Wash', score: 3.39473032951355 },
   { title: 'Used Cars', score: 3.39473032951355 },
   { title: 'Blue Car', score: 3.39473032951355 },
   { title: 'Cars 2', score: 3.39473032951355 },
   { title: 'Stealing Cars', score: 3.39473032951355 }

   Os resultados da Pesquisa Atlas contêm documentos para ambos os termos de pesquisa. Os resultados contêm filmes com car no campo title para o termo de consulta automobile porque configuramos automobile para ser um sinônimo de car, vehicle e automobile na coleção de origem sinônimos denominada transport_synonyms. O resultado também contém filmes com dress no campo de título para o termo de consulta attire porque configuramos attire para ser um sinônimo de dress, apparel e attire na coleção de origem sinônimos denominada attire_synonyms.

   O Atlas Search retorna os mesmos resultados para uma pesquisa de car ou vehicle na coleção de fontes transport_synonyms e dress ou apparel na coleção de fontes attire_synonyms. Para testar esse exemplo, substitua o valor do campo query na consulta acima por car ou vehicle e substitua o valor do campo query na consulta acima por dress ou apparel e execute a consulta novamente.

A query pesquisa a palavra boat no campo title e usa a definição de mapeamento de sinônimos chamada transportSynonyms para pesquisar palavras configuradas como sinônimos da palavra de query boat na coleção de fontes de sinônimos chamada transport_synonyms. A query também pesquisa no campo title a palavra hat e usa a definição de mapeamento de sinônimos denominada attireSynonyms para pesquisar palavras configuradas como sinônimos da palavra de query hat na coleção de fontes de sinônimos denominada attire_synonyms.

A query inclui os seguintes estágios:

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

• Estágio $project para excluir todos os campos, exceto title e adicionar um campo chamado score.

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": "synonyms-tutorial", "compound": { "should": [{ "text": { "path": "title", "query": "boat", "synonyms": "transportSynonyms" } }, { "text": { "path": "title", "query": "hat", "synonyms": "attireSynonyms" } }] } }
   $limit	10
   $project	{ "_id": 0, "title": 1, "score": { "$meta": "searchScore" } }

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

   { title: 'Fedora', score: 5.673145294189453 },
   { title: 'Vessel', score: 5.373150825500488 },
   { title: 'Boats', score: 4.589139938354492 },
   { title: 'And the Ship Sails On', score: 4. 3452959060668945 },
   { title: 'Broken Vessels', score: 4.3452959060668945 },
   { title: 'Sailing to Paradise', score: 4.3452959060668945 },
   { title: 'Top Hat', score: 4.066137313842773 },
   { title: 'A Hatful of Rain', score: 4.066137313842773 },
   { title: 'Boat People', score: 3.711261749267578 },
   { title: 'Boat Trip', score: 3.711261749267578 }

   Os resultados da Pesquisa Atlas contêm documentos para ambos os termos de pesquisa. Os resultados contêm filmes com vessel, boate sail no campo title para o termo de consulta boat porque configuramos boat para ser sinônimo de boat, vessele sail na coleção de origem de sinônimos chamada transport_synonyms.

   O Atlas Search não inclui documentos com boat ou sail no campo title nos resultados de uma pesquisa do termo vessel porque não configuramos vessel como sinônimo de boat ou sail na coleção de códigos-fonte de sinônimos. Da mesma forma, o Atlas Search não inclui documentos com boat ou vessel no campo title nos resultados para uma pesquisa do termo sail porque não configuramos sail como sinônimo de boat ou vessel na coleção de códigos-fonte de sinônimos. Para testar esses exemplos, substitua o valor do campo query na query acima por vessel ou sail e execute a query novamente.

   O resultado também contém filmes com fedora e hat no campo de título do termo de query hat porque configuramos hat como sinônimo de hat, fedora e headgear na coleção de fontes de sinônimos chamada attire_synonyms.

   O Atlas Search não inclui documentos com hat ou fedora no campo title nos resultados de uma pesquisa do termo headgear porque não configuramos headgear como sinônimo de hat ou fedora na coleção de códigos-fonte de sinônimos. Da mesma forma, o Atlas Search não inclui documentos com hat ou headgear no campo title nos resultados para uma pesquisa do termo fedora porque não configuramos fedora como sinônimo de hat ou headgear na coleção de códigos-fonte de sinônimos. Para testar esses exemplos, substitua o valor do campo query na query acima por fedora ou headgear e execute a query novamente.

1. Crie um arquivo denominado synonyms-equivalent-query.go.

2. Copie e cole o exemplo de código no arquivo synonyms-equivalent-query.go.

   O exemplo de código contém os seguintes estágios:

   • $search estágio para pesquisar no campo title pela palavra automobile e utiliza a definição de mapeamento sinônimo denominada transportSynonyms para procurar por palavras configuradas como sinônimos da palavra de consulta automobile na coleção de origem sinônimos denominada transport_synonyms.

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

   • Estágio $project para excluir todos os campos, exceto title e adicionar um campo chamado score.

   1
   package main
   2
   3
   import (
   4
   	"context"
   5
   	"fmt"
   6
   	"time"
   7
   8
   	"go.mongodb.org/mongo-driver/bson"
   9
   	"go.mongodb.org/mongo-driver/mongo"
   10
   	"go.mongodb.org/mongo-driver/mongo/options"
   11
   )
   12
   13
   // define structure of movies collection
   14
   type MovieCollection struct {
   15
   	title string `bson:"Title,omitempty"`
   16
   }
   17
   18
   func main() {
   19
   	var err error
   20
   	// connect to the Atlas cluster
   21
   	ctx := context.Background()
   22
   	client, err := mongo.Connect(ctx, options.Client().ApplyURI("<connection-string>"))
   23
   	if err != nil {
   24
   		panic(err)
   25
   	}
   26
   	defer client.Disconnect(ctx)
   27
   	// set namespace
   28
   	collection := client.Database("sample_mflix").Collection("movies")
   29
   	// define pipeline
   30
   	searchStage := bson.D{{"$search", bson.D{{"index", "synonyms-tutorial"}, {"text", bson.D{{"path", "title"}, {"query", "automobile"}, {"synonyms", "transportSynonyms"}}}}}}
   31
   	limitStage := bson.D{{"$limit", 10}}
   32
   	projectStage := bson.D{{"$project", bson.D{{"title", 1}, {"_id", 0}, {"score", bson.D{{"$meta", "searchScore"}}}}}}
   33
   	// specify the amount of time the operation can run on the server
   34
   	opts := options.Aggregate().SetMaxTime(5 * time.Second)
   35
   	// run pipeline
   36
   	cursor, err := collection.Aggregate(ctx, mongo.Pipeline{searchStage, limitStage, projectStage}, opts)
   37
   	if err != nil {
   38
   		panic(err)
   39
   	}
   40
   	// print results
   41
   	var results []bson.D
   42
   	if err = cursor.All(context.TODO(), &results); err != nil {
   43
   		panic(err)
   44
   	}
   45
   	for _, result := range results {
   46
   		fmt.Println(result)
   47
   	}
   48
   }

3. Antes de executar o exemplo, substitua <connection-string> por sua cadeia de conexão do Atlas. Certifique-se de que sua cadeia de conexão inclui as credenciais do usuário do banco de dados. Para saber mais, consulte Conectar via Drivers.

4. Execute o seguinte comando para consultar sua collection:

   go run synonyms-equivalent-query.go

   Quando você executa synonyms-equivalent-query.go, o programa imprime os seguintes documentos no seu terminal:

   [{title Cars} {score 4.197734832763672}]
   [{title Planes, Trains & Automobiles} {score 3.8511905670166016}]
   [{title Car Wash} {score 3.39473032951355}]
   [{title Used Cars} {score 3.39473032951355}]
   [{title Blue Car} {score 3.39473032951355}]
   [{title Cars 2} {score 3.39473032951355}]
   [{title Stealing Cars} {score 3.39473032951355}]
   [{title Cop Car} {score 3.39473032951355}]
   [{title The Cars That Eat People} {score 2.8496146202087402}]
   [{title Khrustalyov, My Car!} {score 2.8496146202087402}]

   Os resultados da Pesquisa do Atlas contêm filmes com car e automobile no campo title embora o termo de consulta seja automobile porque configuramos o automobile para ser um sinônimo de car, vehicle e automobile na coleção de origem sinônimos denominada sample_synonyms, que é especificado no índice da coleção. Atlas Search retorna os mesmos resultados para uma pesquisa das palavras car e vehicle. Para testar isto, substitua o valor do campo query na consulta acima por car ou vehicle e execute a consulta.

1. Crie um arquivo denominado synonyms-explicit-query.go.

2. Copie e cole o exemplo de código no arquivo synonyms-explicit-query.go.

   O exemplo de código contém os seguintes estágios:

   • $search estágio para pesquisar no campo title pela palavra boat e utiliza a definição de mapeamento sinônimo denominada transportSynonyms para procurar por palavras configuradas como sinônimos da palavra de consulta boat na coleção de origem sinônimos denominada transport_synonyms.

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

   • Estágio $project para excluir todos os campos, exceto title e adicionar um campo chamado score.

   1
   package main
   2
   3
   import (
   4
   	"context"
   5
   	"fmt"
   6
   	"time"
   7
   8
   	"go.mongodb.org/mongo-driver/bson"
   9
   	"go.mongodb.org/mongo-driver/mongo"
   10
   	"go.mongodb.org/mongo-driver/mongo/options"
   11
   )
   12
   13
   // define structure of movies collection
   14
   type MovieCollection struct {
   15
   	title string `bson:"Title,omitempty"`
   16
   }
   17
   18
   func main() {
   19
   	var err error
   20
   	// connect to the Atlas cluster
   21
   	ctx := context.Background()
   22
   	client, err := mongo.Connect(ctx, options.Client().ApplyURI("<connection-string>"))
   23
   	if err != nil {
   24
   		panic(err)
   25
   	}
   26
   	defer client.Disconnect(ctx)
   27
   	// set namespace
   28
   	collection := client.Database("sample_mflix").Collection("movies")
   29
   	// define pipeline
   30
   	searchStage := bson.D{{"$search", bson.D{{"text", bson.D{{"index", "synonyms-tutorial"}, {"path", "title"}, {"query", "boat"}, {"synonyms", "transportSynonyms"}}}}}}
   31
   	limitStage := bson.D{{"$limit", 10}}
   32
   	projectStage := bson.D{{"$project", bson.D{{"title", 1}, {"_id", 0}, {"score", bson.D{{"$meta", "searchScore"}}}}}}
   33
   	// specify the amount of time the operation can run on the server
   34
   	opts := options.Aggregate().SetMaxTime(5 * time.Second)
   35
   	// run pipeline
   36
   	cursor, err := collection.Aggregate(ctx, mongo.Pipeline{searchStage, limitStage, projectStage}, opts)
   37
   	if err != nil {
   38
   		panic(err)
   39
   	}
   40
   	// print results
   41
   	var results []bson.D
   42
   	if err = cursor.All(context.TODO(), &results); err != nil {
   43
   		panic(err)
   44
   	}
   45
   	for _, result := range results {
   46
   		fmt.Println(result)
   47
   	}
   48
   }

3. Antes de executar o exemplo, substitua <connection-string> por sua cadeia de conexão do Atlas. Certifique-se de que sua cadeia de conexão inclui as credenciais do usuário do banco de dados. Para saber mais, consulte Conectar via Drivers.

4. Execute o seguinte comando para consultar sua collection:

   go run synonyms-explicit-query.go

   OCULTAR SAÍDA

   [{title Vessel} {score 5.373150825500488}]
   [{title Boats} {score 4.589139938354492}]
   [{title And the Ship Sails On} {score 4.3452959060668945}]
   [{title Broken Vessels} {score 4.3452959060668945}]
   [{title Sailing to Paradise} {score 4.3452959060668945}]
   [{title Boat People} {score 3.711261749267578}]
   [{title Boat Trip} {score 3.711261749267578}]
   [{title Three Men in a Boat} {score 3.1153182983398438}]
   [{title The Glass Bottom Boat} {score 3.1153182983398438}]
   [{title Jack Goes Boating} {score 3.1153182983398438}]

   Os resultados do Atlas Search contêm filmes com boat, vessel, e sail no campo title porque configuramos boat, vessel, e sail como sinônimos de boat nos sinônimos coleção de códigos-fonte chamada sample_synonyms, que é especificada no índice para a coleção.

   O Atlas Search retorna os seguintes documentos apenas para uma pesquisa da palavra vessel nos resultados:

   { "title" : "Vessel", "score" : 5.373150825500488 }
   { "title" : "Broken Vessels", "score" : 4.3452959060668945 }

   O Atlas Search não inclui documentos com boat ou sail no campo title nos resultados porque não configuramos vessel como sinônimo de boat ou sail nos sinônimos coleção de códigos-fonte. Para testar isso, substitua o valor do campo query na consulta acima por vessel e execute a consulta novamente.

   Da mesma forma, o Atlas Search retorna apenas os seguintes documentos nos resultados para uma pesquisa do termo sail:

   { "title" : "And the Ship Sails On", "score" : 4.3452959060668945 }
   { "title" : "Sailing to Paradise", "score" : 4.3452959060668945 }

   O Atlas Search não inclui documentos com boat ou vessel no campo title nos resultados porque não configuramos sail como sinônimo de boat ou vessel na coleção de fonte de sinônimos. Para testar este exemplo, substitua o valor do campo query na query acima por sail e execute a query novamente.

1. Crie um arquivo denominado synonyms-equivalent-query.go.

2. Copie e cole o exemplo de código no arquivo synonyms-equivalent-query.go.

   O exemplo de código contém os seguintes estágios:

   • $search para pesquisar no campo title a palavra automobile e usa a definição de mapeamento de sinônimos denominada transportSynonyms para pesquisar palavras configuradas como sinônimos da palavra de consulta automobile na coleção de fontes de sinônimos denominada transport_synonyms. A consulta também pesquisa no campo title a palavra attire e usa a definição de mapeamento de sinônimos denominada attireSynonyms para pesquisar palavras configuradas como sinônimos da palavra de consulta attire na coleção de fontes de sinônimos denominada attire_synonyms.

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

   • Estágio $project para excluir todos os campos, exceto title e adicionar um campo chamado score.

   1
   package main
   2
   3
   import (
   4
   	"context"
   5
   	"fmt"
   6
   	"time"
   7
   8
   	"go.mongodb.org/mongo-driver/bson"
   9
   	"go.mongodb.org/mongo-driver/mongo"
   10
   	"go.mongodb.org/mongo-driver/mongo/options"
   11
   )
   12
   13
   // define structure of movies collection
   14
   type MovieCollection struct {
   15
   	title string `bson:"Title,omitempty"`
   16
   }
   17
   18
   func main() {
   19
   	var err error
   20
   	// connect to the Atlas cluster
   21
   	ctx := context.Background()
   22
   	client, err := mongo.Connect(ctx, options.Client().ApplyURI("<connection-string>"))
   23
   	if err != nil {
   24
   		panic(err)
   25
   	}
   26
   	defer client.Disconnect(ctx)
   27
   	// set namespace
   28
   	collection := client.Database("sample_mflix").Collection("movies")
   29
   	// define pipeline
   30
   	searchStage := bson.D{{"$search", bson.M{
   31
   		"index": "synonyms-tutorial",
   32
   		"compound": bson.M{
   33
   			"should": bson.A{
   34
   				bson.M{
   35
   					"text": bson.D{
   36
   						{"path", "title"}, {"query", "automobile"}, {"synonyms", "transportSynonyms"},
   37
   					},
   38
   				},
   39
   				bson.M{
   40
   					"text": bson.D{
   41
   						{"path", "title"}, {"query", "attire"}, {"synonyms", "attireSynonyms"},
   42
   					},
   43
   				},
   44
   			},
   45
   		},
   46
   	}}}
   47
   	limitStage := bson.D{{"$limit", 10}}
   48
   	projectStage := bson.D{{"$project", bson.D{{"title", 1}, {"_id", 0}, {"score", bson.D{{"$meta", "searchScore"}}}}}}
   49
   	// specify the amount of time the operation can run on the server
   50
   	opts := options.Aggregate().SetMaxTime(5 * time.Second)
   51
   	// run pipeline
   52
   	cursor, err := collection.Aggregate(ctx, mongo.Pipeline{searchStage, limitStage, projectStage}, opts)
   53
   	if err != nil {
   54
   		panic(err)
   55
   	}
   56
   	// print results
   57
   	var results []bson.D
   58
   	if err = cursor.All(context.TODO(), &results); err != nil {
   59
   		panic(err)
   60
   	}
   61
   	for _, result := range results {
   62
   		fmt.Println(result)
   63
   	}
   64
   }

3. Antes de executar o exemplo, substitua <connection-string> por sua cadeia de conexão do Atlas. Certifique-se de que sua cadeia de conexão inclui as credenciais do usuário do banco de dados. Para saber mais, consulte Conectar via Drivers.

4. Execute o seguinte comando para consultar sua collection:

   go run synonyms-equivalent-query.go

   OCULTAR SAÍDA

   [{title The Dress} {score 4.812004089355469}]
   [{title Cars} {score 4.197734832763672}]
   [{title Dressed to Kill} {score 3.891493320465088}]
   [{title 27 Dresses} {score 3.891493320465088}]
   [{title Planes, Trains & Automobiles} {score 3.8511905670166016}]
   [{title Car Wash} {score 3.39473032951355}]
   [{title Used Cars} {score 3.39473032951355}]
   [{title Blue Car} {score 3.39473032951355}]
   [{title Cars 2} {score 3.39473032951355}]
   [{title Stealing Cars} {score 3.39473032951355}]

   Os resultados da Pesquisa Atlas contêm documentos para ambos os termos de pesquisa. Os resultados contêm filmes com car no campo title para o termo de consulta automobile porque configuramos automobile para ser um sinônimo de car, vehicle e automobile na coleção de origem sinônimos denominada transport_synonyms. O resultado também contém filmes com dress no campo de título para o termo de consulta attire porque configuramos attire para ser um sinônimo de dress, apparel e attire na coleção de origem sinônimos denominada attire_synonyms.

   O Atlas Search retorna os mesmos resultados para uma pesquisa de car ou vehicle na coleção de fontes transport_synonyms e dress ou apparel na coleção de fontes attire_synonyms. Para testar esse exemplo, substitua o valor do campo query na consulta acima por car ou vehicle e substitua o valor do campo query na consulta acima por dress ou apparel e execute a consulta novamente.

1. Crie um arquivo denominado synonyms-explicit-query.go.

2. Copie e cole o exemplo de código no arquivo synonyms-explicit-query.go.

   O exemplo de código contém os seguintes estágios:

   • $search para pesquisar no campo title a palavra boat e usa a definição de mapeamento de sinônimos denominada transportSynonyms para pesquisar palavras configuradas como sinônimos da palavra de consulta boat na coleção de fontes de sinônimos denominada transport_synonyms. A consulta também pesquisa no campo title a palavra hat e usa a definição de mapeamento de sinônimos denominada attireSynonyms para pesquisar palavras configuradas como sinônimos da palavra de consulta hat na coleção de fontes de sinônimos denominada attire_synonyms.

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

   • Estágio $project para excluir todos os campos, exceto title e adicionar um campo chamado score.

   1
   package main
   2
   3
   import (
   4
   	"context"
   5
   	"fmt"
   6
   	"time"
   7
   8
   	"go.mongodb.org/mongo-driver/bson"
   9
   	"go.mongodb.org/mongo-driver/mongo"
   10
   	"go.mongodb.org/mongo-driver/mongo/options"
   11
   )
   12
   13
   // define structure of movies collection
   14
   type MovieCollection struct {
   15
   	title string `bson:"Title,omitempty"`
   16
   }
   17
   18
   func main() {
   19
   	var err error
   20
   	// connect to the Atlas cluster
   21
   	ctx := context.Background()
   22
   	client, err := mongo.Connect(ctx, options.Client().ApplyURI("<connection-string>"))
   23
   	if err != nil {
   24
   		panic(err)
   25
   	}
   26
   	defer client.Disconnect(ctx)
   27
   	// set namespace
   28
   	collection := client.Database("sample_mflix").Collection("movies")
   29
   	// define pipeline
   30
   	searchStage := bson.D{{"$search", bson.M{
   31
   		"index": "synonyms-tutorial",
   32
   		"compound": bson.M{
   33
   			"must": bson.A{
   34
   				bson.M{
   35
   					"text": bson.D{
   36
   						{"path", "title"}, {"query", "boat"}, {"synonyms", "transportSynonyms"},
   37
   					},
   38
   				},
   39
   				bson.M{
   40
   					"text": bson.D{
   41
   						{"path", "title"}, {"query", "hat"}, {"synonyms", "attireSynonyms"},
   42
   					},
   43
   				},
   44
   			},
   45
   		},
   46
   	}}}
   47
   	limitStage := bson.D{{"$limit", 10}}
   48
   	projectStage := bson.D{{"$project", bson.D{{"title", 1}, {"_id", 0}, {"score", bson.D{{"$meta", "searchScore"}}}}}}
   49
   	// specify the amount of time the operation can run on the server
   50
   	opts := options.Aggregate().SetMaxTime(5 * time.Second)
   51
   	// run pipeline
   52
   	cursor, err := collection.Aggregate(ctx, mongo.Pipeline{searchStage, limitStage, projectStage}, opts)
   53
   	if err != nil {
   54
   		panic(err)
   55
   	}
   56
   	// print results
   57
   	var results []bson.D
   58
   	if err = cursor.All(context.TODO(), &results); err != nil {
   59
   		panic(err)
   60
   	}
   61
   	for _, result := range results {
   62
   		fmt.Println(result)
   63
   	}
   64
   }

3. Antes de executar o exemplo, substitua <connection-string> por sua cadeia de conexão do Atlas. Certifique-se de que sua cadeia de conexão inclui as credenciais do usuário do banco de dados. Para saber mais, consulte Conectar via Drivers.

4. Execute o seguinte comando para consultar sua collection:

   go run synonyms-explicit-query.go

   OCULTAR SAÍDA

   [{title Fedora} {score 5.673145294189453}]
   [{title Vessel} {score 5.373150825500488}]
   [{title Boats} {score 4.589139938354492}]
   [{title And the Ship Sails On} {score 4.3452959060668945}]
   [{title Broken Vessels} {score 4.3452959060668945}]
   [{title Sailing to Paradise} {score 4.3452959060668945}]
   [{title Top Hat} {score 4.066137313842773}]
   [{title A Hatful of Rain} {score 4.066137313842773}]
   [{title Boat People} {score 3.711261749267578}]
   [{title Boat Trip} {score 3.711261749267578}]

   Os resultados da Pesquisa Atlas contêm documentos para ambos os termos de pesquisa. Os resultados contêm filmes com vessel, boate sail no campo title para o termo de consulta boat porque configuramos boat para ser sinônimo de boat, vessele sail na coleção de origem de sinônimos chamada transport_synonyms.

   O Atlas Search não inclui documentos com boat ou sail no campo title nos resultados de uma pesquisa do termo vessel porque não configuramos vessel como sinônimo de boat ou sail na coleção de códigos-fonte de sinônimos. Da mesma forma, o Atlas Search não inclui documentos com boat ou vessel no campo title nos resultados para uma pesquisa do termo sail porque não configuramos sail como sinônimo de boat ou vessel na coleção de códigos-fonte de sinônimos. Para testar esses exemplos, substitua o valor do campo query na query acima por vessel ou sail e execute a query novamente.

   O resultado também contém filmes com fedora e hat no campo de título do termo de query hat porque configuramos hat como sinônimo de hat, fedora e headgear na coleção de fontes de sinônimos chamada attire_synonyms.

   O Atlas Search não inclui documentos com hat ou fedora no campo title nos resultados de uma pesquisa do termo headgear porque não configuramos headgear como sinônimo de hat ou fedora na coleção de códigos-fonte de sinônimos. Da mesma forma, o Atlas Search não inclui documentos com hat ou headgear no campo title nos resultados para uma pesquisa do termo fedora porque não configuramos fedora como sinônimo de hat ou headgear na coleção de códigos-fonte de sinônimos. Para testar esses exemplos, substitua o valor do campo query na query acima por fedora ou headgear e execute a query novamente.

1. Crie um arquivo denominado SynonymsEquivalentQuery.java.

2. Copie e cole o seguinte código no arquivo.

   O exemplo de código contém os seguintes estágios:

   • $search estágio para pesquisar no campo title pela palavra automobile e utiliza a definição de mapeamento sinônimo denominada transportSynonyms para procurar por palavras configuradas como sinônimos da palavra de consulta automobile na coleção de origem sinônimos denominada transport_synonyms.

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

   • Estágio $project para excluir todos os campos, exceto title e adicionar um campo chamado score.

   1
   import java.util.Arrays;
   2
   import static com.mongodb.client.model.Filters.eq;
   3
   import static com.mongodb.client.model.Aggregates.limit;
   4
   import static com.mongodb.client.model.Aggregates.project;
   5
   import static com.mongodb.client.model.Projections.excludeId;
   6
   import static com.mongodb.client.model.Projections.fields;
   7
   import static com.mongodb.client.model.Projections.include;
   8
   import static com.mongodb.client.model.Projections.computed;
   9
   import com.mongodb.client.MongoClient;
   10
   import com.mongodb.client.MongoClients;
   11
   import com.mongodb.client.MongoCollection;
   12
   import com.mongodb.client.MongoDatabase;
   13
   import org.bson.Document;
   14
   15
   public class SynonymsEquivalentQuery {
   16
     public static void main( String[] args ) {
   17
       // define query
   18
       Document agg = new Document("$search",
   19
           new Document("index", "synonyms-tutorial")
   20
           .append("text", 
   21
               new Document("query", "automobile")
   22
               .append("path","title")
   23
               .append("synonyms", "transportSynonyms")));
   24
   25
       // specify connection
   26
       String uri = "<connection-string>";
   27
   28
       // establish connection and set namespace
   29
       try (MongoClient mongoClient = MongoClients.create(uri)) {
   30
         MongoDatabase database = mongoClient.getDatabase("sample_mflix");
   31
         MongoCollection<Document> collection = database.getCollection("movies");
   32
         
   33
   			// run query and print results
   34
         collection.aggregate(Arrays.asList(agg, 
   35
           limit(10), 
   36
           project(fields(excludeId(), include("title"), computed("score", new Document("$meta", "searchScore")))))
   37
         ).forEach(doc -> System.out.println(doc.toJson()));	
   38
       }
   39
     }
   40
   }

   Observação

   Para executar o código de exemplo em seu ambiente Maven, adicione o seguinte acima das declarações de importação no seu arquivo:

   package com.mongodb.drivers;

3. Antes de executar o exemplo, substitua <connection-string> por sua cadeia de conexão do Atlas. Certifique-se de que sua cadeia de conexão inclui as credenciais do usuário do banco de dados. Para saber mais, consulte Conectar via Drivers.

4. Compile e execute o arquivo SynonymsEquivalentQuery.java.

   javac SynonymsEquivalentQuery.java
   java SynonymsEquivalentQuery

   OCULTAR SAÍDA

   {"title": "Cars", "score": 4.197734832763672}
   {"title": "Planes, Trains & Automobiles", "score": 3.8511905670166016}
   {"title": "Car Wash", "score": 3.39473032951355}
   {"title": "Used Cars", "score": 3.39473032951355}
   {"title": "Blue Car", "score": 3.39473032951355}
   {"title": "Cars 2", "score": 3.39473032951355}
   {"title": "Stealing Cars", "score": 3.39473032951355}
   {"title": "Cop Car", "score": 3.39473032951355}
   {"title": "The Cars That Eat People", "score": 2.8496146202087402}
   {"title": "Khrustalyov, My Car!", "score": 2.8496146202087402}

   Os resultados da Pesquisa do Atlas contêm filmes com car e automobile no campo title embora o termo de consulta seja automobile porque configuramos o automobile para ser um sinônimo de car, vehicle e automobile na coleção de origem sinônimos denominada sample_synonyms, que é especificado no índice da coleção. Atlas Search retorna os mesmos resultados para uma pesquisa das palavras car e vehicle. Para testar isto, substitua o valor do campo query na consulta acima por car ou vehicle e execute a consulta.

1. Crie um arquivo denominado SynonymsExplicitQuery.java.

2. Copie e cole o seguinte código no arquivo.

   O exemplo de código contém os seguintes estágios:

   • $search estágio para pesquisar no campo title pela palavra boat e utiliza a definição de mapeamento sinônimo denominada transportSynonyms para procurar por palavras configuradas como sinônimos da palavra de consulta boat na coleção de origem sinônimos denominada transport_synonyms.

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

   • Estágio $project para excluir todos os campos, exceto title e adicionar um campo chamado score.

   1
   import java.util.Arrays;
   2
   import static com.mongodb.client.model.Filters.eq;
   3
   import static com.mongodb.client.model.Aggregates.limit;
   4
   import static com.mongodb.client.model.Aggregates.project;
   5
   import static com.mongodb.client.model.Projections.excludeId;
   6
   import static com.mongodb.client.model.Projections.fields;
   7
   import static com.mongodb.client.model.Projections.include;
   8
   import static com.mongodb.client.model.Projections.computed;
   9
   import com.mongodb.client.MongoClient;
   10
   import com.mongodb.client.MongoClients;
   11
   import com.mongodb.client.MongoCollection;
   12
   import com.mongodb.client.MongoDatabase;
   13
   import org.bson.Document;
   14
   15
   public class SynonymsExplicitQuery {
   16
     public static void main( String[] args ) {
   17
       // define query
   18
       Document agg = new Document("$search",
   19
           new Document("index", "synonyms-tutorial")
   20
           .append("text", 
   21
               new Document("query", "boat")
   22
               .append("path","title")
   23
               .append("synonyms", "transportSynonyms")));
   24
   25
       // specify connection
   26
       String uri = "<connection-string>";
   27
   28
       // establish connection and set namespace
   29
       try (MongoClient mongoClient = MongoClients.create(uri)) {
   30
         MongoDatabase database = mongoClient.getDatabase("sample_mflix");
   31
         MongoCollection<Document> collection = database.getCollection("movies");
   32
   			
   33
         // run query and print results
   34
         collection.aggregate(Arrays.asList(agg, 
   35
           limit(10), 
   36
           project(fields(excludeId(), include("title"), computed("score", new Document("$meta", "searchScore")))))
   37
         ).forEach(doc -> System.out.println(doc.toJson()));	
   38
       }
   39
     }
   40
   }

   Observação

   Para executar o código de exemplo em seu ambiente Maven, adicione o seguinte acima das declarações de importação no seu arquivo:

   package com.mongodb.drivers;

3. Antes de executar o exemplo, substitua <connection-string> por sua cadeia de conexão do Atlas. Certifique-se de que sua cadeia de conexão inclui as credenciais do usuário do banco de dados. Para saber mais, consulte Conectar via Drivers.

4. Compile e execute o arquivo SynonymsExplicitQuery.java.

   javac SynonymsExplicitQuery.java
   java SynonymsExplicitQuery

   OCULTAR SAÍDA

   {"title": "Vessel", "score": 5.373150825500488}
   {"title": "Boats", "score": 4.589139938354492}
   {"title": "And the Ship Sails On", "score": 4.3452959060668945}
   {"title": "Broken Vessels", "score": 4.3452959060668945}
   {"title": "Sailing to Paradise", "score": 4.3452959060668945}
   {"title": "Boat People", "score": 3.711261749267578}
   {"title": "Boat Trip", "score": 3.711261749267578}
   {"title": "Three Men in a Boat", "score": 3.1153182983398438}
   {"title": "The Glass Bottom Boat", "score": 3.1153182983398438}
   {"title": "Jack Goes Boating", "score": 3.1153182983398438}

   Os resultados do Atlas Search contêm filmes com boat, vessel, e sail no campo title porque configuramos boat, vessel, e sail como sinônimos de boat nos sinônimos coleção de códigos-fonte chamada sample_synonyms, que é especificada no índice para a coleção.

   O Atlas Search retorna os seguintes documentos apenas para uma pesquisa da palavra vessel nos resultados:

   { "title" : "Vessel", "score" : 5.373150825500488 }
   { "title" : "Broken Vessels", "score" : 4.3452959060668945 }

   O Atlas Search não inclui documentos com boat ou sail no campo title nos resultados porque não configuramos vessel como sinônimo de boat ou sail nos sinônimos coleção de códigos-fonte. Para testar isso, substitua o valor do campo query na consulta acima por vessel e execute a consulta novamente.

   Da mesma forma, o Atlas Search retorna apenas os seguintes documentos nos resultados para uma pesquisa do termo sail:

   { "title" : "And the Ship Sails On", "score" : 4.3452959060668945 }
   { "title" : "Sailing to Paradise", "score" : 4.3452959060668945 }

   O Atlas Search não inclui documentos com boat ou vessel no campo title nos resultados porque não configuramos sail como sinônimo de boat ou vessel na coleção de fonte de sinônimos. Para testar este exemplo, substitua o valor do campo query na query acima por sail e execute a query novamente.

1. Crie um arquivo denominado SynonymsEquivalentQuery.java.

2. Copie e cole o seguinte código no arquivo.

   O exemplo de código contém os seguintes estágios:

   • $search para pesquisar no campo title a palavra automobile e usa a definição de mapeamento de sinônimos denominada transportSynonyms para pesquisar palavras configuradas como sinônimos da palavra de consulta automobile na coleção de fontes de sinônimos denominada transport_synonyms. A consulta também pesquisa no campo title a palavra attire e usa a definição de mapeamento de sinônimos denominada attireSynonyms para pesquisar palavras configuradas como sinônimos da palavra de consulta attire na coleção de fontes de sinônimos denominada attire_synonyms.

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

   • Estágio $project para excluir todos os campos, exceto title e adicionar um campo chamado score.

   1
   import java.util.Arrays;
   2
   import static com.mongodb.client.model.Filters.eq;
   3
   import static com.mongodb.client.model.Aggregates.limit;
   4
   import static com.mongodb.client.model.Aggregates.project;
   5
   import static com.mongodb.client.model.Projections.computed;
   6
   import static com.mongodb.client.model.Projections.excludeId;
   7
   import static com.mongodb.client.model.Projections.fields;
   8
   import static com.mongodb.client.model.Projections.include;
   9
   import com.mongodb.client.MongoClient;
   10
   import com.mongodb.client.MongoClients;
   11
   import com.mongodb.client.MongoCollection;
   12
   import com.mongodb.client.MongoDatabase;
   13
   import org.bson.Document;
   14
   15
   public class SynonymsEquivalentQuery {
   16
   	public static void main( String[] args ) {
   17
   		Document agg = new Document("$search",
   18
   			new Document("index", "synonyms-tutorial")
   19
   			.append("compound", 
   20
   				new Document("should", Arrays.asList(new Document("text", 
   21
                   	new Document("path", "title")
   22
                   	.append("query", "automobile")
   23
                   	.append("synonyms", "transportSynonyms")), 
   24
   			new Document("text", 
   25
   				new Document("path", "title")
   26
   				.append("query", "attire")
   27
                   .append("synonyms", "attireSynonyms"))))));
   28
   		
   29
   		String uri = "<connection-string>";
   30
   31
   		try (MongoClient mongoClient = MongoClients.create(uri)) {
   32
   			MongoDatabase database = mongoClient.getDatabase("sample_mflix");
   33
   			MongoCollection<Document> collection = database.getCollection("movies");
   34
   					
   35
   			collection.aggregate(Arrays.asList(agg, 
   36
   					limit(10), 
   37
   					project(fields(excludeId(), include("title"), computed("score", new Document("$meta", "searchScore")))))
   38
   			).forEach(doc -> System.out.println(doc.toJson()));	
   39
   		}
   40
   	}
   41
   }

   Observação

   Para executar o código de exemplo em seu ambiente Maven, adicione o seguinte acima das declarações de importação no seu arquivo:

   package com.mongodb.drivers;

3. Antes de executar o exemplo, substitua <connection-string> por sua cadeia de conexão do Atlas. Certifique-se de que sua cadeia de conexão inclui as credenciais do usuário do banco de dados. Para saber mais, consulte Conectar via Drivers.

4. Compile e execute o arquivo SynonymsEquivalentQuery.java.

   javac SynonymsEquivalentQuery.java
   java SynonymsEquivalentQuery

   OCULTAR SAÍDA

   {"title": "The Dress", "score": 4.812004089355469}
   {"title": "Cars", "score": 4.197734832763672}
   {"title": "Dressed to Kill", "score": 3.891493320465088}
   {"title": "27 Dresses", "score": 3.891493320465088}
   {"title": "Planes, Trains & Automobiles", "score": 3.8511905670166016}
   {"title": "Car Wash", "score": 3.39473032951355}
   {"title": "Used Cars", "score": 3.39473032951355}
   {"title": "Blue Car", "score": 3.39473032951355}
   {"title": "Cars 2", "score": 3.39473032951355}
   {"title": "Stealing Cars", "score": 3.39473032951355}

   Os resultados da Pesquisa Atlas contêm documentos para ambos os termos de pesquisa. Os resultados contêm filmes com car no campo title para o termo de consulta automobile porque configuramos automobile para ser um sinônimo de car, vehicle e automobile na coleção de origem sinônimos denominada transport_synonyms. O resultado também contém filmes com dress no campo de título para o termo de consulta attire porque configuramos attire para ser um sinônimo de dress, apparel e attire na coleção de origem sinônimos denominada attire_synonyms.

   O Atlas Search retorna os mesmos resultados para uma pesquisa de car ou vehicle na coleção de fontes transport_synonyms e dress ou apparel na coleção de fontes attire_synonyms. Para testar esse exemplo, substitua o valor do campo query na consulta acima por car ou vehicle e substitua o valor do campo query na consulta acima por dress ou apparel e execute a consulta novamente.