Szybki start: uruchamianie zapytań w witrynie Azure Portal przy użyciu Eksploratora wyszukiwania

  • Artykuł

W tym przewodniku Szybki start dowiesz się, jak używać Eksploratora wyszukiwania, wbudowanego narzędzia zapytań w witrynie Azure Portal używanego do uruchamiania zapytań względem indeksu wyszukiwania w usłudze Azure AI Search. Służy do testowania zapytania lub wyrażenia filtru lub potwierdzania, czy zawartość istnieje w indeksie.

Ten przewodnik Szybki start używa istniejącego indeksu do zademonstrowania Eksploratora wyszukiwania.

Wymagania wstępne

Przed rozpoczęciem należy spełnić następujące wymagania wstępne:

  • Konto platformy Azure z aktywną subskrypcją. Utwórz konto bezpłatnie.

  • Usługa wyszukiwania sztucznej inteligencji platformy Azure. Utwórz usługę lub znajdź istniejącą usługę w ramach bieżącej subskrypcji. W tym przewodniku Szybki start możesz skorzystać z bezpłatnej usługi.

  • Na potrzeby tego przewodnika Szybki start jest używany realestate-us-sample-index . Aby utworzyć indeks, użyj kreatora Importuj dane, wybierz wbudowane przykładowe dane i wykonaj kroki przez kreatora przy użyciu wszystkich wartości domyślnych.

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

Uruchamianie Eksploratora wyszukiwania

  1. W witrynie Azure Portal otwórz stronę przeglądu wyszukiwania na pulpicie nawigacyjnym lub znajdź swoją usługę.

  2. Otwórz Eksploratora wyszukiwania na pasku poleceń:

    Screenshot of the Search explorer command in portal.

    Możesz też użyć osadzonej karty Eksplorator wyszukiwania w otwartym indeksie:

    Screenshot of the Search explorer tab.

Wykonywanie zapytań na dwa sposoby

Istnieją dwa podejścia do wykonywania zapytań w Eksploratorze wyszukiwania.

  • Domyślny pasek wyszukiwania akceptuje puste zapytanie lub wolne zapytanie tekstowe z wartościami logicznymi. Na przykład seattle condo +parking.

  • Widok JSON obsługuje sparametryzowane zapytania. Filtry, kolejność, wybór, liczba, pola wyszukiwania i wszystkie inne parametry muszą być ustawione w widoku JSON.

    Przejdź do widoku JSON dla sparametryzowanych zapytań. W przykładach w tym artykule założono, że w całym widoku JSON. Przykłady w formacie JSON można wkleić z tego artykułu do obszaru tekstu.

    Screenshot of the JSON view selector.

Uruchamianie nieokreślonego zapytania

W Eksploratorze wyszukiwania żądania POST są formułowane wewnętrznie przy użyciu interfejsu API REST wyszukiwania POST z odpowiedziami zwracanymi jako pełne dokumenty JSON.

Aby najpierw przyjrzeć się zawartości, wykonaj puste wyszukiwanie, klikając pozycję Wyszukaj bez podanych terminów. Puste wyszukiwanie jest przydatne jako pierwsze zapytanie, ponieważ zwraca całe dokumenty, aby można było przejrzeć kompozycję dokumentu. W przypadku pustego wyszukiwania nie ma wyników wyszukiwania i dokumenty nie są zwracane w dowolnej kolejności ("@search.score": 1 dla wszystkich dokumentów). Domyślnie w żądaniu wyszukiwania jest zwracanych 50 dokumentów.

Równoważna składnia pustego wyszukiwania to * lub "search": "*".

{
   "search": "*"
}

Wyniki

Unqualified or empty query example

Wyszukiwanie tekstu w warstwie Bezpłatna

Zapytania bez formularzy z operatorami lub bez operatorów są przydatne do symulowania zapytań zdefiniowanych przez użytkownika wysyłanych z aplikacji niestandardowej do usługi Azure AI Search. Tylko te pola przypisywane jako "możliwe do wyszukiwania" w definicji indeksu są skanowane pod kątem dopasowań.

Nie potrzebujesz widoku JSON dla bezpłatnego zapytania tekstowego, ale udostępniamy go w formacie JSON w celu zapewnienia spójności z innymi przykładami w tym artykule.

Zwróć uwagę, że po podaniu kryteriów wyszukiwania, takich jak terminy zapytania lub wyrażenia, ranga wyszukiwania wchodzi w grę. W poniższym przykładzie przedstawiono wyszukiwanie bezpłatnego tekstu. Wynik "@search.score" jest wynikiem istotności obliczonym dla dopasowania przy użyciu domyślnego algorytmu oceniania.

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

Wyniki

Możesz użyć klawiszy Ctrl-F, aby wyszukać w wynikach określone terminy zainteresowania.

Screenshot of a free text query example.

Liczba pasujących dokumentów

Dodaj "count": true , aby uzyskać liczbę dopasowań znalezionych w indeksie. W pustym wyszukiwaniu liczba jest całkowitą liczbą dokumentów w indeksie. W kwalifikowanym wyszukiwaniu jest to liczba dokumentów pasujących do danych wejściowych zapytania. Pamiętaj, że usługa zwraca domyślnie 50 pierwszych dopasowań, więc liczba może wskazywać więcej dopasowań w indeksie niż zwracane w wynikach.

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

Wyniki

Screenshot of a count example.

Ogranicz pola w wynikach wyszukiwania

Dodaj pozycję "select", aby ograniczyć wyniki do jawnie nazwanych pól w celu uzyskania bardziej czytelnych danych wyjściowych w Eksploratorze wyszukiwania. W wynikach mogą być wyświetlane tylko pola oznaczone jako "możliwe do pobrania" w indeksie wyszukiwania.

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

Wyniki

Screenshot of restrict fields in search results example.

Zwraca następną partię wyników

Usługa Azure AI Search zwraca 50 pierwszych dopasowań w oparciu o rangę wyszukiwania. Aby uzyskać następny zestaw pasujących dokumentów, dołącz "top": 100 i "skip": 50 zwiększ zestaw wyników do 100 dokumentów (wartość domyślna to 50, wartość maksymalna to 1000), pomijając pierwsze 50 dokumentów. Aby zidentyfikować dokument, możesz sprawdzić klucz dokumentu (listingID).

Pamiętaj, że musisz podać kryteria wyszukiwania, takie jak termin zapytania lub wyrażenie, aby uzyskać sklasyfikowane wyniki. Zwróć uwagę, że wyniki wyszukiwania zmniejszają poziom głębiej osiągany w wynikach wyszukiwania.

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

Wyniki

Screenshot of returning next batch of search results example.

Wyrażenia filtru (większe niż, mniejsze niż, równe)

Użyj parametru , filter aby określić kryteria dołączania lub wykluczania. Pole musi być przypisywane jako "filtrowalne" w indeksie. W tym przykładzie wyszukuje sypialnie większe niż 3:

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

Wyniki

Screenshot of a filter example.

Sortowanie wyników

Dodaj orderby do sortowania wyników według innego pola oprócz wyniku wyszukiwania. Pole musi być przypisywane jako "sortowalne" w indeksie. W sytuacjach, gdy filtrowana wartość jest identyczna (na przykład ta sama cena), zamówienie jest dowolne, ale można dodać więcej kryteriów do dokładniejszego sortowania. Przykładowe wyrażenie, którego można użyć do przetestowania tego elementu, to:

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

Wyniki

Screenshot of a sorting example.

Wnioski

W tym przewodniku Szybki start użyto Eksploratora wyszukiwania do wykonywania zapytań dotyczących indeksu przy użyciu interfejsu API REST.

  • Wyniki są zwracane jako pełne dokumenty JSON, dzięki czemu można wyświetlać konstrukcję i zawartość dokumentu w całości. Parametr select w wyrażeniu zapytania może ograniczyć zwracane pola.

  • Wyniki wyszukiwania składają się ze wszystkich pól oznaczonych jako "możliwe do pobrania" w indeksie. Wybierz sąsiednią kartę Pola , aby przejrzeć atrybuty.

  • Wyszukiwanie słów kluczowych, podobne do tego, co można wprowadzić w komercyjnej przeglądarce internetowej, jest przydatne do testowania środowiska użytkownika końcowego. Na przykład przy założeniu wbudowanego indeksu przykładowego nieruchomości można wprowadzić "Seattle apartments lake washington", a następnie użyć klawiszy Ctrl-F, aby znaleźć terminy w wynikach wyszukiwania.

  • Wyrażenia zapytań i filtrów są wyrażane w składni implementowanej przez usługę Azure AI Search. Wartość domyślna to prosta składnia, ale opcjonalnie można używać pełnej lucene w przypadku bardziej zaawansowanych zapytań. Wyrażenia filtru są wyrażane w składni OData.

Czyszczenie zasobów

Jeśli pracujesz we własnej subskrypcji, dobrym pomysłem na końcu projektu jest podjęcie decyzji, czy nadal potrzebujesz utworzonych zasobów. Uruchomione zasoby mogą generować koszty. Zasoby możesz usuwać pojedynczo lub jako grupę zasobów, usuwając cały zestaw zasobów.

Zasoby można znaleźć w portalu i zarządzać nimi, korzystając z linku Wszystkie zasoby lub Grupy zasobów w okienku nawigacji po lewej stronie.

Jeśli używasz bezpłatnej usługi, pamiętaj, że masz ograniczenie do trzech indeksów, indeksatorów i źródeł danych. Możesz usunąć poszczególne elementy w portalu, aby pozostać w limicie.

Następne kroki

Aby dowiedzieć się więcej na temat struktur zapytań i składni, użyj klienta REST do tworzenia wyrażeń zapytań korzystających z większej liczby części interfejsu API. Interfejs API REST wyszukiwania POST jest szczególnie przydatny do nauki i eksploracji.

Tworzenie podstawowego zapytania w architekturze REST