MongoDB\Collection::createSearchIndexes()

Definición

MongoDB\Collection::createSearchIndexes()

Cree uno o más índices de búsqueda MongoDB o de búsqueda vectorial para la colección.

function createSearchIndexes(
    array $indexes,
    array $options = []
): string

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

$indexes : arreglo

Matriz de documentos que describen los índices a crear.

Un campo de documento obligatorio definition describe el índice que se va a crear. Para obtener detalles sobre la sintaxis de definición, consulta Sintaxis de Definición de Índice de Búsqueda.

Un campo de cadena opcional name especifica el nombre del índice de búsqueda que se creará. No se pueden crear varios índices con el mismo nombre en una misma colección. Si no se especifica un nombre, el nombre predeterminado del índice es default.

Un campo de string type opcional especifica el tipo de índice de búsqueda que se debe crear. Los valores aceptados son 'search' y 'vectorSearch'. Si no especificas un tipo, el método crea un índice de búsqueda en MongoDB Search.

$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.

Return Values

Los nombres de los índices de búsqueda MongoDB y búsqueda vectorial creados como una matriz de cadenas.

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.

Ejemplos

<?php
$collection = (new MongoDB\Client)->selectCollection('test', 'articles');
$indexNames = $collection->createSearchIndexes(
    [
        [
            'name' => 'test-search-index',
            'definition' => ['mappings' => ['dynamic' => true]],
        ],
    ]
);
var_dump($indexNames);

array(1) {
  [0]=>
  string(17) "test-search-index"
}

Ver también

• MongoDB\Collection::createSearchIndex()

• MongoDB\Collection::dropSearchIndex()

• MongoDB\Collection::listSearchIndexes()

• MongoDB\Collection::updateSearchIndex()

• Guía de Índices de búsqueda de MongoDB

• Referencia del comando createSearchIndexes en el manual de MongoDB

• MongoDB Search documentación en el Manual de MongoDB