Partilhar via


ingestion_time()

Aplica-se a: ✅Microsoft FabricAzure Data Explorer✅Azure MonitorMicrosoft Sentinel

Retorna a data e hora aproximada no formato UTC indicando quando o registro atual foi ingerido.

Essa função deve ser usada no contexto de uma tabela ou de uma exibição materializada. Caso contrário, essa função produzirá valores nulos.

Se a política IngestionTime não tiver sido habilitada quando os dados foram ingeridos, a função retornará valores nulos.

Recupera quando datetime o registro foi assimilado e está pronto para consulta.

Observação

O valor retornado por essa função é apenas aproximado, pois o processo de ingestão pode levar vários minutos para ser concluído e várias atividades de ingestão podem ocorrer simultaneamente. Para processar todos os registros de uma tabela com garantias exatamente uma vez, use cursores de banco de dados.

Dica

A função ingestion_time() retorna valores de acordo com o relógio de serviço, conforme medido quando a ingestão foi concluída. Como resultado, esse valor não pode ser usado para "ordenar" operações de ingestão, pois duas operações que se sobrepõem no tempo podem ter qualquer ordenação desses valores. Se a ordenação de registros for importante para a semântica do aplicativo, deve-se garantir que a tabela tenha uma coluna de carimbo de data/hora, medida pela origem dos dados, em vez de depender do valor ingestion_time().

Sintaxe

ingestion_time()

Saiba mais sobre as convenções de sintaxe.

Devoluções

Um datetime valor que especifica o tempo aproximado de ingestão em uma tabela.

Exemplo

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