Todos los productos
Search
Centro de documentos

OpenSearch:Configuraciones de clústeres cuantizados

Última actualización: Sep 05, 2026

Configure el comportamiento del índice de clústeres cuantizados (QC) mediante dos grupos de parámetros: QcBuilder controla la construcción del índice y QcSearcher determina la ejecución de consultas en tiempo de ejecución.

  • Los parámetros de QcBuilder se establecen durante la construcción del índice y no pueden modificarse sin reconstruirlo.

  • Los parámetros de QcSearcher pueden ajustarse en cualquier momento sin necesidad de reconstruir el índice.

QcBuilder

Los parámetros de QcBuilder controlan el proceso de construcción del índice fuera de línea, incluido el volumen de datos de entrenamiento, el paralelismo, la estructura de clústeres y la cuantización.

Parámetro

Tipo

Predeterminado

Descripción

qc.builder.train_sample_count

uint32

0

Cantidad de documentos que se usan como datos de entrenamiento. Establezca este valor en 0 para usar todos los documentos como datos de entrenamiento.

qc.builder.thread_count

uint32

0

Cantidad de hilos que se usan durante la construcción del índice. Establezca este valor en 0 para usar todos los núcleos de CPU disponibles en la instancia de OpenSearch Vector Search Edition.

qc.builder.centroid_count

string

Opcional

Cantidad de centroides para la agrupación en clústeres. Deje este campo en blanco para permitir que el sistema infiera automáticamente una cantidad adecuada; esta opción se recomienda para la mayoría de los casos. Para configurarlo manualmente, use un número entero simple para un clúster de un solo nivel (por ejemplo, 1000) o separe los niveles con un asterisco (*) para clústeres jerárquicos (por ejemplo, 100*100). En los clústeres jerárquicos, configure una cantidad mayor de centroides en el primer nivel que en los siguientes: el primer nivel aporta 10 veces más puntos de datos al entrenamiento que cada nivel posterior, por lo que una mayor cantidad de centroides en el primer nivel produce mejores resultados.

qc.builder.quantizer_class

string

Ninguna

Cuantizador que se usa para comprimir los datos del índice. Omita este parámetro para omitir la cuantización. Valores válidos: Int8QuantizerConverter, HalfFloatConverter, DoubleBitConverter. Un cuantizador suele reducir el tamaño del índice y mejorar la velocidad de consulta, pero puede disminuir la precisión de recuperación. Si su caso de uso requiere una alta tasa de recuperación, evalúe la calidad de los resultados antes de utilizar este parámetro en producción.

qc.builder.quantize_by_centroid

bool

false

Especifica si se debe realizar la cuantización basada en centroides. Solo surte efecto cuando qc.builder.quantizer_class está establecido en Int8QuantizerConverter.

QcSearcher

Los parámetros de QcSearcher controlan el comportamiento durante las consultas y pueden actualizarse sin reconstruir el índice.

Parámetro

Tipo

Predeterminado

Descripción

qc.searcher.scan_ratio

float

0.01

Fracción del total de documentos que se examinan durante una consulta. Determina max_scan_num mediante la fórmula: max_scan_num = total documents × scan_ratio.

qc.searcher.brute_force_threshold

int

1000

Cantidad de documentos por debajo de la cual el índice recurre a la búsqueda por fuerza bruta en lugar de la búsqueda aproximada del vecino más cercano.