hash()
S’applique à : ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel
Retourne une valeur de hachage pour la valeur d’entrée.
Remarque
- La fonction calcule les hachages à l’aide de l’algorithme xxhash64, mais cela peut changer. Il est recommandé d’utiliser cette fonction uniquement dans une seule requête.
- Si vous devez conserver un hachage combiné, il est recommandé d’utiliser hash_sha256(), hash_sha1() ou hash_md5() et de combiner les hachages avec un opérateur au niveau du bit. Ces fonctions sont plus complexes à calculer que
hash().
Syntaxe
hash(source [, mod])
En savoir plus sur les conventions de syntaxe.
Paramètres
| Nom | Type | Requise | Description |
|---|---|---|---|
| source | scalaire | ✔️ | Valeur à hacher. |
| mod | int |
Valeur modulo à appliquer au résultat de hachage, afin que la valeur de sortie soit comprise entre 0 et mod - 1. Ce paramètre est utile pour limiter la plage de valeurs de sortie possibles ou pour compresser la sortie de la fonction de hachage dans une plage plus petite. |
Retours
Valeur de hachage de la source. Si le mod est spécifié, la fonction retourne la valeur de hachage modulo la valeur du mod, ce qui signifie que la sortie de la fonction sera le reste de la valeur de hachage divisée par mod. La sortie est une valeur comprise entre 0 et mod - 1inclus.
Exemples
Entrée de chaîne
print result=hash("World")
| result |
|---|
| 1846988464401551951 |
Entrée de chaîne avec mod
print result=hash("World", 100)
| result |
|---|
| 51 |
Entrée Datetime
print result=hash(datetime("2015-01-01"))
| result |
|---|
| 1380966698541616202 |
Utiliser le hachage pour vérifier la distribution des données
Utilisez la hash() fonction pour l’échantillonnage des données si les valeurs de l’une de ses colonnes sont distribuées uniformément. Dans l’exemple suivant, les valeurs StartTime sont distribuées uniformément et la fonction est utilisée pour exécuter une requête sur 10 % des données.
StormEvents
| where hash(StartTime, 10) == 0
| summarize StormCount = count(), TypeOfStorms = dcount(EventType) by State
| top 5 by StormCount desc