Rövid útmutató: Lekérdezések futtatása a Kereséskezelővel a Azure portálon

Ebben a rövid útmutatóban megtudhatja, hogyan használhatja a Search Explorer, a Azure portál beépített lekérdezési eszközét a lekérdezések Azure AI Keresés indexen való futtatásához. Ezzel az eszközzel tesztelhet egy lekérdezést vagy szűrőkifejezést, vagy ellenőrizheti, hogy létezik-e tartalom az indexben.

Ez a rövid útmutató egy meglévő index használatával mutatja be a Keresőböngészőt.

Előfeltételek

• Aktív előfizetéssel rendelkező Azure fiók. Hozzon létre egy fiókot ingyenesen.

• Egy Azure AI Keresés szolgáltatás. Szolgáltatás létrehozása vagy meglévő szolgáltatás definiálása az aktuális előfizetésben. Ebben a rövid útmutatóban ingyenes szolgáltatást használhat.

• Ez a rövid útmutató a szállodai mintaindexet használja. Az index létrehozásához kövesse az ebben a rövid útmutatóban található utasításokat.

Kereséskezelő indítása

1. Nyissa meg a keresőszolgáltatást a Azure portálon.

2. A bal oldali panelen válassza az Áttekintés lehetőséget.

3. A parancssávon válassza a Kereséskezelő lehetőséget.

   

   Másik lehetőségként válassza a Kereséskezelő lapot az indexlapon.

Lekérdezés háromféleképpen

A Lekérdezéskezelőben háromféleképpen kérdezhet le:

• A Lekérdezés nézet egy alapértelmezett keresősávot biztosít. Egy üres vagy szabad szöveges kifejezést fogad logikai operátorokkal, például ocean view + parking.

• A képnézet egy PNG-, JPG- vagy JPEG-fájl tallózására vagy húzására szolgáló ablakot biztosít. Ez a nézet csak akkor érhető el, ha az index képvektorral és azzal egyenértékű képességgel rendelkezik.

• A JSON-nézet támogatja a paraméteres lekérdezéseket. A szűrőket, az orderbyt, a kiválasztást, a darabszámot, a searchFieldset és az összes többi paramétert JSON nézetben kell beállítani.

  

Példa: Kép lekérdezése

A Keresőböngésző a Képek nézetben fogadja el a képeket lekérdezési bemenetként, amelyhez egy támogatott vektorizáló–képességpárt kell használnia. További információ: Vektorizáló konfigurálása keresési indexben.

A szállodai mintaindex nincs képvektorizálásra konfigurálva. Ha képlekérdezéseket szeretne futtatni, hozzon létre egy indexet a Gyorsútmutató: Vektorkeresés az Azure portálon című részben leírtak szerint. A rövid útmutató szövegalapú mintaadatokra támaszkodik, ezért képeket tartalmazó dokumentumokat kell használnia.

Kép lekérdezés futtatásához jelöljön ki vagy húzzon egy képet a keresési területre, majd válassza a Keresés lehetőséget. A Keresőböngésző vektorizálja a képet, és elküldi a vektort a keresőmotornak a lekérdezés végrehajtásához. A keresőmotor a bemeneti képhez megfelelően hasonló dokumentumokat ad vissza a megadott k számú találatig.

Példák: JSON-lekérdezések

Az alábbiakban olyan JSON-lekérdezéseket mutatunk be, amelyeket a Kereséskezelővel futtathat. Az alábbi példák követéséhez váltson JSON-nézetre. Minden JSON-példát beilleszthet a szövegterületre.

Meghatározatlan lekérdezés futtatása

A Kereséskezelőben a POST-kérések belsőleg a Dokumentumok – Search Post (REST API) használatával jönnek létre, és a válaszok részletes JSON-dokumentumokként jelennek meg.

Ha először meg szeretné tekinteni a tartalmat, futtass egy üres keresést úgy, hogy a Keresés elemet választja, és nincs megadva kifejezés. Az üres keresés első lekérdezésként hasznos, mert teljes dokumentumokat ad vissza, így áttekintheti a dokumentumösszeállítást. Üres keresés esetén nincs keresési pontszám, és a rendszer tetszőleges sorrendben adja vissza a dokumentumokat ("@search.score": 1 az összes dokumentum esetében). A rendszer alapértelmezés szerint keresési kérelemként 50 dokumentumot ad vissza.

Adja hozzá "count": true az indexben található egyezések számának lekéréséhez. Üres keresés esetén a szám az indexben lévő dokumentumok teljes száma. Minősített keresés esetén a lekérdezés bemenetének megfelelő dokumentumok száma. Ne feledje, hogy a szolgáltatás alapértelmezés szerint az első 50 találatot adja vissza, így a darabszám több egyezést jelezhet az indexben, mint amennyit az eredmények visszaadnak.

Az üres keresés egyenértékű szintaxisa a * vagy a "search": "*".

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

Eredmények

Szabadszöveges lekérdezés futtatása

Az ingyenes űrlapalapú keresés operátorokkal vagy anélkül hasznos lehet az egyéni alkalmazásból Azure AI Keresés küldött felhasználó által megadott lekérdezések szimulálásához. A rendszer csak az indexben kereshetőnek tulajdonított mezőket ellenőrzi.

Nincs szüksége a JSON nézetre egy szabadszöveges lekérdezéshez, de a jelen cikkben szereplő többi példával való konzisztenciáért JSON-ban biztosítjuk.

Figyelje meg, hogy ha keresési feltételeket, például lekérdezési kifejezéseket vagy kifejezéseket ad meg, a keresési rang is megjelenik. Az alábbi példa egy ingyenes szöveges keresést szemléltet. A @search.score a alapértelmezett pontozási algoritmussal kiszámított relevanciaérték az egyezéshez.

{
    "search": "activities `outdoor pool` restaurant OR continental breakfast"
}

Eredmények

A Ctrl-F használatával kereshet a találatok között adott érdeklődési körökre vonatkozóan.

Mezők korlátozása a keresési találatokban

Adja hozzá "select" , hogy a keresési böngészőben olvashatóbb kimenet érdekében a megadott mezőkre korlátozza az eredményeket. Az eredményekben csak az indexben lekérdezhetőként hozzárendelt mezők jelennek meg.

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

Eredmények

A következő eredményköteg visszaadása

Azure AI Keresés a keresési rangsor alapján adja vissza az 50 legjobb találatot. A szállodai mintaindex csak 50 szállodával rendelkezik, ezért kisebb számmal szemléltetjük a lapozást. Az egyező dokumentumok következő készletének lekéréséhez fűzze hozzá "top": 20 , és "skip": 10 az eredményhalmazt 20 dokumentumra növelje (alapértelmezés szerint 50, maximum 1000), kihagyva az első 10 dokumentumot. A dokumentum azonosításához ellenőrizze a dokumentumkulcsot (HotelId).

Ne feledje, hogy a rangsorolt eredmények eléréséhez meg kell adnia a keresési feltételeket, például egy lekérdezési kifejezést vagy kifejezést. A keresési pontszámok csökkennek, minél mélyebbre hatolsz a keresési eredmények között.

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

Eredmények

Szűrőkifejezések (nagyobb, kisebb, egyenlő)

A paraméter használatával adja meg a filter befogadási vagy kizárási feltételeket. A mezőt szűrhetőként kell hozzárendelni az indexhez. Ez a példa négynél nagyobb minősítéseket keres:

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

Eredmények

Találatok rendezése

A orderby keresési pontszám mellett egy másik mező alapján is rendezheti a találatokat. A mezőt rendezhetőként kell hozzárendelni az indexhez. Olyan esetekben, amikor a szűrt érték azonos (például ugyanaz az ár), a sorrend tetszőleges, de további feltételeket adhat hozzá a mélyebb rendezéshez. Az alábbi példakifejezéssel tesztelheti ezt:

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

Eredmények

Tanulságok

Ebben a rövid útmutatóban a Search Explorer használatával kérdezett le egy indexet a REST API használatával.

• A rendszer részletes JSON-dokumentumként adja vissza az eredményeket, így az egyes dokumentumok felépítését és tartalmát teljes egészében megtekintheti. A select lekérdezési kifejezés paramétere korlátozza a visszaadott mezőket.

• A keresési eredmények az indexben lekérdezhetőként hozzárendelt összes mezőből állnak. Az attribútumok áttekintéséhez válassza a Mezők lapot.

• A kulcsszókeresés, hasonlóan ahhoz, amit egy kereskedelmi webböngészőben beírhat, hasznos a végfelhasználói élmény teszteléséhez. Tegyük fel például, hogy a szállodai mintaindexet beírhatja "activities 'outdoor pool' restaurant OR continental breakfast", majd Ctrl-F használatával kereshet kifejezéseket a keresési eredmények között.

• A lekérdezési és szűrőkifejezések a Azure AI Keresés által implementált szintaxisban vannak kifejezve. Az alapértelmezett érték egy egyszerű szintaxis, de igény szerint teljes Lucene-t is használhat a hatékonyabb lekérdezésekhez. A szűrőkifejezések OData-szintaxisban vannak tagoltak.

Erőforrások törlése

Ha a saját előfizetésében dolgozik, érdemes befejezni egy projektet a már nem szükséges erőforrások eltávolításával. Az otthagyott futó erőforrások pénzbe kerülhetnek.

Az Azure portálon válassza a Minden erőforrás vagy Erőforráscsoportok lehetőséget a bal oldali panelen az erőforrások megkereséséhez és kezeléséhez. Az erőforrásokat egyenként törölheti, vagy törölheti az erőforráscsoportot az összes erőforrás egyidejű eltávolításához.

Ha ingyenes keresési szolgáltatást használ, ne feledje, hogy három indexre, indexelőre és adatforrásra korlátozódik. A portálon törölheti az egyes elemeket , hogy a korlát alatt maradjon.

Következő lépés

Ahhoz, hogy többet megtudjon a lekérdezési struktúrákról és szintaxisról, használjon egy REST-ügyfelet olyan lekérdezési kifejezések létrehozására, amelyek a REST API több részét is használják. Dokumentumok – Keresési bejegyzés (REST API) különösen hasznos a tanuláshoz és a felfedezéshez.