Inicio rápido: uso del Explorador de búsqueda para ejecutar consultas en Azure Portal

  • Artículo

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 AI Search. Úselo para probar una consulta o una expresión de filtro o confirmar si el contenido existe en el índice.

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 Azure AI 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 integrados y recorra los pasos del asistente utilizando todos los valores predeterminados.

    Screenshot of the sample data sets available in the Import data wizard.

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:

    Screenshot of the Search explorer command in portal.

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

    Screenshot of the Search explorer tab.

Dos formas de consulta

Hay dos enfoques para realizar consultas en el Explorador de búsqueda.

  • La barra de búsqueda predeterminada acepta una consulta vacía o una consulta de texto libre con valores booleanos. Por ejemplo, seattle condo +parking.

  • La vista JSON admite consultas con parámetros. Los filtros, orderby, select, count, searchFields y todos los demás parámetros deben establecerse en la vista JSON.

    Cambie a Vista JSON para las consultas con parámetros. En los ejemplos de este artículo se supone que Vista JSON está seleccionada. Puede pegar ejemplos JSON de este artículo en el área de texto.

    Screenshot of the JSON view selector.

Ejecución de una consulta sin especificar

En el Explorador de búsqueda las solicitudes POST se formulan internamente 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 puntuació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

Unqualified or empty query example

Búsqueda de texto libre

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

No necesita la vista JSON para una consulta de texto libre, pero se ofrece en JSON para mantener la coherencia con otros ejemplos de este artículo.

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.

{
    "search": "Seattle townhouse `Lake Washington` miele OR thermador appliance"
}

Resultados

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

Screenshot of a free text query example.

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.

{
    "search": "Seattle townhouse `Lake Washington` miele OR thermador appliance",
    "count": true
}

Resultados

Screenshot of a count example.

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. Solo los campos marcados como "recuperables" en el índice de búsqueda pueden aparecer en los resultados.

{
   "search": "seattle condo",
   "count": true,
   "select": "listingId, beds, baths, description, street, city, price"
}

Resultados

Screenshot of restrict fields in search results example.

Devolución del lote siguiente de resultados

Azure 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 y "skip": 50 para aumentar el conjunto de resultados a 100 documentos (el valor predeterminado es 50, el máximo es 1000), lo que omite 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",
   "count": true,
   "select": "listingId, beds, baths, description, street, city, price",
   "top": 100,
   "skip": 50
}

Resultados

Screenshot of returning next batch of search results example.

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

Use el parámetro filter para especificar los criterios de inclusión o exclusión. El campo se debe atribuir como "filtrable" en el índice. En este ejemplo se buscan más de tres dormitorios:

{
    "search": "seattle condo",
    "count": true,
    "select": "listingId, beds, baths, description",
    "filter": "beds gt 3"
}

Resultados

Screenshot of a filter example.

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. En situaciones en las que el valor filtrado es idéntico (por ejemplo, el mismo precio), el orden es arbitrario, pero puede agregar más criterios para una ordenación más profunda. Una expresión de ejemplo que puede usar para probar este caso es:

{
    "search": "seattle condo",
    "count": true,
    "select": "listingId, price, beds, baths, description",
    "filter": "beds gt 3",
    "orderby": "price asc"
}

Resultados

Screenshot of a sorting example.

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 "recuperables" en el índice. Seleccione la pestaña adyacente Campos para revisar los atributos.

  • 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 AI 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, se recomienda 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 de consulta y la sintaxis, use un cliente REST para crear expresiones de consulta que usen más partes de la API. La API REST de Search con POST es especialmente útil para el aprendizaje y la exploración.

Creación de una consulta básica en REST