View a markdown version of this page

limit - Amazon CloudWatch Logs

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

limit

使用 limit 指定您希望查詢傳回的日誌事件數目。如果您省略 limit,查詢預設為傳回最多 10,000 個日誌事件。您最多可以指定 100,000 個limit值。

例如,下列範例僅傳回 25 個最新的日誌事件。

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

限制任何

使用 在找到 N 個相符日誌事件時立即limit any N停止查詢,無需掃描剩餘的資料。當您只需要比對事件的範例,而不是特定的排序集時,這可以大幅減少掃描的資料量並加快查詢速度。

使用一般 limit,查詢會掃描時間範圍中的所有資料,然後傳回前 N 個結果。使用 時limit any,查詢會在找到足夠結果後提早完成,這表示傳回的事件可能來自時間範圍的任何部分。

例如,下列查詢會傳回 1 個日誌事件,並在找到相符項目時立即停止掃描:

fields @message | limit any 1
注意

由於 會提早limit any停止掃描,因此不保證結果處於任何特定順序。如果您需要排序結果,請any搭配 使用 limit 而不搭配 sort