$listSearchIndexes (aggregation)

項目一覧

定義
構文
コマンドフィールド
アクセス制御
出力
Index Status Details
Synonym Mapping Details
Atlas Search Index Statuses
Errors
例
Return All Search Indexes
Return a Single Search Index by Name
Return a Single Search Index by id
詳細

定義

$listSearchIndexes

バージョン 7.0 で追加: (6.0.7 以降でも使用可能)

指定されたコレクションの既存のAtlas Search インデックスに関する情報を返します。

重要

このコマンドは、 MongoDB Atlasでホストされている配置でのみ実行でき、サーバーレスインスタンスではサポートされていません。

構文

コマンド構文:

db.<collection>.aggregate(
   [
      {
         $listSearchIndexes:
            {
               id: <indexId>,
               name: <indexName>
            }
      }
   ]
)

コマンドフィールド

$listSearchIndexes takes either of the following fields:

フィールド	タイプ	必要性	説明
`id`	string	任意	The id of the index to return information about.
`name`	string	任意	The name of the index to return information about.

You cannot specify both id and name. If you omit both the id and name fields, $listSearchIndexes returns information about all Atlas Search indexes on the collection.

アクセス制御

配置でアクセス制御を適用する場合、 $listSearchIndexesを実行しているユーザーは、データベースまたはコレクションに対するlistSearchIndexes特権アクションを持っている必要があります。

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

The built-in read role provides the the listSearchIndexes privilege. The following example grants the read role on the qa database:

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

出力

$listSearchIndexes returns an array of documents. Each document in the array contains the following fields:

フィールド	タイプ	説明
`id`	string	Unique identifier for the index.
`name`	string	Name of the index.
`status`	string	Status of the index. For more information, see Atlas Search Index Statuses.
`queryable`	ブール値	Indicates whether the index is ready to be queried.
`latestDefinitionVersion`	ドキュメント	Describes the version of the index.
`latestDefinitionVersion.version`	integer	Version number associated with the index definition. When you update an index definition, the version number increments automatically.
`latestDefinitionVersion.createdAt`	date	Time when the current index definition was created.
`latestDefinition`	ドキュメント	The most recent definition for the index. For more information, see 検索インデックス定義構文.
`statusDetail`	ドキュメントの配列	Contains the status of the index on each search host (`mongot`).
`statusDetail.[n].hostname`	string	Hostname of the corresponding `mongot`.
`statusDetail.[n].status`	string	Status of the index on the corresponding `mongot`.
`statusDetail.[n].queryable`	ブール値	Indicates whether the index is ready to be queried on the corresponding `mongot`.
`statusDetail.[n].mainIndex`	ドキュメント	Contains status information about the active index on the corresponding `mongot`. For details, see Index Status Details.
`statusDetail.[n].stagedIndex`	ドキュメント	Contains status information about an index being built in the background on the corresponding `mongot`. This field only appears if you are building a new index to update an existing active index. For details, see Index Status Details.
`synonymMappingStatus`	string	Status of the index's synonym mappings. This field only appears if the index has synonyms defined. Can be one of the following values: `BUILDING` `FAILED` `READY` The returned status is a summary of the synonym mappings on each individual `mongot`.
`synonymMappingStatusDetail`	ドキュメントの配列	Contains the status of the index's synonym mappings on each search host (`mongot`). This field (and its subfields) only appear if the index has synonyms defined.
`synonymMappingStatusDetail.[n].status`	string	Status for the corresponding synonym mapping across all `mongot` processes.
`synonymMappingStatusDetail.[n].queryable`	ブール値	Indicates whether the corresponding synonym mapping can support queries across all `mongot` processes.
`message`	string	Describes an error for the synonym mapping, if applicable. Only appears if the `status` for this synonym mapping is `FAILED`.

Index Status Details

The following table describes the embedded fields of the following documents: - statusDetail.[mongot].mainIndex - statusDetail.[mongot].stagedIndex

The fields describe the index status on a specific mongot.

フィールド	タイプ	説明
`status`	string	The state of the index generation on the corresponding `mongot`.
`queryable`	ブール値	Indicates whether the index generation is ready to be queried on the corresponding `mongot`.
`synonymMappingStatus`	string	The state of the index generation's synonym mappings on the corresponding `mongot`. Only present if the index has synonyms defined.
`synonymMappingStatusDetails`	ドキュメント	Contains the status of the index's synonym mappings on the corresponding `mongot`. This field (and its subfields) only appear if the index has synonyms defined. For more information, see Synonym Mapping Details.
`definitionVersion`	ドキュメント	Describes the index definition version that this index generation is being built with.
`definitionVersion.version`	integer	Version number that the index generation is using on the corresponding `mongot`. When you update an index definition, the updated index builds with an incremented version number.
`definitionVersion.createdAt`	date	Time when the index definition was created.
`definition`	ドキュメント	The definition that this index is being built with.

Synonym Mapping Details

The following table describes the embedded fields of the following objects:

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

フィールド	タイプ	説明
`status`	string	Status for the synonym mapping across on the corresponding `mongot` process.
`queryable`	ブール値	Indicates whether the synonym mapping can support queries on the corresponding `mongot` process.
`message`	string	Describes an error for the synonym mapping, if applicable. Only appears if the `status` for this synonym mapping is `FAILED`.

Atlas Search Index Statuses

The status field in the $listSearchIndexes output can be one of the following:

Status	説明
`BUILDING`	The following scenarios can cause an index to be in the `BUILDING` state: Atlas is building the index or re-building the index after an edit. Atlas Search cannot keep up with indexing changes to the collection. In this case, Atlas rebuilds the index in the background. When the index is in the `BUILDING` state: For a new index, Atlas Search cannot use the index for queries until the index build is complete. For an existing index, Atlas Search uses the old index definition for queries until the index rebuild is complete. An index in the `BUILDING` state may be queryable or non-queryable.
`DOES_NOT_EXIST`	The index does not exist. An index in the `DOES_NOT_EXIST` state is always non-queryable.
`DELETING`	Atlas is deleting the index. An index in the `DELETING` state is always non-queryable.
`FAILED`	The index build failed. Indexes can enter the `FAILED` state due to an invalid index definition. An index in the `FAILED` state may be queryable or non-queryable.
`PENDING`	Atlas has not yet started building the index. An index in the `PENDING` state is always non-queryable.
`READY`	The index is ready and can support queries. An index in the `READY` state is always queryable.
`STALE`	The index is queryable but has stopped replicating data from the indexed collection. Searches on the index may return out-of-date data. Indexes can enter the `STALE` state due to replication errors. An index in the `STALE` state is always queryable.

Errors

Changed in version 7.1: This command throws an error when not executed on Atlas.

db.names.aggregate( [
   { $listSearchIndexes: { } }
] )

MongoServerError: PlanExecutor error during aggregation :: caused by :: Search index commands are only supported with Atlas.

In previous releases, this command returns an empty result when not executed on Atlas.

例

These examples demonstrate how to:

Return All Search Indexes
Return a Single Search Index by Name
Return a Single Search Index by id

Return All Search Indexes

The following example returns all Atlas Search indexes on the movies collection:

db.movies.aggregate(
   [
      {
         $listSearchIndexes: { }
      }
   ]
)

Sample output:

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

Return a Single Search Index by Name

The following example returns the index named synonym-mappings on the movies collection:

db.movies.aggregate(
   [
      {
         $listSearchIndexes:
            {
               name: "synonym-mappings"
            }
      }
   ]
)

Sample output:

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

Return a Single Search Index by id

The following example returns the search index with the provided id:

db.movies.aggregate(
   [
      {
         $listSearchIndexes:
            {
               id: "6524096020da840844a4c4a7"
            }
      }
   ]
)

Sample output:

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

詳細

To use a mongosh method to view Atlas Search indexes, see db.collection.getSearchIndexes().

To create Atlas Search indexes, see:

The db.collection.createSearchIndex() mongosh method
The createSearchIndexes database command

戻る

$listSampledQueries

$listSessions