Set statement

Learn how to use the set statement to set a request property for the duration of the query.

The set statement is used to set a request property for the duration of the query.

Request properties control how a query executes and returns results. They can be boolean flags, which are false by default, or have an integer value. A query may contain zero, one, or more set statements. Set statements affect only the tabular expression statements that trail them in the program order. Any two statements must be separated by a semicolon.

Request properties aren’t formally a part of the Kusto Query Language and may be modified without being considered as a breaking language change.

Syntax

set OptionName [= OptionValue]

Parameters

NameTypeRequiredDescription
OptionNamestring✔️The name of the request property.
OptionValue✔️The value of the request property.

Example

This query uses query_take_max_records to limit the number of records retrieved from the StormEvents table. (This is somewhat equivalent to using a | take 100 operator.)

set query_take_max_records=100;
StormEvents

Output

The table shows the first few results.

StartTimeEndTimeEpisodeIdEventIdStateEventType
2007-01-15T12:30:00Z2007-01-15T16:00:00Z16367821OHIOFlood
2007-08-03T01:50:00Z2007-08-03T01:50:00Z1008556083NEW YORKThunderstorm Wind
2007-08-03T15:33:00Z2007-08-03T15:33:00Z1008656084NEW YORKHail
2007-08-03T15:40:00Z2007-08-03T15:40:00Z1008656085NEW YORKHail
2007-08-03T23:15:00Z2007-08-05T04:30:00Z656938232NEBRASKAFlood
2007-08-06T18:19:00Z2007-08-06T18:19:00Z671939781IOWAThunderstorm Wind