Konfigurieren eines Anreicherungscaches (Vorschau)

Note

Azure KI-Suche ist über das Azure Portal, REST-APIs und Azure SDKs verfügbar. Es unterstützt auch Foundry IQ, die verwaltete Wissensschicht, die Unternehmensinhalte in wiederverwendbare, berechtigungsfähige Wissensbasen für Agenten im Microsoft Foundry-Portal transformiert.

Wichtig

Features, Funktionen oder Eigenschaften, die als (Vorschau) gekennzeichnet sind, werden von keiner Dienstebenenvereinbarung (SLA) abgedeckt, werden für Produktionsworkloads nicht empfohlen und können geändert oder eingeschränkt werden, bevor sie allgemein verfügbar sind. Die Azure KI-Suche Vorschaubedingungen gelten für alle Vorschaufunktionen, unabhängig davon, ob sie eigenständig oder Teil eines allgemein verfügbaren Features ist.

In diesem Artikel wird erläutert, wie Sie einer Skillset-Pipeline Zwischenspeicherung hinzufügen, damit Sie nachgelagerte Anreicherungsschritte ändern können, ohne jedes Mal vollständig neu zu erstellen. Die Anreicherungszwischenspeicherung (Vorschauversion) erfordert eine Vorschau-REST-API. Standardmäßig ist ein Skillset zustandslos, und eine Änderung eines beliebigen Teils seiner Komposition erfordert eine vollständige erneute Ausführung des Indexers. Mit einem Anreicherungscache bestimmt der Indexer, welche Teile der Dokumentstruktur basierend auf Änderungen der Fähigkeiten oder Indexerdefinition aktualisiert werden müssen. Der Indexer behält vorhandene verarbeitete Ausgabe bei, sofern möglich, und verwendet sie wieder.

Sie platzieren zwischengespeicherte Inhalte in Azure Storage mithilfe einer von Ihnen bereitgestellten Verbindungszeichenfolge. Der Indexer erstellt diese Objekte, wenn er ausgeführt wird. Berücksichtigen Sie den Anreicherungscache einer internen Komponente, die von Ihrem Suchdienst verwaltet wird, die Sie nicht ändern dürfen.

Wichtig

Ein Anreicherungscache ist keine Sicherung von Skillset-Ausgaben, Indexerstatus oder indizierten Dokumenten. Es wird nicht nachverfolgt, welche Dokumente die Verarbeitung abgeschlossen haben. Überprüfen Sie für große Datenquellen den Abschnitt "Einschränkungen" , bevor Sie die Zwischenspeicherung aktivieren.

Ein Container mit dem Namen ms-az-search-indexercache-<alpha-numeric-string>
Tabellen mit dem Namen MsAzSearchIndexerCacheIndex<alpha-numeric-string>

Voraussetzungen

Azure Storage zum Speichern zwischengespeicherter Anreicherungen. Das Speicherkonto muss General Purpose v2 sein.
Gilt nur für die Blob-Indizierung: Wenn Sie eine synchronisierte Löschung von Dokumenten aus dem Cache und dem Index benötigen, wenn Blobs aus Ihrer Datenquelle gelöscht werden, aktivieren Sie eine Löschrichtlinie im Indexer. Ohne diese Richtlinie wird das Löschen von Dokumenten aus dem Cache nicht unterstützt.

Sie sollten mit der Einrichtung von Indexern und Skillsets vertraut sein. Beginnen Sie mit der Indexer-Übersicht und fahren Sie dann mit skillsets fort, um mehr über Anreicherungspipelines zu erfahren.

Einschränkungen

Vorsicht

Wenn Sie den SharePoint Indexer (Vorschau) verwenden, vermeiden Sie die inkrementelle Anreicherung. Unter bestimmten Umständen wird der Cache ungültig. Um sie neu zu laden, führen Sie ein Zurücksetzen des Indexers und eine vollständige Neuindizierung durch.

Große Datenquellen haben eine zusätzliche Cachebeschränkung.

Vorsicht

Bei großen Datenquellen kann ein Anreicherungscache die gesamte Neuverarbeitung erhöhen, wenn lange laufende Fähigkeiten, wiederholte Unterbrechungen oder häufige Fähigkeitsfehler auftreten. Der Indexer priorisiert die Korrektheit gegenüber der Minimierung der Neuverarbeitung, sodass ein Cache-Backlog von wiederholten Unterbrechungen das Wiederholungsverhalten verstärkt. Dieses Verhalten wird erwartet, kein Fehler.

Um aus einem wachsenden Cache-Backlog wiederherzustellen, partitionieren Sie die Datenquelle in kleinere Container oder virtuelle Ordner. Verwenden Sie dann parallele Indexer , die auf denselben Index zeigen. Wenn Sie die Zuordnung des Caches aufheben möchten, legen Sie die cache Eigenschaft auf NULL für den Indexer fest. Anleitungen zum Partitionierungsmuster finden Sie unter "Große Datensätze indizieren ".

Berechtigungen

Eine Azure KI-Suche Identität benötigt Schreibzugriff auf Azure Storage:

Speicher-Blob-Daten Mitwirkender
Mitwirkender an Storage-Tabellendaten

Die syntax Verbindungszeichenfolge bestimmt, ob eine vom System zugewiesene oder vom Benutzer zugewiesene Identität verwendet wird. Weitere Informationen finden Sie unter Connect to Azure Storage using a managed identity.

Festlegen der Cacheeigenschaft

Verwenden Sie dieses Verfahren sowohl für neue als auch für vorhandene Indexer.

Definieren Sie in der Indexerdefinition cache mit Folgendem:

(Erforderlich) storageConnectionString auf eine Azure Storage Verbindungszeichenfolge festgelegt.
(Optional) enableReprocessing (true standardmäßig). Stellen Sie es auf false, um die inkrementelle Anreicherung vorübergehend anzuhalten, und stellen Sie es später wieder auf true um.

Azure Portal
REST

Wählen Sie auf der linken Seite die Option "Indexer" aus.
Wählen Sie "Indexer hinzufügen" aus, um einen neuen Indexer zu erstellen, oder öffnen Sie eine vorhandene im JSON-Bearbeitungsmodus.
Aktivieren Sie die inkrementelle Anreicherung, legen Sie das Speicherkonto für die Anreicherung fest, und speichern Sie den Indexer.
Setzen Sie den Indexer zurück, wenn er bereits vorhanden ist.
Führen Sie den Indexer aus. Dieser einmalige vollständige Neuaufbau initialisiert den Cache. Nach dem Laden gilt die inkrementelle Wiederverwertung für nachfolgende Durchläufe.

Wenn Sie einen vorhandenen Indexer bearbeiten, verwenden Sie GET Indexer , um die aktuelle Konfiguration abzurufen.

Verwenden Sie die neueste Vorschau-API zum Erstellen oder Aktualisieren von Indexer.

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": []
    }

Setzen Sie den Indexer zurück , wenn er bereits vorhanden ist.

Führen Sie den Indexer aus. Dieser einmalige vollständige Neuaufbau initialisiert den Cache. Nach dem Laden gilt die inkrementelle Wiederverwertung für nachfolgende Durchläufe.

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]

Wenn Sie jetzt eine weitere GET-Anforderung für den Indexer ausgeben, enthält die Antwort des Diensts eine ID Eigenschaft im Cacheobjekt. Die Zeichenfolge wird an den Namen des Containers angefügt, der alle zwischengespeicherten Ergebnisse und den Zwischenzustand jedes Dokuments enthält, das von diesem Indexer verarbeitet wird. Die ID wird verwendet, um den Cache im BLOB-Speicher eindeutig zu benennen.

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

Zwischengespeicherte Ausgabe prüfen

Melden Sie sich beim Azure-Portal an, und suchen Sie Ihr Azure Storage Konto.
Verwenden Sie den Speicherbrowser, um Container und Tabellen zu überprüfen.
- Der Containername lautet ms-az-search-indexercache-<some-alphanumeric-string>.
- Tabellennamen sind MsAzSearchIndexerCacheIndex<alpha-numeric-string>.

Ein Indexer erstellt und verwendet einen Cache. Der Inhalt ist nicht für Menschen lesbar.

Um zu überprüfen, ob der Cache betriebsbereit ist, ändern Sie ein Skillset, und führen Sie den Indexer aus, und vergleichen Sie dann vor und nach Metriken für die Ausführungszeit und die Dokumentanzahl.

Kompetenzen, die Bildanalyse und optische Zeichenerkennung (OCR) von gescannten Dokumenten umfassen, bilden gute Testfälle. Wenn Sie eine nachgeschaltete Textkompetenz oder eine Fähigkeit ändern, die nicht bildbezogen ist, kann der Indexer zuvor verarbeitete Bild- und OCR-Inhalte aus dem Cache abrufen und nur textbezogene Änderungen aus Ihren Bearbeitungen verarbeiten. Sie können weniger Dokumente in der Indexerausführungsanzahl, kürzere Ausführungszeiten und niedrigere Kosten erwarten.

Der Dateisatz, der in den cog-search-demo tutorials verwendet wird, ist ein nützlicher Testfall, da er 14 Dateien verschiedener Formate wie JPG, PNG, HTML, DOCX, PPTX und andere Typen enthält. Ändern Sie en in es oder eine andere Sprache im Skill „Textübersetzung“, um Proof-of-Concept-Tests der inkrementellen Anreicherung durchzuführen.

Häufige Fehler

Der folgende Fehler tritt auf, wenn Sie vergessen, eine Vorschau-API-Version für die Anforderung anzugeben:

"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."

Ein Fehler 400 (Bad Request) tritt auch auf, wenn eine erforderliche Voraussetzung für den Indizierer fehlt. Die Fehlermeldung gibt alle fehlenden Abhängigkeiten an.

Nächster Schritt

Sie können inkrementelle Anreicherung für Indexer verwenden, die Skillsets enthalten, sodass Sie Inhalte sowohl für Indizes als auch für Wissensspeicher wiederverwenden können. Weitere Informationen zur Cacheverwaltung finden Sie im folgenden Artikel:

Verwalten eines Anreicherungscaches

Feedback

War diese Seite hilfreich?

Last updated on 2026-09-17