Test-DbaLastBackup: Backups wirklich wiederherstellen
Eine Sicherung ist erst belegt, wenn sie sich wiederherstellen lässt und die Datenbank danach in Ordnung ist. Dass die Datei existiert und der Sicherungsjob grün war, sagt darüber wenig.
In unserem Lab hatte eine Datenbank eine beschädigte Datenseite. Die Sicherung lief durch, die Wiederherstellung ebenfalls. Erst DBCC CHECKDB auf der wiederhergestellten Kopie fand den Schaden. Die schnellere Prüfung -VerifyOnly meldete für dieselbe Sicherung „Success“.
dbatools hat für diese Probe einen eigenen Befehl: Test-DbaLastBackup. Diese Seite zeigt, was er tut, wohin er wiederherstellt, welcher Aufruf im Lab funktioniert hat und wo die Ergebnisse weniger aussagen, als ihr Name verspricht. Wie man sichert und eine Sicherungsstrategie aufbaut, steht in unserer Reihe Backup & Restore.
In 60 Sekunden
- Was der Befehl tut: Er sucht in der Sicherungshistorie die letzte Voll-, Differenz- und Logsicherung, stellt sie als
dbatools-testrestore-<Name>wieder her, lässtDBCC CHECKDBlaufen und löscht die Kopie wieder. - Ohne
-Destinationstellt er auf der Quellinstanz wieder her. Wiederherstellung und CHECKDB laufen dann auf dem Produktionsserver, mit dessen Speicherplatz und Last. Geben Sie eine Testinstanz an. - Eine andere Instanz braucht einen gemeinsamen Pfad. Liegen die Sicherungen auf einem lokalen Pfad, überspringt der Befehl das Ziel mit
Restore not located on shared location. Mit-Pathauf einen Ordner, den beide Instanzen sehen, funktionierte es; unter Windows auch mit Sicherungen auf einer Netzwerkfreigabe oder mit-CopyFile. -VerifyOnlyreicht nicht. Es prüft nur, ob die Sicherung lesbar ist, und findet keine beschädigte Datenseite. Bis Version 2.9.1 prüft es außerdem nur die erste Datei einer Sicherungskette, und-Checksumkam bei SQL Server nicht an.- Instanznamen übergeben, keine Verbindungsobjekte. Der Befehl verbindet sich intern neu und verliert dabei Zertifikatsvertrauen und Anmeldedaten eines übergebenen Objekts. Nach einem Abbruch blieb die Testdatenbank liegen.
- Ergebnis auswerten. Bei einem Schaden steht in
DbccResultdie Meldung von SQL Server, nicht das Wort „Failure“.
1 · Warum Wiederherstellen plus CHECKDB
Eine Sicherung kann auf drei Arten unbrauchbar sein: Die Datei fehlt oder ist unlesbar, die Kette aus Voll-, Differenz- und Logsicherung ist unterbrochen, oder die gesicherte Datenbank war schon beschädigt. Nur der dritte Fall braucht CHECKDB, und er ist der tückischste. Die Sicherung sieht fehlerfrei aus und enthält den Schaden trotzdem.
BACKUP … WITH CHECKSUM prüft beim Sichern die Prüfsummen der Datenseiten. Im Lab hat SQL Server die Sicherung der beschädigten Datenbank so tatsächlich abgelehnt:
BACKUP 'dbt_kaputt' detected an error on page (1:508) in file '/var/opt/mssql/data/dbt_kaputt.mdf'.
BACKUP DATABASE is terminating abnormally.Ohne CHECKSUM, und das ist der Standard, solange Sie es nicht in den Sicherungsjobs oder mit der Serveroption backup checksum default einschalten, lief dieselbe Sicherung ohne Meldung durch. Danach findet nur noch eine Wiederherstellung mit anschließendem CHECKDB den Schaden.
2 · Was Test-DbaLastBackup Schritt für Schritt tut
- Es liest aus
msdbdie letzte Vollsicherung je Datenbank, dazu die letzte Differenzsicherung und die Logsicherungen danach. - Es stellt diese Kette als neue Datenbank
dbatools-testrestore-<Name>wieder her und benennt dabei die Dateien um. - Es führt
DBCC CHECKDBauf der neuen Datenbank aus. - Es löscht die Testdatenbank und gibt je Datenbank ein Ergebnisobjekt aus.
Die wichtigsten Parameter (Hilfe von 2.9.1):
| Parameter | Wirkung |
|---|---|
-Destination, -DestinationSqlCredential | Zielinstanz für die Probe; ohne Angabe die Quellinstanz |
-Path | Ordner mit Sicherungsdateien durchsuchen statt der Historie; dann ist -Destination Pflicht |
-Database, -ExcludeDatabase | Auswahl; ohne Angabe alle Datenbanken |
-VerifyOnly | nur RESTORE VERIFYONLY, keine Wiederherstellung, kein CHECKDB |
-NoCheck, -NoDrop | CHECKDB auslassen bzw. Testdatenbank stehen lassen |
-MaxSize | Datenbanken über dieser Größe (MB) überspringen |
-MaxDop | Parallelität für CHECKDB begrenzen |
-IgnoreDiffBackup, -IgnoreLogBackup | Differenz- bzw. Logsicherungen nicht verwenden |
-DataDirectory, -LogDirectory | Dateiablage der Testdatenbank auf dem Ziel |
-CopyFile | Sicherungsdateien vorher zum Ziel kopieren (Windows, siehe Abschnitt 4) |
3 · Der Aufruf, der im Lab funktioniert hat
Im Lab hatte jede Version vier Testdatenbanken: dbt_ok mit Voll-, Differenz- und Logsicherung, dbt_nochk mit einer Sicherung ohne Prüfsumme, dbt_bitflip mit einer Sicherungsdatei, in der wir 64 Byte überschrieben haben, und dbt_kaputt mit einer absichtlich beschädigten Datenseite (erzeugt mit dem undokumentierten DBCC WRITEPAGE, nur in einem Wegwerf-Container). Alle vier Server verwendeten ein selbstsigniertes Zertifikat. Der funktionierende Aufruf sah so aus:
$cred = Get-Credential sa
# Laborabkürzung für selbstsignierte Zertifikate, nur diese Sitzung, Verbindung bleibt verschlüsselt (Teil 1)
Set-DbatoolsConfig -FullName sql.connection.trustcert -Value $true
$r = Test-DbaLastBackup -SqlInstance sql2022 -SqlCredential $cred -Database dbt_ok, dbt_nochk, dbt_bitflip, dbt_kaputt
$r | Select-Object Database, RestoreResult, DbccResult, RestoreElapsed, DbccElapsedErgebnis auf SQL Server 2022 (Auszug):
Database RestoreResult DbccResult RestoreElapsed DbccElapsed
-------- ------------- ---------- -------------- -----------
dbt_ok Success Success 00:00:03 00:00:01
dbt_nochk Success Success 00:00:01 00:00:00
dbt_bitflip Success Success 00:00:01 00:00:00
dbt_kaputt Success Microsoft.Data.SqlClient.SqlException (0x80131904): Table error: … … …Der Anfang von DbccResult für dbt_kaputt lautete vollständig: Microsoft.Data.SqlClient.SqlException (0x80131904): Table error: Object ID 901578250, index ID 1, partition ID 72057594045726720, alloc unit ID 72057594052476928 (type In-row data), page (1:508). Test (IS_OFF (BUF_IOERR, pBUF->bstat)) failed. Values are 133129 and -4. Weiter unten folgte CHECKDB found 0 allocation errors and 3 consistency errors in database 'dbatools-testrestore-dbt_kaputt'.
So verhielten sich alle vier Versionen. Für die vier Datenbanken brauchte ein Lauf 13 bis 17 Sekunden. Die Testdatenbanken waren danach wieder gelöscht.
dbt_ok: Alle drei Dateien wurden wiederhergestellt, CHECKDB fand nichts.dbt_kaputt: Die Wiederherstellung gelang, CHECKDB fand den Schaden. Genau dafür ist der Befehl da.dbt_nochk: Eine Sicherung ohne Prüfsumme ist kein Fehler; der Inhalt war in Ordnung.dbt_bitflip: Unser Muster war unglücklich gewählt und hob sich in der Prüfsumme auf (Randnotiz in Abschnitt 6). Mit zufälligen Bytes erkannte SQL Server dieselbe Art von Schaden.
Auswerten statt nur ansehen. Bei einem Schaden steht in DbccResult die Fehlermeldung, nicht „Failure“. Prüfen Sie deshalb auf alles, was nicht Success ist, und listen Sie Datenbanken ohne Sicherung getrennt auf:
# Gesichert, aber Wiederherstellung oder CHECKDB nicht sauber
$r | Where-Object { $_.FileExists -and ($_.RestoreResult -ne 'Success' -or $_.DbccResult -ne 'Success') } |
Select-Object SourceServer, Database, RestoreResult, DbccResult
# Keine Sicherung gefunden: übersprungen, aber selbst ein Befund
$r | Where-Object { -not $_.FileExists } | Select-Object SourceServer, Database, FileExists, RestoreResultIm Lab lieferte die erste Abfrage genau dbt_kaputt mit der Meldung von CHECKDB, die zweite die Datenbanken ohne Sicherung: master, model, msdb und eine Benutzerdatenbank, die nie gesichert worden war, jeweils mit FileExists False und Skipped. Ohne -Database prüft der Befehl alle Datenbanken.
FileExists ist ein Wahrheitswert, kein Text. Unsere erste Fassung verglich ihn mit 'False'. PowerShell wandelt den Text dabei in $true um, und der Filter kehrte sich um: Er meldete die übersprungenen Datenbanken und verschwieg die beschädigte.
4 · Wohin wiederherstellen
Standard ist die Quellinstanz. Ohne -Destination stellt Test-DbaLastBackup auf dem Server wieder her, dessen Sicherungen geprüft werden. Wiederherstellung und CHECKDB brauchen dann dort Speicherplatz, Ein- und Ausgabe und CPU, bei großen Datenbanken über längere Zeit. Für einen regelmäßigen Lauf gegen Produktion gehört die Probe auf eine eigene Testinstanz.
Eine andere Instanz braucht einen gemeinsamen Pfad. Bei einem anderen Ziel prüft der Befehl, ob der Pfad der Sicherung in der Historie mit \\ (Netzwerkfreigabe), http oder s3 beginnt. Lokale Pfade überspringt er (Quelltext 2.9.1, Zeile 744). Im Lab lagen die Sicherungen auf einem Volume, das beide Instanzen unter demselben Pfad sahen. Trotzdem:
Test-DbaLastBackup -SqlInstance sql2019 -SqlCredential $cred -Destination sql2022 -DestinationSqlCredential $cred -Database dbt_ok |
Select-Object Database, FileExists, RestoreResult, DbccResultDatabase FileExists RestoreResult DbccResult
-------- ---------- ------------- ----------
dbt_ok Skipped Restore not located on shared location SkippedMit -Path ging es. Statt der Historie durchsucht der Befehl dann einen Ordner. Liegt dieser auf einem Speicher, den das Ziel sieht, stellt es von dort wieder her:
Test-DbaLastBackup -Path /var/opt/mssql/shared/sql2019 -Destination sql2022 -DestinationSqlCredential $cred -Database dbt_okIm Lab waren Wiederherstellung und CHECKDB erfolgreich, mit allen drei Dateien. Als SourceServer erschien der Rechnername des Containers statt sql2019, vermutlich weil der Befehl die Quelle hier aus dem Kopf der Sicherungsdatei liest.
Ältere Zielversion: Eine Sicherung von SQL Server 2025 auf einer 2019-Instanz wies SQL Server sauber ab. Die Meldung stand in RestoreResult: The database was backed up on a server running version 17.00.5005. That version is incompatible with this server, which is running version 15.00.4490. … Das Testziel muss also mindestens die Version der Quelle haben; laut Microsoft lässt sich keine Sicherung auf einer älteren Version wiederherstellen.
Unter Windows: Freigabe oder -CopyFile. Auf einem Windows-Server mit zwei Instanzen haben wir dieselbe Datenbank auf drei Wegen auf die zweite Instanz geprüft (Windows-Anmeldung, Instanznamen):
| Sicherung liegt | Aufruf | Ergebnis |
|---|---|---|
im Standard-Backupordner der Quelle (C:\Program Files\…\Backup) | -Destination PSG-WIN01\SQL2 | Skipped, Restore not located on shared location |
| ebenda | zusätzlich -CopyFile | Success, Success |
auf einer Freigabe (\\PSG-WIN01\psgbackup\…) | -Destination PSG-WIN01\SQL2 | Success, Success |
Mit -CopyFile kopiert der Befehl die Sicherung über Administratorfreigaben der Windows-Server (Quelltext 2.9.1, Zeilen 692–707) in den Backupordner des Ziels. Im Lab lag sie danach unter C:\Program Files\Microsoft SQL Server\MSSQL16.SQL2\MSSQL\Backup\. Das kommt also nur zwischen Windows-Hosts infrage und braucht dort Platz für eine weitere Kopie. Für die Freigabe brauchen die Dienstkonten beider Instanzen Rechte. Im Lab haben wir sie den virtuellen Konten NT Service\MSSQLSERVER und NT Service\MSSQL$SQL2 gegeben, weil beide Instanzen auf demselben Server liefen. Zwischen zwei Servern braucht es Domänenkonten oder die Computerkonten; das haben wir nicht aufgebaut. Seit Version 2.8.2 (Mai 2026) gelten auch https- und s3-Pfade als gemeinsamer Ort (#10362). Das haben wir nicht ausprobiert.
5 · Verbindungsobjekte helfen hier nicht
In Teil 1 empfehlen wir, eine Verbindung mit Connect-DbaInstance zu öffnen und das Objekt weiterzugeben. Bei Test-DbaLastBackup ging das im Lab schief. Der Befehl verbindet sich intern über den Instanznamen neu (Quelltext 2.9.1, Zeilen 549 und 577 für Quelle und Ziel, Zeile 876 vor CHECKDB). Er übernimmt nur ausdrücklich übergebene -SqlCredential und -DestinationSqlCredential.
- Erster Versuch mit Verbindungsobjekten aus
Connect-DbaInstance -TrustServerCertificate: Das Vertrauen ging verloren, es kamen Zertifikatswarnungen und keine Ergebnisse. - Zweiter Versuch, zusätzlich mit Vertrauen per Sitzungskonfiguration: Nun fehlten die Anmeldedaten. dbatools versuchte eine Windows-Anmeldung, die es im Container nicht gibt:
The target principal name is incorrect. Cannot generate SSPI context. - In beiden Versuchen scheiterte ein Lauf nach der Wiederherstellung, und die Testdatenbank
dbatools-testrestore-dbt_okblieb auf dem Ziel stehen. - Unter Windows, mit Windows-Anmeldung und einem Verbindungsobjekt aus
Connect-DbaInstance -TrustServerCertificate, scheiterte schon die erste interne Verbindung am Zertifikat:The certificate chain was issued by an authority that is not trusted. Ergebnisse gab es keine, Reste ebenfalls nicht. Die Anmeldung wäre hier kein Problem gewesen, das Vertrauen ging trotzdem verloren.
Was funktioniert: Instanznamen plus -SqlCredential und -DestinationSqlCredential, Vertrauen nur per Sitzungskonfiguration (Abschnitt 3). Stand 16.11.2026 fanden wir dazu keine Meldung im Projekt.
Aufräumen gehört dazu. Wer den Befehl regelmäßig laufen lässt, sollte danach nach Resten suchen:
-- Reste von Test-DbaLastBackup auf der Zielinstanz finden (nur lesend)-- MAXDOP 1: läuft seriell und belegt keine weiteren Kerne der AnwendungSELECT name, create_date, state_descFROM sys.databasesWHERE name LIKE N'dbatools-testrestore-%'OPTION (MAXDOP 1);Gefundene Reste entfernen Sie, nachdem Sie geprüft haben, dass kein Lauf mehr aktiv ist, etwa mit Remove-DbaDatabase und zuerst -WhatIf. Im Lab meldete -WhatIf für einen absichtlich stehen gelassenen Rest What if: Performing the operation "KillDatabase" on target "[dbatools-testrestore-dbt_ok] on [sql2022]". Der Aufruf ohne -WhatIf gab Status Dropped zurück, danach fand die Abfrage nichts mehr.
6 · -VerifyOnly und -Checksum: schwächer, als sie klingen
Mit -VerifyOnly führt der Befehl nur RESTORE VERIFYONLY aus. SQL Server liest dabei die Sicherung und prüft, ob sie vollständig und lesbar ist. Wiederhergestellt wird nichts, und CHECKDB läuft nicht. Im Lab meldete -VerifyOnly deshalb für die Sicherung mit der beschädigten Datenseite Success, auf allen vier Versionen.
Zwei weitere Einschränkungen gelten bis einschließlich Version 2.9.1:
- Nur die erste Datei.
-VerifyOnlyprüft nur die erste Sicherung einer Kette, beidbt_okalso nur die Vollsicherung. Die Maintainer haben das in der Entwicklungsfassung korrigiert (#10791); veröffentlicht war die Korrektur am 17.11.2026 noch nicht, neueste Version war weiterhin 2.9.1. -Checksumkommt nicht an. Laut Hilfe soll-VerifyOnly -Checksumscheitern, wenn eine Sicherung keine Prüfsummen enthält. Im Lab meldete es fürdbt_nochkauf allen VersionenSuccess. Ein Mitschnitt mit Extended Events zeigte, was dbatools an SQL Server schickt:
RESTORE VERIFYONLY FROM DISK = N'/var/opt/mssql/data/nochk.bak' WITH FILE = 1, NOUNLOADEin CHECKSUM steht darin nicht. Dieselbe Prüfung direkt in SQL Server mit WITH CHECKSUM bricht so ab, wie die Hilfe es verspricht:
Msg 3187, Level 16, State 1, Server 1cf80207bb49, Line 1
RESTORE WITH CHECKSUM cannot be specified because the backup set does not contain checksum information.
Msg 3013, Level 16, State 1, Server 1cf80207bb49, Line 1
VERIFY DATABASE is terminating abnormally.Stand 16.11.2026 war dieser Befund im Projekt nicht gemeldet. Ob Ihre Sicherungen Prüfsummen tragen, sehen Sie bis dahin direkt in der Historie:
-- Sicherungen der letzten 7 Tage ohne Prüfsumme (nur lesend)-- MAXDOP 1: läuft seriell und belegt keine weiteren Kerne der AnwendungSELECT b.database_name, b.type, -- D = voll, I = differenziell, L = Log b.backup_finish_date, b.has_backup_checksums, mf.physical_device_nameFROM msdb.dbo.backupset AS bJOIN msdb.dbo.backupmediafamily AS mf ON mf.media_set_id = b.media_set_idWHERE b.backup_finish_date >= DATEADD(DAY, -7, SYSDATETIME()) AND b.has_backup_checksums = 0ORDER BY b.backup_finish_date DESCOPTION (MAXDOP 1);Randnotiz zur Prüfsumme. Unsere Testsicherung dbt_bitflip mit 64 überschriebenen Byte kam durch alle Prüfungen, auch durch CHECKDB, und die Änderung stand danach in der Datenbank. Die Ursache liegt in SQL Server, nicht in dbatools. Die Prüfsumme einer Datenseite verknüpft deren 4-Byte-Wörter mit XOR. Ändert sich im selben 512-Byte-Abschnitt einer Seite eine gerade Anzahl von Wörtern auf genau dieselbe Weise, heben sich die Änderungen auf. Unser Muster, gleichmäßige Leerzeichen mit 0xFF überschrieben, traf genau diesen Fall. Einzelne Bytes, zufällige Inhalte und ungerade Muster erkannte SQL Server 2022 sofort. Das Verfahren haben wir an 3.439 Seiten nachgerechnet; beschrieben ist es nur in Sekundärquellen. Für den Alltag heißt das: Die Seitenprüfsumme ist ein schneller Detektor für typische Speicher- und Übertragungsfehler, aber kein Schutz gegen gezielte Veränderung.
7 · Regelmäßig prüfen
- Auf einer Testinstanz mit mindestens der Version der Quelle, eigenem Speicherplatz und Zugriff auf die Sicherungen (Netzwerkfreigabe, URL oder gemeinsamer Pfad mit
-Path). - Mit Grenzen:
-MaxSizeüberspringt Datenbanken, die zu groß für das Testziel sind,-MaxDopbegrenzt CHECKDB. Übersprungene Datenbanken gehören in den Bericht, damit sie nicht unbemerkt nie geprüft werden. - Geplant und protokolliert: als Aufgabe auf einem Verwaltungsrechner, als Agent-Job mit PowerShell-Schritt unter Windows oder als Pipeline-Job. Unter Linux kann der SQL Server Agent keine PowerShell-Schritte ausführen (Microsoft führt die Subsysteme PowerShell und CmdExec dort als nicht unterstützt); dort läuft der Befehl von einem eigenen Rechner oder Container aus. Die Ergebnisobjekte lassen sich als CSV oder in eine Tabelle schreiben.
- Mit Aufräumschritt am Ende (Abschnitt 5) und einer Auswertung, die alles meldet, was nicht
Successist (Abschnitt 3).
Was wir gemessen haben und was nicht
- Gemessen (16.11.2026): dbatools 2.9.1 unter PowerShell 7.6.8 in einem Linux-Container gegen SQL Server 2017 CU31, 2019 CU32, 2022 CU27 und 2025 CU9 in Linux-Containern. Die Sicherungen lagen auf einem gemeinsamen Docker-Volume. Die Datenbanken waren klein (4 bis 40 MB); die Laufzeiten sind Laborwerte und sagen nichts über große Datenbanken. Die Gegenproben zu Prüfsummen und zum gesendeten
RESTORE-Befehl liefen auf SQL Server 2022. - Unter Windows gemessen (17.11.2026): dbatools 2.9.1 unter Windows PowerShell 5.1 auf Windows Server 2022 mit zwei Instanzen SQL Server 2022 RTM auf demselben Server, Windows-Anmeldung; eine kleine Datenbank (rund 10 MB) mit lokaler Sicherung, Freigabe und
-CopyFile, dazu das Verbindungsobjekt. Die VM hatte eine vCPU; die Laufzeiten von 3 bis 7 Minuten je Probe sind deshalb nicht aussagekräftig. - Nicht gemessen: zwei getrennte Windows-Server (Freigaberechte, Administratorfreigaben über das Netz), Agent-Jobs mit PowerShell-Schritt, Sicherungen auf Azure Blob Storage oder S3, verschlüsselte Sicherungen, große Datenbanken und die Last einer Probe auf einem Produktionsserver.
Weiterlesen
- dbatools: Test-DbaLastBackup (Hilfe mit Beispielen).
- Microsoft Learn: RESTORE VERIFYONLY, Possible media errors during backup and restore, backup checksum default, backupset (
has_backup_checksums), RESTORE, Kompatibilität. - Bei PSG: Backup & Restore: Grundlagen und Advanced, dbatools-Übersicht, Teil 1: Installieren und sicher verbinden.