Todos los productos
Search

Este producto

    OpenSearch:Cláusula config

    Centro de documentos

    OpenSearch:Cláusula config

    Última actualización: Sep 04, 2026

    La cláusula config controla la paginación, el formato de respuesta y el alcance de clasificación de los resultados de búsqueda.

    Parámetros

    Parámetro

    Tipo

    Obligatorio

    Valor válido

    Predeterminado

    Descripción

    start

    INT

    No

    [0, 5000]

    0

    Desplazamiento del primer documento que se devuelve.

    hit

    INT

    No

    [0, 500]

    10

    Número máximo de documentos por conjunto de resultados.

    format

    STRING

    No

    JSON, fullJSON

    JSON

    Formato de respuesta. fullJSON incluye dos campos adicionales: variableValue y sortExprValues.

    rerank_size

    INT

    No

    [0, 2000]

    200

    Cantidad de documentos que se pasan a la expresión de clasificación fina.

    total_rank_size

    INT

    No

    —

    —

    Cantidad de documentos que se pasan a la expresión de clasificación preliminar.

    default_operator

    STRING

    No

    AND, OR

    AND

    Operador de consulta predeterminado. Solo es compatible con instancias exclusivas.

    Notas de uso

    1. La cláusula config es opcional.

    2. Separe los pares clave-valor con comas (,). Separe cada clave y valor con dos puntos (:).

    3. La suma de start y hit no debe exceder 5,000. Las consultas que superan este límite devuelven un error sin resultados. Este límite existe porque recuperar ventanas de resultados profundas requiere cargar todos los documentos anteriores en memoria, lo que aumenta significativamente el uso de recursos. Para paginar más allá de 5,000 documentos, utilice una scroll search.

    4. default_operator solo es compatible con instancias exclusivas.

    5. total_rank_size utiliza una sintaxis diferente según su SDK:

      • Java SDK: config.addToCustomConfig("total_rank_size:200000");

      • PHP SDK: $params->setCustomConfig('total_rank_size', 200000);

    6. Para incluir detalles de ordenamiento en la respuesta, agregue format:fulljson a la cláusula config. El campo sortExprValues en la respuesta es una matriz de valores de campo de ordenamiento correspondientes a la cláusula de ordenamiento. Por ejemplo, con sort=-price;-RANK, sortExprValues devuelve [price, Document score]. Si no se configura ninguna cláusula de ordenamiento, sortExprValues devuelve la puntuación del documento de forma predeterminada.

    Formato de respuesta: JSON vs fullJSON

    Campo

    JSON

    fullJSON

    Campos de resultado estándar

    Sí

    Sí

    variableValue

    —

    Sí

    sortExprValues

    —

    Sí

    Utilice fullJSON cuando necesite inspeccionar las puntuaciones de ordenamiento por documento o los valores de expresiones variables; por ejemplo, al depurar el comportamiento de clasificación.

    Ejemplos

    Paginar resultados: 20 documentos por página

    # Page 1
config=start:0, hit:20, format:xml

# Page 2
config=start:20, hit:20, format:xml
    El documento fuente utiliza format:xml en este ejemplo de paginación. Sin embargo, la tabla de parámetros solo lista JSON y fullJSON como valores de formato compatibles. Esta inconsistencia existe en la fuente original y está marcada para revisión por parte del equipo de producto.

    Establezca el pool de candidatos de clasificación fina en 1,000 documentos

    config=start:0, hit:20, rerank_size:1000

    Limitar la clasificación preliminar a 100 documentos

    config=start:0, hit:20, total_rank_size:100

    Pasos siguientes