Konfigurowanie pamięci podręcznej wzbogacania (wersja zapoznawcza)

Note

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.

Ważne

Funkcje, możliwości lub właściwości oznaczone (wersja zapoznawcza) nie są objęte umową dotyczącą poziomu usług, nie są zalecane w przypadku obciążeń produkcyjnych i mogą ulec zmianie lub ograniczeniu, zanim staną się one ogólnie dostępne. Warunki Wyszukiwanie AI platformy Azure wersji zapoznawczej mają zastosowanie do wszystkich funkcji w wersji zapoznawczej, niezależnie od tego, czy jest ona autonomiczna, czy częścią ogólnie dostępnej funkcji.

W tym artykule wyjaśniono, jak dodać buforowanie do potoku zestawu umiejętności, aby można było modyfikować kroki wzbogacania podrzędnego bez ponownej kompilacji za każdym razem. Buforowanie wzbogacania (wersja zapoznawcza) wymaga interfejsu API REST w wersji zapoznawczej. Domyślnie zestaw umiejętności jest pozbawiony stanów, a zmiana dowolnej części jego struktury wymaga pełnej przebudowy indeksatora. W pamięci podręcznej wzbogacania indeksator określa, które części drzewa dokumentów muszą być odświeżane na podstawie zmian w definicji zestawu umiejętności lub indeksatora. Indeksator zachowuje i ponownie używa istniejących przetworzonych danych wyjściowych, jeśli to możliwe.

Zawartość buforowana jest umieszczana w Azure Storage przy użyciu podanej parametry połączenia. Indeksator tworzy te obiekty podczas jego uruchamiania. Pamięć podręczną wzbogacania należy traktować jako składnik wewnętrzny zarządzany przez Twoją usługę wyszukiwania, którego nie wolno modyfikować.

Ważne

Pamięć podręczna wzbogacania nie jest kopią zapasową danych wyjściowych zestawu umiejętności, stanu indeksatora ani indeksowanych dokumentów. Nie śledzi on, które dokumenty zakończą przetwarzanie. W przypadku dużych źródeł danych zapoznaj się z sekcją Ograniczenia przed włączeniem buforowania.

Kontener o nazwie ms-az-search-indexercache-<alpha-numeric-string>
Tabele o nazwie MsAzSearchIndexerCacheIndex<alpha-numeric-string>

Wymagania wstępne

Azure Storage do przechowywania buforowanych wzbogaceń. Konto magazynu musi być kontem ogólnego przeznaczenia w wersji 2.
Tylko w przypadku indeksowania obiektów blob, jeśli potrzebujesz zsynchronizowanego usunięcia dokumentu z zarówno pamięci podręcznej, jak i indeksu, gdy obiekty blob zostaną usunięte ze źródła danych, włącz zasadę usuwania w indeksatorze. Bez tych zasad usuwanie dokumentów z pamięci podręcznej nie jest obsługiwane.

Należy zapoznać się z konfigurowaniem indeksatorów i zestawów umiejętności. Zacznij od przeglądu indeksatora , a następnie przejdź do zestawów umiejętności , aby dowiedzieć się więcej o potokach wzbogacania.

Ograniczenia

Ostrożność

Jeśli używasz indeksatora SharePoint (wersja zapoznawcza), unikaj wzbogacania przyrostowego. W pewnych okolicznościach pamięć podręczna traci ważność. Aby go ponownie załadować, wykonaj resetowanie indeksatora i pełne ponowne kompilowanie.

Duże źródła danych mają dodatkowe ograniczenie pamięci podręcznej.

Ostrożność

W przypadku dużych źródeł danych pamięć podręczna wzbogacania może wydłużyć całkowity czas ponownego przetwarzania, gdy występują długotrwale wykonywane operacje, powtarzające się przerwy lub częste niepowodzenia umiejętności. Indeksator przedkłada poprawność nad minimalizowanie ponownego przetwarzania, dlatego zaległości w pamięci podręcznej spowodowane powtarzającymi się przerwaniami nasilają ponawianie prób. To zachowanie jest oczekiwane, a nie usterka.

Aby uporać się z rosnącymi zaległościami w pamięci podręcznej, podziel źródło danych na mniejsze kontenery lub foldery wirtualne. Następnie użyj indeksatorów równoległych wskazujących ten sam indeks. Aby usunąć powiązanie pamięci podręcznej, ustaw właściwość cache na null w indeksatorze. Aby uzyskać wskazówki dotyczące wzorca partycjonowania, zobacz Indeksowanie dużych zestawów danych .

Uprawnienia

Tożsamość usługi Wyszukiwanie AI platformy Azure wymaga uprawnień do zapisu do usługi Azure Storage:

Współautor danych Storage Blob
Współautor danych tabeli usługi Storage

Składnia parametry połączenia określa, czy jest używana tożsamość przypisana przez system, czy przypisana przez użytkownika. Aby uzyskać więcej informacji, zobacz Połączenie z Azure Storage przy użyciu tożsamości zarządzanej.

Ustawianie właściwości pamięci podręcznej

Użyj tej procedury zarówno dla nowych, jak i istniejących indeksatorów.

W definicji indeksatora określ cache za pomocą:

(Wymagane) storageConnectionString ustaw na ciąg połączenia Azure Storage.
(Opcjonalnie) enableReprocessing (true domyślnie). Ustaw na false, aby tymczasowo zawiesić wzbogacanie przyrostowe, i przełącz go później z powrotem na true.

Portal Azure
REST

Po lewej stronie wybierz pozycję Indeksatory.
Wybierz pozycję Dodaj indeksator , aby utworzyć nowy indeksator lub otworzyć istniejący w trybie edycji JSON.
Włącz wzbogacanie przyrostowe, ustaw konto magazynu pamięci podręcznej wzbogacania i zapisz indeksator.
Zresetuj indeksator, jeśli już istnieje.
Uruchom indeksator. Ta jednorazowa pełna ponowna kompilacja powoduje nasiona pamięci podręcznej. Po załadowaniu ponowne użycie przyrostowe ma zastosowanie do kolejnych przebiegów.

Jeśli edytujesz istniejący indeksator, użyj narzędzia GET Indexer , aby uzyskać bieżącą konfigurację.

Użyj najnowszego interfejsu API w wersji zapoznawczej do tworzenia lub aktualizowania indeksatora.

PUT https://[YOUR-SEARCH-SERVICE].search.windows.net/indexers/[YOUR-INDEXER-NAME]?api-version=2026-08-01-preview
    Content-Type: application/json
    api-key: [YOUR-ADMIN-KEY]
    {
        "name": "<YOUR-INDEXER-NAME>",
        "targetIndexName": "<YOUR-INDEX-NAME>",
        "dataSourceName": "<YOUR-DATASOURCE-NAME>",
        "skillsetName": "<YOUR-SKILLSET-NAME>",
        "cache": {
            "storageConnectionString": "<YOUR-STORAGE-ACCOUNT-CONNECTION-STRING>",
            "enableReprocessing": true
        },
        "fieldMappings": [],
        "outputFieldMappings": [],
        "parameters": []
    }

Zresetuj indeksator , jeśli już istnieje.
Uruchom indeksator. Ta jednorazowa pełna ponowna kompilacja powoduje nasiona pamięci podręcznej. Po załadowaniu ponowne użycie przyrostowe ma zastosowanie do kolejnych przebiegów.
```
POST https://[YOUR-SEARCH-SERVICE].search.windows.net/indexers/[YOUR-INDEXER-NAME]/run?api-version=2026-08-01-preview
    Content-Type: application/json
    api-key: [YOUR-ADMIN-KEY]
```

Jeśli teraz wykonasz kolejne żądanie GET w indeksatorze, odpowiedź z usługi zawiera ID właściwość w obiekcie pamięci podręcznej. Ciąg jest dołączany do nazwy kontenera zawierającego wszystkie buforowane wyniki i stan pośredni każdego dokumentu przetworzonego przez ten indeksator. Identyfikator jest używany do unikatowej nazwy pamięci podręcznej w usłudze Blob Storage.

    "cache": {
        "ID": "<ALPHA-NUMERIC STRING>",
        "enableReprocessing": true,
        "storageConnectionString": "DefaultEndpointsProtocol=https;AccountName=<YOUR-STORAGE-ACCOUNT>;AccountKey=<YOUR-STORAGE-KEY>;EndpointSuffix=core.windows.net"
    }

Sprawdzanie buforowanych danych wyjściowych

Zaloguj się do portalu Azure i znajdź swoje konto Azure Storage.
Użyj przeglądarki magazynu, aby przejrzeć kontenery i tabele.
- Nazwa kontenera to ms-az-search-indexercache-<some-alphanumeric-string>.
- Nazwy tabel to MsAzSearchIndexerCacheIndex<alpha-numeric-string>.

Indeksator tworzy pamięć podręczną i używa jej. Jego zawartość nie jest czytelna dla człowieka.

Aby sprawdzić, czy pamięć podręczna działa, zmodyfikuj zestaw umiejętności i uruchom indeksator, a następnie porównaj metryki przed i po dla czasu wykonywania i liczby dokumentów.

Zestawy kompetencji, które obejmują analizę obrazu i optyczne rozpoznawanie znaków (OCR) zeskanowanych dokumentów, są dobrymi przypadkami testowymi. Jeśli zmodyfikujesz umiejętności tekstu podrzędnego lub jakiejkolwiek umiejętności, która nie jest powiązana z obrazem, indeksator może pobrać wcześniej przetworzony obraz i zawartość OCR z pamięci podręcznej oraz przetworzyć tylko zmiany związane z tekstem z Twoich edycji. Można oczekiwać mniejszej liczby dokumentów w liczbach wykonywania indeksatora, krótszych czasach wykonywania i niższych kosztach.

Zestaw plików używany w samouczkach „cog-search-demo” jest przydatnym przypadkiem testowym, ponieważ zawiera 14 plików o różnych formatach: JPG, PNG, HTML, DOCX, PPTX i innych typów. Zmień en język na es lub inny język w umiejętności tłumaczenia tekstu na potrzeby testowania weryfikacji koncepcji wzbogacania przyrostowego.

Typowe błędy

Następujący błąd występuje, jeśli zapomnisz określić wersję interfejsu API w wersji zapoznawczej w żądaniu:

"The request is invalid. Details: indexer : A resource without a type name was found, but no expected type was specified. To allow entries without type information, the expected type must also be specified when the model is specified."

Błąd 400 Bad Request pojawia się również, jeśli brakuje wymaganego elementu indeksatora. Komunikat o błędzie określa brakujące zależności.

Następny krok

Można użyć przyrostowego wzbogacania indeksatorów, które zawierają zestawy umiejętności, dzięki czemu można ponownie używać zawartości zarówno dla indeksów, jak i magazynów wiedzy. Aby dowiedzieć się więcej na temat zarządzania pamięcią podręczną, zobacz następujący artykuł:

Zarządzanie pamięcią podręczną dla wzbogacania

Opinia

Czy ta strona była pomocna?

Last updated on 2026-07-08