Controllo integrità database (DBCC CHECKDB)

Esegue DBCC CHECKDB su un database e registra l’esito in un log, con avviso in caso di errori.

Lo script esegue il controllo di integrità DBCC CHECKDB su un database specifico e registra l’esito (con o senza errori) in un file di log con timestamp.

Prerequisiti Modulo SqlServer, permessi adeguati

Come si usa

Scarica il file, apri PowerShell nella cartella in cui l’hai salvato e avvialo indicando i parametri obbligatori:

.\Verifica-IntegritaDatabase.ps1 -NomeDatabase "<NomeDatabase>"

Sostituisci i valori tra < > con i tuoi.

La stessa esecuzione con tutti i parametri scritti per esteso (qui con i valori predefiniti, da adattare al tuo ambiente):

.\Verifica-IntegritaDatabase.ps1 -ServerSQL "localhost" -NomeDatabase "<NomeDatabase>" -LogPath "C:\Report\IntegritaDatabase_Log.txt"

Parametri

ParametroTipoObbligatorioValore predefinitoA cosa serve
-ServerSQLtestonolocalhostcomputer o istanza su cui lavora Invoke-Sqlcmd
-NomeDatabasetestosì—passato a Invoke-Sqlcmd -Database
-LogPathtestonoC:\Report\IntegritaDatabase_Log.txtfile di testo in cui viene salvato il risultato

Cosa restituisce

  • Un file di testo in C:\Report\IntegritaDatabase_Log.txt (si cambia con -LogPath).
  • Un file di testo in C:\Report\IntegritaDatabase_Log.txt (si cambia con -LogPath).
  • A video, un riepilogo a colori: azzurro per titoli e informazioni, verde quando l’esito è positivo, rosso per errori e problemi.

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-IntegritaDatabase.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.
  • Out-File: scrive il testo in un file.

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
    Esegue DBCC CHECKDB su un database e registra l'esito in un log.
#>
param(
    [string]$ServerSQL = "localhost",
    [Parameter(Mandatory=$true)]
    [string]$NomeDatabase,
    [string]$LogPath = "C:\Report\IntegritaDatabase_Log.txt"
)
Import-Module SqlServer -ErrorAction SilentlyContinue

Write-Host "Esecuzione DBCC CHECKDB su '$NomeDatabase' in corso, puo richiedere tempo su database di grandi dimensioni..." -ForegroundColor Cyan

try {
    $risultato = Invoke-Sqlcmd -ServerInstance $ServerSQL -Database $NomeDatabase -Query "DBCC CHECKDB WITH NO_INFOMSGS, ALL_ERRORMSGS" -QueryTimeout 0 -ErrorAction Stop
    "$(Get-Date) - CHECKDB completato senza errori su $NomeDatabase" | Out-File -FilePath $LogPath -Append
    Write-Host "Nessun errore di integrita rilevato." -ForegroundColor Green
}
catch {
    "$(Get-Date) - ERRORI rilevati su $NomeDatabase : $_" | Out-File -FilePath $LogPath -Append
    Write-Host "[ATTENZIONE] Rilevati errori di integrita. Dettagli in: $LogPath" -ForegroundColor Red
}

Approfondimenti

Privacy Policy Cookie Policy