View a markdown version of this page

limit - Amazon CloudWatch Logs

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

limit

Verwenden Sie limit, um die Anzahl der Protokollereignisse anzugeben, die Ihre Abfrage zurückgeben soll. Wenn Sie weglassen limit, die Abfrage gibt standardmäßig bis zu 10.000 Protokollereignisse zurück. Sie können eine angeben limit Wert von bis zu 100.000.

Das folgende Beispiel gibt beispielsweise nur die letzten 25 Protokollereignisse zurück:

fields @timestamp, @message | sort @timestamp desc | limit 25

beliebig einschränken

Benutzen limit any N um die Abfrage zu beenden, sobald N Es werden übereinstimmende Protokollereignisse gefunden, ohne dass die verbleibenden Daten gescannt werden. Dadurch kann die Menge der gescannten Daten erheblich reduziert und Abfragen beschleunigt werden, wenn Sie nur eine Stichprobe übereinstimmender Ereignisse und nicht eine bestimmte Reihenfolge benötigen.

Mit einem regulären limit, die Abfrage scannt alle Daten im Zeitbereich und gibt dann den obersten Wert zurück N Ergebnisse. Mit limit anywird die Abfrage frühzeitig abgeschlossen, sobald genügend Ergebnisse gefunden wurden, was bedeutet, dass die zurückgegebenen Ereignisse aus einem beliebigen Teil des Zeitbereichs stammen können.

Die folgende Abfrage gibt beispielsweise ein Protokollereignis zurück und stoppt den Scanvorgang, sobald eine Übereinstimmung gefunden wird:

fields @message | limit any 1
Anmerkung

Weil limit any stoppt das Scannen vorzeitig. Es kann nicht garantiert werden, dass die Ergebnisse in einer bestimmten Reihenfolge vorliegen. Wenn Sie geordnete Ergebnisse benötigen, verwenden Sie limit ohne any zusammen mit sort.