Planen eines Indexers in Azure KI-Suche

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.

Wenn die Indizierung nicht innerhalb des typischen 2-Stunden-Verarbeitungsfensters abgeschlossen werden kann, planen Sie den Indexer so, dass er auf einem 2-Stunden-Takt ausgeführt wird, um ein großes Datenvolumen zu durchlaufen. Solange Ihre Datenquelle Änderungserkennungslogik unterstützt, können Indexer automatisch an der Stelle aufnehmen, an der sie bei jeder Ausführung aufgehört haben.

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.

• Änderungserkennung 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.

Zeitplandefinition

Ein Zeitplan ist Teil der Indexerdefinition. Wenn Sie die schedule Eigenschaft weglassen, wird der Indexer nur bei Bedarf ausgeführt. Die Eigenschaft hat zwei Teile.

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.

var schedule = new IndexingSchedule(TimeSpan.FromDays(1))
{
    StartTime = DateTimeOffset.Now
};

var indexer = new SearchIndexer("demo-idxr", dataSource.Name, searchIndex.Name)
{
    Description = "Demo data indexer",
    Schedule = schedule
};

await indexerClient.CreateOrUpdateIndexerAsync(indexer);

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 Suchdienst 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 zum 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.

Was geschieht, wenn die Indizierung wiederholt im selben 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.

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 Suchdienst abrufen oder detaillierte Informationen abrufen, indem Sie die Ressourcenprotokollierung aktivieren.

• Überwachen des Status von Suchindexern
• Sammeln und Analysieren von Protokolldaten
• Indizieren großer Datasets