Individua le statistiche di tabella non aggiornate da tempo, che possono causare piani di esecuzione inefficienti.
Lo script recupera la data di ultimo aggiornamento delle statistiche di ogni tabella in un database, segnalando quelle non aggiornate da piu della soglia di giorni configurata.
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-StatisticheObsolete.ps1
La stessa esecuzione con tutti i parametri scritti per esteso (qui con i valori predefiniti, da adattare al tuo ambiente):
.\Report-StatisticheObsolete.ps1 -ServerSQL "localhost" -GiorniSoglia 7 -PercorsoCSV "C:\Report\StatisticheObsolete.csv"
Parametri
| Parametro | Tipo | Obbligatorio | Valore predefinito | A cosa serve |
|---|---|---|---|---|
-ServerSQL | testo | no | localhost | computer o istanza su cui lavora Invoke-Sqlcmd |
-NomeDatabase | testo | no | — | passato a Invoke-Sqlcmd -Database |
-GiorniSoglia | numero intero | no | 7 | — |
-PercorsoCSV | testo | no | C:\Report\StatisticheObsolete.csv | file CSV in cui viene salvato il risultato |
Cosa restituisce
- Un file CSV in
C:\Report\StatisticheObsolete.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: giallo per avvisi e valori da controllare.
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-StatisticheObsolete.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 (23 righe): leggilo prima di eseguirlo, come si dovrebbe fare con qualsiasi script preso da Internet.
<#
.SYNOPSIS
Individua le statistiche di tabella non aggiornate da più della soglia configurata.
#>
param(
[string]$ServerSQL = "localhost",
[string]$NomeDatabase,
[int]$GiorniSoglia = 7,
[string]$PercorsoCSV = "C:\Report\StatisticheObsolete.csv"
)
Import-Module SqlServer -ErrorAction SilentlyContinue
$query = @"
SELECT OBJECT_NAME(s.object_id) AS Tabella, s.name AS Statistica,
STATS_DATE(s.object_id, s.stats_id) AS UltimoAggiornamento
FROM sys.stats s
WHERE STATS_DATE(s.object_id, s.stats_id) < DATEADD(DAY, -$GiorniSoglia, GETDATE())
OR STATS_DATE(s.object_id, s.stats_id) IS NULL
"@
$risultati = Invoke-Sqlcmd -ServerInstance $ServerSQL -Database $NomeDatabase -Query $query
$risultati | Export-Csv -Path $PercorsoCSV -NoTypeInformation -Encoding UTF8 -Delimiter ";"
Write-Host "Trovate $($risultati.Count) statistiche non aggiornate da oltre $GiorniSoglia giorni." -ForegroundColor Yellow
Approfondimenti
- Come configurare le statistiche automatiche del query optimizer
- Come diagnosticare una query lenta con il piano di esecuzione
- Per farlo girare ogni giorno in automatico: Come pianificare uno script con Task Scheduler
- Tutte le guide Database
- Gli altri script Database