Dokumente zurücksetzen (Vorschau DER REST-API)

  • Artikel

Gilt für: 2023-07-01-Preview, 2021-04-30-Preview, 2020-06-30-Preview, 2019-05-06-Preview

Wichtig

2023-07-01-Preview (keine Änderungen).

2021-04-30-Preview (keine Änderungen).

2020-06-30-Preview (keine Änderungen).

2019-05-06-Preview fügt Unterstützung für Zurücksetzungsszenarien hinzu.

Dokumente zurücksetzen ist eine asynchrone API. Es ermöglicht Ihnen, Dokumente aus Ihrer Datenquelle selektiv erneut zu verarbeiten.

Die API akzeptiert zwei Arten von Dokumentbezeichnern als Eingabe. Dabei handelt es sich um Dokumentschlüssel (Schlüssel, die Dokumente in einem Suchindex eindeutig identifizieren) und Datenquellendokumentbezeichner (Schlüssel, die Dokumente in einer Datenquelle eindeutig identifizieren). Beim Aufrufen der API werden die Dokumentschlüssel oder Datenquellendokumentbezeichner hinzugefügt, die auf die Indexermetadaten zurückgesetzt werden sollen. Bei der nächsten geplanten oder bedarfsgesteuerten Ausführung des Indexers verarbeitet der Indexer nur die Zurücksetzungsdokumente.

  • Bei Indexern mit aktiviertem Skillset und inkrementeller Anreicherung löscht die API den Cache und führen das vollständige Skillset nur für die angegebenen Dokumente erneut aus.
  • Bei Indexern ohne Skillset liest die API das Quelldokument aus der Datenquelle und aktualisiert/fügt den Inhalt in den Index ein.

Wenn Sie Dokumentschlüssel zum Zurücksetzen von Dokumenten verwenden und auf Ihre Dokumentschlüssel in einer Indexerfeldzuordnung verwiesen wird, verwendet der Indexer die Feldzuordnung, um das entsprechende Feld in der zugrunde liegenden Datenquelle zu suchen.

Die API funktioniert für alle Indexer (mit oder ohne Skillset). Sie können sie mithilfe einer HTTP POST-Anforderung aufrufen. Wenn der Aufruf erfolgreich ist, erhalten Sie eine 204 NoContent-Antwort. Geben Sie den Namen des Indexers an, der für den Anforderungs-URI aktualisiert werden soll:

POST https://[service name].search.windows.net/indexers/[indexer name]/resetdocs?api-version=[api-version]
    Content-Type: application/json
    api-key: [admin key]

URI-Parameter

Parameter BESCHREIBUNG
Dienstname Erforderlich. Legen Sie dies auf den eindeutigen, benutzerdefinierten Namen Ihres Suchdiensts fest.
Indexername Erforderlich. Der Anforderungs-URI gibt den Namen des zu aktualisierenden Indexers an.
api-version Erforderlich. Die aktuelle Vorschauversion ist 2023-07-01-Preview. Weitere Versionen finden Sie unter API-Versionen .
overwrite Optional. Dieser Parameter bestimmt, ob aufeinanderfolgende Vorgänge zum Zurücksetzen von Dokumenten kombiniert oder überschrieben werden. Der Standardwert ist "false". Bei false wird die Nutzlast des Aufrufs von Dokumentschlüsseln oder Datenquellendokumentbezeichnern der Liste der Schlüssel hinzugefügt, die bereits für die erneute Verarbeitung in die Warteschlange eingereiht wurden. Wenn true, überschreibt die Nutzlast des Aufrufs von Dokumentschlüsseln oder Datenquellendokumentbezeichnern die vorhandene Liste, einschließlich des Löschens der Liste der Zurücksetzungsdokumente, wenn Sie die Schlüssel auf NULL festlegen.

Anforderungsheader

Die folgende Tabelle beschreibt die erforderlichen und optionalen Anforderungsheader.

Felder BESCHREIBUNG
Content-Type Erforderlich. Auf application/json
api-key Optional, wenn Sie Azure-Rollen verwenden und ein Bearertoken für die Anforderung bereitgestellt wird, andernfalls ist ein Schlüssel erforderlich. Ein API-Schlüssel ist eine eindeutige, vom System generierte Zeichenfolge, die die Anforderung bei Ihrem Suchdienst authentifiziert. Zurücksetzungsanforderungen müssen einen api-key Header enthalten, der auf Ihren Administratorschlüssel (im Gegensatz zu einem Abfrageschlüssel) festgelegt ist. Weitere Informationen finden Sie unter Herstellen einer Verbindung mit Azure AI Search mithilfe der Schlüsselauthentifizierung .

Anforderungstext

Der Text sollte entweder eine Liste von Dokumentschlüsseln oder eine Liste von Datenquellendokumentbezeichnern enthalten, nach denen der Indexer in der Datenquelle sucht.

Der folgende JSON-Code ist eine allgemeine Darstellung des Standard Teile der Definition.

{
    "documentKeys" : [
        "key1",
        "key2",
        "key3"
    ],
    "datasourceDocumentIds" : [
        "key1",
        "key2",
        "key3"
    ],
}

Die Anforderung enthält die folgenden Eigenschaften, und beachten Sie, dass nur eine der "documentKeys" und "datasourceDocumentIds" bereitgestellt werden sollte:

Eigenschaft BESCHREIBUNG
documentKeys Dies ist der Satz von Dokumentschlüsseln, die der Indexer selektiv aus seiner Datenquelle verarbeitet. Standardmäßig werden beim mehrfachen Aufrufen dieser Aktion die Dokumentschlüsselsätze angefügt. Dieses Verhalten kann geändert werden, um zu überschreiben, anstatt über den Überschreibungs-URI-Parameter anzufügen (siehe oben). Wenn der Indexer die Verarbeitung von Zurücksetzungsdokumenten beenden soll, können Sie "documentKeys" auf eine leere Liste "[]" festlegen. Dies führt dazu, dass der Indexer die reguläre Indizierung basierend auf der High-Water-Marke fort setzt. Ungültige Dokumentschlüssel oder Dokumentschlüssel, die nicht vorhanden sind, werden ignoriert.
datasourceDocumentIds Dies ist der Satz von Datenquellendokumentbezeichnern, die der Indexer selektiv aus seiner Datenquelle verarbeitet. Standardmäßig fügt das mehrfache Aufrufen dieser Aktion die Datenquellendokumentbezeichner zusammen. Dieses Verhalten kann geändert werden, um zu überschreiben, anstatt über den Überschreibungs-URI-Parameter anzufügen (siehe oben). Wenn der Indexer nicht mehr versucht, Rücksetzungsdokumente zu verarbeiten, können Sie "datasourceDocumentIds" auf eine leere Liste "[]" festlegen. Dies führt dazu, dass der Indexer die reguläre Indizierung basierend auf der High-Water-Marke fort setzt. Ungültige Datenquellendokumentbezeichner oder Datenquellendokumentbezeichner, die nicht vorhanden sind, werden ignoriert.

Antwort

204 Kein Inhalt für eine erfolgreiche Anforderung.

Weitere Informationen