range()

Alterne entre serviços usando a lista suspensa Version. Saiba mais sobre navegação.
Aplica a: ✅ Microsoft Fabric ✅ Azure Data Explorer ✅ Azure Monitor ✅ Microsoft Sentinel

Gera um array dinâmico que contém uma série de valores igualmente espaçados.

Sintaxe

range( Início,Pára [,passo])

Saiba mais sobre convenções de sintaxe.

Parâmetros

Nome	Tipo	Obrigatório	Description
começar	escalar	✔️	O valor do primeiro elemento no array resultante.
Pára	escalar	✔️	O valor máximo do último elemento do array resultante, tal que o último valor da série seja menor ou igual ao valor de parada.
degrau	escalar		A diferença entre dois elementos consecutivos do array. O valor padrão para step é 1 para numérico e 1h para timespan ou datetime.

Devoluções

Um array dinâmico cujos valores são: início, início + passo, ... até e incluindo stop. O array é truncado se for atingido o número máximo de resultados permitidos.

Observação

A função de alcance suporta um máximo de 1.048.576 (2^20) resultados.

Examples

O exemplo seguinte devolve um array de números de um a oito, com um incremento de três.

Executar a consulta

print r = range(1, 8, 3)

Output

r
[1,4,7]

O exemplo seguinte devolve um array com todas as datas do ano de 2007.

Executar a consulta

print r = range(datetime(2007-01-01), datetime(2007-12-31), 1d)

Output

r
["2007-01-01T00:00:00.000000Z","2007-01-02T00:00:00.000000Z","2007-01-03T00:00:00.000000Z",.....,"2007-12-31T00:00:00:000000Z"]

O exemplo seguinte devolve um array com números entre um e três.

Executar a consulta

print range(1, 3)

Output

print_0
[1,2,3]

O exemplo seguinte devolve um intervalo de horas entre uma hora e cinco horas.

Executar a consulta

print range(1h, 5h)

Output

print_0
1,000,000
["01:00:00","02:00:00","03:00:00","04:00:00","05:00:00"]:

O exemplo seguinte devolve um array truncado à medida que o intervalo excede o limite máximo de resultados. O exemplo demonstra que o limite é ultrapassado usando o operador mv-expand para expandir o array em múltiplos registos e depois contando o número de registos.

Executar a consulta

print r = range(1,1000000000) 
| mv-expand r 
| count

Output

Contar
1 048 576