Partager via

range()

  • Article

S’applique à : ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Génère un tableau dynamique contenant une série de valeurs avec des intervalles égaux.

Syntaxe

range(start, stop [, step])

En savoir plus sur les conventions de syntaxe.

Paramètres

Nom Type Requise Description
start scalaire ✔️ Valeur du premier élément dans le tableau résultant.
stop scalaire ✔️ Valeur maximale du dernier élément dans le tableau résultant, de sorte que la dernière valeur de la série est inférieure ou égale à la valeur d’arrêt.
step scalaire Différence entre deux éléments consécutifs du tableau. La valeur par défaut de l’étape est 1 numérique et 1h pour timespan ou datetime.

Retours

Tableau dynamique dont les valeurs sont : démarrer, démarrer + l’étape, ... jusqu’à l’arrêt et y compris. Le tableau est tronqué si le nombre maximal de résultats autorisés est atteint.

Remarque

La fonction de plage prend en charge un maximum de 1 048 576 (2^20) résultats.

Exemples

L’exemple suivant retourne un tableau de nombres d’un à huit, avec un incrément de trois.

print r = range(1, 8, 3)

Sortie

r
[1,4,7]

L’exemple suivant retourne un tableau avec toutes les dates de l’année 2007.

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

Sortie

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

L’exemple suivant retourne un tableau avec des nombres compris entre un et trois.

print range(1, 3)

Sortie

print_0
[1,2,3]

L’exemple suivant retourne une plage d’heures comprises entre une heure et cinq heures.

print range(1h, 5h)

Sortie

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

L’exemple suivant retourne un tableau tronqué, car la plage dépasse la limite de résultats maximale. L’exemple montre que la limite est dépassée à l’aide de l’opérateur mv-expand pour développer le tableau en plusieurs enregistrements, puis en comptant le nombre d’enregistrements.

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

Sortie

Count
1,048,576