Condividi tramite


queryinsights.exec_requests_history (Transact-SQL)

Si applica a:Endpoint di analisi SQL e Warehouse in Microsoft Fabric

L'in queryinsights.exec_requests_history Microsoft Fabric Data Warehouse fornisce informazioni su ogni richiesta SQL completata.

Nome colonna Tipo di dati Descrizione
distributed_statement_id uniqueidentifier ID univoco per ogni query.
database_name varchar(200) Specifica il nome dell'elemento a cui è stato connesso l'endpoint SQL al momento dell'esecuzione della query.
submit_time datetime2 Ora in cui la richiesta è stata inviata per l'esecuzione.
start_time datetime2 Ora di avvio dell'esecuzione della query.
end_time datetime2 Ora di completamento dell'esecuzione della query.
is_distributed Int Specifica se la query è stata eseguita in una natura distribuita (1) o meno (0).
statement_type varchar(128) Identifica il tipo di comando eseguito. I tipi di istruzioni comuni includono i seguenti valori: SELECT, INSERT, UPDATE, DELETE
total_elapsed_time_ms Int Tempo totale (in millisecondi) impiegato dalla query per terminare.
login_name varchar(128) Nome dell'utente o del sistema che ha inviato la query.
row_count bigint Numero di righe recuperate dalla query.
status varchar(30) Stato della query: Succeeded, Failedo Canceled
session_id piccoloint ID che collega la query a una sessione utente specifica.
connection_id uniqueidentifier Numero di identificazione per la connessione della query. Ammette valori Null.
program_name varchar(128) Nome del programma client che ha avviato la sessione. Il valore è NULL per le sessioni interne. Nullable.
batch_id uniqueidentifier ID per le query raggruppate (se applicabile). Ammette valori Null.
root_batch_id uniqueidentifier ID per il gruppo principale di query (se annidato). Ammette valori Null.
query_hash varchar(200) Valore hash binario calcolato sulla query che consente di identificare query con logica analoga. È possibile usare l'hash della query per correlare tra le viste di Informazioni dettagliate query. Per altre informazioni, vedere Informazioni dettagliate query - Aggregazione.
label varchar(8000) Stringa di etichetta facoltativa associata ad alcune istruzioni di query SELECT.
result_cache_hit Int Mostra lo stato della memorizzazione nella cache dei set di risultati per questa query:

2 - query usata cache set di risultati (hit cache)
1 - Query created result set cache
0 - La query non è applicabile per la creazione o l'utilizzo della cache
allocated_cpu_time_ms bigint Mostra il tempo totale di CPU allocate per l'esecuzione di una query.
data_scanned_remote_storage_mb decimal(18,3) Mostra la quantità di dati analizzati/letti dall'archiviazione remota (One Lake).
data_scanned_memory_mb decimal(18,3) Mostra la quantità di dati analizzati dalla memoria locale. I dati analizzati dal disco e dalla memoria insieme indicano la quantità di dati letti dalla cache.
data_scanned_disk_mb decimal(18,3) Mostra la quantità di dati analizzati/letti dal disco locale. I dati analizzati dal disco e dalla memoria insieme indicano la quantità di dati letti dalla cache.
command varchar(8000) Testo completo della query eseguita.

Autorizzazioni

È necessario avere accesso a un endpoint di analisi SQL o a Un warehouse all'interno di un'area di lavoro della capacità Premium con autorizzazioni di collaboratore o superiore.

Esempi

A. Trova le prestazioni delle query su un testo di comando specifico

Puoi visualizzare queryinsights.exec_requets_history la storia delle esecuzioni di query con comandi su parole chiave, come una tabella, una vista o una colonna. Ad esempio, per cercare query sulla SalesInvoices tabella:

SELECT *
FROM 
    queryinsights.exec_requests_history 
WHERE 
    command LIKE '%SalesInvoices%';

B. Confronta le query con etichette diverse

Puoi queryinsights.exec_requets_history visualizzare per confrontare le differenze tra le query con etichette diverse, ad esempio una query eseguita con o senza clustering dati. Per un tutorial sull'uso del clustering dati in Fabric Data Warehouse, vedi Usa il clustering dei dati in Fabric Data Warehouse.

SELECT *
FROM 
    queryinsights.exec_requests_history 
WHERE 
    command LIKE '%NYTaxi%'
    AND label IN ('Regular','Clustered')
ORDER BY 
  submit_time DESC;

Passo successivo