Individua le query con tempo medio di esecuzione piu alto, a partire dalle statistiche interne del motore.
Lo script interroga le statistiche di esecuzione mantenute internamente da SQL Server e restituisce le query con il tempo medio di esecuzione piu alto, insieme al numero di volte che sono state eseguite.
Come si usa
Scarica il file, apri PowerShell nella cartella in cui l’hai salvato ed eseguilo: tutti i parametri hanno un valore predefinito, quindi basta il nome dello script.
.\Report-QueryLente.ps1
La stessa esecuzione con tutti i parametri scritti per esteso (qui con i valori predefiniti, da adattare al tuo ambiente):
.\Report-QueryLente.ps1 -ServerSQL "localhost" -Top 20 -PercorsoCSV "C:\Report\QueryLente.csv"
Parametri
| Parametro | Tipo | Obbligatorio | Valore predefinito | A cosa serve |
|---|---|---|---|---|
-ServerSQL | testo | no | localhost | computer o istanza su cui lavora Invoke-Sqlcmd |
-Top | numero intero | no | 20 | — |
-PercorsoCSV | testo | no | C:\Report\QueryLente.csv | file CSV in cui viene salvato il risultato |
Cosa restituisce
- Un file CSV in
C:\Report\QueryLente.csv(si cambia con-PercorsoCSV) con il punto e virgola come separatore, così Excel in italiano lo apre già diviso in colonne. - A video, un riepilogo a colori: verde quando l’esito è positivo.
Requisiti
- Modulo SqlServer dalla PowerShell Gallery:
Install-Module SqlServer -Scope CurrentUser. - La cartella di destinazione (
C:\Report) deve già esistere: lo script non la crea. - Se Windows blocca l’esecuzione perché il file arriva da Internet, sbloccalo una volta con
Unblock-File .\Report-QueryLente.ps1.
I comandi usati dallo script
Invoke-Sqlcmd: esegue una query T-SQL su un’istanza SQL Server e restituisce le righe come oggetti PowerShell.Export-Csv: salva gli oggetti in un file CSV, una colonna per ogni proprietà.
Il codice completo
È lo stesso contenuto del file scaricabile (25 righe): leggilo prima di eseguirlo, come si dovrebbe fare con qualsiasi script preso da Internet.
<#
.SYNOPSIS
Individua le query con tempo medio di esecuzione più alto sull'istanza.
#>
param(
[string]$ServerSQL = "localhost",
[int]$Top = 20,
[string]$PercorsoCSV = "C:\Report\QueryLente.csv"
)
Import-Module SqlServer -ErrorAction SilentlyContinue
$query = @"
SELECT TOP $Top
qs.total_elapsed_time / qs.execution_count / 1000.0 AS MsMedioEsecuzione,
qs.execution_count AS NumeroEsecuzioni,
SUBSTRING(st.text, (qs.statement_start_offset/2)+1,
((CASE qs.statement_end_offset WHEN -1 THEN DATALENGTH(st.text) ELSE qs.statement_end_offset END - qs.statement_start_offset)/2)+1) AS TestoQuery
FROM sys.dm_exec_query_stats qs
CROSS APPLY sys.dm_exec_sql_text(qs.sql_handle) st
ORDER BY MsMedioEsecuzione DESC
"@
$risultati = Invoke-Sqlcmd -ServerInstance $ServerSQL -Query $query
$risultati | Export-Csv -Path $PercorsoCSV -NoTypeInformation -Encoding UTF8 -Delimiter ";"
Write-Host "Esportate le $Top query piu lente in: $PercorsoCSV" -ForegroundColor Green
Approfondimenti
- Come diagnosticare una query lenta con il piano di esecuzione
- Come configurare le statistiche automatiche del query optimizer
- Per farlo girare ogni giorno in automatico: Come pianificare uno script con Task Scheduler
- Tutte le guide Database
- Gli altri script Database