Partilhar 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 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 acompanham na ordem do programa. Quaisquer duas instruções devem ser separadas por ponto-e-vírgula.

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

Note

  • To set request properties using T-SQL, see Set request properties.
  • Para definir propriedades de solicitação usando obibliotecas de cliente Kusto , consulte classe Kusto Data ClientRequestProperties.

Syntax

set OptionName [=OptionValue]

Learn more about syntax conventions.

Parameters

Name Tipo Required Description
OptionName string ✔️ O nome da propriedade request.
OptionValue ✔️ O valor da propriedade request.

Example

Essa consulta é usada query_take_max_records para limitar o número de registros recuperados da StormEvents tabela. (Isso é um pouco equivalente a usar 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 espaço de trabalho.

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
... ... ... ... ... ...