Rychlý start: Použití Průzkumníka služby Search ke spouštění dotazů na portálu

Průzkumník služby Search je integrovaný nástroj pro dotazy v Azure Portal, který se používá pro spouštění dotazů proti indexu vyhledávání v Azure Cognitive Search. Tento nástroj usnadňuje učení syntaxe dotazů, testování výrazu dotazu nebo filtru nebo potvrzení aktualizace dat kontrolou, jestli v indexu existuje nový obsah.

Tento rychlý start používá existující index k předvedení Průzkumníka služby Search.

Požadavky

Než začnete, musíte mít splněné následující požadavky:

  • Účet Azure s aktivním předplatným. Zdarma si vytvořte účet.

  • Služba Azure Cognitive Search. Vytvořte službu nebo vyhledejte existující službu v rámci vašeho aktuálního předplatného. Pro účely tohoto rychlého startu můžete použít bezplatnou službu.

  • Pro účely tohoto rychlého startu se používá realestate-us-sample-index . Pokud chcete vytvořit index, použijte Průvodce importem dat, zvolte ukázková data a projděte průvodce pomocí všech výchozích hodnot.

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

Spuštění Průzkumníka služby Search

  1. V Azure Portal otevřete stránku přehledu hledání na řídicím panelu nebo vyhledejte službu.

  2. Na panelu příkazů otevřete Průzkumníka služby Search:

    Search explorer command in portal

    Nebo použijte vloženou kartu Průzkumníka vyhledávání v otevřeném indexu:

    Search explorer tab

Nespecifikovaný dotaz

V Průzkumníku služby Search se požadavky formulují pomocí rozhraní REST API vyhledávání s odpověďmi vrácenými jako podrobné dokumenty JSON.

První pohled na obsah spustíte tak, že kliknete na Hledat bez zadaných termínů. Prázdné hledání je užitečné jako první dotaz, protože vrací celé dokumenty, abyste mohli zkontrolovat složení dokumentu. Při prázdném hledání neexistuje žádné pořadí hledání a dokumenty se vrátí v libovolném pořadí ("@search.score": 1 pro všechny dokumenty). Ve výchozím nastavení se v žádosti o hledání vrátí 50 dokumentů.

Ekvivalentní syntaxe prázdného hledání je * nebo search=*.

search=*

Výsledky

Unqualified or empty query example

Dotazy bez formulářů s operátory nebo bez jsou užitečné pro simulaci uživatelsky definovaných dotazů odesílaných z vlastní aplikace do Azure Cognitive Search. V definici indexu jsou prohledávána pouze pole, která jsou přiřazena jako prohledávatelná .

Všimněte si, že když zadáte kritéria hledání, jako jsou termíny dotazu nebo výrazy, pořadí hledání se přehraje. Následující příklad znázorňuje bezplatné hledání textu.

Seattle apartment "Lake Washington" miele OR thermador appliance

Výsledky

K hledání ve výsledcích můžete použít kombinaci kláves Ctrl-F pro konkrétní podmínky zájmu.

Free text query example

Počet odpovídajících dokumentů

Přidejte $count=true , abyste získali počet shod nalezených v indexu. Při prázdném hledání je celkový počet dokumentů v indexu. V rámci kvalifikovaného vyhledávání se jedná o počet dokumentů odpovídajících vstupu dotazu. Vzpomeňte si, že služba ve výchozím nastavení vrací prvních 50 shod, takže v indexu můžete mít více shod než to, co je součástí výsledků.

$count=true

Výsledky

Count of matching documents in index

Omezení polí ve výsledcích hledání

Přidáním $select omezit výsledky na explicitně pojmenovaná pole pro čitelnější výstup v Průzkumníku služby Search. Chcete-li zachovat hledaný řetězec a $count=true, argumenty předpony s &.

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

Výsledky

Restrict fields in search results

Vrácení další dávky výsledků

Azure Cognitive Search vrátí prvních 50 shod na základě pořadí hledání. Pokud chcete získat další sadu odpovídajících dokumentů, připojte $top=100,&$skip=50 , abyste zvýšili sadu výsledků na 100 dokumentů (výchozí hodnota je 50, maximum je 1000), přeskočí prvních 50 dokumentů. Pokud chcete identifikovat dokument, můžete zkontrolovat klíč dokumentu (listingID).

Vzpomeňte si, že pro získání seřazených výsledků potřebujete zadat kritéria hledání, jako je termín dotazu nebo výraz. Všimnětesich bodů.

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

Výsledky

Return next batch of search results

Filtrovací výrazy (větší než, menší než, rovno)

Parametr $filter použijte, pokud chcete místo bezplatného hledání textu zadat přesná kritéria. Pole musí být v indexu přiřazeno jako filtrovatelné . Tento příklad hledá ložnice větší než 3:

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

Výsledky

Filter by criteria

Řazení výsledků

Přidejte $orderby k řazení výsledků podle jiného pole vedle skóre hledání. Pole musí být v indexu přiřazeno jako seřaditelné . Ukázkový výraz, který můžete použít k otestování, je:

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

Výsledky

Change the sort order

Výrazy $filter i $orderby jsou konstrukce OData. Další informace najdete v tématu věnovaném syntaxi jazyka OData pro filtry.

Shrnutí

V tomto rychlém startu jste použili Průzkumníka služby Search k dotazování indexu pomocí rozhraní REST API.

  • Výsledky se vrátí jako podrobné dokumenty JSON, abyste mohli zobrazit celou konstrukci a obsah dokumentu. Parametr $select ve výrazu dotazu může omezit, která pole se vrátí.

  • Výsledky hledání se skládají ze všech polí označených jako Zobrazitelná v indexu. Pokud chcete zobrazit atributy polí na portálu, klikněte na realestate-us-sample v seznamu Indexy na stránce přehledu hledání a pak otevřete kartu Pole .

  • Vyhledávání klíčových slov podobné tomu, co můžete zadat v komerčním webovém prohlížeči, je užitečné pro testování prostředí koncového uživatele. Například za předpokladu, že integrovaný index ukázky nemovitostí, můžete zadat "Seattle apartments lake washington" a pak můžete pomocí Ctrl-F najít termíny ve výsledcích hledání.

  • Výrazy dotazů a filtrů jsou vyjádřeny v syntaxi implementované Azure Cognitive Search. Výchozí hodnota je jednoduchá syntaxe, ale pro výkonnější dotazy můžete volitelně použít úplnou syntaxi Lucene . Výrazy filtru jsou vyjádřeny v syntaxi OData.

Vyčištění prostředků

Pokud pracujete s vlastním předplatným, je vhodné vždy na konci projektu zkontrolovat, jestli budete vytvořené prostředky ještě potřebovat. Prostředky, které necháte běžet, vás stojí peníze. Můžete odstraňovat prostředky jednotlivě nebo odstraněním skupiny prostředků odstranit celou sadu prostředků najednou.

Prostředky můžete najít a spravovat na portálu pomocí odkazu Všechny prostředky nebo skupiny prostředků v levém navigačním podokně.

Pokud používáte bezplatnou službu, nezapomeňte, že jste omezeni na tři indexy, indexery a zdroje dat. Jednotlivé položky na portálu můžete odstranit, abyste zůstali pod limitem.

Další kroky

Další informace o strukturách a syntaxi dotazů získáte pomocí nástroje Postman nebo ekvivalentního nástroje k vytváření výrazů dotazů, které využívají více částí rozhraní API. Rozhraní REST API pro vyhledávání je zvlášť užitečné pro výuku a zkoumání.