hash()
Gilt für: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel
Gibt einen Hashwert für den Eingabewert zurück.
Hinweis
- Die Funktion berechnet Hashes mithilfe des xxhash64-Algorithmus, dies kann sich jedoch ändern. Es wird empfohlen, diese Funktion nur in einer einzigen Abfrage zu verwenden.
- Wenn Sie einen kombinierten Hash beibehalten müssen, empfiehlt es sich, hash_sha256(), hash_sha1()) oder hash_md5() zu verwenden und die Hashes mit einem bitweisen Operator zu kombinieren. Diese Funktionen sind komplexer zu berechnen als
hash().
Syntax
hash(source [, mod])
Erfahren Sie mehr über Syntaxkonventionen.
Parameter
| Name | Type | Erforderlich | Beschreibung |
|---|---|---|---|
| Quelle | Skalarwert | ✔️ | Der wert, der hashed werden soll. |
| mod | int |
Ein Modulowert, der auf das Hashergebnis angewendet werden soll, sodass der Ausgabewert zwischen 0 und mod - 1. Dieser Parameter eignet sich zum Einschränken des Bereichs möglicher Ausgabewerte oder zum Komprimieren der Ausgabe der Hashfunktion in einen kleineren Bereich. |
Gibt zurück
Der Hashwert der Quelle. Wenn mod angegeben ist, gibt die Funktion das Hashwertmodulo den Wert des Mods zurück, was bedeutet, dass die Ausgabe der Funktion der Rest des Hashwerts dividiert durch Mod ist. Die Ausgabe ist ein Wert zwischen 0 und mod - 1einschließlich.
Beispiele
Zeichenfolgeneingabe
print result=hash("World")
| result |
|---|
| 1846988464401551951 |
Zeichenfolgeneingabe mit Mod
print result=hash("World", 100)
| result |
|---|
| 51 |
Datetime-Eingabe
print result=hash(datetime("2015-01-01"))
| result |
|---|
| 1380966698541616202 |
Verwenden von Hash zum Überprüfen der Datenverteilung
Verwenden Sie die hash() Funktion zum Sampling von Daten, wenn die Werte in einer ihrer Spalten einheitlich verteilt sind. Im folgenden Beispiel werden StartTime-Werte einheitlich verteilt, und die Funktion wird verwendet, um eine Abfrage auf 10 % der Daten auszuführen.
StormEvents
| where hash(StartTime, 10) == 0
| summarize StormCount = count(), TypeOfStorms = dcount(EventType) by State
| top 5 by StormCount desc