Condividi tramite


ingestion_time()

Si applica a: ✅Microsoft Fabric✅Azure Esplora dati Azure MonitorMicrosoft Sentinel

Restituisce il valore datetime approssimativo in formato UTC che indica quando è stato inserito il record corrente.

Questa funzione deve essere utilizzata nel contesto di una tabella o di una vista materializzata. In caso contrario, questa funzione produce valori Null.

Se il criterio IngestionTime non è stato abilitato durante l'inserimento dei dati, la funzione restituisce valori Null.

Recupera l'oggetto datetime quando il record è stato inserito e pronto per la query.

Nota

Il valore restituito da questa funzione è approssimativo, poiché il processo di inserimento può richiedere alcuni minuti per completare e più attività di inserimento possono essere eseguite simultaneamente. Per elaborare tutti i record di una tabella con garanzie di tipo exactly-once, usare i cursori di database.

Suggerimento

La funzione ingestion_time() restituisce valori in base all'orologio del servizio misurato al termine dell'inserimento. Di conseguenza, questo valore non può essere usato per "ordinare" operazioni di inserimento, perché due operazioni che si sovrappongono nel tempo potrebbero avere un ordinamento di questi valori. Se l'ordinamento dei record è importante per la semantica dell'applicazione, è necessario assicurarsi che la tabella abbia una colonna timestamp misurata dall'origine dei dati anziché basarsi sul valore ingestion_time().

Sintassi

ingestion_time()

Altre informazioni sulle convenzioni di sintassi.

Valori restituiti

Valore datetime che specifica il tempo approssimativo di inserimento in una tabella.

Esempio

T
| extend ingestionTime = ingestion_time() | top 10 by ingestionTime