AWS awscloudtrail: CloudTrail Lake query cost note on eventTime constraints
Summary
Adds a note explaining that constraining queries with starting/ending eventTime timestamps reduces scanned data on a best-effort basis, that some queries still scan all data, and that BytesScanned from describe-query shows how much data was scanned.
Security assessment
The added text is purely about query cost and performance (data scanned, run time, BytesScanned). It does not address any vulnerability, credential handling, or access control, so it is a non-security documentation change.
Evidence
+Constraining a query with starting and ending `eventTime` time stamps reduces the amount of data scanned on a best-effort basis. Some queries scan all data in the event data store even though they specify an `eventTime` range. Scanning more data does not change the results of a query, but it increases the cost and the run time. To see how much data a query scanned, check the `BytesScanned` value returned by `describe-query`. For more information, see [Get metadata about a query with the AWS CLI](./lake-queries-cli.html#lake-cli-describe-query).
Diff
diff --git a/awscloudtrail/latest/userguide/cloudtrail-lake-queries.md b/awscloudtrail/latest/userguide/cloudtrail-lake-queries.md index 81617db..861dfa1 100644 --- a//awscloudtrail/latest/userguide/cloudtrail-lake-queries.md +++ b//awscloudtrail/latest/userguide/cloudtrail-lake-queries.md @@ -24,0 +25,2 @@ An unbounded query (such as `SELECT * FROM `edsID``) scans all data in your even +Constraining a query with starting and ending `eventTime` time stamps reduces the amount of data scanned on a best-effort basis. Some queries scan all data in the event data store even though they specify an `eventTime` range. Scanning more data does not change the results of a query, but it increases the cost and the run time. To see how much data a query scanned, check the `BytesScanned` value returned by `describe-query`. For more information, see [Get metadata about a query with the AWS CLI](./lake-queries-cli.html#lake-cli-describe-query). +