Compartir vía


Inicio rápido: uso del Explorador de búsqueda para ejecutar consultas en Azure 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 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.

Sugerencia

El explorador de búsqueda ahora admite la búsqueda de imágenes. Inicio rápido: Búsqueda de imágenes en Azure Portal proporciona los pasos.

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.

    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:

    Captura de pantalla del comando del Explorador de búsqueda en el portal.

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

    Captura de pantalla de la pestaña del Explorador de búsqueda.

Dos formas de consulta

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

  • La vista de consulta proporciona una 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.

    Sugerencia

    La vista JSON proporciona IntelliSense para la finalización del nombre del parámetro. Coloque el cursor dentro de la vista JSON y escriba un carácter de espacio para mostrar una lista de todos los parámetros de consulta, o escriba una sola letra, como "s", para mostrar solo los parámetros de consulta que empiezan por "s". IntelliSense no excluye parámetros no válidos, por lo que debe seguir su mejor criterio.

    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.

    Captura de pantalla del selector de vistas de JSON.

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

Ejemplo de consulta vacía o incompleta

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.

Captura de pantalla de un 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.

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

Resultados

Captura de pantalla de un ejemplo de recuento.

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

Captura de pantalla de restricción de campos en el ejemplo de resultados de búsqueda.

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

Captura de pantalla de la devolución del siguiente lote de resultados de búsqueda.

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

Captura de pantalla de un ejemplo de filtro.

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

Captura de pantalla de un ejemplo de ordenación.

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.