Ładowanie danych do indeksu wyszukiwania w usłudze Azure AI Search

W tym artykule wyjaśniono, jak importować, odświeżać zawartość i zarządzać nią w wstępnie zdefiniowanym indeksie wyszukiwania. W usłudze Azure AI Search najpierw tworzony jest indeks wyszukiwania z importem danych po drugim kroku. Wyjątkiem jest kreator importu danych i potoki indeksatora, które tworzą i ładują indeks w jednym przepływie pracy.

Usługa wyszukiwania importuje i indeksuje tekst i wektory w formacie JSON, używane w scenariuszach wyszukiwania pełnotekstowego, wyszukiwania wektorów, wyszukiwania hybrydowego i wyszukiwania wiedzy. Zawartość tekstowa jest uzyskiwana z pól alfanumerycznych w zewnętrznym źródle danych, metadanych przydatnych w scenariuszach wyszukiwania lub wzbogaconej zawartości utworzonej przez zestaw umiejętności (umiejętności mogą wyodrębniać lub wnioskować opisy tekstowe z obrazów i zawartości bez struktury). Zawartość wektorowa jest wektoryzowana przy użyciu zewnętrznego modelu osadzania lub zintegrowanej wektoryzacji (wersja zapoznawcza).

Po zaindeksowanym indeksie fizyczne struktury danych indeksu są zablokowane. Aby uzyskać wskazówki dotyczące tego, co można zmienić i których nie można zmienić, zobacz Usuwanie i ponowne kompilowanie indeksu.

Indeksowanie nie jest procesem w tle. Usługa wyszukiwania zrównoważy indeksowanie i obciążenia zapytań, ale jeśli opóźnienie zapytań jest zbyt wysokie, możesz dodać pojemność lub zidentyfikować okresy niskiej aktywności zapytań na potrzeby ładowania indeksu.

Ładowanie dokumentów

Usługa wyszukiwania akceptuje dokumenty JSON zgodne ze schematem indeksu.

Te dokumenty można przygotować samodzielnie, ale jeśli zawartość znajduje się w obsługiwanym źródle danych, uruchomienie indeksatora lub kreator importu danych może zautomatyzować pobieranie dokumentów, serializacji JSON i indeksowanie.

Witryna Azure Portal

W witrynie Azure Portal użyj kreatorów importu danych, aby utworzyć i załadować indeksy w bezproblemowym przepływie pracy. Jeśli chcesz załadować istniejący indeks, wybierz alternatywne podejście.

1. Zaloguj się w witrynie Azure Portal przy użyciu danych konta Azure.

2. Znajdź usługę wyszukiwania i na stronie Przegląd wybierz pozycję Importuj dane lub Importuj i wektoryzuj dane na pasku poleceń, aby utworzyć i wypełnić indeks wyszukiwania. Skorzystaj z poniższych linków, aby przejrzeć przepływ pracy: Szybki start: tworzenie indeksu usługi Azure AI Search i Szybki start: wektoryzacja zintegrowana (wersja zapoznawcza).

   

Jeśli indeksatory są już zdefiniowane, możesz zresetować i uruchomić indeksator w witrynie Azure Portal, co jest przydatne w przypadku przyrostowego dodawania pól. Polecenie Reset wymusza rozpoczęcie od początku indeksatora i pobieranie wszystkich pól ze wszystkich dokumentów źródłowych.

REST

Dokumenty — indeks (REST) to metoda, za pomocą której można importować dane do indeksu wyszukiwania. Parametr @search.action określa, czy dokumenty są dodawane w całości, czy częściowo pod względem nowych lub zastępczych wartości dla określonych pól.

Szybki start: wyszukiwanie tekstu przy użyciu interfejsu REST wyjaśnia kroki. Poniższy przykład to zmodyfikowana wersja przykładu. Została ona przycięta do zwięzłości, a pierwsza wartość HotelId została zmieniona, aby uniknąć zastępowania istniejącego dokumentu.

1. Sformułuj wywołanie POST określające nazwę indeksu, punkt końcowy "docs/index" i treść żądania zawierającą @search.action parametr .

   POST https://[service name].search.windows.net/indexes/hotels-sample-index/docs/index?api-version=2023-11-01
   Content-Type: application/json   
   api-key: [admin key] 
   {
       "value": [
       {
       "@search.action": "upload",
       "HotelId": "1111",
       "HotelName": "Secret Point Motel",
       "Description": "The hotel is ideally located on the main commercial artery of the city in the heart of New York. A few minutes away is Time's Square and the historic centre of the city, as well as other places of interest that make New York one of America's most attractive and cosmopolitan cities.",
       "Category": "Boutique",
       "Tags": [ "pool", "air conditioning", "concierge" ]
       },
       {
       "@search.action": "mergeOrUpload",
       "HotelId": "2",
       "HotelName": "Twin Dome Motel",
       "Description": "This is description is replacing the original one for this hotel. New and changed values overwrite the previous ones. In a comma-delimited list like Tags, be sure to provide the full list because there is no merging of values within the field itself.",
       "Category": "Boutique",
       "Tags": [ "pool", "free wifi", "concierge", "my first new tag", "my second new tag" ]
       }
     ]
   }
   

2. Wyszukaj właśnie dodane dokumenty jako krok weryfikacji:

   GET https://[service name].search.windows.net/indexes/hotel-sample-index/docs/1111?api-version=2023-11-01
   

Gdy klucz lub identyfikator dokumentu jest nowy, wartość null staje się wartością dowolnego pola, które nie jest określone w dokumencie. W przypadku akcji w istniejącym dokumencie zaktualizowane wartości zastępują poprzednie wartości. Wszystkie pola, które nie zostały określone w "merge" lub "mergeUpload", pozostają nienaruszone w indeksie wyszukiwania.

Zestaw .NET SDK (C#)

Usługa Azure AI Search obsługuje następujące interfejsy API na potrzeby prostego i zbiorczego przekazywania dokumentów do indeksu:

• IndexDocumentsAsync (Zestaw Azure SDK dla platformy .NET)
• SearchIndexingBufferedSender

Istnieje kilka przykładów ilustrujących indeksowanie w kontekście prostego i na dużą skalę indeksowania:

• W artykule "Ładowanie indeksu" opisano podstawowe kroki.

• Azure.Search.Documents Samples — indeksowanie dokumentów z zespołu zestawu Azure SDK dodaje element SearchIndexingBufferedSender.

• Samouczek: indeksowanie wszystkich par danych indeksowania wsadowego za pomocą strategii testowania w celu określenia optymalnego rozmiaru.

Usuwanie oddzielonych dokumentów

Usługa Azure AI Search obsługuje operacje na poziomie dokumentu, dzięki czemu można wyszukiwać, aktualizować i usuwać określony dokument w izolacji. W poniższym przykładzie pokazano, jak usunąć dokument. W usłudze wyszukiwania dokumenty nie są powiązane, więc usunięcie jednego z nich nie będzie miało wpływu na pozostałą część indeksu.

1. Zidentyfikuj, które pole jest kluczem dokumentu. W portalu można wyświetlić pola poszczególnych indeksów. Klucze dokumentów są polami ciągów i są oznaczone ikoną klucza, aby ułatwić ich odnajdowanie.

2. Sprawdź wartości pola klucza dokumentu: search=*&$select=HotelId. Prosty ciąg jest prosty, ale jeśli indeks używa pola zakodowanego w formacie base-64 lub jeśli dokumenty wyszukiwania zostały wygenerowane na podstawie parsingMode ustawienia, możesz pracować z wartościami, których nie znasz.

3. Wyszukaj dokument , aby sprawdzić wartość identyfikatora dokumentu i przejrzeć jego zawartość przed jego usunięciem. Określ klucz lub identyfikator dokumentu w żądaniu. W poniższych przykładach przedstawiono prosty ciąg dla przykładowego indeksu Hotels i zakodowany ciąg base-64 dla klucza metadata_storage_path indeksu cog-search-demo.

   GET https://[service name].search.windows.net/indexes/hotel-sample-index/docs/1111?api-version=2023-11-01
   

   GET https://[service name].search.windows.net/indexes/cog-search-demo/docs/aHR0cHM6Ly9oZWlkaWJsb2JzdG9yYWdlMi5ibG9iLmNvcmUud2luZG93cy5uZXQvY29nLXNlYXJjaC1kZW1vL2d1dGhyaWUuanBn0?api-version=2023-11-01
   

4. Usuń dokument , aby usunąć go z indeksu wyszukiwania.

   POST https://[service name].search.windows.net/indexes/hotels-sample-index/docs/index?api-version=2023-11-01
   Content-Type: application/json   
   api-key: [admin key] 
   {  
     "value": [  
       {  
         "@search.action": "delete",  
         "id": "1111"  
       }  
     ]  
   }
   

Zobacz też

• Omówienie indeksów wyszukiwania
• Omówienie importowania danych
• Omówienie kreatora importu danych
• Indexers overview (Omówienie indeksatorów)