Uruchamianie lub resetowanie indeksatorów, umiejętności lub dokumentów

Uwaga

Wyszukiwanie AI platformy Azure jest dostępna za pośrednictwem portalu Azure, interfejsów API REST i Azure SDKs. Jest także podstawą Foundry IQ — zarządzanej warstwy wiedzy, która przekształca treści przedsiębiorstwa w bazy wiedzy wielokrotnego użytku z uwzględnieniem uprawnień dla agentów w portalu Microsoft Foundry.

W Wyszukiwanie AI platformy Azure można uruchomić indeksator na kilka sposobów:

W tym artykule wyjaśniono, jak uruchamiać indeksatory na żądanie i bez resetowania. Opisuje również wykonywanie operacji indeksowania, czas trwania i współbieżność.

Jak indeksatory łączą się z zasobami Azure

Indeksatory są jednym z niewielu podsystemów, które wykonują jawne wywołania wychodzące do innych zasobów Azure. W zależności od zewnętrznego źródła danych można użyć kluczy lub ról do uwierzytelniania połączenia.

Jeśli chodzi o role platformy Azure, indeksatory nie mają oddzielnych tożsamości: połączenie z usługi wyszukiwania z innym zasobem platformy Azure używa tożsamości zarządzanej przypisanej przez system lub użytkownika usługi wyszukiwania oraz przypisania roli w docelowym zasobie platformy Azure. Jeśli indeksator łączy się z zasobem Azure w sieci wirtualnej, należy utworzyć współdzielony prywatny link dla tego połączenia.

Uwaga

Indeksatory działają z uprawnieniami na poziomie usługi, a nie z uprawnieniami użytkownika. Indeksator może zapisywać w dowolnym indeksie na usłudze wyszukiwania, nawet jeżeli przypisano role ograniczające dostęp do niektórych indeksów. Aby uzyskać więcej informacji, zobacz Zakres dla poszczególnych indeksów i operacje indeksowania.

Wykonywanie indeksatora

Usługa wyszukiwania uruchamia jedno zadanie indeksatora na jednostkę wyszukiwania. Każda usługa wyszukiwania zaczyna się od jednej jednostki wyszukiwania, ale w raz z dodaniem nowej partycji lub repliki wzrasta liczba jednostek wyszukiwania w usłudze. Liczbę jednostek wyszukiwania można sprawdzić w sekcji Podstawy portalu Azure na stronie Overview. Jeśli potrzebujesz przetwarzania współbieżnego, upewnij się, że jednostki wyszukiwania zawierają wystarczające repliki. Indeksatory nie działają w tle, więc może dojść do częstszego ograniczania zapytań niż zwykle, jeśli usługa działa pod dużym obciążeniem.

Poniższy zrzut ekranu przedstawia liczbę jednostek wyszukiwania, która określa liczbę indeksatorów, które mogą być uruchamiane jednocześnie.

Zrzut ekranu przedstawiający sekcję podstaw na stronie przeglądu przedstawiającą jednostki wyszukiwania.

Po uruchomieniu wykonywania indeksatora nie można go wstrzymać ani zatrzymać. Wykonywanie indeksatora zostaje zatrzymane, gdy nie ma więcej dokumentów do załadowania lub odświeżenia lub gdy zostanie osiągnięty maksymalny limit czasu działania .

Jednocześnie można uruchomić wiele indeksatorów przy założeniu wystarczającej pojemności, ale każdy indeksator jest pojedynczym wystąpieniem. Uruchomienie nowego wystąpienia, gdy indeksator jest już w wykonaniu, powoduje następujący błąd: "Failed to run indexer "<indexer name>" error: "Another indexer invocation is currently in progress; concurrent invocations are not allowed."

Środowisko wykonywania indeksatora

Zadanie indeksatora jest uruchamiane w zarządzanym środowisku uruchomieniowym. Obecnie istnieją dwa środowiska:

  • Prywatne środowisko wykonywania jest uruchamiane w klastrach wyszukiwania specyficznych dla Twojej usługi wyszukiwania.

  • Środowisko wielodostępne ma procesory zawartości, które Microsoft zarządza i zabezpiecza bez dodatkowych kosztów. To środowisko odciąża przetwarzanie intensywnie korzystające z obliczeń, więc zasoby specyficzne dla usługi pozostają dostępne dla rutynowych operacji. Jeśli to możliwe, większość funkcjonalności działa w środowisku wielodostępnym. To środowisko jest domyślne.

    Przetwarzanie intensywnie korzystające z obliczeń odnosi się do zestawów umiejętności działających na procesorach zawartości i zadaniach indeksatora, które przetwarzają dużą liczbę dokumentów lub dokumentów o dużym rozmiarze. Heurystyki i informacje systemowe określają przetwarzanie niezwiązane z zestawem umiejętności w wielodzierżawnych procesorach zawartości i nie podlegają kontroli klienta.

Możesz zapobiec używaniu środowiska wielotenancyjnego w usługach na poziomie Standardowa2 lub wyższym, przypinając indeksator oraz przetwarzanie zestawu umiejętności wyłącznie do dedykowanych klastrów wyszukiwania. Ustaw parametr w definicji indeksatoraexecutionEnvironment, aby zawsze uruchamiał indeksator w prywatnym środowisku wykonywania.

Zapory adresów IP blokują środowisko wielodostępne, więc jeśli masz zaporę, utwórz regułę zezwalającą na wielodostępne połączenia procesora.

Limity indeksatora różnią się w zależności od środowiska:

Obciążenia Maksymalny czas trwania Maksymalna liczba zadań Środowisko wykonywania
Prywatne wykonanie 24 godziny Jedno zadanie indeksatora na jednostkę wyszukiwania1. Indeksowanie nie jest uruchamiane w tle. Zamiast tego usługa wyszukiwania równoważy wszystkie zadania indeksowania względem bieżących zapytań i akcji zarządzania obiektami (takich jak tworzenie lub aktualizowanie indeksów). Podczas uruchamiania indeksatorów należy oczekiwać, że niektóre opóźnienia zapytań będą widoczne, jeśli woluminy indeksowania są duże.
Multitenant 2 godziny 2 Nieokreślony 3 Ponieważ klaster przetwarzania zawartości jest wielodzierżawny, system dodaje procesory przetwarzania zawartości, aby sprostać zapotrzebowaniu. Jeśli wystąpi opóźnienie w wykonywaniu na żądanie lub zaplanowanym wykonaniu, prawdopodobnie dlatego, że system dodaje procesory lub czeka na udostępnienie jednego.

1 Jednostki wyszukiwania mogą być elastycznymi kombinacjami partycji i replik, ale zadania indeksatora nie są powiązane z jedną lub drugą. Innymi słowy, jeśli masz 12 jednostek, możesz mieć 12 zadań indeksatora działających równocześnie w trybie prywatnym wykonania, niezależnie od sposobu wdrażania jednostek wyszukiwania.

2 Jeśli do przetworzenia wszystkich danych potrzebne są ponad dwie godziny, włącz wykrywanie zmian i zaplanuj uruchamianie indeksatora w 5-minutowych odstępach czasu, aby szybko wznowić indeksowanie, jeśli zostanie zatrzymany z powodu przekroczenia limitu czasu. Aby uzyskać więcej strategii, zobacz Indeksowanie dużego zestawu danych .

3 "Nieokreślone" oznacza, że limit nie jest kwantyfikowany przez liczbę zadań. Niektóre obciążenia, takie jak przetwarzanie zestawu umiejętności, mogą działać równolegle, co może spowodować powstanie wielu zadań, mimo że zaangażowany jest tylko jeden indeksator. Mimo że środowisko nie nakłada ograniczeń, nadal obowiązują limity indeksatora dla usługi wyszukiwania.

Uruchamianie bez resetowania

Operacja uruchom indeksatora wykrywa i przetwarza tylko to, czego potrzebuje do zsynchronizowania indeksu wyszukiwania ze zmianami w bazowym źródle danych. Indeksowanie przyrostowe rozpoczyna się od zlokalizowania wewnętrznego punktu odniesienia, aby znaleźć ostatnio zaktualizowany dokument w indeksie wyszukiwania. Ten dokument staje się punktem wyjścia do uruchamiania indeksatora dla nowych i zaktualizowanych dokumentów w źródle danych.

Wykrywanie zmian jest niezbędne do określenia nowości lub aktualizacji w źródle danych. Indeksatory używają funkcji wykrywania zmian bazowego źródła danych, aby określić, co nowego lub zaktualizowanego w źródle danych.

  • Azure Storage ma wbudowane wykrywanie zmian za pośrednictwem właściwości LastModified.

  • Inne źródła danych, takie jak Azure SQL lub Azure Cosmos DB, wymagają konfiguracji wykrywania zmian, zanim indeksator będzie mógł odczytać nowe i zaktualizowane wiersze.

Jeśli zawartość bazowa jest niezmieniona, operacja uruchamiania nie ma żadnego efektu. W takim przypadku historia wykonywania indeksatora 0\0 wskazuje przetworzone dokumenty.

Aby ponownie przetworzyć wszystkie dokumenty, należy zresetować indeksator.

Resetuj indeksatory

Po początkowym uruchomieniu indeksator śledzi, które dokumenty wyszukiwania są indeksowane za pomocą wewnętrznego znacznika najwyższego stanu. Znacznik nie jest udostępniany, ale wewnętrznie indeksator wie, w którym miejscu ostatnio zakończył działanie.

Aby odbudować cały indeks lub jego część, użyj interfejsów API resetowania dostępnych na coraz niższych poziomach hierarchii obiektów:

Po zresetowaniu wykonaj polecenie Uruchom, aby ponownie przetworzyć nowe i istniejące dokumenty. Nie można usunąć osieroconych dokumentów indeksu wyszukiwania, które nie mają odpowiednika w źródle danych, za pomocą operacji resetowania i uruchomienia. Aby usunąć określone dokumenty, zobacz Usuwanie dokumentów w indeksie wyszukiwania lub Dokumentach — indeks.

Uwaga

Tabele nie mogą być puste. Jeśli używasz TRUNCATE TABLE polecenia do czyszczenia wierszy, resetowanie i ponowne uruchamianie indeksatora nie spowoduje usunięcia odpowiednich dokumentów wyszukiwania. Aby usunąć osierocone dokumenty wyszukiwania, należy zaindeksować je akcją usuwania.

Jak zresetować i uruchomić indeksatory

Reset zeruje znacznik najwyższego poziomu. Wszystkie dokumenty w indeksie wyszukiwarki mają oznaczenie do pełnego zastąpienia, bez wbudowanych aktualizacji ani scalania z istniejącą zawartością. W przypadku indeksatorów posiadających zestaw umiejętności i mechanizm buforowania wzbogacania, resetowanie indeksu powoduje także niejawne resetowanie zestawu umiejętności.

Rzeczywista praca odbywa się po zresetowaniu za pomocą polecenia Uruchom:

  • Wszystkie nowe dokumenty, które znalazły bazowe źródło, są dodawane do indeksu wyszukiwania.
  • Wszystkie dokumenty, które istnieją zarówno w źródle danych, jak i indeksie wyszukiwania, są zastępowane w indeksie wyszukiwania.
  • Każda wzbogacona zawartość utworzona na podstawie zestawów umiejętności zostanie ponownie utworzona. Pamięć podręczna wzbogacania, jeśli jest włączona, jest odświeżona.

Jak wspomniano wcześniej, resetowanie jest operacją pasywną: należy wykonać żądanie Uruchom, aby ponownie skompilować indeks.

Operacje resetowania i uruchamiania mają zastosowanie do indeksu wyszukiwania lub repozytorium wiedzy, do określonych dokumentów lub projekcji oraz do buforowanych wzbogaceń, jeśli resetowanie jawnie lub niejawnie obejmuje funkcje.

Resetowanie dotyczy również operacji tworzenia i aktualizowania. Nie powoduje usuwania ani oczyszczania osieroconych dokumentów w indeksie wyszukiwania. Aby uzyskać więcej informacji na temat usuwania dokumentów, zobacz Dokumenty — indeks.

Nie można cofnąć operacji resetowania.

  1. Przejdź do usługi wyszukiwania w portalu Azure.

  2. Na stronie Przegląd wybierz kartę Indeksatory .

  3. Wybierz indeksator.

  4. Wybierz polecenie Resetuj , a następnie wybierz pozycję Tak , aby potwierdzić akcję.

  5. Odśwież stronę, aby wyświetlić stan. Możesz wybrać element, aby wyświetlić jego szczegóły.

  6. Wybierz pozycję Uruchom , aby rozpocząć przetwarzanie indeksatora lub poczekaj na następne zaplanowane wykonanie.

    Zrzut ekranu przedstawiający stronę portalu wykonywania indeksatora z wyróżnionym poleceniem Resetuj.

Jak zresetować umiejętności (wersja zapoznawcza)

Żądanie resetowania umiejętności selektywnie przetwarza co najmniej jedną umiejętności podczas następnego uruchomienia indeksatora. W przypadku indeksatorów, którzy mają zestawy umiejętności, możesz zresetować poszczególne umiejętności, aby wymusić ponowne przetwarzanie tylko tej umiejętności i wszelkich umiejętności podrzędnych, które zależą od jego danych wyjściowych. Jeśli włączono pamięć podręczną wzbogacania danych, żądanie również ją odświeża.

W przypadku indeksatorów z włączoną buforowaniem można jawnie zażądać przetwarzania aktualizacji umiejętności, których indeksator nie może wykryć. Jeśli na przykład wprowadzisz zmiany poza systemem, takie jak modyfikacje umiejętności niestandardowej, użyj tego interfejsu API, aby ponownie uruchomić tę umiejętność. Proces odświeża dane wyjściowe, takie jak magazyn wiedzy lub indeks wyszukiwania, przy użyciu danych wielokrotnego użytku z pamięci podręcznej i nowej zawartości zgodnie ze zaktualizowaną umiejętnością.

Użyj najnowszego interfejsu API w wersji zapoznawczej.

POST /skillsets/[skillset name]/resetskills?api-version=2026-05-01-preview
{
    "skillNames" : [
        "#1",
        "#5",
        "#6"
    ]
}

Możesz określić indywidualne umiejętności, jak pokazano w poprzednim przykładzie, ale jeśli którekolwiek z tych umiejętności wymaga danych wyjściowych z umiejętności nieznajdujących się na liście (od #2 do 4), proces uruchamia nieznajdujące się umiejętności, chyba że pamięć podręczna może dostarczyć niezbędnych informacji. Aby ten warunek był spełniony, buforowane wzbogacenia dla umiejętności od #2 do #4 nie mogą zależeć od #1 (wskazanej do zresetowania).

Jeśli nie określisz żadnych umiejętności, proces wykonuje cały zestaw umiejętności i, jeśli buforowanie jest włączone, odświeża również pamięć podręczną.

Pamiętaj, aby postępować zgodnie z instrukcjami Uruchom indeksator w celu wywołania rzeczywistego przetwarzania.

Jak zresetować dokumenty (wersja zapoznawcza)

Interfejs API indeksatorów — resetuj dokumenty (wersja zapoznawcza) akceptuje listę kluczy dokumentów, dzięki czemu można odświeżyć określone dokumenty. Jeśli określisz parametry resetowania, określają one wyłącznie, co jest przetwarzane, niezależnie od innych zmian w danych bazowych. Jeśli na przykład 20 obiektów blob zostało dodanych lub zaktualizowanych od ostatniego uruchomienia indeksatora, ale zresetujesz tylko jeden dokument, indeksator przetwarza tylko ten dokument.

Na podstawie poszczególnych dokumentów indeksator odświeża wszystkie pola w dokumencie wyszukiwania wartościami i metadanymi ze źródła danych. Nie można wybierać, które pola odświeżyć.

Jeśli źródło danych jest Azure Data Lake Storage (ADLS) Gen2, a obiekty blob są skojarzone z metadanymi uprawnień, indeksator ponownie pozyska te uprawnienia w indeksie wyszukiwania, jeśli uprawnienia zmienią się w danych bazowych. Aby uzyskać więcej informacji, zobacz Ponowne indeksowanie listy ACL i zakresów RBAC przy użyciu indeksatorów ADLS Gen2.

Jeśli wzbogacasz dokument za pomocą zestawu umiejętności, a dokument ma dane w pamięci podręcznej, indeksator wywołuje zestaw umiejętności tylko dla określonych dokumentów i aktualizuje pamięć podręczną dla ponownie przetworzonych dokumentów.

Podczas testowania tego interfejsu API po raz pierwszy następujące interfejsy API mogą pomóc w weryfikowaniu i testowaniu zachowań. Użyj najnowszego interfejsu API w wersji zapoznawczej.

  1. Wywoływanie indeksatorów — pobieranie stanu z wersją interfejsu API w wersji zapoznawczej w celu sprawdzenia stanu resetowania i stanu wykonywania. Informacje o żądaniu resetowania można znaleźć na końcu odpowiedzi stanu.

  2. Wywołaj indeksatory - zresetuj dokumenty z wersją zapoznawczą API, aby określić, które dokumenty mają być przetworzone.

    POST https://[service name].search.windows.net/indexers/[indexer name]/resetdocs?api-version=2026-05-01-preview
{
    "documentKeys" : [
        "1001",
        "4452"
    ]
}

    • Interfejs API akceptuje dwa typy identyfikatorów dokumentów jako dane wejściowe: Klucze dokumentów, które jednoznacznie identyfikują dokumenty w indeksie wyszukiwania, oraz identyfikatory dokumentów źródła danych, które jednoznacznie identyfikują dokumenty w źródle danych. Treść powinna zawierać listę kluczy dokumentów lub listę identyfikatorów dokumentów źródła danych, które indeksator szuka w źródle danych. Wywołanie interfejsu API powoduje dodanie kluczy dokumentów lub identyfikatorów dokumentów źródła danych w celu zresetowania ich do metadanych indeksatora. Podczas następnego zaplanowanego lub na żądanie uruchomienia indeksatora, indeksator przetwarza tylko zresetowane dokumenty.

    • Jeśli używasz kluczy dokumentów do resetowania dokumentów, a klucze dokumentów są przywołyne w mapowaniu pól indeksatora, indeksator używa mapowania pól w celu zlokalizowania odpowiedniego pola w bazowym źródle danych.

    • Klucze dokumentów podane w żądaniu to wartości z indeksu wyszukiwania, które mogą różnić się od odpowiednich pól w źródle danych. Jeśli nie masz pewności co do wartości klucza, wyślij zapytanie , aby zwrócić wartość. Możesz użyć select polecenia , aby zwrócić tylko pole klucza dokumentu.

    • W przypadku obiektów blob, które indeksator analizuje na wiele dokumentów wyszukiwania (gdy dla parsingMode ustawiono wartość jsonLines lub jsonArrays albo delimitedText), indeksator generuje klucz dokumentu i możesz go nie znać. W tym scenariuszu zapytanie dotyczące klucza dokumentu w celu zwrócenia poprawnej wartości.

    • Jeśli chcesz, aby indeksator przestał próbować przetwarzać zresetowane dokumenty, ustaw "documentKeys" lub "datasourceDocumentIds" na pustą listę []. To działanie powoduje, że indeksator wznawia regularne indeksowanie na podstawie znacznika wysokiego poziomu wody. Nieprawidłowe klucze dokumentów lub klucze dokumentów, które nie istnieją, są ignorowane.

  3. Wywołaj usługę Run Indexer (dowolną wersję interfejsu API), aby przetworzyć określone dokumenty. Indeksator indeksuje tylko te określone dokumenty.

  4. Wywołaj Run Indexer po raz drugi, aby przetworzyć od ostatniego punktu kontrolnego.

  5. Wywołaj funkcję Wyszukaj dokumenty , aby sprawdzić zaktualizowane wartości, a także zwrócić klucze dokumentów, jeśli nie masz pewności co do wartości. Użyj polecenia "select": "<field names>" , jeśli chcesz ograniczyć pola wyświetlane w odpowiedzi.

Zastąp listę kluczy dokumentu

Jeśli wielokrotnie wywołasz interfejs API Reset Documents przy użyciu różnych kluczy, nowe klucze zostaną dodane do listy resetowanych kluczy dokumentów. Jeśli wywołasz interfejs API z parametrem ustawionym overwrite na true, bieżąca lista zostanie zamieniona na nową:

POST https://[service name].search.windows.net/indexers/[indexer name]/resetdocs?api-version=2026-05-01-preview
{
    "documentKeys" : [
        "200",
        "630"
    ],
    "overwrite": true
}

Jak ponownie zsynchronizować indeksatory (wersja zapoznawcza)

Resynchronizacja indeksatorów to interfejs API REST w wersji zapoznawczej, który wykonuje częściowe ponowne indeksowanie wszystkich dokumentów. Indeksator jest uznawany za zsynchronizowany ze źródłem danych, gdy określone pola wszystkich dokumentów w indeksie docelowym są zgodne z danymi w źródle danych. Zazwyczaj indeksator osiąga synchronizację po pomyślnym początkowym uruchomieniu. Jeśli usuniesz dokument ze źródła danych, indeksator pozostanie zsynchronizowany zgodnie z tą definicją. Jednak podczas następnego uruchomienia indeksatora odpowiedni dokument w indeksie docelowym zostanie usunięty, jeśli śledzenie usuwania jest włączone.

Jeśli zmodyfikujesz dokument w źródle danych, indeksator stanie się niezsynchronizowany. Ogólnie rzecz biorąc, mechanizmy śledzenia zmian ponownie zsynchronizują się z indeksatorem podczas następnego uruchomienia. Na przykład w usłudze Azure Storage zmodyfikowanie obiektu blob aktualizuje czas jego ostatniej modyfikacji, więc indeksator może ponownie go zaindeksować podczas kolejnego uruchomienia, ponieważ zaktualizowany czas przekracza próg „high-water mark” ustawiony podczas poprzedniego uruchomienia.

Natomiast w przypadku niektórych źródeł danych, takich jak ADLS Gen2, zmiana list kontroli dostępu (ACL) obiektu blob nie zmienia czasu ostatniej modyfikacji, więc śledzenie zmian jest nieskuteczne, jeśli listy ACL mają być pozyskiwane. W związku z tym zmodyfikowany obiekt blob nie jest ponownie indeksowany w kolejnym przebiegu, ponieważ przetwarzane są tylko dokumenty zmodyfikowane po ostatnim znaczniku wysokiej wody.

Chociaż użycie polecenia „reset” lub „reset docs” może rozwiązać ten problem, polecenie „reset” może być czasochłonne i nieefektywne w przypadku dużych zbiorów danych, a polecenie „reset docs” wymaga zidentyfikowania klucza dokumentu obiektu blob, który chcesz zaktualizować.

Resync Indexers oferuje wydajną i wygodną alternatywę. Indeksator należy po prostu umieścić w trybie ponownej synchronizacji i określić zawartość do ponownej synchronizacji, wywołując interfejs API indeksatorów resync. W następnym uruchomieniu indeksator sprawdza tylko odpowiednią część danych w źródle i unika niepotrzebnego przetwarzania niepowiązanego z określonymi danymi. Wysyła również zapytania do istniejących dokumentów w indeksie docelowym i aktualizuje tylko dokumenty, które pokazują rozbieżności między źródłem danych a indeksem docelowym. Po ponownym uruchomieniu synchronizacji indeksator jest synchronizowany i przywraca normalny tryb uruchamiania indeksatora dla kolejnych uruchomień.

Jak ponownie zsynchronizować i uruchomić indeksatory

  1. Wywołaj indeksatory - ponowna synchronizacja z wersją zapoznawczą interfejsu API, aby określić, jaka zawartość ma zostać ponownie zsynchronizowana.

    POST https://[service name].search.windows.net/indexers/[indexer name]/resync?api-version=2026-05-01-preview
{
    "options" : [
        "permissions"
    ]
}
    • Pole options jest wymagane. Obecnie jedyną obsługiwaną opcją jest permissions. Oznacza to, że aktualizowane są tylko pola filtru uprawnień w indeksie docelowym.

  2. Wywołaj funkcję Run Indexer (dowolną wersję interfejsu API), aby ponownie zsynchronizować indeksator.

  3. Wywołaj Run Indexer po raz drugi, aby przetworzyć od ostatniego punktu kontrolnego.

Sprawdź stan resetowania "currentState"

Aby sprawdzić stan resetowania i sprawdzić, które klucze dokumentów są kolejkowane do przetwarzania, wykonaj następujące kroki:

  1. Wywołaj metodę Pobierz stan indeksatora przy użyciu interfejsu API w wersji zapoznawczej.

    Interfejs API w wersji zapoznawczej zwraca sekcję currentState znajdującą się na końcu odpowiedzi.

    "currentState": {
    "mode": "indexingResetDocs",
    "allDocsInitialTrackingState": "{\"LastFullEnumerationStartTime\":\"2021-02-06T19:02:07.0323764+00:00\",\"LastAttemptedEnumerationStartTime\":\"2021-02-06T19:02:07.0323764+00:00\",\"NameHighWaterMark\":null}",
    "allDocsFinalTrackingState": "{\"LastFullEnumerationStartTime\":\"2021-02-06T19:02:07.0323764+00:00\",\"LastAttemptedEnumerationStartTime\":\"2021-02-06T19:02:07.0323764+00:00\",\"NameHighWaterMark\":null}",
    "resetDocsInitialTrackingState": null,
    "resetDocsFinalTrackingState": null,
    "resyncInitialTrackingState": null,
    "resyncFinalTrackingState": null,
    "resetDocumentKeys": [
        "200",
        "630"
    ]
}

  2. Sprawdź tryb:

    W przypadku resetowania umiejętności ustaw element „mode” na indexingAllDocs, ponieważ może to dotyczyć wszystkich dokumentów pod względem pól wypełnianych przez wzbogacanie AI.

    W przypadku indeksatorów resync ustaw wartość "mode" na indexingResync. Indeksator sprawdza wszystkie dokumenty i koncentruje się na zainteresowanych danych w źródle danych i zainteresowanych polach w indeksie docelowym.

    Dla opcji „Reset Documents” ustaw parametr „mode” na indexingResetDocs. Indeksator utrzymuje ten stan, dopóki nie przetworzy wszystkich kluczy dokumentów podanych w wywołaniu resetowania dokumentów. W tym czasie żadne inne zadania indeksatora nie są wykonywane podczas wykonywania operacji. Znalezienie wszystkich dokumentów na liście kluczy dokumentów wymaga złamania każdego dokumentu w celu zlokalizowania i dopasowania go w kluczu. Ten proces może zająć trochę czasu, jeśli zestaw danych jest duży. Jeśli kontener obiektów blob zawiera setki obiektów blob, a dokumenty, które chcesz zresetować, znajdują się na końcu, indeksator nie znajdzie pasujących obiektów blob, dopóki nie sprawdzi wszystkich pozostałych.

  3. Po ponownym przetworzeniu dokumentów przez indeksator ponownie uruchom polecenie Pobierz stan indeksatora. Indeksator powraca do indexingAllDocs trybu i przetwarza wszystkie nowe lub zaktualizowane dokumenty w następnym uruchomieniu.

Sprawdź limit czasu działania indeksatora dla usług wyszukiwania S3 HD i Serverless

Ta sekcja dotyczy usług wyszukiwania Standard 3 High Density (S3 HD) oraz bezserwerowych usług wyszukiwania. Aby uzyskać wskazówki dotyczące zbiorczego działania limitów przydziału i planowania, zobacz Uruchamianie indeksatora w trybie bezserwerowym i w S3 HD.

Każde uruchomienie indeksatora może trwać maksymalnie dwie godziny. Oddzielnie wszystkie indeksatory współdzielą 24 godziny łącznego czasu działania dla każdej usługi w każdym 24-godzinnym oknie UTC.

Aby ułatwić monitorowanie czasów działania indeksatora względem okna 24-godzinnego, funkcja Pobierz statystyki usługi i Pobierz stan indeksatora zwraca teraz więcej informacji w odpowiedzi.

Śledzenie skumulowanego limitu przydziału czasu wykonywania

Śledź skumulowane użycie czasu działania indeksatora usługi wyszukiwania i określ, ile limitu czasu działania pozostało w bieżącym 24-godzinnym okresie.

Wyślij żądanie GET do punktu końcowego usługi wyszukiwania. Aby uzyskać pomoc dotyczącą konfigurowania klienta REST i uzyskiwania tokenu dostępu, zobacz Nawiązywanie połączenia z usługą wyszukiwania.

GET {{search-endpoint}}/servicestats?api-version=2026-05-01-preview 
  Content-Type: application/json
  Authorization: Bearer {{accessToken}}

Odpowiedzi obejmują indexersRuntime właściwości, które pokazują czas rozpoczęcia i zakończenia okna, skumulowane sekundy używane przez wszystkie indeksatory i sekundy pozostałe dla usługi.

Śledzenie limitu przydziału czasu działania indeksowania

Zwrot tych samych informacji dla pojedynczego indeksującego.

GET {{search-endpoint}}/indexers/hotels-sample-indexer/search.status?api-version=2026-05-01-preview 
  Content-Type: application/json
  Authorization: Bearer {{accessToken}}

Odpowiedzi obejmują runtime właściwości, które pokazują czas rozpoczęcia i zakończenia okna, sekundy używane przez indeksator i sekundy pozostałe dla wszystkich indeksatorów w usłudze.

Następne kroki

Interfejsy API resetowania służą do informowania o zakresie następnego uruchomienia indeksatora. Aby rozpocząć faktyczne przetwarzanie, należy uruchomić indeksator na żądanie lub zaczekać na zakończenie zaplanowanego zadania. Po zakończeniu przebiegu indeksator powraca do normalnego przetwarzania, niezależnie od tego, czy jest to przetwarzanie na żądanie, czy zgodnie z harmonogramem.

Po zresetowaniu i ponownym uruchomieniu zadań indeksatora można monitorować stan z usługi wyszukiwania lub uzyskać szczegółowe informacje za pośrednictwem rejestrowania zasobów.

  • Last updated on