Log di query
La tabella dei log delle query contiene l'elenco delle query eseguite in un database KQL di Eventhouse, che fa parte dell'intelligence in tempo reale. Per ogni query, un record di eventi del log viene archiviato nella tabella EventhouseQueryLogs .
tabella dei log di query
Usare i log di query per:
- Analizzare le prestazioni e le tendenze delle query.
- Risolvere i problemi relativi alle query lente.
- Identificare query pesanti che utilizzano grandi quantità di risorse di sistema.
- Identificare gli utenti o le applicazioni che eseguono il maggior numero di query.
Nella tabella seguente vengono descritte le colonne archiviate nella tabella EventhouseQueryLogs :
| Nome colonna | Tipo | Descrizione |
|---|---|---|
| CacheColdHitsBytes | long | Quantità di dati di archiviazione ad accesso sporadico disponibili per la query nella cache a freddo a causa del prelettura dei dati. |
| CacheColdMissesBytes | long | Quantità di dati di archiviazione ad accesso sporadico non disponibili per la query nella cache ad accesso sporadico. |
| CacheHotHitsBytes | long | Quantità di dati disponibili per la query nella cache ad accesso frequente. La quantità di dati archiviati nella cache ad accesso frequente è definita dai criteri di memorizzazione nella cache del database o della tabella. |
| CacheHotMissesBytes | long | Quantità di dati non disponibili per la query nella cache ad accesso frequente. |
| CapacityId | string | Identificatore della capacità dell'infrastruttura. |
| ComponentFault | string | In caso di errore di query, il componente in cui si è verificato l'errore. Valori validi: Server e Client. Se il set di risultati della query è troppo grande, il valore è Client. Se si è verificato un errore interno, il valore è Server. |
| CorrelationId | string | Identificatore di correlazione della query. Il valore può includere componenti di altri elementi che partecipano alla query, ad esempio il modello semantico del report che esegue la query. |
| CpuTimeMs | long | Tempo totale CPU (ms) usato dalla query. |
| CustomerTenantId | string | Identificatore del tenant del cliente. |
| DatabaseId | string | Identificatore univoco del database. |
| DatabaseName | string | Nome del database. |
| DurationMs | long | Durata della query (ms). |
| ExtentsMaxScannedTime | datetime | Tempo massimo di analisi dei dati. |
| ExtentsMinScannedTime | datetime | Tempo minimo di analisi dei dati. |
| FailureReason | string | Motivo per cui la query non è riuscita. |
| Identità | dynamic | Identità dell'utente o dell'applicazione che ha eseguito la query. |
| ItemId | string | Identificatore dell'elemento Fabric Eventhouse. |
| ItemKind | string | Tipo di elemento fabric. Valori validi: Eventhouse. |
| ItemName | string | Nome dell'elemento Fabric Eventhouse. |
| Livello | string | Non applicabile. |
| MemoryPeakBytes | long | Picco del consumo di memoria della query. |
| OperationEndTime | datetime | Ora (UTC) terminata l'operazione. |
| OperationId | string | Identificatore univoco del log di query. |
| OperationStartTime | datetime | Ora (UTC) dell'avvio dell'operazione. |
| QueryText | string | Testo della query. |
| Paese | string | Area in cui si trova il database KQL dell'infrastruttura. |
| ResultTableCount | int | Numero di tabelle utilizzate dalla query. |
| ResultTableStatistics | string | Statistiche dettagliate delle tabelle usate dalla query. |
| ScannedExtentsCount | long | Numero di extent analizzati dalla query. Un numero elevato potrebbe indicare la causa di un problema di latenza delle query. |
| ScannedRowsCount | long | Numero di righe analizzate dalla query. Un numero elevato potrebbe indicare la causa di un problema di latenza delle query. |
| SourceApplication | string | Nome dell'applicazione di origine che ha eseguito la query. |
| Stato | string | Stato di completamento della query. |
| Timestamp: | datetime | Ora (UTC) generata dall'evento. |
| TotalExtentsCount | long | Numero totale di extent nel set di risultati. |
| TotalRowsCount | long | Numero totale di righe nel set di risultati. |
| WorkspaceId | string | Identificatore dell'area di lavoro. |
| WorkspaceMonitoringTableName | string | Nome della tabella di monitoraggio dell'area di lavoro. Valori validi: EventhouseQueryLogs. |
| WorkspaceName | string | Nome dell'area di lavoro. |
Query di esempio
È possibile trovare query di esempio nel repository GitHub fabric-samples .