如何在 Atlas Search 中使用同义词

1. 在侧边栏中，单击 Services 标题下的 Atlas Search。

2. 从 Select data source 下拉菜单中选择您的集群并单击 Go to Atlas Search。

   将显示 Atlas Search 页面。

1. 单击集群的对应 Browse Collections 按钮。

2. 展开数据库并选择集合。

3. 单击该集合的 Search Indexes 标签页。

   将显示 Atlas Search 页面。

1. 单击集群的名称。

2. 单击 Atlas Search 标签页。

   将显示 Atlas Search 页面。

Atlas Search 查询结果根据同义词源集合中定义的单词映射类型而有所不同。

[
  {
    $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 }

Atlas Search 查询结果根据同义词源集合中定义的单词映射类型而有所不同。

[
  {
    $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"

Atlas Search 查询结果根据同义词源集合中定义的单词映射类型而有所不同。

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 }

Atlas Search 查询结果根据同义词源集合中定义的单词映射类型而有所不同。

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 }
]

该查询还会在 title 字段中搜索单词 automobile，并使用名为 transportSynonyms 的同义词映射定义在名为 transport_synonyms 的同义词源集合中搜索配置为查询单词 automobile 同义词的单词。查询包括以下阶段：

• $limit 阶段将输出限制为 10 个结果。

• $project 阶段排除 title 之外的所有字段，并添加一个名为 score 的字段。

若要在 MongoDB Compass 中运行此查询：

1. 单击 Aggregations 标签页。

2. 单击 Select...，然后从下拉菜单中选择阶段并为该阶段添加查询，以配置以下每个管道阶段。单击 Add Stage 以添加其他阶段。

   管道阶段	查询
   $search	{ "index": "synonyms-tutorial", "text": { "path": "title", "query": "automobile", "synonyms": "transportSynonyms" } }
   $limit	10
   $project	{ "_id": 0, "title": 1, "score": { "$meta": "searchScore" } }

   如果已启用 Auto Preview，则 MongoDB Compass 将在 $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}

   Atlas Search 结果包含在 title 字段中带有 car 和 automobile 的电影，尽管查询术语是 automobile，因为我们在名为 sample_synonyms 的同义词来源集合中将 automobile 配置为 car、vehicle 和 automobile 的同义词，该集合在索引中指定。Atlas Search 对于单词 car 和 vehicle 的搜索返回相同的结果。要对此进行测试，将上面查询中的 query 字段的值替换为 car 或 vehicle，然后运行查询。

该查询还会在 title 字段中搜索单词 boat，并使用名为 transportSynonyms 的同义词映射定义在名为 transport_synonyms 的同义词源集合中搜索配置为查询单词 boat 同义词的单词。它包括以下阶段：

• $limit 阶段将输出限制为 10 个结果。

• $project 阶段排除 title 之外的所有字段，并添加一个名为 score 的字段。

若要在 MongoDB Compass 中运行此查询：

1. 单击 Aggregations 标签页。

2. 单击 Select...，然后从下拉菜单中选择阶段并为该阶段添加查询，以配置以下每个管道阶段。单击 Add Stage 以添加其他阶段。

   管道阶段	查询
   $search	{ "index": "synonyms-tutorial", "text": { "path": "title", "query": "boat", "synonyms": "transportSynonyms" } }
   $limit	10
   $project	{ "_id": 0, "title": 1, "score": { "$meta": "searchScore" } }

   如果已启用 Auto Preview，则 MongoDB Compass 将在 $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}

   Atlas Search 搜索结果包含 title 字段中具有 boat、 vessel 和 sail 的电影，因为我们在名为 sample_synonyms 的同义词源集合中将 boat、 vessel 和 sail 配置为boat 的同义词，该集合在集合的索引中指定。

   Atlas Search 仅在结果中搜索单词 vessel 时返回以下文档

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

   Atlas Search 不包括结果中 title 字段中带有 boat 或 sail 的文档，因为我们没有将 vessel 配置为同义词源集合中 boat 或 sail 的同义词。要对此进行测试，将上面查询中的 query 字段的值替换为 vessel，然后再次运行查询。

   同样，Atlas Search 仅在搜索词 sail 的结果中返回以下文档：

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

   Atlas Search 不包括结果中 title 字段中带有 boat 或 vessel 的文档，因为我们没有将 sail 配置为同义词源集合中 boat 或 vessel 的同义词。要测试此示例，请将上述查询中 query 字段的值替换为 sail，然后再次运行查询。

该查询还会在 title 字段中搜索单词 automobile，并使用名为 transportSynonyms 的同义词映射定义在名为 transport_synonyms 的同义词源集合中搜索配置为查询单词 automobile 的同义词的单词。该查询还会在 title 字段中搜索单词 attire，并使用名为 attireSynonyms 的同义词映射定义在名为 attire_synonyms 的同义词源集合中搜索配置为查询单词 attire 的同义词的单词。

查询包括以下阶段：

• $limit 阶段将输出限制为 10 个结果。

• $project 阶段排除 title 之外的所有字段，并添加一个名为 score 的字段。

若要在 MongoDB Compass 中运行此查询：

1. 单击 Aggregations 标签页。

2. 单击 Select...，然后从下拉菜单中选择阶段并为该阶段添加查询，以配置以下每个管道阶段。单击 Add Stage 以添加其他阶段。

   管道阶段	查询
   $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" } }

   如果已启用 Auto Preview，则 MongoDB Compass 将在 $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 }

   Atlas Search 结果包含两个搜索术语的文档。结果包含查询术语 automobile 的 title 字段中带有 car 的电影，因为我们将 automobile 配置为名为car、vehicle 和 automobile 的同义词源集合中的同义词 transport_synonyms。结果还包含查询术语 attire 的标题字段中带有 dress 的电影，因为我们将 attire 配置为名为 attire_synonyms 的同义词源集合中的dress、apparel 和 attire 的同义词。

   Atlas Search 在 transport_synonyms 源集合中搜索 car 或 vehicle 以及在 attire_synonyms 源集合中搜索 dress 或 apparel 会返回相同的结果。要测试此示例，将上述查询中 query 字段的值替换为 car 或 vehicle，并将上述查询中 query 字段的值替换为 dress 或 apparel，然后再次运行查询。

该查询还会在 title 字段中搜索单词 boat，并使用名为 transportSynonyms 的同义词映射定义在名为 transport_synonyms 的同义词源集合中搜索配置为查询单词 boat 的同义词的单词。该查询还会在 title 字段中搜索单词 hat，并使用名为 attireSynonyms 的同义词映射定义在名为 attire_synonyms 的同义词源集合中搜索配置为查询单词 hat 的同义词的单词。

查询包括以下阶段：

• $limit 阶段将输出限制为 10 个结果。

• $project 阶段排除 title 之外的所有字段，并添加一个名为 score 的字段。

若要在 MongoDB Compass 中运行此查询：

1. 单击 Aggregations 标签页。

2. 单击 Select...，然后从下拉菜单中选择阶段并为该阶段添加查询，以配置以下每个管道阶段。单击 Add Stage 以添加其他阶段。

   管道阶段	查询
   $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" } }

   如果已启用 Auto Preview，则 MongoDB Compass 将在 $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 }

   Atlas Search 结果包含两个搜索术语的文档。结果包含查询术语 boat 的 title 字段中带有 vessel、boat 和 sail 的电影，因为我们将 boat 配置为名为 transport_synonyms 的同义词源集合中的 boat、vessel 和 sail 的同义词。

   Atlas Search 不包括搜索结果中 title 字段中带有 boat 或 sail 的文档 vessel，因为我们没有将 vessel 配置为同义词来源集合中 boat 或 sail 的同义词。同样，Atlas Search 不会在搜索词 sail 的结果中包含 title 字段中包含 boat 或 vessel 的文档，因为我们没有将 sail 配置为同义词源集合中的 boat 或 vessel。要测试这些示例，请将上述查询中 query 字段的值替换为 vessel 或 sail，然后再次运行查询。

   结果还包含查询词 hat 的标题字段中带有 fedora 和 hat 的电影，因为我们将 hat 配置为名为 attire_synonyms 的同义词源集合中的 hat、fedora 和 headgear 的同义词。

   Atlas Search 不包括搜索结果中 title 字段中带有 hat 或 fedora 的文档 headgear，因为我们没有将 headgear 配置为同义词来源集合中 hat 或 fedora 的同义词。同样，Atlas Search 不会在搜索词 fedora 的结果中包含 title 字段中包含 hat 或 headgear 的文档，因为我们没有将 fedora 配置为同义词源集合中的 hat 或 headgear。要测试这些示例，请将上述查询中 query 字段的值替换为 fedora 或 headgear，然后再次运行查询。

1. 创建一个名为 synonyms-equivalent-query.go 的文件。

2. 将代码示例复制并粘贴到 synonyms-equivalent-query.go 文件中。

   该代码示例包含以下阶段：

   • $search 阶段，在 title 字段中搜索单词 automobile，并使用名为 transportSynonyms 的同义词映射定义在名为 transport_synonyms 的同义词源集合中搜索配置为查询单词 automobile 同义词的单词。

   • $limit 阶段用于将输出限制为 10 个结果。

   • $project 阶段排除除 title 之外的所有字段，并添加一个名为 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. 在运行示例之前，请将 <connection-string> 替换为 Atlas 连接字符串。确保您的连接字符串包含数据库用户的档案。要了解详情，请参阅通过驱动程序连接。

4. 运行以下命令来查询您的集合：

   go run synonyms-equivalent-query.go

   当您运行 synonyms-equivalent-query.go 时，程序会将以下文档打印到您的终端：

   [{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}]

   Atlas Search 结果包含在 title 字段中带有 car 和 automobile 的电影，尽管查询术语是 automobile，因为我们在名为 sample_synonyms 的同义词来源集合中将 automobile 配置为 car、vehicle 和 automobile 的同义词，该集合在索引中指定。Atlas Search 对于单词 car 和 vehicle 的搜索返回相同的结果。要对此进行测试，将上面查询中的 query 字段的值替换为 car 或 vehicle，然后运行查询。

1. 创建一个名为 synonyms-explicit-query.go 的文件。

2. 将代码示例复制并粘贴到 synonyms-explicit-query.go 文件中。

   该代码示例包含以下阶段：

   • $search 阶段，在 title 字段中搜索单词 boat，并使用名为 transportSynonyms 的同义词映射定义在名为 transport_synonyms 的同义词源集合中搜索配置为查询单词 boat 同义词的单词。

   • $limit 阶段用于将输出限制为 10 个结果。

   • $project 阶段排除除 title 之外的所有字段，并添加一个名为 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. 在运行示例之前，请将 <connection-string> 替换为 Atlas 连接字符串。确保您的连接字符串包含数据库用户的档案。要了解详情，请参阅通过驱动程序连接。

4. 运行以下命令来查询您的集合：

   go run synonyms-explicit-query.go

   隐藏输出

   [{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}]

   Atlas Search 搜索结果包含 title 字段中具有 boat、 vessel 和 sail 的电影，因为我们在名为 sample_synonyms 的同义词源集合中将 boat、 vessel 和 sail 配置为boat 的同义词，该集合在集合的索引中指定。

   Atlas Search 仅在结果中搜索单词 vessel 时返回以下文档

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

   Atlas Search 不包括结果中 title 字段中带有 boat 或 sail 的文档，因为我们没有将 vessel 配置为同义词源集合中 boat 或 sail 的同义词。要对此进行测试，将上面查询中的 query 字段的值替换为 vessel，然后再次运行查询。

   同样，Atlas Search 仅在搜索词 sail 的结果中返回以下文档：

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

   Atlas Search 不包括结果中 title 字段中带有 boat 或 vessel 的文档，因为我们没有将 sail 配置为同义词源集合中 boat 或 vessel 的同义词。要测试此示例，请将上述查询中 query 字段的值替换为 sail，然后再次运行查询。

1. 创建一个名为 synonyms-equivalent-query.go 的文件。

2. 将代码示例复制并粘贴到 synonyms-equivalent-query.go 文件中。

   该代码示例包含以下阶段：

   • $search 阶段，在 title 字段中搜索单词 automobile，并使用名为 transportSynonyms 的同义词映射定义在名为 transport_synonyms 的同义词源集合中搜索配置为查询单词 automobile 同义词的单词。该查询还会在 title 字段中搜索单词 attire，并使用名为 attireSynonyms 的同义词映射定义在名为 attire_synonyms 的同义词源集合中搜索配置为查询单词 attire 同义词的单词。

   • $limit 阶段用于将输出限制为 10 个结果。

   • $project 阶段排除除 title 之外的所有字段，并添加一个名为 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. 在运行示例之前，请将 <connection-string> 替换为 Atlas 连接字符串。确保您的连接字符串包含数据库用户的档案。要了解详情，请参阅通过驱动程序连接。

4. 运行以下命令来查询您的集合：

   go run synonyms-equivalent-query.go

   隐藏输出

   [{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}]

   Atlas Search 结果包含两个搜索术语的文档。结果包含查询术语 automobile 的 title 字段中带有 car 的电影，因为我们将 automobile 配置为名为car、vehicle 和 automobile 的同义词源集合中的同义词 transport_synonyms。结果还包含查询术语 attire 的标题字段中带有 dress 的电影，因为我们将 attire 配置为名为 attire_synonyms 的同义词源集合中的dress、apparel 和 attire 的同义词。

   Atlas Search 在 transport_synonyms 源集合中搜索 car 或 vehicle 以及在 attire_synonyms 源集合中搜索 dress 或 apparel 会返回相同的结果。要测试此示例，将上述查询中 query 字段的值替换为 car 或 vehicle，并将上述查询中 query 字段的值替换为 dress 或 apparel，然后再次运行查询。

1. 创建一个名为 synonyms-explicit-query.go 的文件。

2. 将代码示例复制并粘贴到 synonyms-explicit-query.go 文件中。

   该代码示例包含以下阶段：

   • $search 阶段，在 title 字段中搜索单词 boat，并使用名为 transportSynonyms 的同义词映射定义在名为 transport_synonyms 的同义词源集合中搜索配置为查询单词 boat 同义词的单词。该查询还会在 title 字段中搜索单词 hat，并使用名为 attireSynonyms 的同义词映射定义在名为 attire_synonyms 的同义词源集合中搜索配置为查询单词 hat 同义词的单词。

   • $limit 阶段用于将输出限制为 10 个结果。

   • $project 阶段排除除 title 之外的所有字段，并添加一个名为 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. 在运行示例之前，请将 <connection-string> 替换为 Atlas 连接字符串。确保您的连接字符串包含数据库用户的档案。要了解详情，请参阅通过驱动程序连接。

4. 运行以下命令来查询您的集合：

   go run synonyms-explicit-query.go

   隐藏输出

   [{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}]

   Atlas Search 结果包含两个搜索术语的文档。结果包含查询术语 boat 的 title 字段中带有 vessel、boat 和 sail 的电影，因为我们将 boat 配置为名为 transport_synonyms 的同义词源集合中的 boat、vessel 和 sail 的同义词。

   Atlas Search 不包括搜索结果中 title 字段中带有 boat 或 sail 的文档 vessel，因为我们没有将 vessel 配置为同义词来源集合中 boat 或 sail 的同义词。同样，Atlas Search 不会在搜索词 sail 的结果中包含 title 字段中包含 boat 或 vessel 的文档，因为我们没有将 sail 配置为同义词源集合中的 boat 或 vessel。要测试这些示例，请将上述查询中 query 字段的值替换为 vessel 或 sail，然后再次运行查询。

   结果还包含查询词 hat 的标题字段中带有 fedora 和 hat 的电影，因为我们将 hat 配置为名为 attire_synonyms 的同义词源集合中的 hat、fedora 和 headgear 的同义词。

   Atlas Search 不包括搜索结果中 title 字段中带有 hat 或 fedora 的文档 headgear，因为我们没有将 headgear 配置为同义词来源集合中 hat 或 fedora 的同义词。同样，Atlas Search 不会在搜索词 fedora 的结果中包含 title 字段中包含 hat 或 headgear 的文档，因为我们没有将 fedora 配置为同义词源集合中的 hat 或 headgear。要测试这些示例，请将上述查询中 query 字段的值替换为 fedora 或 headgear，然后再次运行查询。

1. 创建一个名为 SynonymsEquivalentQuery.java 的文件。

2. 将以下代码复制并粘贴到该文件中。

   该代码示例包含以下阶段：

   • $search 阶段，在 title 字段中搜索单词 automobile，并使用名为 transportSynonyms 的同义词映射定义在名为 transport_synonyms 的同义词源集合中搜索配置为查询单词 automobile 同义词的单词。

   • $limit 阶段用于将输出限制为 10 个结果。

   • $project 阶段排除除 title 之外的所有字段，并添加一个名为 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
   }

   注意

   要在 Maven 环境中运行示例代码，请在文件中的 import 语句上方添加以下内容。

   package com.mongodb.drivers;

3. 在运行示例之前，请将 <connection-string> 替换为 Atlas 连接字符串。确保您的连接字符串包含数据库用户的档案。要了解详情，请参阅通过驱动程序连接。

4. 编译并运行 SynonymsEquivalentQuery.java 文件。

   javac SynonymsEquivalentQuery.java
   java SynonymsEquivalentQuery

   隐藏输出

   {"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}

   Atlas Search 结果包含在 title 字段中带有 car 和 automobile 的电影，尽管查询术语是 automobile，因为我们在名为 sample_synonyms 的同义词来源集合中将 automobile 配置为 car、vehicle 和 automobile 的同义词，该集合在索引中指定。Atlas Search 对于单词 car 和 vehicle 的搜索返回相同的结果。要对此进行测试，将上面查询中的 query 字段的值替换为 car 或 vehicle，然后运行查询。

1. 创建一个名为 SynonymsExplicitQuery.java 的文件。

2. 将以下代码复制并粘贴到该文件中。

   该代码示例包含以下阶段：

   • $search 阶段，在 title 字段中搜索单词 boat，并使用名为 transportSynonyms 的同义词映射定义在名为 transport_synonyms 的同义词源集合中搜索配置为查询单词 boat 同义词的单词。

   • $limit 阶段用于将输出限制为 10 个结果。

   • $project 阶段排除除 title 之外的所有字段，并添加一个名为 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
   }

   注意

   要在 Maven 环境中运行示例代码，请在文件中的 import 语句上方添加以下内容。

   package com.mongodb.drivers;

3. 在运行示例之前，请将 <connection-string> 替换为 Atlas 连接字符串。确保您的连接字符串包含数据库用户的档案。要了解详情，请参阅通过驱动程序连接。

4. 编译并运行 SynonymsExplicitQuery.java 文件。

   javac SynonymsExplicitQuery.java
   java SynonymsExplicitQuery

   隐藏输出

   {"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}

   Atlas Search 搜索结果包含 title 字段中具有 boat、 vessel 和 sail 的电影，因为我们在名为 sample_synonyms 的同义词源集合中将 boat、 vessel 和 sail 配置为boat 的同义词，该集合在集合的索引中指定。

   Atlas Search 仅在结果中搜索单词 vessel 时返回以下文档

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

   Atlas Search 不包括结果中 title 字段中带有 boat 或 sail 的文档，因为我们没有将 vessel 配置为同义词源集合中 boat 或 sail 的同义词。要对此进行测试，将上面查询中的 query 字段的值替换为 vessel，然后再次运行查询。

   同样，Atlas Search 仅在搜索词 sail 的结果中返回以下文档：

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

   Atlas Search 不包括结果中 title 字段中带有 boat 或 vessel 的文档，因为我们没有将 sail 配置为同义词源集合中 boat 或 vessel 的同义词。要测试此示例，请将上述查询中 query 字段的值替换为 sail，然后再次运行查询。

1. 创建一个名为 SynonymsEquivalentQuery.java 的文件。

2. 将以下代码复制并粘贴到该文件中。

   该代码示例包含以下阶段：

   • $search 阶段，在 title 字段中搜索单词 automobile，并使用名为 transportSynonyms 的同义词映射定义在名为 transport_synonyms 的同义词源集合中搜索配置为查询单词 automobile 同义词的单词。该查询还会在 title 字段中搜索单词 attire，并使用名为 attireSynonyms 的同义词映射定义在名为 attire_synonyms 的同义词源集合中搜索配置为查询单词 attire 同义词的单词。

   • $limit 阶段用于将输出限制为 10 个结果。

   • $project 阶段排除除 title 之外的所有字段，并添加一个名为 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
   }

   注意

   要在 Maven 环境中运行示例代码，请在文件中的 import 语句上方添加以下内容。

   package com.mongodb.drivers;

3. 在运行示例之前，请将 <connection-string> 替换为 Atlas 连接字符串。确保您的连接字符串包含数据库用户的档案。要了解详情，请参阅通过驱动程序连接。

4. 编译并运行 SynonymsEquivalentQuery.java 文件。

   javac SynonymsEquivalentQuery.java
   java SynonymsEquivalentQuery

   隐藏输出

   {"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}

   Atlas Search 结果包含两个搜索术语的文档。结果包含查询术语 automobile 的 title 字段中带有 car 的电影，因为我们将 automobile 配置为名为car、vehicle 和 automobile 的同义词源集合中的同义词 transport_synonyms。结果还包含查询术语 attire 的标题字段中带有 dress 的电影，因为我们将 attire 配置为名为 attire_synonyms 的同义词源集合中的dress、apparel 和 attire 的同义词。

   Atlas Search 在 transport_synonyms 源集合中搜索 car 或 vehicle 以及在 attire_synonyms 源集合中搜索 dress 或 apparel 会返回相同的结果。要测试此示例，将上述查询中 query 字段的值替换为 car 或 vehicle，并将上述查询中 query 字段的值替换为 dress 或 apparel，然后再次运行查询。