Planen eines Indexers in Foundry IQ (Azure KI-Suche)

Hinweis

Foundry IQ (Azure KI-Suche) bietet direkte Indizierungs- und Abfrage-APIs zusammen mit Wissensquellen- und Knowledge Base-APIs auf höherer Ebene für den verwalteten Abruf. Verwenden Sie das Azure Portal, REST-APIs oder Azure SDKs, um diese Funktionen zu konfigurieren, oder verbinden Sie Agents mit Wissensdatenbanken im Microsoft Foundry-Portal.

Legen Sie die schedule Eigenschaft fest, um Indexer so zu konfigurieren, dass sie für einen Zeitplan ausgeführt werden. Die Planung des Indexers ist in folgenden Situationen hilfreich:

  • Quelldaten ändern sich im Laufe der Zeit, und Sie möchten, dass der Indexer den Unterschied automatisch verarbeitet.
  • Quelldaten sind sehr groß, und Sie benötigen einen wiederkehrenden Zeitplan, um alle Inhalte indizieren zu können.
  • Ein Index wird mithilfe mehrerer Indexer aus mehreren Quellen befüllt, und Sie möchten die Aufträge zeitlich staffeln, um Konflikte zu reduzieren.

Verwenden Sie einen Wiederkehrenden Zeitplan, um neue oder geänderte Quellinhalte zu ermitteln. Separat kann die Suche nach dem Beenden der Ausführungszeit der Inhaltsverarbeitung automatisch die nicht abgeschlossene Aufnahme fortsetzen. Solange Ihre Datenquelle die Änderungserkennung unterstützt, können nachfolgende Ausführungen aus dem gespeicherten Fortschritt fortgesetzt werden.

Nachdem Sie einen Indexer in einen Zeitplan gesetzt haben, bleibt er im Zeitplan, bis Sie das Intervall oder die Startzeit löschen oder auf "true" festgelegt disabled haben. Wenn ein geplanter Indexer unerwartet nicht mehr ausgelöst wird, finden Sie unter Häufig gestellte Fragen zum Planungsverhalten Schritte zur Wiederherstellung. Den Indexer zeitgesteuert aktiviert zu lassen, wenn es nichts zu verarbeiten gibt, beeinträchtigt die Systemleistung nicht. Die Überprüfung auf geänderte Inhalte ist ein relativ schneller Vorgang.

Voraussetzungen

  • Ein gültiger Indexer, der mit einer Datenquelle und einem Index konfiguriert ist.

  • Ändern der Erkennung in der Datenquelle. Azure Storage und SharePoint verfügen über eine integrierte Änderungserkennung. Bei anderen Datenquellen, z. B. Azure SQL und Azure Cosmos DB, müssen Sie die Änderungserkennung manuell aktivieren.

Automatische Fortsetzung nach zeitbedingtem Stopp

Wenn eine Ausführung eines Inhaltsverarbeitungsindexers sein Laufzeitkontingent erreicht und berechtigte Arbeit bleibt, wird die Fortsetzung von Search automatisch in die Warteschlange gestellt. Diese vom System generierte Fortsetzung ist getrennt von dem von Ihnen konfigurierten Abrufzeitplan.

Beispielsweise kann eine indizierte Wissensquelle alle 24 Stunden Änderungen abfragen. Wenn der generierte Indexer das Ausführungszeitkontingent während der anfänglichen oder inkrementellen Aufnahme erreicht, werden berechtigte nicht abgeschlossene Arbeiten für die Fortsetzung in die Warteschlange gestellt, anstatt auf die nächste tägliche Umfrage zu warten. Sie müssen das Abfrageintervall nicht allein deshalb verkürzen, um diese Arbeit fortzusetzen.

Die Fortsetzung wird ans Ende der Inhaltsverarbeitungswarteschlange gestellt. Es ist kein sofortiger Neustart, und die Auslastung der Warteschlange kann die Ausführung verzögern. Die nächste Ausführung setzt ab dem gespeicherten Fortschritt fort, anstatt den Indexer zurückzusetzen. Die Arbeit nach dem letzten gespeicherten Prüfpunkt kann erneut verarbeitet werden. Ein großer Aufnahmeauftrag kann mehrere Ausführungsfenster erfordern.

Ergebnis der vorherigen Ausführung Was ist zu erwarten?
Das Ausführungszeitkontingent wurde erreicht, obwohl noch zulässige Aufgaben ausstehen. Suchwarteschlangen setzen die Arbeit fort, sofern Warteschlangen verfügbar sind.
Normaler Abschluss. Für keine unvollendete Arbeit ist eine Kontingentfortsetzung erforderlich. Zukünftige Quelländerungen werden im konfigurierten Zeitplan ermittelt.
Abbruch, dauerhafter Fehler oder ungültige Konfiguration. Verlassen Sie sich nicht auf die Kontingentfortsetzung zur Wiederherstellung. Beheben Sie die Ursache, und verwenden Sie die entsprechende Ausführungs- oder Terminplanungsprozedur.

Das Fortsetzen ändert weder Ihr konfiguriertes Abrufintervall noch erlaubt es zwei gleichzeitige Instanzen desselben Indexers. Geplante und On-Demand-Anforderungen unterliegen weiterhin dem normalen Planungsverhalten. Senden Sie nicht wiederholt manuelle Ausführungen, um die Warteschlange zu umgehen.

Die automatische Fortsetzung entfernt keine Ausführungsgrenzwerte oder garantiert keine Fertigstellungszeit. Wiederholte Fehler können dazu führen, dass ein Backoff geplant wird. Wenn die Ausführung wiederholt beendet wird, ohne Fortschritte zu machen, untersuchen Sie die Quelle, die Dokumentgrößen und die Verarbeitung von Fähigkeiten, anstatt anzunehmen, dass Fortsetzungswiederholungen unbegrenzt bis zum Erfolg fortgesetzt werden. Weitere Informationen finden Sie unter „Problembehandlung bei einer nicht abgeschlossenen Datenaufnahme“.

Verwenden Sie den Ausführungsverlauf, um kontingentbedingte Stopps und den anschließenden Fortschritt zu überwachen. Der hier beschriebene Stop pro Ausführung unterscheidet sich vom dienstweiten kumulativen Laufzeitkontingent für S3 HD- und Serverless-Dienste. Die Fortsetzung umgeht dieses Kontingent nicht.

Zeitplandefinition

Ein Zeitplan ist Teil der Indexerdefinition. Wenn Sie die schedule Eigenschaft weglassen, weist der Indexer keinen wiederkehrenden Abrufzeitplan auf; starten Sie ihn bei Bedarf. Die automatische Fortsetzung für geeignete Elemente unterscheidet sich von der Konfiguration von wiederkehrenden Abfragen. Die Eigenschaft hat zwei Teile.

Eigenschaft BESCHREIBUNG
„interval“ (erforderlich) Die Zeitspanne zwischen dem Start von zwei aufeinanderfolgenden Indexerausführungen. Das kleinste zulässige Intervall beträgt 5 Minuten, und die längste beträgt 1.440 Minuten (24 Stunden). Formatieren Sie es als XSD-„dayTimeDuration“-Wert (eine eingeschränkte Teilmenge eines ISO 8601-Dauerwerts).

Das Muster für diesen Wert lautet: P(nD)(T(nH)(nM)).

Beispiele: PT15M alle 15 Minuten, PT2H alle zwei Stunden.
„startTime“ (optional) Geben Sie die Startzeit in koordinierter Weltzeit (UTC) an. Wenn Sie diesen Wert weglassen, wird die aktuelle Uhrzeit verwendet. Diese Zeitangabe kann in der Vergangenheit liegen. In diesem Fall wird die erste Ausführung so geplant, als wäre der Indexer seit der ursprünglichen Startzeit kontinuierlich ausgeführt worden.

Das folgende Beispiel ist ein Zeitplan, der am 1. Januar um Mitternacht beginnt und alle 2 Stunden ausgeführt wird.

{
    "dataSourceName" : "hotels-ds",
    "targetIndexName" : "hotels-idx",
    "schedule" : { "interval" : "PT2H", "startTime" : "2024-01-01T00:00:00Z" }
}

Konfigurieren eines Zeitplans

Geben Sie Zeitpläne in einer Indexerdefinition an. Verwenden Sie zum Einrichten eines Zeitplans das Azure Portal, REST-APIs oder eine Azure SDK.

  1. Wechseln Sie im Azure Portal zu Ihrem Foundry IQ Service.
  2. Wählen Sie im linken Bereich die Option "Indexer" aus.
  3. Öffnen Sie einen Indexer.
  4. Wählen Sie Settingsaus.
  5. Scrollen Sie nach unten zu "Zeitplan", und wählen Sie dann " Stündlich", " Täglich" oder " Benutzerdefiniert" aus, um ein bestimmtes Datum, eine bestimmte Uhrzeit oder ein benutzerdefiniertes Intervall festzulegen.

Wechseln Sie oben im Index zur Registerkarte Indexerdefinition (JSON), um die Zeitplandefinition im XSD-Format anzuzeigen.

Häufig gestellte Fragen zum Planungsverhalten

Kann ich mehrere Indexeraufträge parallel ausführen?

Sie können mehrere Indexer gleichzeitig ausführen, aber jeder Indexer ist eine einzelne Instanz. Sie können nicht zwei Kopien desselben Indexers gleichzeitig ausführen.

Bei der textbasierten Indizierung kann der Scheduler so viele Indizierungsaufträge starten, wie der Foundry IQ-Dienst unterstützt, den die Anzahl der Sucheinheiten bestimmt. Wenn der Dienst beispielsweise drei Replikate und vier Partitionen aufweist, können Sie zwölf Indexeraufträge gleichzeitig ausführen, unabhängig davon, ob sie bedarfsgesteuert oder nach einem Zeitplan eingeleitet werden.

Indexer für die skillbasierte Indizierung werden in einer spezifischen Ausführungsumgebung ausgeführt. Aus diesem Grund wirkt sich die Anzahl der Diensteinheiten nicht auf die Anzahl der fähigkeitenbasierten Indexeraufträge aus, die Sie ausführen können. Mehrere skillbasierte Indexer können parallel ausgeführt werden. Dies hängt jedoch von der Verfügbarkeit des Inhaltsprozessors innerhalb der Ausführungsumgebung ab.

Beginnen geplante Aufträge immer zu dem festgelegten Zeitpunkt?

Indexerprozesse können sich anstauen und je nach Verarbeitungslast und anderen Faktoren möglicherweise nicht genau zum angegebenen Zeitpunkt starten. Wenn beispielsweise ein Indexer noch läuft, wenn seine nächste geplante Ausführung beginnen soll, wird die anstehende Ausführung auf den nächsten planmäßigen Termin verschoben, sodass der aktuelle Vorgang abgeschlossen werden kann.

Um dieses Verhalten konkreter zu gestalten, betrachten Sie das folgende Beispiel. Angenommen, Sie konfigurieren einen Indexerplan mit einem Stundenintervall und einer Startzeit vom 1. Januar 2024 um 8:00:00 Uhr UTC. Folgendes könnte passieren, wenn eine Indexerausführung länger als eine Stunde dauert:

  1. Die erste Indexerausführung beginnt am 1. Januar 2024 um ca. 8:00 Uhr (UTC) oder genau um 8:00 Uhr (UTC). Angenommen, diese Ausführung dauert 20 Minuten (oder hat eine andere Dauer unter 1 Stunde).

  2. Die zweite Ausführung beginnt am 1. Januar 2024 um ca. 9:00 Uhr (UTC) oder genau um 9:00 Uhr (UTC). Angenommen, diese Ausführung dauert 70 Minuten – mehr als eine Stunde – und es wird erst nach 10:10 Uhr UTC abgeschlossen.

  3. Der Start der dritten Ausführung ist für 10:00 Uhr (UTC) geplant, aber zu diesem Zeitpunkt ist die vorherige Ausführung noch nicht abgeschlossen. Diese geplante Ausführung wird dann übersprungen. Die nächste Ausführung des Indexers beginnt erst um 11:00 Uhr UTC.

In seltenen Fällen, etwa während Wartungsarbeiten oder bei der Wiederherstellung nach vorübergehenden Zuständen, stellt das System mehrere Indexer-Ausführungen in die Warteschlange. Wenn diese Bedingung auftritt, führt der Indexer ausstehende Workloads sequenziell innerhalb des geplanten Fensters aus. Wenn ein Indizierer beispielsweise so geplant ist, dass er stündlich ausgeführt wird, und mehrere Ausführungen verzögert wurden oder bei Bedarf ausgelöst wurden, werden die in der Warteschlange befindlichen Einzelvorgänge unmittelbar nacheinander ausgeführt, bis die Warteschlange abgearbeitet ist. Diese Läufe sind keine zusätzlichen Läufe, sondern stellen zuvor geplante oder angeforderte Ausführungen dar. Dieses Verhalten ist zwar in den meisten Szenarien ungewöhnlich, aber der Indexer dient schließlich dazu, alle in die Warteschlange eingereihten Aufgaben zu verarbeiten, um Konsistenz und Aktualität der Daten aufrechtzuerhalten.

Hinweis

Wenn Sie strenge Indizierungsausführungsanforderungen haben, die zeitempfindlich sind, sollten Sie das Push-API-Modell verwenden, damit Sie die Indizierungspipeline direkt steuern können.

Was geschieht, wenn die Indizierung wiederholt bei demselben Dokument fehlschlägt?

Wenn Sie einen Indexer auf einen bestimmten Zeitplan festlegen, aber es wiederholt auf demselben Dokument jedes Mal fehlschlägt, beginnt der Indexer mit der Ausführung in einem weniger häufigen Intervall (bis zum maximalen Intervall von mindestens einmal alle 2 Stunden oder 24 Stunden, je nach verschiedenen Implementierungsfaktoren), bis er erfolgreich erneut voranschreitet. Wenn Sie glauben, dass Sie das zugrunde liegende Problem behoben haben, führen Sie den Indexer manuell aus. Wenn die Indizierung erfolgreich ist, kehrt der Indexer zu seinem regulären Zeitplan zurück. Wenn der Indexer nach einem erfolgreichen manuellen Lauf nicht zu seinem regulären Zeitplan zurückkehrt, siehe die nächste Frage.

Ein geplanter Indexer wurde nicht mehr ausgelöst. Wie kann ich den Zeitplan zurücksetzen?

Wenn ein geplanter Indexer nicht mehr ausgeführt wird, deaktivieren Sie ihn, und aktivieren Sie ihn dann erneut, um den Zeitplan zurückzusetzen. Ein Zeichen, dass diese Wiederherstellung erforderlich ist: Es werden keine neuen Ausführungsläufe im Ausführungsverlauf angezeigt, obwohl der Zeitplan konfiguriert ist und die Datenquelle geändert wurde.

Wenn disabled auf true gesetzt wird, wird der Zeitplan ausgesetzt. Wenn Sie sie wieder auf false setzen (oder die Eigenschaft weglassen), wird die Planung fortgesetzt, wobei die aktuelle Zeit als neuer Ausgangspunkt für das konfigurierte Intervall verwendet wird.

  1. Wechseln Sie im Azure-Portal zu Ihrem Foundry IQ-Dienst.
  2. Wählen Sie Indexers aus.
  3. Wählen Sie den Indexer aus, um ihn zu öffnen.
  4. Wählen Sie Settingsaus.
  5. Legen Sie den Indexer auf "Deaktiviert" fest.
  6. Wählen Sie Speichern aus.
  7. Legen Sie den Indexer wieder auf "Aktiviert" fest.
  8. Wählen Sie Speichern aus.
  9. Wählen Sie die Registerkarte "Ausführungsverlauf " aus, und überprüfen Sie, ob eine neue Ausführung im nächsten geplanten Intervall angezeigt wird.

Hinweis

Durch erneutes Aktivieren des Indexers wird der Zeitplan relativ zur aktuellen Uhrzeit und nicht zum Ursprünglichen startTimezurückgesetzt. Wenn das Intervall zum Beispiel zwei Stunden beträgt und Sie um 15:15 Uhr wieder aktivieren, findet die nächste geplante Ausführung ungefähr um 17:15 Uhr statt.

Nächste Schritte

Für Indexer, die nach einem Zeitplan ausgeführt werden, können Sie Vorgänge überwachen, indem Sie den Status aus dem Foundry IQ-Dienst abrufen oder detaillierte Informationen abrufen, indem Sie die Ressourcenprotokollierung aktivieren.