Individua gli indici con frammentazione sopra soglia, candidati a riorganizzazione o ricostruzione.
Lo script interroga le statistiche di frammentazione fisica degli indici di un database e riporta quelli sopra la soglia percentuale 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-IndiciFrammentati.ps1
La stessa esecuzione con tutti i parametri scritti per esteso (qui con i valori predefiniti, da adattare al tuo ambiente):
.\Report-IndiciFrammentati.ps1 -ServerSQL "localhost" -SogliaFrammentazionePercento 30 -PercorsoCSV "C:\Report\IndiciFrammentati.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 |
-SogliaFrammentazionePercento | numero intero | no | 30 | — |
-PercorsoCSV | testo | no | C:\Report\IndiciFrammentati.csv | file CSV in cui viene salvato il risultato |
Cosa restituisce
- Un file CSV in
C:\Report\IndiciFrammentati.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-IndiciFrammentati.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 (24 righe): leggilo prima di eseguirlo, come si dovrebbe fare con qualsiasi script preso da Internet.
<#
.SYNOPSIS
Individua gli indici con frammentazione sopra soglia in un database.
#>
param(
[string]$ServerSQL = "localhost",
[string]$NomeDatabase,
[int]$SogliaFrammentazionePercento = 30,
[string]$PercorsoCSV = "C:\Report\IndiciFrammentati.csv"
)
Import-Module SqlServer -ErrorAction SilentlyContinue
$query = @"
SELECT OBJECT_NAME(ips.object_id) AS Tabella, i.name AS Indice,
ips.avg_fragmentation_in_percent AS PercentualeFrammentazione
FROM sys.dm_db_index_physical_stats(DB_ID('$NomeDatabase'), NULL, NULL, NULL, 'LIMITED') ips
JOIN sys.indexes i ON i.object_id = ips.object_id AND i.index_id = ips.index_id
WHERE ips.avg_fragmentation_in_percent > $SogliaFrammentazionePercento AND i.name IS NOT NULL
ORDER BY PercentualeFrammentazione DESC
"@
$risultati = Invoke-Sqlcmd -ServerInstance $ServerSQL -Database $NomeDatabase -Query $query
$risultati | Export-Csv -Path $PercorsoCSV -NoTypeInformation -Encoding UTF8 -Delimiter ";"
Write-Host "Trovati $($risultati.Count) indici sopra il $SogliaFrammentazionePercento% di frammentazione." -ForegroundColor Yellow
Approfondimenti
- Come configurare un job di manutenzione indici con SQL Server Agent
- Come ottimizzare una tabella MySQL con indici
- Per farlo girare ogni giorno in automatico: Come pianificare uno script con Task Scheduler
- Tutte le guide Database
- Gli altri script Database