Start/notes.ini Parameter/FT_MAX_SEARCH_RESULTS

FT_MAX_SEARCH_RESULTS

Parameter: FT_MAX_SEARCH_RESULTS
Kurzbeschreibung: Hebt die Standardgrenze von 5.000 Rückgabedokumenten für Volltextsuchen in indizierten Datenbanken an oder senkt sie ab.

Steckbrief

Parameter
FT_MAX_SEARCH_RESULTS
Kategorie
Performance / Memory
Komponente
Server, Client
Verfügbar seit
6.0 (älter)
Unterstützte Versionen
9.0.1, 10.0, 11.0, 12.0, 14.0, 14.5, 14.5.1
GUI-Entsprechung
Nur notes.ini (keine GUI)
Mögliche Werte
Ganzzahl; Standard 5000, Maximum 2147483647

Beschreibung

Die Volltextsuche in Domino/Notes liefert standardmäßig maximal 5.000 Treffer pro Anfrage zurück – unabhängig davon, wie viele Dokumente das Suchkriterium tatsächlich erfüllen. Mit FT_MAX_SEARCH_RESULTS lässt sich diese Obergrenze server- bzw. client-weit anheben (oder absenken).
Der Parameter wirkt sowohl in der Notes-Client-Suche als auch für LotusScript-/Java-Aufrufe wie NotesDatabase.FTSearch/FTSearchRange und für REST-/Web-Suchen, sofern die Datenbank volltextindiziert ist. Ist die Datenbank nicht indiziert und läuft der Aufruf in einem Server-Agenten, muss zusätzlich Temp_Index_Max_Doc gesetzt werden – typischerweise auf denselben Wert.
Die Anhebung sollte mit Bedacht erfolgen: jede Suchanfrage, die viele Tausend Dokumente zurückliefert, kostet Speicher und CPU; bei sehr großen Werten droht außerdem, dass Clients/Browser die Ergebnismenge nicht mehr sinnvoll verarbeiten können. HCL empfiehlt, den Wert nur so hoch wie nötig zu setzen.

Beispiel-Konfiguration

Standardverhalten (Parameter nicht gesetzt) – 5.000 Treffer:
FT_MAX_SEARCH_RESULTS=5000
Typische Anhebung für große Mail-/Archiv-Datenbanken auf 65.535:
FT_MAX_SEARCH_RESULTS=65535
Maximalwert (nur in Ausnahmefällen sinnvoll):
FT_MAX_SEARCH_RESULTS=2147483647
Laufzeit-Variante über die Server-Konsole:
set config FT_MAX_SEARCH_RESULTS=65535

Hinweise & Stolperfallen

  • Wirkt nur für volltextindizierte Datenbanken. Für nicht indizierte Datenbanken in Server-Agenten muss zusätzlich Temp_Index_Max_Doc mit demselben Wert gesetzt werden.
  • Lokale Notes-Clients verwenden den lokalen FT_MAX_SEARCH_RESULTS der Workstation – Server-Einstellungen wirken nicht auf reine Client-Aufrufe gegen lokale Datenbanken.
  • HCL-Empfehlung: Wert nicht höher als nötig anheben; bei großen Treffermengen leidet die Performance, und Aufrufer müssen die Rückgabe verarbeiten können.
  • Wirkt dynamisch nach set config FT_MAX_SEARCH_RESULTS=…; ein Server-Restart ist nicht zwingend erforderlich.
  • Hat keinen Einfluss auf die Anzahl der Dokumente, die der Updall-Task indiziert – nur auf die Rückgabe von Suchen.

Quellen (HCL Product Documentation)