hash()hash()

Restituisce un valore hash per il valore di input.Returns a hash value for the input value.

SintassiSyntax

hash(origine [ , Mod])hash(source [, mod])

ArgomentiArguments

  • source: valore di cui eseguire l'hashing.source: The value to be hashed.
  • mod: valore facoltativo del modulo da applicare al risultato hash, in modo che il valore di output sia compreso tra 0 e Mod -1mod: An optional module value to be applied to the hash result, so that the output value is between 0 and mod - 1

RestituisceReturns

Valore hash dell'oggetto scalare specificato, modulo del valore del mod specificato (se specificato).The hash value of the given scalar, modulo the given mod value (if specified).

Avviso

L'algoritmo utilizzato per calcolare l'hash è xxhash.The algorithm used to calculate the hash is xxhash. Questo algoritmo potrebbe cambiare in futuro e l'unica garanzia è che all'interno di una singola query tutte le chiamate di questo metodo utilizzano lo stesso algoritmo.This algorithm might change in the future, and the only guarantee is that within a single query all invocations of this method use the same algorithm. Di conseguenza, si consiglia di non archiviare i risultati di hash() in una tabella.Consequently, you are advised not to store the results of hash() in a table. Se è richiesto il salvataggio permanente dei valori hash, usare invece hash_sha256 () o hash_md5 () .If persisting hash values is required, use hash_sha256() or hash_md5() instead. Si noti che queste funzioni sono più complesse del calcolo di hash() .Note that these functions are more complex to calculate than hash()).

EsempiExamples

hash("World")                   // 1846988464401551951
hash("World", 100)              // 51 (1846988464401551951 % 100)
hash(datetime("2015-01-01"))    // 1380966698541616202

Nell'esempio seguente viene utilizzata la funzione hash per eseguire una query sul 10% dei dati. è utile utilizzare la funzione hash per il campionamento dei dati quando si presuppone che il valore sia distribuito in modo uniforme (in questo valore StartTime di esempio)The following example uses the hash function to run a query on 10% of the data, It is helpful to use the hash function for sampling the data when assuming the value is uniformly distributed (In this example StartTime value)

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