Compartilhar via


Set statement

Applies to: ✅Microsoft FabricAzure Data ExplorerAzure MonitorMicrosoft Sentinel

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

As propriedades de solicitação controlam como uma consulta é executada e retorna os resultados. Eles podem ser sinalizadores booleanos, que são false por padrão, ou têm um valor inteiro. Uma consulta pode conter zero, uma ou mais instruções set. As instruções set afetam apenas as instruções de expressão tabular que as rastreiam na ordem do programa. Duas instruções devem ser sempre separadas por ponto e vírgula.

As propriedades de solicitação não fazem parte formalmente da Linguagem de Consulta Kusto e podem ser modificadas sem serem consideradas como uma alteração de idioma significativa.

Note

Syntax

set OptionName [=OptionValue]

Learn more about syntax conventions.

Parameters

Name Tipo Required Description
OptionName string ✔️ O nome da propriedade de solicitação.
OptionValue ✔️ O valor da propriedade request.

Example

Essa consulta usa para limitar o número de registros recuperados query_take_max_records da StormEvents tabela. (Isso é um pouco equivalente ao uso de um | take 100 operador.)

The examples in this article use publicly available tables in the help cluster, such as the StormEvents table in the Samples database.

The examples in this article use publicly available tables, such as the Weather table in the Weather analytics sample gallery. Talvez seja necessário modificar o nome da tabela na consulta de exemplo para corresponder à tabela em seu workspace.

set query_take_max_records=100;
StormEvents

Output

A tabela mostra os primeiros resultados.

StartTime EndTime EpisodeId EventId State EventType
2007-01-15T12:30:00Z 2007-01-15T16:00:00Z 1636 7821 OHIO Flood
2007-08-03T01:50:00Z 2007-08-03T01:50:00Z 10085 56083 NEW YORK Thunderstorm Wind
2007-08-03T15:33:00Z 2007-08-03T15:33:00Z 10086 56084 NEW YORK Hail
2007-08-03T15:40:00Z 2007-08-03T15:40:00Z 10086 56085 NEW YORK Hail
2007-08-03T23:15:00Z 2007-08-05T04:30:00Z 6569 38232 NEBRASKA Flood
2007-08-06T18:19:00Z 2007-08-06T18:19:00Z 6719 39781 IOWA Thunderstorm Wind
... ... ... ... ... ...