Verifica la percentuale di utilizzo del log delle transazioni per ogni database.
Lo script recupera la percentuale di spazio utilizzato nel log delle transazioni di ogni database, segnalando quelli sopra la soglia 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.
.\Verifica-SpazioLogTransazioni.ps1
La stessa esecuzione con tutti i parametri scritti per esteso (qui con i valori predefiniti, da adattare al tuo ambiente):
.\Verifica-SpazioLogTransazioni.ps1 -ServerSQL "localhost" -SogliaPercentoUso 80 -PercorsoCSV "C:\Report\SpazioLogTransazioni.csv"
Parametri
| Parametro | Tipo | Obbligatorio | Valore predefinito | A cosa serve |
|---|---|---|---|---|
-ServerSQL | testo | no | localhost | computer o istanza su cui lavora Invoke-Sqlcmd |
-SogliaPercentoUso | numero intero | no | 80 | — |
-PercorsoCSV | testo | no | C:\Report\SpazioLogTransazioni.csv | file CSV in cui viene salvato il risultato |
Cosa restituisce
- Un file CSV in
C:\Report\SpazioLogTransazioni.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: rosso per errori e problemi, 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 .\Verifica-SpazioLogTransazioni.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
Verifica la percentuale di utilizzo del log delle transazioni per ogni database.
#>
param(
[string]$ServerSQL = "localhost",
[int]$SogliaPercentoUso = 80,
[string]$PercorsoCSV = "C:\Report\SpazioLogTransazioni.csv"
)
Import-Module SqlServer -ErrorAction SilentlyContinue
$query = @"
SELECT DB_NAME(database_id) AS NomeDatabase,
total_log_size_in_bytes / 1024.0 / 1024 AS DimensioneLogMB,
used_log_space_in_percent AS PercentualeUso
FROM sys.dm_db_log_space_usage
"@
$risultati = Invoke-Sqlcmd -ServerInstance $ServerSQL -Query $query
$allarme = $risultati | Where-Object { $_.PercentualeUso -ge $SogliaPercentoUso }
$risultati | Export-Csv -Path $PercorsoCSV -NoTypeInformation -Encoding UTF8 -Delimiter ";"
Write-Host "Controllati $($risultati.Count) log. Sopra soglia: $($allarme.Count)" -ForegroundColor $(if($allarme.Count -gt 0){"Red"}else{"Green"})
Approfondimenti
- Come ridurre le dimensioni di un file di log delle transazioni
- Per farlo girare ogni giorno in automatico: Come pianificare uno script con Task Scheduler
- Tutte le guide Database
- Gli altri script Database