Inicio rápido: Uso del Explorador de búsqueda para ejecutar consultas en el portal

En este inicio rápido, aprenderá a usar el Explorador de búsqueda, una herramienta de consulta integrada en Azure Portal que se usa para ejecutar consultas en un índice de búsqueda en Azure Cognitive Search. Esta herramienta facilita aprender la sintaxis de las consultas, probar una expresión de consulta o filtro, o verificar si existe contenido nuevo en el índice para confirmar la actualización de datos.

En esta guía de inicio rápido se usa un índice existente para hacer una demostración del Explorador de búsqueda.

Requisitos previos

Antes de comenzar, tiene que cumplir los siguientes requisitos previos:

  • Una cuenta de Azure con una suscripción activa. Cree una cuenta gratuita.

  • Un servicio de Azure Cognitive Search. Cree un servicio o busque uno existente en su suscripción actual. Puede usar un servicio gratuito para este inicio rápido.

  • En esta guía de inicio rápido se usa realestate-us-sample-index. Para crear el índice, use el Asistente para importación de datos, elija los datos de ejemplo y recorra los pasos del asistente utilizando todos los valores predeterminados.

    Captura de pantalla de los conjuntos de datos de ejemplo disponibles en el Asistente para importación de datos.

Inicio del Explorador de búsqueda

  1. En Azure Portal, abra la página del información general de búsqueda desde el panel o busque el servicio.

  2. Abra el Explorador de búsqueda desde la barra de comandos:

    Comando del Explorador de búsqueda en el portal

    O bien, use la pestaña Explorador de búsqueda insertada en un índice abierto:

    Pestaña Explorador de búsqueda

Consulta sin especificar

En el Explorador de búsqueda las solicitudes se formulan mediante la API REST de Search, donde las respuestas se devuelven como documentos JSON detallados.

Para un echar un primer vistazo al contenido, ejecute una búsqueda vacía haciendo clic en Buscar sin especificar ningún término. Una búsqueda vacía resulta útil como primera consulta porque devuelve documentos completos para que pueda revisar la composición del documento. En una búsqueda vacía, no hay ninguna clasificación de búsqueda y los documentos se devuelven en orden arbitrario ("@search.score": 1 para todos los documentos). De forma predeterminada, en una solicitud de búsqueda se devuelven 50 documentos.

La sintaxis equivalente para una búsqueda vacía es * o search=*.

search=*

Resultados

Ejemplo de consulta vacía o incompleta

Las consultas de forma libre, con o sin operadores, resultan útiles para simular consultas definidas por el usuario enviadas desde una aplicación personalizada a Azure Cognitive Search. Solo se examinan las coincidencias de los campos atribuidos como Buscable en la definición del índice.

Tenga en cuenta que, al proporcionar criterios de búsqueda, como expresiones o términos de consulta, entra en juego la clasificación de búsqueda. El ejemplo siguiente ilustra una búsqueda de texto libre. "@search.score" es una puntuación de relevancia calculada para la coincidencia con el algoritmo de puntuación predeterminado.

Seattle apartment "Lake Washington" miele OR thermador appliance

Resultados

Puede usar Ctrl-F para buscar términos específicos de interés en los resultados.

Ejemplo de consulta de texto libre

Recuento de documentos coincidentes

Agregue $count=true para obtener el número de coincidencias encontradas en un índice. En una búsqueda vacía, el recuento corresponde al número total de documentos en el índice. En una búsqueda completa, corresponde al número de documentos que coinciden con la entrada de la consulta. Recuerde que el servicio devuelve las 50 coincidencias principales de forma predeterminada, por lo que es posible que tenga más coincidencias en el índice de lo que se incluye en los resultados.

$count=true

Resultados

Número de documentos coincidentes en el índice

Limitación de campos en los resultados de la búsqueda

Agregue $select para limitar los resultados a los campos designados de manera explícita para obtener una salida más legible en el Explorador de búsqueda. Para mantener los parámetros mencionados anteriormente en la consulta, use & para separar cada parámetro.

search=seattle condo&$select=listingId,beds,baths,description,street,city,price&$count=true

Resultados

Restricción de campos en los resultados de la búsqueda

Devolución del lote siguiente de resultados

Azure Cognitive Search devuelve las primeras 50 coincidencias en función de la clasificación de búsqueda. Para obtener el siguiente conjunto de documentos coincidentes, anexe $top=100,&$skip=50 para aumentar el conjunto de resultados a 100 documentos (el valor predeterminado es 50, el máximo es 1000) y omitir los primeros 50 documentos. Puede comprobar la clave del documento (listingID) para identificar el documento.

Recuerde que debe proporcionar criterios de búsqueda, como una expresión o un término de consulta, para obtener los resultados clasificados. Tenga en cuenta que las puntuaciones de búsqueda disminuyen cuanto más profundamente se llega en los resultados de la búsqueda.

search=seattle condo&$select=listingId,beds,baths,description,street,city,price&$count=true&$top=100&$skip=50

Resultados

Devolución del lote siguiente de los resultados de búsqueda

Expresiones de filtro (mayor que, menor que, igual a)

Utilice el parámetro $filter cuando quiera especificar criterios precisos en lugar de búsqueda de texto libre. El campo se debe atribuir como Filtrable en el índice. En este ejemplo se buscan más de tres dormitorios:

search=seattle condo&$filter=beds gt 3&$count=true

Resultados

Filtrar por criterios

Ordenar resultados

Agregue $orderby para ordenar los resultados por otro campo además de la puntuación de búsqueda. El campo se debe atribuir como Ordenable en el índice. Una expresión de ejemplo que puede usar para probar este caso es:

search=seattle condo&$select=listingId,beds,price&$filter=beds gt 3&$count=true&$orderby=price asc

Resultados

Cambio del criterio de ordenación

Ambas expresiones, $filter y $orderby son construcciones de OData. Para más información, consulte la sintaxis de filtro de OData.

Puntos clave

En esta guía de inicio rápido, ha usado el Explorador de búsqueda para consultar un índice mediante la API de REST.

  • Los resultados se devuelven como documentos JSON detallados para que pueda ver la construcción y el contenido del documento en su totalidad. El parámetro $select de una expresión de consulta puede limitar los campos que se devuelven.

  • Los resultados de la búsqueda se componen de todos los campos marcados como Recuperable en el índice. Para ver los atributos de campo en el portal, seleccione realestate-us-sample en la lista Índices de la página de información general de búsqueda y, luego, abra la pestaña Campos.

  • Las consultas por palabra clave, similares a las que se pueden escribir en un explorador web comercial, resultan útiles para probar una experiencia de usuario final. Por ejemplo, si partimos del índice realestate de ejemplo integrado, podría escribir "Apartamentos Seattle Lake Washington" y luego usar Ctrl-F para buscar términos dentro de los resultados de la búsqueda.

  • Las expresiones de consulta y de filtro se articulan en una sintaxis implementada por Azure Cognitive Search. El valor predeterminado es una sintaxis simple, pero también puede usar la sintaxis de Lucene completa para realizar consultas más eficaces. Las expresiones de filtro se articulan en la sintaxis de OData.

Limpieza de recursos

Cuando trabaje con su propia suscripción, es una buena idea al final de un proyecto identificar si todavía se necesitan los recursos que ha creado. Los recursos que se dejan en ejecución pueden costarle mucho dinero. Puede eliminar los recursos de forma individual o eliminar el grupo de recursos para eliminar todo el conjunto de recursos.

Puede encontrar y administrar recursos en el portal, mediante el vínculo Todos los recursos o Grupos de recursos en el panel de navegación izquierdo.

Si está usando un servicio gratuito, recuerde que está limitado a tres índices, indexadores y orígenes de datos. Puede eliminar elementos individuales en el portal para mantenerse por debajo del límite.

Pasos siguientes

Para más información sobre las estructuras y la sintaxis de consulta, use Postman o una herramienta equivalente para crear expresiones de consulta que usen más partes de la API. La API de REST de Search es especialmente útil para el aprendizaje y la exploración.