hash()

Szolgáltatások váltása a Verzió legördülő listával. További információ a navigációról.
A következőkre vonatkozik: ✅ Microsoft Fabric ✅ Azure Data Explorer ✅ Azure Monitor ✅ Microsoft Sentinel

A bemeneti érték kivonatértékét adja vissza.

Megjegyzés:

  • A függvény az xxhash64 algoritmussal számítja ki a kivonatokat, de ez változhat. Javasoljuk, hogy csak egyetlen lekérdezésen belül használja ezt a függvényt.
  • Ha egyesített kivonatot kell őriznie, ajánlott hash_sha256(), hash_sha1() vagy hash_md5() használata, és a kivonatokat bitenkénti operátorral kombinálni. Ezek a függvények összetettebbek, mint hash()a .

Szemantika

hash( forrás [,mod])

További információ szintaxiskonvenciákról.

Paraméterek

Név Típus Kötelező Description
forrás skaláris ✔️ A kivonatolt érték.
mod int A kivonat eredményére alkalmazandó moduloérték, így a kimeneti érték az és 0a között mod - 1 van. Ez a paraméter a lehetséges kimeneti értékek tartományának korlátozásához vagy a kivonatoló függvény kimenetének kisebb tartományba való tömörítéséhez hasznos.

Visszatérítések

A forrás kivonatértéke. Ha a mod meg van adva, a függvény a mod értéke modulo kivonatértékét adja vissza, ami azt jelenti, hogy a függvény kimenete a kivonat értékének fennmaradó része lesz modtal osztva. A kimenet az és 0az , közötti érték mod - 1 lesz.

Példák

Sztringbemenet

print result=hash("World")
eredmény
1846988464401551951

Sztringbemenet moddal

print result=hash("World", 100)
eredmény
51

Datetime bemenet

print result=hash(datetime("2015-01-01"))
eredmény
1380966698541616202

Kivonat használata az adateloszlás ellenőrzéséhez

Az adatok mintavételezéséhez használja a hash() függvényt, ha az egyik oszlopában lévő értékek egyenletesen oszlanak el. Az alábbi példában a StartTime-értékek egységesen vannak elosztva, és a függvény az adatok 10% lekérdezésének futtatására szolgál.

StormEvents 
| where hash(StartTime, 10) == 0
| summarize StormCount = count(), TypeOfStorms = dcount(EventType) by State 
| top 5 by StormCount desc