Todos los productos
Search
Centro de documentos

OpenSearch:Campos de visualización predeterminados

Última actualización: Sep 04, 2026

Configure los campos de visualización predeterminados para especificar qué campos del esquema de la aplicación deben recuperarse y devolverse en cada solicitud de búsqueda. Use el parámetro fetch_fields para indicar únicamente los campos que su aplicación necesita mostrar.

Funcionamiento

Dos niveles de configuración determinan qué campos se devuelven:

Nivel

Cuándo aplica

Valor predeterminado de la consola

No se pasa ningún valor de fetch_fields en la solicitud

fetch_fields de SDK/API

Se pasa un valor durante la consulta; anula el valor predeterminado de la consola

Configurar campos de visualización predeterminados en la consola

  1. Inicie sesión en la consola de OpenSearch. En el panel de navegación izquierdo, elija Feature Extensions > Search Result Display.

  2. En la sección Default Display Fields, agregue los campos que desea devolver.

    En la sección Default Display Fields, haga clic en el icono de edición al final de la lista de campos para agregar o modificar los campos de visualización.

Si aún no ha establecido un valor predeterminado en la consola, también puede agregar campos de visualización durante una prueba de búsqueda de una aplicación.

Nota: Separe varios valores de campo con puntos y coma (;) .

En la página de prueba de búsqueda, dentro del área de parámetros, use el parámetro fetch_fields para especificar los campos que se devolverán. Por ejemplo, fetch_fields=buy,cate_id,title devuelve únicamente los campos buy, cate_id y title.

Anular campos de visualización durante la consulta

Pasar fetch_fields en una llamada de SDK o en una solicitud de API anula el valor predeterminado de la consola para esa solicitud. Especifique solo los campos que su cliente necesita, ya que el tamaño de los datos de texto devueltos afecta significativamente el rendimiento de la búsqueda.

Parámetros de API: Consulte Initiate search requests para conocer cómo usar el parámetro fetch_fields en las llamadas a la API.

SDK para Java: A continuación se muestra un ejemplo que especifica los campos que se devolverán.

// Specify the fields to return in search results.
config.setFetchFields(Lists.newArrayList("id", "name", "phone", "int_arr", "literal_arr", "float_arr", "cate_id"));

Límites

Escenarios JOIN de varias tablas: Los campos de clave principal en tablas secundarias no pueden configurarse como campos de visualización predeterminados. Para incluir valores de clave principal de tablas secundarias en los resultados de búsqueda, use los campos asociados de la tabla principal.

Por ejemplo, si la tabla principal p_table tiene la clave principal id y la tabla secundaria s_table_1 tiene la clave principal id_1, especificar fetch_fields=id_1 en una prueba de búsqueda no devolverá el valor de la clave principal de la tabla secundaria. Especificar fetch_fields=id (el campo asociado en la tabla principal) sí devuelve los resultados esperados.