MongoDB\Collection::updateSearchIndex()
1.17 版本中的新增功能。
定义
MongoDB\Collection::updateSearchIndex()
更新collection的 Atlas Search 搜索索引。
function updateSearchIndex( string $name, array|object $definition, array $options = [] ): void 此命令只能在托管在 MongoDB Atlas上的部署上运行,并且需要至少 M 10的 Atlas 集群层。 本地 Atlas 部署也可用于开发。
参数
$name
: 细绳- 要更新的索引的名称。
$definition
: array|object- 描述更新的Atlas Search索引定义的文档。 指定的定义会替换Atlas Search索引中先前的定义。 有关定义语法的详细信息,请参阅Atlas Search索引定义语法。
$options
: array指定所需选项的数组。
错误/异常
MongoDB\Exception\UnsupportedException
,如果所选服务器使用了选项但不支持选项(例如collation
、readConcern
、writeConcern
)。
MongoDB\Exception\InvalidArgumentException
用于与参数或选项解析相关的错误。
MongoDB\ 驱动程序\Exception\RuntimeException 对于扩展级别的其他错误(例如连接错误)。
行为
Atlas Search索引是异步托管的。 创建或更新索引后,您可以定期执行MongoDB\Collection::listSearchIndexes()
并检查queryable
输出字段,以确定是否可以使用。