DokumentationExperience Cloud KCS

Der von SIM verwaltete Index ist für Abfragen in AEM as a Cloud Service nicht ausgewählt.

Letzte Aktualisierung: 11. August 2026

In Adobe Experience Manager as a Cloud Service kann eine SIM-Definition (Simplified Index Management) erfolgreich bereitgestellt werden, während Abfragen weiterhin einen vorherigen Index verwenden. Der Abfrageplaner bewertet geeignete Indizes anhand von Abfragebeschränkungen, indizierten Eigenschaften und geschätzten Kosten. Um dies zu beheben, überprüfen Sie den Bereitstellungs- und Abfrageplan, richten Sie includedPaths-, queryPaths- und Indexregeln an den Abfrageanforderungen aus, stellen Sie die Änderungen über Cloud Manager bereit und validieren Sie die Abfragen nach Abschluss der Indizierung.

Beschreibung description

Umgebung

Adobe Experience Manager as a Cloud Service mit vereinfachter Indexverwaltung

Problem/Symptome

Nachdem Sie eine vereinfachte Indexverwaltungsdefinition bereitgestellt haben, verwenden Abfragen weiterhin einen vorherigen Index anstelle des vorgesehenen SIM-verwalteten Index.

  • Bei Abfragen wird weiterhin ein vorheriger Index wie cqPageLucene anstelle des vorgesehenen Index wie cqPageContent verwendet.
  • Der von SIM verwaltete Index wird im Repository angezeigt, aber das Abfrageleistungs-Tool wählt ihn nicht für die relevanten Abfragen aus.
  • Die Indexdefinition enthält includedPaths und queryPaths, aber die Abfrage verwendet weiterhin den vorherigen Index.
  • Erforderliche Abfrageeigenschaften sind nicht in den SIM-verwalteten Indexregeln enthalten.
  • In den Protokollen wird keine spezifische Fehlermeldung angezeigt.

Ursache

Der Abfrageplaner wählt den geeigneten Index mit den niedrigsten geschätzten Kosten aus. Wenn der von SIM verwaltete Index den Abfragepfad oder die erforderlichen Eigenschaften nicht abdeckt oder seine geschätzten Kosten höher als der vorherige Index sind, verwendet die Abfrage weiterhin den vorherigen Index.

Lösung resolution

Gehen Sie wie folgt vor, um Fehler bei der Indexauswahl zu beheben:

  1. Führen Sie die betroffene Abfrage im Abfrageleistungs-Tool aus und überprüfen Sie die Ausgabe „Abfrage erläutern“.

    • Überprüfen, welcher Index von der Abfrage verwendet wird.
    • Überprüfen Sie, ob der beabsichtigte SIM-verwaltete Index vom Abfrageplan berücksichtigt wird.
    • Notieren Sie den Abfrageplan und die geschätzten Kosten für den Vergleich, nachdem Sie die Indexdefinition aktualisiert haben.

  2. Überprüfen Sie, ob die SIM-Definition korrekt bereitgestellt wurde.

    • Überprüfen Sie, ob die SIM-Definition in der Projekt-Code-Basis enthalten ist.
    • Bestätigen Sie, dass die Pipeline Cloud Manager erfolgreich abgeschlossen wurde.
    • Verwenden Sie Repository-Browser, um zu überprüfen, ob die generierte Indexdefinition, z. B. /oak:index/<sim-index-name>, mit der erwarteten Konfiguration vorhanden ist.

  3. Überprüfen Sie die Pfadkonfiguration in der Indexdefinition.

    • Bestätigen Sie, dass includedPaths den Inhalt abdeckt, den der Index enthalten soll.
    • Vergewissern Sie sich, dass queryPaths die von der Abfrage verwendeten Pfadeinschränkungen behandelt.
    • Verwenden Sie übereinstimmende Werte für includedPaths und queryPaths, wenn der Index Abfragen für denselben Inhaltsbereich enthalten und bereitstellen soll.
    • Hinweis: includedPaths steuert den Umfang der indizierten Inhalte, während queryPaths beeinflusst, ob der Index für eine Abfrage mit einer entsprechenden Pfadbeschränkung geeignet ist.

  4. Überprüfen Sie die für die Abfrage erforderlichen Indexregeln und Eigenschaften.

    • Vergewissern Sie sich, dass jede von der Abfrage verwendete Eigenschaft in der entsprechenden Indexregel indiziert ist.
    • Überprüfen Sie Eigenschaften wie jcr:content/cq:lastModified, excludeSearch und hideFromExternalUser, wenn die Abfrage sie verwendet.
    • Wenn eine erforderliche Eigenschaft fehlt, fügen Sie die entsprechende Indexregel zur SIM-Definition hinzu und stellen Sie sie über die Pipeline Cloud Manager erneut bereit.

  5. Stellen Sie die aktualisierte Indexdefinition über die standardmäßige Cloud ManagerPipeline bereit.

    • Verpacken Sie die aktualisierte Indexdefinition als Teil der Projekt-Codebasis.
    • Führen Sie die Pipeline aus und lassen Sie zu, dass der Indizierungs- oder Neuindizierungsprozess abgeschlossen wird.
    • Überprüfen Sie den Indizierungsstatus auf der Cloud Manager-Build-Seite, bevor Sie die Abfrage erneut validieren.

  6. Validieren des Abfrageverhaltens nach Abschluss der Indizierung.

    • Führen Sie die betroffene Abfrage im Abfrageleistungs-Tool) erneut .
    • Vergewissern Sie sich, dass der beabsichtigte SIM-verwaltete Index in der Ausgabe „Abfrage erläutern“ ausgewählt ist.
    • Testen Sie einen repräsentativen Satz von Abfragen mit hoher Auswirkung.
    • Ergebnisse und Ranking vor und nach der Migration vergleichen, insbesondere bei Abfragen mit erweiterten Feldern wie Titel, Beschreibung und Inhalt.
    • Verwenden Sie das Abfrageleistungs-Tool um nach Leistungs-Regressionen zu suchen.

  7. Entfernen Sie veraltete Indexdefinitionen aus der Projekt-Codebasis, nachdem Sie den neuen SIM-verwalteten Index validiert haben.

    • Löschen Sie Indexknoten nicht manuell aus dem Repository.
    • Hinweis: alte und neue Indexversionen können während einer rollierenden Bereitstellung vorübergehend nebeneinander bestehen, während AEM as a Cloud Service die neue Version vorbereitet.

Hinweise:

  • SIM wird für Seiten-, DAM- und Audit-Indizes empfohlen. Die Migration ist nicht obligatorisch, wenn ein vorhandener Index Ihre Anforderungen erfüllt und weiterhin unterstützt wird.
  • Nehmen Sie Indizes ohne benutzerdefinierte Abfragepfade, wie Audit Event oder eine benutzerdefinierte Email Index, nur dann in die Migrationskonfiguration auf, wenn Sie ihre Abfragen nach SIM migrieren möchten.
  • Migrieren benutzerdefinierter Indizes nach SIM, wenn fortlaufende Unterstützung und zukünftige Kompatibilität erforderlich sind.

Verwandtes Lesen

recommendation-more-help
experience-cloud-kcs-help-kbarticles