Docs 菜单
Docs 主页
/
Atlas
/
Atlas Search
/
为数据模型设计搜索

在Atlas Search中使用视图

您可以在 视图上创建 Atlas Search 索引，以转换文档和集合，从而可以部分索引集合、支持不兼容的数据类型或数据模型等。

以下示例使用了 sample_mflix 和 sample_airbnb 示例数据库。

注意

消歧

本页讨论标准视图。要了解按需物化视图，请参阅按需物化视图。

要了解视图类型之间的差异，请参阅与按需物化视图的比较。

要求

您必须使用 MongoDB 8.0 或更高版本。

要编辑视图，您必须拥有用户管理员角色，并使用 collMod 数据库命令。

限制

  • Atlas Search 仅支持在以下阶段 $expr 的视图：

  • 索引名称在源集合及其所有视图中必须是唯一的。

  • Atlas Search 不支持包含产生动态结果的操作符的视图定义，例如 $$USER_ROLES系统变量和 $rand 聚合操作符。

  • Atlas Search 查询返回源集合中显示的原始文档。

示例：过滤文档

要创建视图，您必须拥有 createCollection 权限。

您可以对集合进行部分索引，以过滤文档。以下示例在 sample_mflix.movies 集合上创建一个视图，以便您可以仅搜索在 2000 年 1 月 1 日之后发行的电影。

1

使用 mongosh 连接到 Atlas 集群。

要了解更多信息，请参阅通过 mongosh 进行连接。

2

切换到 sample_mflix 数据库。

use sample_mflix
3

创建一个 movies_ReleasedAfter2000 视图。

db.createView(
  "movies_ReleasedAfter2000",
  "movies",
  [
    {
      $match: {
        $expr: {
          $gt: [
            "$released",
            ISODate("2000-01-01")
          ]
        }
      }
    }
  ]
)
4

AtlasGoClusters在Atlas中，Go项目的 页面。

警告： 导航优化正在进行中我们目前正在逐步推出改进的全新导航体验。如果以下步骤与您在 Atlas UI 中的视图不符，请参阅预览文档。

  1. 如果尚未显示，请从导航栏上的 Organizations 菜单中选择包含所需项目的组织。

  2. 如果尚未显示，请从导航栏的Projects菜单中选择所需的项目。

  3. 如果尚未出现，请单击侧边栏中的 Clusters（集群）。

    会显示集群页面。

5

转到集群的 Atlas Search 页面。

您可以从侧边栏、 Data Explorer 或集群详细信息页面转到 Atlas Search 页面。

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

    如果没有集群，则请单击 Create cluster 来创建一个。要了解更多信息，请参阅创建集群。

  2. 如果您的项目有多个集群，请从 Select cluster 下拉列表中选择要使用的集群，然后单击 Go to Atlas Search。

    将显示 Atlas Search 页面。

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

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

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

    将显示 Atlas Search 页面。

  1. 单击集群的名称。

  2. 单击 Atlas Search 标签页。

    将显示 Atlas Search 页面。

6

单击 Create Search Index（保存并关闭）。

7

开始您的索引配置。

在页面上进行以下选择，然后单击 Next。

Search Type

选择 Atlas Search 索引类型。

Index Name and Data Source

指定以下信息：

  • Index Name: releasedAfter2000Index

  • Database and Collection:

    • sample_mflix

    • movies_ReleasedAfter2000

Configuration Method

For a guided experience, select Visual Editor.

To edit the raw index definition, select JSON Editor.

注意

您的 Atlas Search 索引默认名为 default。如果保留此名称，则对于任何未在其操作符中指定不同 index选项的 Atlas Search 查询，您的搜索索引将成为默认搜索索引。如果您要创建多个索引，我们建议您在所有索引中保持一致且具有描述性的命名规则。

8

单击 Create Search Index（保存并关闭）。

Atlas 会显示一个 Toast（简短的非交互式通知），以通知索引正在构建中。

9

检查状态。

新创建的索引会出现在 Atlas Search 标签页上。在构建索引期间，Status 字段显示为 Build in Progress。索引构建完成后，Status 字段将显示为Active。

注意

较大的集合需要较长的索引时间。索引构建完成后，您将收到电子邮件通知。

10

在 releasedAfter2000Index 部分索引上运行查询。

注意

以下示例通过对名为 movies_ReleasedAfter2000 的视图运行 .aggregate 命令来查询 releasedAfter2000Index 索引。如果您的集群正在运行 MongoDB v8.0，则必须使用视图上的索引查询源集合（例如，movies）。升级到 MongoDB v8.1+ 以直接查询视图。

use sample_mflix
1db.db.movies_ReleasedAfter2000.aggregate([
2  {
3    $search: {
4      index: "releasedAfter2000Index",
5      text: {
6        path: "title",
7        query: "foo"
8      },
9      sort: {
10        released: 1
11      }
12    }
13  }
14])
[
  {
    _id: ObjectId('573a13d2f29313caabd929f8'),
    plot: "Rising from the ashes of Nirvana, the Foo Fighters became a Grammy-winning sensation on their own. Sixteen years of the band's history comes to life in this documentary, from their demo ...",
    genres: [ 'Documentary', 'Music' ],
    runtime: 150,
    cast: [
      'Shawn Cloninger',
      'William Goldsmith',
      'Jessy Greene',
      'Dave Grohl'
    ],
    num_mflix_comments: 0,
    poster: 'https://m.media-amazon.com/images/M/MV5BMzE4OTczMTgxM15BMl5BanBnXkFtZTcwNTU1NjQxOA@@._V1_SY1000_SX677_AL_.jpg',
    title: 'Foo Fighters: Back and Forth',
    fullplot: `Rising from the ashes of Nirvana, the Foo Fighters became a Grammy-winning sensation on their own. Sixteen years of the band's history comes to life in this documentary, from their demo tapes through the creation of their 2011 album, "Wasting Light."`,
    languages: [ 'English' ],
    released: ISODate('2011-04-05T00:00:00.000Z'),
    directors: [ 'James Moll' ],
    awards: { wins: 1, nominations: 1, text: '1 win & 1 nomination.' },
    lastupdated: '2015-08-19 00:00:25.937000000',
    year: 2011,
    imdb: { rating: 8.4, votes: 3745, id: 1853563 },
    countries: [ 'USA' ],
    type: 'movie',
    tomatoes: {
      viewer: { rating: 4.4, numReviews: 857, meter: 96 },
      dvd: ISODate('2011-08-08T00:00:00.000Z'),
      website: 'http://us.foofightersfilm.com/',
      production: 'Cinedigm Digital Cinema',
      lastUpdated: ISODate('2015-09-12T18:42:01.000Z')
    }
  }
]

示例：添加或修改字段

以下示例允许您根据新的 totalPrice 字段（该字段是 price 和 cleaningFee 字段的总和）在 sample_airbnb.listingsAndReviews 集合中搜索住宿信息。此外，由于 Atlas Search 不支持 Decimal128 类型，我们将值转换为 Double。

1

使用 mongosh 连接到 Atlas 集群。

要了解更多信息，请参阅通过 mongosh 进行连接。

2

切换到 sample_airbnb 数据库。

use sample_airbnb
3

创建一个 listingsAndReviews_totalPrice 视图。

db.createView(
  "listingsAndReviews_totalPrice",
  "listingsAndReviews",
  [
    {
      $addFields: {
        totalPrice: {
          $add: [
            {
              $ifNull: [{ $toDouble: "$price" }, 0]
            },
            {
              $ifNull: [{ $toDouble: "$cleaning_fee" }, 0]
            }
          ]
        }
      }
    }
  ]
)
4

AtlasGoClusters在Atlas中，Go项目的 页面。

警告： 导航优化正在进行中我们目前正在逐步推出改进的全新导航体验。如果以下步骤与您在 Atlas UI 中的视图不符，请参阅预览文档

  1. 如果尚未显示，请从导航栏上的 Organizations 菜单中选择包含所需项目的组织。

  2. 如果尚未显示，请从导航栏的Projects菜单中选择所需的项目。

  3. 如果尚未出现，请单击侧边栏中的 Clusters（集群）。

    会显示集群页面。

5

转到集群的 Atlas Search 页面。

您可以从侧边栏、 Data Explorer 或集群详细信息页面转到 Atlas Search 页面。

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

    如果没有集群，则请单击 Create cluster 来创建一个。要了解更多信息，请参阅创建集群。

  2. 如果您的项目有多个集群，请从 Select cluster 下拉列表中选择要使用的集群，然后单击 Go to Atlas Search。

    将显示 Atlas Search 页面。

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

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

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

    将显示 Atlas Search 页面。

  1. 单击集群的名称。

  2. 单击 Atlas Search 标签页。

    将显示 Atlas Search 页面。

6

单击 Create Search Index（保存并关闭）。

7

开始您的索引配置。

在页面上进行以下选择，然后单击 Next。

Search Type

选择 Atlas Search 索引类型。

Index Name and Data Source

指定以下信息：

  • Index Name: totalPriceIndex

  • Database and Collection:

    • sample_airbnb

    • listingsAndReviews_totalPrice

Configuration Method

For a guided experience, select Visual Editor.

To edit the raw index definition, select JSON Editor.

注意

您的 Atlas Search 索引默认名为 default。如果保留此名称，则对于任何未在其操作符中指定不同 index选项的 Atlas Search 查询，您的搜索索引将成为默认搜索索引。如果您要创建多个索引，我们建议您在所有索引中保持一致且具有描述性的命名规则。

8

指定索引定义。

  1. 请指定以下索引定义：

    {
      "mappings": {
        "dynamic": true
      },
      "storedSource": {
        "include": [
          "totalPrice"
        ]
      }
    }

  2. 单击 Next（连接）。

9

单击 Create Search Index（保存并关闭）。

Atlas 会显示一个 Toast（简短的非交互式通知），以通知索引正在构建中。

10

检查状态。

新创建的索引会出现在 Atlas Search 标签页上。在构建索引期间，Status 字段显示为 Build in Progress。索引构建完成后，Status 字段将显示为Active。

注意

较大的集合需要较长的索引时间。索引构建完成后，您将收到电子邮件通知。

11

在 totalPriceIndex 索引上运行查询。

注意

以下示例通过对名为 listingsAndReviews_totalPrice 的视图运行 .aggregate 命令来查询 totalPriceIndex 索引。如果您的集群正在运行 MongoDB v8.0，则必须使用视图上的索引查询源集合（例如，listingsAndReviews）。升级到 MongoDB v8.1+ 以直接查询视图。

use sample_airbnb
1db.listingsAndReviews_totalPrice.aggregate([
2  {
3    $search: {
4      index: "totalPriceIndex",
5      range: {
6        path: "totalPrice",
7        lte: 300
8      },
9      returnStoredSource: true
10    }
11  }
12])
[
  { _id: '10006546', totalPrice: 115 },
  { _id: '1001265', totalPrice: 215 },
  { _id: '10021707', totalPrice: 40 },
  { _id: '1003530', totalPrice: 270 },
  { _id: '10038496', totalPrice: 269 },
  { _id: '10051164', totalPrice: 250 },
  { _id: '10057447', totalPrice: 50 },
  { _id: '10057826', totalPrice: 205 },
  { _id: '10059244', totalPrice: 43 },
  { _id: '10066928', totalPrice: 140 },
  { _id: '10082422', totalPrice: 60 },
  { _id: '10083468', totalPrice: 40 },
  { _id: '10084023', totalPrice: 231 },
  { _id: '10091713', totalPrice: 231 },
  { _id: '10092679', totalPrice: 58 },
  { _id: '10096773', totalPrice: 205 },
  { _id: '10112159', totalPrice: 90 },
  { _id: '10117617', totalPrice: 55 },
  { _id: '10120414', totalPrice: 150 },
  { _id: '10133554', totalPrice: 121 }
]

编辑视图

以下示例更新了 2000 年之前电影的 movies_ReleasedAfter2000 MongoDB 视图。

db.runCommand(
{
    collMod: "movies_ReleasedAfter2000",
    viewOn: "movies",
    "pipeline": [
      {
        $match: {
          $expr: {
            $lt: [
              "$released",
              ISODate("2000-01-01T00")
            ]
          }
        }
      }
    ]
  }
)

运行此命令后，Atlas Search 会自动检测到 View 定义的更改，并在不中断服务的情况下执行重新索引。

返回视图的管道

以下示例返回 movies_ReleasedAfter2000 视图中的管道。

1db.getCollectionInfos({ name: "movies_ReleasedAfter2000" })[0].options.pipeline
[
  {
    '$match': {
      '$expr': { '$gt': [ '$released', ISODate('2000-01-01T00:00:00.000Z') ] }
    }
  }
]

性能考虑因素

对于在视图上创建的索引，Atlas Search 会在查询时和复制时应用您在视图管道中定义的转换或过滤器。虽然视图管道中的简单转换或过滤器通常不会对性能产生显著影响，但视图管道中的复杂转换或高度选择性的过滤器可能会显著降低查询或复制的速度。如果您想对文档进行大量转换或应用高度选择性的过滤器，建议创建一个包含已转换或已过滤文档的物化视图。您可以通过比较在视图上执行的查询延迟与在其源集合上执行的查询延迟来评估视图性能。

故障排除

索引更改为 FAILED

在以下场景中，索引会更改为 FAILED 状态：

  • 您在与 Atlas Search 不兼容的视图上创建索引。

  • 您编辑视图的方式不符合 Atlas Search 兼容性要求。

  • 您删除或更改视图的源集合。

    例如，如果一个视图是在另一个视图上创建的，并且将父视图源更改为另一个集合。

    注意

    如果一个视图是其他视图的后代，这一限制也同样适用。例如，您无法更改或移除所有后代所源自的源集合。

索引更改为 STALE

在以下场景中，索引会更改为 STALE 状态：

警告

如果在视图中定义的聚合管道与集合中的文档不兼容，搜索复制将失败。例如，如果 $toDouble 表达式对包含数组的文档字段进行操作，复制将失败。确保您的视图在处理集合中的所有文档时不会出错。

  • 如果视图定义导致聚合失败，而索引为READY ，则索引变为STALE 。解析文档或更改视图定义以使其不再失败后，索引将返回到READY 。当为STALE 时，索引仍然可查询。如果索引脱离oplog ，则会触发索引重建。

  • 如果视图定义在索引为 BUILDING 时导致聚合管道失败，则在修复文档之前，则索引生成将停滞。在您解析文档或更改视图定义后，索引将返回到 READY，以确保不再失败。

您可以在 Atlas 用户界面的索引状态详情页面查看索引状态。

错误：$search 仅作为管道中的第一阶段有效

当您使用 8.1 之前的MongoDB版本查询视图时，会出现此错误。

  • 如果您使用 8.0 之前的MongoDB版本，我们建议您升级到 8.1+ 以直接查询视图。您可以升级到 8.0 来查询源集合。

  • 如果使用MongoDB 8.0，则必须针对源集合查询视图索引。示例，对集合而不是视图运行.aggregate()。

索引流程

当您在视图上创建 Atlas Search 索引时，mongot 进程执行的任务与在常规集合上创建 Atlas Search 索引时相同。mongot 进程：

  1. 根据该集合的索引定义中的规则来创建 Atlas Search 索引。

  2. 监控文档当前状态的变更流，以及已定义 Atlas Search 索引的集合索引。

  3. 处理 Atlas Search 查询，并将匹配文档的文档 ID 和其他搜索元数据返回给 mongod，然后执行完整的文档查找并将结果返回给客户端。

当您在视图上创建 Atlas Search 索引时，视图定义将在步骤 1 和 2 期间应用，转换后的文档将存储在磁盘上的 Atlas Search 索引中。

了解详情

要了解有关视图的更多信息，请参阅视图。

要在视图上创建Atlas Vector Search索引，请参阅将视图与Atlas Vector Search结合使用。

后退

多个集合

来年

兼容性与限制

在此页面上