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 para ejecutar consultas en un índice de Azure AI Search. Use esta herramienta para probar una consulta o una expresión de filtro o para 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

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

• Un servicio de Búsqueda de Azure AI. Cree un servicio o busque un servicio existente en la suscripción actual. Para este inicio rápido, puede usar un servicio gratuito.

• En este inicio rápido se usa el índice hotels-sample. Siga las instrucciones de este inicio rápido para crear el índice.

Inicio del Explorador de búsqueda

1. Inicie sesión en Azure Portal y seleccione el servicio de búsqueda.

2. En el panel izquierdo, seleccione Información general.

3. En la barra de comandos, seleccione Explorador de búsqueda.

   

   Como alternativa, seleccione la pestaña Explorador de búsqueda en la página de índice.

Consulta de tres maneras

Hay tres enfoques para consultar 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 booleanos, como ocean view + parking.

• La vista de imagen proporciona una ventana para examinar o arrastrar y colocar archivos PNG, JPG o JPEG. A menos que el índice tenga un vectorizador de imagen y una aptitud equivalente, esta vista no está disponible.

• 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.

  

Ejemplo: Consulta de imagen

El Explorador de búsqueda acepta imágenes como entradas de consulta a través de la vista Imagen, lo que requiere que use un par de aptitudes vectorizador compatible. Para obtener más información, vea Configurar un vectorizador en un índice de búsqueda.

El índice hotels-sample no está configurado para la vectorización de imágenes. Si desea ejecutar consultas de imagen, cree un índice como se describe en Inicio rápido: Búsqueda de vectores en Azure Portal. El inicio rápido se basa en datos de ejemplo basados en texto, por lo que debe usar documentos que contengan imágenes.

Para ejecutar una consulta de imagen, seleccione o arrastre una imagen al área de búsqueda y, a continuación, seleccione Buscar. El Explorador de búsqueda vectoriza la imagen y envía el vector al motor de búsqueda para la ejecución de consultas. El motor de búsqueda devuelve documentos que son lo suficientemente similares a la imagen de entrada, hasta el número especificado k de resultados.

Ejemplos: consultas JSON

A continuación se muestran ejemplos de consultas JSON que puede ejecutar mediante el Explorador de búsqueda. Para seguir estos ejemplos, cambie a la vista JSON. Puede pegar cada ejemplo JSON en el área de texto.

Ejecución de una consulta sin especificar

En el Explorador de búsqueda, las solicitudes POST se formulan internamente mediante Documentos: Búsqueda de registros (API de REST), con respuestas devueltas como documentos JSON detallados.

Para ver primero el contenido, ejecute una búsqueda vacía seleccionando Buscar sin términos proporcionados. 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, se devuelven 50 documentos por solicitud de búsqueda.

Agregue "count": true para obtener el número de coincidencias encontradas en un índice. En una búsqueda vacía, el recuento es el número total de documentos del í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, de forma predeterminada, las 50 principales coincidencias, por lo que el recuento podría indicar más coincidencias que hay en el índice que las que se devuelven en los resultados.

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

{
   "search": "*",
   "count": true
}

Resultados

Ejecución de una consulta de texto libre

La búsqueda de forma libre, con o sin operadores, es útil para simular consultas definidas por el usuario enviadas desde una aplicación personalizada a Azure AI Search. Solo se examinan los campos atribuidos como buscables en el índice para encontrar coincidencias.

No necesita la vista JSON para una consulta de texto libre, pero se proporciona 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": "activities `outdoor pool` restaurant OR continental breakfast"
}

Resultados

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

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

Agregue "select" para limitar los resultados a los campos con nombre explícito para obtener una salida más legible en el Explorador de búsqueda. Solo los campos que se atribuyen como recuperables en el índice pueden aparecer en los resultados.

{
   "search": "activities `outdoor pool` restaurant OR continental breakfast",
   "count": true,
   "select": "HotelId, HotelName, Tags, Description"
}

Resultados

Devolución del lote siguiente de resultados

Azure AI Search devuelve las 50 coincidencias principales en función del rango de búsqueda. El índice hotels-sample solo tiene 50 hoteles, por lo que usamos un número menor para ilustrar la paginación. Para obtener el siguiente conjunto de documentos coincidentes, anexe "top": 20 y "skip": 10 aumente el conjunto de resultados a 20 documentos (el valor predeterminado es 50, el máximo es 1000), omitiendo los primeros 10 documentos. Puede comprobar la clave del documento (HotelId) para identificar un documento.

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

{
   "search": "activities `outdoor pool` restaurant OR continental breakfast",
   "count": true,
   "select": "HotelId, HotelName, Tags, Description",
   "top": 20,
   "skip": 10
}

Resultados

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 clasificaciones superiores a cuatro:

{
    "search": "activities `outdoor pool` restaurant OR continental breakfast",
    "count": true,
    "select": "HotelId, HotelName, Tags, Description, Rating",
    "filter": "Rating gt 4"
}

Resultados

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. Esta es una expresión de ejemplo que puede usar para probar esto:

{
    "search": "activities `outdoor pool` restaurant OR continental breakfast",
    "count": true,
    "select": "HotelId, HotelName, Tags, Description, Rating, LastRenovationDate",
    "filter": "Rating gt 4",
    "orderby": "LastRenovationDate desc"
}

Resultados

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 de cada documento en su totalidad. El select parámetro de una expresión de consulta limita los campos que se devuelven.

• Los resultados de la búsqueda se componen de todos los campos que se atribuyen como recuperables en el índice. Seleccione la pestaña Campos para revisar los atributos.

• La búsqueda de palabras clave, similar a lo que puede escribir en un explorador web comercial, es útil para probar una experiencia del usuario final. Por ejemplo, tomando el índice hotels-sample, puede escribir "activities 'outdoor pool' restaurant OR continental breakfast", y, a continuación, usar Ctrl-F para buscar términos dentro de los resultados de 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 en una suscripción propia, al final de un proyecto es aconsejable identificar si todavía necesita 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.

En Azure Portal, puede encontrar y administrar recursos seleccionando Todos los recursos o grupos de recursos en el panel izquierdo.

Recuerde que un servicio de búsqueda gratuito está limitado a tres índices, tres indexadores y tres orígenes de datos. Para mantenerse bajo el límite, puede eliminar estos elementos individualmente en Azure Portal.

Paso siguiente

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 REST. Documentos - Búsqueda de publicaciones (API REST) es especialmente útil para el aprendizaje y la exploración.