MongoDB\Collection::updateSearchIndex()

Definición

MongoDB\Collection::updateSearchIndex()

Actualice un índice de búsqueda de MongoDB para la colección.

function updateSearchIndex(
    string $name,
    array|object $definition,
    array $options = []
): void

Este comando solo se puede ejecutar en una implementación alojada en MongoDB Atlas y requiere un nivel de clúster Atlas de al menos M10. Una implementación local de Atlas también puede usarse para el desarrollo.

Parámetros

$name : string

Nombre del índice a actualizar.

$definition : arreglo|objeto

Documento que describe la definición actualizada del índice de búsqueda. La definición especificada reemplaza a la definición anterior en el índice de búsqueda. Para obtener detalles sobre la sintaxis de definición, consulta Sintaxis de definición del índice de búsqueda.

$options : arreglo

Una matriz que especifica las opciones deseadas.

Nombre	Tipo	Descripción
comment	mixto	Permite a los usuarios especificar un comentario arbitrario para ayudar a rastrear la operación a través del generador de perfiles de base de datos, la salidacurrentOp y los registros.

Errores/Excepciones

MongoDB\Exception\UnsupportedException si se utilizan opciones que no son compatibles con el servidor seleccionado (porcollation readConcernwriteConcernejemplo,,,).

MongoDB\Exception\InvalidArgumentException por errores relacionados con el análisis de parámetros u opciones.

MongoDB\Driver\Exception\RuntimeException para otros errores a nivel de extensión (por ejemplo, errores de conexión).

Comportamiento

Los índices de MongoDB Search y Vector Search se gestionan de forma asíncrona. Después de crear o actualizar un índice, puedes ejecutar periódicamente y comprobar MongoDB\Collection::listSearchIndexes() el queryable campo de salida para determinar si está listo para usarse.

Ver también

• MongoDB\Collection::createSearchIndex()

• MongoDB\Collection::createSearchIndexes()

• MongoDB\Collection::dropSearchIndex()

• MongoDB\Collection::listSearchIndexes()

• Referencia del comandoupdateSearchIndex en el manual de MongoDB

• MongoDB Search documentación en el Manual de MongoDB