OpenSearch ofrece un conjunto de cláusulas que controlan la forma en que se consultan, filtran, ordenan, agregan y exportan los resultados de búsqueda. Cada cláusula gestiona un aspecto específico del procesamiento de búsquedas y es posible combinarlas para construir soluciones eficientes y flexibles.
Descripción general de las funciones de las cláusulas
La cláusula de consulta es un componente obligatorio en cada instrucción de búsqueda. Esta cláusula especifica el campo de índice y el contenido que se va a buscar. Además, admite varias condiciones de consulta unidas mediante AND, OR, ANDNOT o RANK. Para obtener más información, consulte Index retrieval - query clause.
La cláusula de filtro evalúa los documentos con base en condiciones específicas. Su propósito es reducir los resultados obtenidos por la cláusula de consulta para generar el conjunto final. Para obtener más información, consulte Result filtering - filter clause.
Una búsqueda por palabra clave puede devolver miles de documentos, lo cual dificulta revisarlos todos. La cláusula de agregación permite agrupar los resultados y calcular estadísticas en su lugar. Para obtener más información, consulte Grouping and statistics - aggregate clause.
La cláusula distinct garantiza la diversidad de los resultados. Cuando varios documentos de un mismo usuario tienen puntuaciones de relevancia altas, estos pueden dominar los primeros lugares y ocupar una página completa. Dicha cláusula extrae los documentos por usuario para mostrar resultados de distintos usuarios. Para obtener más información, consulte Aggregation and diversification - distinct clause.
La cláusula de ordenamiento controla cómo se organizan los resultados. Para ello, establece el campo de ordenamiento y la dirección (ascendente o descendente). Para obtener más información, consulte Global sorting - sort clause.
La cláusula kvpairs define los parámetros de las partes variables de una expresión de ordenamiento. Esto permite pasar valores a funciones específicas dentro de una instrucción de búsqueda. Para obtener más información, consulte Custom parameter passing - kvpair clause.
La cláusula config establece la posición inicial de los resultados de búsqueda y la cantidad de resultados que se van a devolver. También define el formato de visualización y el número de documentos que se incluyen en la expresión de ordenamiento detallado. Para obtener más información, consulte Query pagination - config clause.
Los motores de búsqueda tradicionales limitan la cantidad de resultados devueltos; por ejemplo, un máximo de 5,000 documentos. Si necesita recuperar un volumen mayor de resultados para analizarlos, utilice el método scroll. Para obtener más información, consulte Batch export of documents - scroll method.