db.collection.getSearchIndexes()

在此页面上

定义

兼容性
语法
命令字段
访问控制
输出
索引状态详情
同义词映射详情
Atlas Search 索引状态
示例
返回所有搜索索引
返回单个搜索索引

定义

db.collection.getSearchIndexes()

7.0 版本中的新增功能：（也可从 6.0.7 开始使用）

返回指定集合上现有 Atlas Search索引的信息。

重要

mongosh 方法

本页面提供 mongosh 方法的相关信息。这不是特定于语言的驱动程序（例如 Node.js）的文档。

如需了解 MongoDB API 驱动程序，请参阅特定语言的 MongoDB 驱动程序文档。

兼容性

此方法可用于以下环境中托管的部署：

MongoDB Atlas：用于云中 MongoDB 部署的完全托管服务

重要

M 0 、M 2和 M 5集群或无服务器实例不支持此命令。有关更多信息，请参阅不支持的命令。

语法

命令语法：

db.<collection>.getSearchIndexes(<indexName>)

命令字段

getSearchIndexes() 采用此字段：

字段	类型	必要性	说明
`indexName`	字符串	Optional	要返回信息的索引名称。如果省略`indexName`字段， `getSearchIndexes()`将返回有关collection上所有 Atlas Search 搜索索引的信息。

访问控制

如果您的部署强制执行访问权限控制，则运行getSearchIndexes()的用户必须对数据库或集合具有 listSearchIndexes动作权限：

{
   resource: {
      db : <database>,
      collection: <collection>
   },
   actions: [ "listSearchIndexes" ]
}

内置的 read 角色提供 listSearchIndexes 权限。以下示例在 qa 数据库上授予 read 角色：

db.grantRolesToUser(
   "<user>",
   [ { role: "read", db: "qa" } ]
)

输出

getSearchIndexes() 返回一个文档大量。大量中的每个文档都包含以下字段：

字段	类型	说明
`id`	字符串	索引的唯一标识符。
`name`	字符串	索引名称。
`status`	字符串	索引的状态。有关更多信息，请参阅 Atlas Search 索引状态。
`queryable`	布尔	表示索引是否准备好进行查询。
`latestDefinitionVersion`	文档	描述索引的版本。
`latestDefinitionVersion.version`	整型	与索引定义关联的版本号。更新索引定义时，版本号会自动递增。
`latestDefinitionVersion.createdAt`	日期	创建当前索引定义的时间。
`latestDefinition`	文档	该索引的最新定义。有关更多信息，请参阅搜索索引定义语法。
`statusDetail`	文档数组	包含每个搜索主机上索引的状态 (`mongot`)。
`statusDetail.[n].hostname`	字符串	相应 `mongot` 的主机名。
`statusDetail.[n].status`	字符串	相应 `mongot` 上的索引状态。
`statusDetail.[n].queryable`	布尔	表示索引是否可以在相应的 `mongot` 上进行查询。
`statusDetail.[n].mainIndex`	文档	包含相应 `mongot` 上活动索引的相关状态信息。有关详情，请参阅索引状态详情。
`statusDetail.[n].stagedIndex`	文档	包含在相应 `mongot` 的后台内置索引的状态信息。仅当您要构建新索引以更新现有活跃索引时，此字段才会显示。有关详情，请参阅索引状态详情。
`synonymMappingStatus`	字符串	索引同义词映射的状态。仅当索引定义了同义词时才会显示此字段。可以是以下值之一： `BUILDING` `FAILED` `READY` 返回的状态是每个 `mongot` 上同义词映射的摘要。
`synonymMappingStatusDetail`	文档数组	包含每个搜索托管 (`mongot`) 上索引同义词映射的状态。仅当索引定义了同义词时，才会显示此字段（及其子字段）。
`synonymMappingStatusDetail.[n].status`	字符串	所有 `mongot` 进程中相应同义词映射的状态。
`synonymMappingStatusDetail.[n].queryable`	布尔	指示相应的同义词映射是否可以支持跨所有 `mongot` 进程的查询。
`message`	字符串	描述同义词映射的错误（如果适用）。仅当此同义词映射的 `status` 为 `FAILED` 时才会出现。

索引状态详情

下表描述了以下文档的嵌入字段：- statusDetail.[mongot].mainIndex - statusDetail.[mongot].stagedIndex

这些字段描述了特定 mongot 的索引状态。

字段	类型	说明
`status`	字符串	相应 `mongot` 上的索引生成状态。
`queryable`	布尔	表示索引生成是否已准备好在相应的 `mongot` 上进行查询。
`synonymMappingStatus`	字符串	索引生成的同义词映射在相应 `mongot` 上的状态。仅当索引定义了同义词时才出现。
`synonymMappingStatusDetails`	文档	包含索引的同义词映射在相应 `mongot` 上的状态。仅当索引定义了同义词时，才会显示此字段（及其子字段）。有关更多信息，请参阅同义词映射详细信息。
`definitionVersion`	文档	描述用于构建此索引生成的索引定义版本。
`definitionVersion.version`	整型	索引生成在相应 `mongot` 上使用的版本号。更新索引定义时，更新后的索引将使用递增的版本号构建。
`definitionVersion.createdAt`	日期	索引定义创建的时间。
`definition`	文档	建立该索引时使用的定义。

同义词映射详情

下表描述了以下对象的嵌入字段：

statusDetail.mainIndex.synonymMappingStatusDetails.<synonymMapping>
statusDetail.stagedIndex.synonymMappingStatusDetails<synonymMapping>

字段	类型	说明
`status`	字符串	跨相应 `mongot` 进程的同义词映射的状态。
`queryable`	布尔	指示相应的同义词映射是否可以支持对相应 `mongot` 进程的查询。
`message`	字符串	描述同义词映射的错误（如果适用）。仅当此同义词映射的 `status` 为 `FAILED` 时才会出现。

Atlas Search 索引状态

getSearchIndexes() 输出中的 status 字段可以是以下之一：

状态	说明
`BUILDING`	以下情况可能导致索引处于 `BUILDING` 状态： Atlas 正在构建索引或在编辑后重新构建索引。 Atlas Search 无法跟上集合的索引变化。在这种情况下，Atlas 会在背景重建索引。当索引处于 `BUILDING` 状态时：对于新索引，Atlas Search 在索引构建完成之前无法使用索引进行查询。对于现有索引，Atlas Search 使用旧的索引定义进行查询，直到索引重建完成。处于 `BUILDING` 状态的索引可以是可查询的，也可以是不可查询的。
`DOES_NOT_EXIST`	该索引不存在。处于 `DOES_NOT_EXIST` 状态的索引始终不可查询。
`DELETING`	Atlas 正在删除索引。处于 `DELETING` 状态的索引始终不可查询。
`FAILED`	索引构建失败。由于索引定义无效，索引可能会进入 `FAILED` 状态。处于 `FAILED` 状态的索引可以是可查询的，也可以是不可查询的。
`PENDING`	Atlas 尚未开始构建索引。处于 `PENDING` 状态的索引始终不可查询。
`READY`	索引已准备好，可以支持查询。处于 `READY` 状态的索引总是可查询的。
`STALE`	索引是可查询的，但已停止从索引集合复制数据。对索引的搜索可能会返回过时的数据。由于复制错误，索引可能会进入 `STALE` 状态。处于 `STALE` 状态的索引总是可查询的。

示例

以下示例演示了如何：

返回所有搜索索引
返回单个搜索索引

返回所有搜索索引

以下示例返回movies集合上的所有 Atlas Search 索引。 movies collection 包含两个搜索索引： default和synonym_mappings 。

db.movies.getSearchIndexes()

示例输出：

[
  {
    id: '6524096020da840844a4c4a7',
    name: 'default',
    status: 'BUILDING',
    queryable: true,
    latestDefinitionVersion: {
      version: 2,
      createdAt: ISODate("2023-10-09T14:51:57.355Z")
    },
    latestDefinition: {
      mappings: { dynamic: true },
      storedSource: { include: [ 'awards.text' ] }
    },
    statusDetail: [
      {
        hostname: 'atlas-n1cm1j-shard-00-02',
        status: 'BUILDING',
        queryable: true,
        mainIndex: {
          status: 'READY',
          queryable: true,
          definitionVersion: {
            version: 0,
            createdAt: ISODate("2023-10-09T14:08:32.000Z")
          },
          definition: { mappings: { dynamic: true, fields: {} } }
        },
        stagedIndex: {
          status: 'PENDING',
          queryable: false,
          definitionVersion: {
            version: 1,
            createdAt: ISODate("2023-10-09T14:51:29.000Z")
          },
          definition: {
            mappings: { dynamic: true, fields: {} },
            storedSource: true
          }
        }
      },
      {
        hostname: 'atlas-n1cm1j-shard-00-01',
        status: 'BUILDING',
        queryable: true,
        mainIndex: {
          status: 'READY',
          queryable: true,
          definitionVersion: {
            version: 0,
            createdAt: ISODate("2023-10-09T14:08:32.000Z")
          },
          definition: { mappings: { dynamic: true, fields: {} } }
        },
        stagedIndex: {
          status: 'PENDING',
          queryable: false,
          definitionVersion: {
            version: 1,
            createdAt: ISODate("2023-10-09T14:51:29.000Z")
          },
          definition: {
            mappings: { dynamic: true, fields: {} },
            storedSource: true
          }
        }
      },
      {
        hostname: 'atlas-n1cm1j-shard-00-00',
        status: 'BUILDING',
        queryable: true,
        mainIndex: {
          status: 'READY',
          queryable: true,
          definitionVersion: {
            version: 0,
            createdAt: ISODate("2023-10-09T14:08:32.000Z")
          },
          definition: { mappings: { dynamic: true, fields: {} } }
        }
      }
    ]
  },
  {
    id: '65240be420da840844a4d077',
    name: 'synonym_mappings',
    status: 'READY',
    queryable: true,
    latestDefinitionVersion: {
      version: 0,
      createdAt: ISODate("2023-10-09T14:19:16.305Z")
    },
    latestDefinition: {
      mappings: {
        dynamic: true,
        fields: {
          fullplot: { type: 'string' }
        }
      },
      synonyms: [
        {
          name: 'synonym_mapping',
          analyzer: 'lucene.english',
          source: { collection: 'synonyms' }
        }
      ]
    },
    synonymMappingStatus: 'READY',
    synonymMappingStatusDetail: [
      {
        synonym_mapping: {
          status: 'READY',
          queryable: true
        }
      }
    ],
    statusDetail: [
      {
        hostname: 'atlas-n1cm1j-shard-00-02',
        status: 'READY',
        queryable: true,
        mainIndex: {
          status: 'READY',
          queryable: true,
          definitionVersion: {
            version: 0,
            createdAt: ISODate("2023-10-09T14:19:16.000Z")
          },
          definition: {
            mappings: {
              dynamic: true,
              fields: {
                fullplot: {
                  type: 'string',
                  indexOptions: 'offsets',
                  store: true,
                  norms: 'include'
                }
              }
            },
            synonyms: [
              {
                name: 'synonym_mapping',
                analyzer: 'lucene.english',
                source: { collection: 'synonyms' }
              }
            ]
          },
          synonymMappingStatus: 'READY',
          synonymMappingStatusDetail: [
            {
              synonym_mapping: {
                status: 'READY',
                queryable: true
              }
            }
          ]
        }
      },
      {
        hostname: 'atlas-n1cm1j-shard-00-01',
        status: 'READY',
        queryable: true,
        mainIndex: {
          status: 'READY',
          queryable: true,
          definitionVersion: {
            version: 0,
            createdAt: ISODate("2023-10-09T14:19:16.000Z")
          },
          definition: {
            mappings: {
              dynamic: true,
              fields: {
                fullplot: {
                  type: 'string',
                  indexOptions: 'offsets',
                  store: true,
                  norms: 'include'
                }
              }
            },
            synonyms: [
              {
                name: 'synonym_mapping',
                analyzer: 'lucene.english',
                source: { collection: 'synonyms' }
              }
            ]
          },
          synonymMappingStatus: 'READY',
          synonymMappingStatusDetail: [
            {
              synonym_mapping: {
                status: 'READY',
                queryable: true
              }
            }
          ]
        }
      },
      {
        hostname: 'atlas-n1cm1j-shard-00-00',
        status: 'READY',
        queryable: true,
        mainIndex: {
          status: 'READY',
          queryable: true,
          definitionVersion: {
            version: 0,
            createdAt: ISODate("2023-10-09T14:19:16.000Z")
          },
          definition: {
            mappings: {
              dynamic: true,
              fields: {
                fullplot: {
                  type: 'string',
                  indexOptions: 'offsets',
                  store: true,
                  norms: 'include'
                }
              }
            },
            synonyms: [
              {
                name: 'synonym_mapping',
                analyzer: 'lucene.english',
                source: { collection: 'synonyms' }
              }
            ]
          },
          synonymMappingStatus: 'READY',
          synonymMappingStatusDetail: [
            {
              synonym_mapping: {
                status: 'READY',
                queryable: true
              }
            }
          ]
        }
      }
    ]
  }
]

返回单个搜索索引

synonym_mappingsmovies以下示例返回collection上的索引：

db.movies.getSearchIndexes("synonym_mappings")

示例输出：

[
  {
    id: '65240be420da840844a4d077',
    name: 'synonym_mappings',
    status: 'READY',
    queryable: true,
    latestDefinitionVersion: {
      version: 0,
      createdAt: ISODate("2023-10-09T14:19:16.305Z")
    },
    latestDefinition: {
      mappings: {
        dynamic: true,
        fields: {
          fullplot: { type: 'string' }
        }
      },
      synonyms: [
        {
          name: 'synonym_mapping',
          analyzer: 'lucene.english',
          source: { collection: 'synonyms' }
        }
      ]
    },
    synonymMappingStatus: 'READY',
    synonymMappingStatusDetail: [
      {
        synonym_mapping: {
          status: 'READY',
          queryable: true
        }
      }
    ],
    statusDetail: [
      {
        hostname: 'atlas-n1cm1j-shard-00-02',
        status: 'READY',
        queryable: true,
        mainIndex: {
          status: 'READY',
          queryable: true,
          definitionVersion: {
            version: 0,
            createdAt: ISODate("2023-10-09T14:19:16.000Z")
          },
          definition: {
            mappings: {
              dynamic: true,
              fields: {
                fullplot: {
                  type: 'string',
                  indexOptions: 'offsets',
                  store: true,
                  norms: 'include'
                }
              }
            },
            synonyms: [
              {
                name: 'synonym_mapping',
                analyzer: 'lucene.english',
                source: { collection: 'synonyms' }
              }
            ]
          },
          synonymMappingStatus: 'READY',
          synonymMappingStatusDetail: [
            {
              synonym_mapping: {
                status: 'READY',
                queryable: true
              }
            }
          ]
        }
      },
      {
        hostname: 'atlas-n1cm1j-shard-00-01',
        status: 'READY',
        queryable: true,
        mainIndex: {
          status: 'READY',
          queryable: true,
          definitionVersion: {
            version: 0,
            createdAt: ISODate("2023-10-09T14:19:16.000Z")
          },
          definition: {
            mappings: {
              dynamic: true,
              fields: {
                fullplot: {
                  type: 'string',
                  indexOptions: 'offsets',
                  store: true,
                  norms: 'include'
                }
              }
            },
            synonyms: [
              {
                name: 'synonym_mapping',
                analyzer: 'lucene.english',
                source: { collection: 'synonyms' }
              }
            ]
          },
          synonymMappingStatus: 'READY',
          synonymMappingStatusDetail: [
            {
              synonym_mapping: {
                status: 'READY',
                queryable: true
              }
            }
          ]
        }
      },
      {
        hostname: 'atlas-n1cm1j-shard-00-00',
        status: 'READY',
        queryable: true,
        mainIndex: {
          status: 'READY',
          queryable: true,
          definitionVersion: {
            version: 0,
            createdAt: ISODate("2023-10-09T14:19:16.000Z")
          },
          definition: {
            mappings: {
              dynamic: true,
              fields: {
                fullplot: {
                  type: 'string',
                  indexOptions: 'offsets',
                  store: true,
                  norms: 'include'
                }
              }
            },
            synonyms: [
              {
                name: 'synonym_mapping',
                analyzer: 'lucene.english',
                source: { collection: 'synonyms' }
              }
            ]
          },
          synonymMappingStatus: 'READY',
          synonymMappingStatusDetail: [
            {
              synonym_mapping: {
                status: 'READY',
                queryable: true
              }
            }
          ]
        }
      }
    ]
  }
]

后退

db.collection.dropSearchIndex

来年

db. 集合.updateSearchIndex