War diese Seite hilfreich?
Ihr Feedback ist uns wichtig. Teilen Sie uns Ihre Meinung mit.
Weiteres Feedback?
1500 verbleibende Zeichen
Exportieren (0) Drucken
Alle erweitern
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

Restore-Klasse

Das Restore-Objekt ermöglicht programmgesteuerten Zugriff auf Wiederherstellungsvorgänge.

Object
  Microsoft.SqlServer.Management.Smo.BackupRestoreBase
    Microsoft.SqlServer.Management.Smo.Restore

Namespace:  Microsoft.SqlServer.Management.Smo
Assembly:  Microsoft.SqlServer.SmoExtended (in Microsoft.SqlServer.SmoExtended.dll)

public sealed class Restore : BackupRestoreBase

Der Restore-Typ macht folgende Elemente verfügbar.

  NameBeschreibung
Öffentliche MethodeRestore()Initialisiert eine neue Instanz der Restore-Klasse.
Öffentliche MethodeRestore(String, BackupSet)Initialisiert eine neue Instanz der Restore-Klasse mit dem angegebenen Zieldatenbanknamen und Sicherungssatz.
Nach oben

  NameBeschreibung
Öffentliche EigenschaftActionRuft den auszuführenden Wiederherstellungstyp ab oder legt ihn fest.
Öffentliche EigenschaftAsyncStatusRuft den asynchronen Status eines Sicherungs- oder Wiederherstellungsvorgangs ab. (Geerbt von BackupRestoreBase.)
Öffentliche EigenschaftBlockSizeRuft die physische Blockgröße der Sicherung oder Wiederherstellung in Bytes ab oder legt sie fest. (Geerbt von BackupRestoreBase.)
Öffentliche EigenschaftBufferCountRuft die Gesamtanzahl von E/A-Puffern ab, die für den Sicherungs- oder Wiederherstellungsvorgang verwendet werden sollen, oder legt sie fest. (Geerbt von BackupRestoreBase.)
Öffentliche EigenschaftChecksumRuft einen Boolean-Eigenschaftswert ab, der bestimmt, ob im Verlauf von Sicherungs- oder Wiederherstellungsvorgängen ein Prüfsummenwert berechnet wird, oder legt ihn fest. (Geerbt von BackupRestoreBase.)
Öffentliche EigenschaftClearSuspectPageTableAfterRestoreRuft einen Boolean-Wert ab, der bestimmt, ob Einträge in der suspect_page-Tabelle nach dem Wiederherstellungsvorgang gelöscht werden, oder legt ihn fest.
Öffentliche EigenschaftContinueAfterErrorRuft einen Boolean-Eigenschaftswert ab, der bestimmt, ob die Sicherung oder Wiederherstellung nach einem Prüfsummenfehler fortgesetzt wird, oder legt ihn fest. (Geerbt von BackupRestoreBase.)
Öffentliche EigenschaftDatabaseRuft die Datenbank ab, auf der der Sicherungs- oder Wiederherstellungsvorgang ausgeführt wird, oder legt sie fest. (Geerbt von BackupRestoreBase.)
Öffentliche EigenschaftDatabaseFileGroupsRuft die SQL Server-Dateigruppen ab, die Ziel des Sicherungs- oder Wiederherstellungsvorgangs sind. (Geerbt von BackupRestoreBase.)
Öffentliche EigenschaftDatabaseFilesRuft die Betriebssystemdateien ab, die Ziel des Sicherungs- oder Wiederherstellungsvorgangs sind. (Geerbt von BackupRestoreBase.)
Öffentliche EigenschaftDatabasePagesRuft die Liste der Wiederherstellungsseiten ab.
Öffentliche EigenschaftDevicesRuft die für den Sicherungs- oder Wiederherstellungsvorgang angegebenen Sicherungsmedien ab. (Geerbt von BackupRestoreBase.)
Öffentliche EigenschaftFileNumberRuft die Indexnummer ab, mit der der Zielsicherungssatz auf dem Sicherungsmedium identifiziert wird, oder legt sie fest.
Öffentliche EigenschaftKeepReplicationRuft einen Boolean-Eigenschaftswert ab, der angibt, ob während eines Wiederherstellungsvorgangs eine Replikationskonfiguration beibehalten werden soll, oder legt ihn fest.
Öffentliche EigenschaftMaxTransferSizeRuft die maximale Anzahl von Bytes ab, die zwischen den Sicherungsmedien und der SQL Server-Instanz übertragen werden sollen, oder legt sie fest. (Geerbt von BackupRestoreBase.)
Öffentliche EigenschaftMediaNameRuft den Namen ab, der zur Identifikation eines bestimmten Mediensatzes verwendet wurde, oder legt ihn fest. (Geerbt von BackupRestoreBase.)
Öffentliche EigenschaftNoRecoveryRuft einen Boolean-Eigenschaftswert ab, der bestimmt, ob das Protokollfragment gesichert und die Datenbank in den Wiederherstellungsstatus wiederhergestellt wird, oder legt ihn fest. (Geerbt von BackupRestoreBase.)
Öffentliche EigenschaftNoRewindRuft einen Boolean-Eigenschaftswert ab, der bestimmt, ob Microsoft SQL Server das Band nach dem Sicherungs- oder Wiederherstellungsvorgang offen hält, oder legt ihn fest. (Geerbt von BackupRestoreBase.)
Öffentliche EigenschaftOffsetRuft das Array der wiederherzustellenden Seitenadressen ab oder legt es fest.
Öffentliche EigenschaftPartialRuft einen Boolean-Eigenschaftswert ab, der angibt, ob eine teilweise oder vollständige Wiederherstellung ausgeführt wird, oder legt ihn fest.
Öffentliche EigenschaftPercentCompleteNotificationRuft das Prozentintervall für Aufrufe des PercentCompleteEventHandler-Ereignishandlers ab oder legt es fest. (Geerbt von BackupRestoreBase.)
Öffentliche EigenschaftRelocateFilesRuft das Array logischer Datenbank-Dateinamen und physischer Betriebssystem-Dateinamen ab, das beim Wiederherstellen einer Datenbank an einem neuen physischen Ort zur Umleitung des Datenbankspeichers verwendet wird.
Öffentliche EigenschaftReplaceDatabaseRuft einen Boolean-Wert ab, der angibt, ob vom Wiederherstellungsvorgang ein neues Image der wiederhergestellten Datenbank erstellt wird, oder legt ihn fest.
Öffentliche EigenschaftRestartRuft einen Boolean-Eigenschaftswert ab, der bestimmt, ob der Sicherungs- oder Wiederherstellungsvorgang bei einer Unterbrechung neu gestartet wird, oder legt ihn fest. (Geerbt von BackupRestoreBase.)
Öffentliche EigenschaftRestrictedUserRuft einen Boolean-Eigenschaftswert ab, der angibt, ob der Zugriff auf die wiederhergestellte Datenbank auf Mitglieder der festen Datenbankrolle db_owner und der festen Serverrollen dbcreator und sysadmin eingeschränkt wird, oder legt ihn fest.
Öffentliche EigenschaftStandbyFileRuft den Namen einer Rückgängigdatei ab, die als Teil der Imagingstrategie für eine SQL Server-Instanz verwendet wird, oder legt ihn fest.
Öffentliche EigenschaftStopAtMarkAfterDateRuft das Datum ab, das in Verbindung mit dem von StopAtMarkName angegebenen Markierungsnamen verwendet wird, um den Endpunkt des Wiederherstellungsvorgangs zu bestimmen, oder legt es fest.
Öffentliche EigenschaftStopAtMarkNameRuft den Markierungsnamen ab, der in Verbindung mit dem von StopAtMarkAfterDate angegebenen Datum verwendet wird, um den Endpunkt des Wiederherstellungsvorgangs zu bestimmen, oder legt ihn fest.
Öffentliche EigenschaftStopBeforeMarkAfterDateRuft das Datum ab, das in Verbindung mit dem von StopBeforeMarkName angegebenen Markierungsnamen verwendet wird, um den Endpunkt des Wiederherstellungsvorgangs zu bestimmen, oder legt es fest.
Öffentliche EigenschaftStopBeforeMarkNameRuft den Markierungsnamen ab, der in Verbindung mit dem von StopBeforeMarkAfterDate angegebenen Datum verwendet wird, um den Endpunkt des Wiederherstellungsvorgangs zu bestimmen, oder legt ihn fest.
Öffentliche EigenschaftToPointInTimeRuft den Endpunkt für die Wiederherstellung des Datenbankprotokolls ab oder legt ihn fest.
Öffentliche EigenschaftUnloadTapeAfterRuft einen Boolean-Eigenschaftswert ab, der bestimmt, ob Bandmedien zurückgespult und nach Ende des Sicherungs- oder Wiederherstellungsvorgangs entladen werden, oder legt ihn fest. (Geerbt von BackupRestoreBase.)
Nach oben

  NameBeschreibung
Öffentliche MethodeAbortBeendet einen laufenden Sicherungs- oder Wiederherstellungsvorgang. (Geerbt von BackupRestoreBase.)
Öffentliche MethodeClearSuspectPageTableLöscht Einträge in der suspect_page-Tabelle.
Öffentliche MethodeEquals (Geerbt von Object.)
Öffentliche MethodeGetHashCode (Geerbt von Object.)
Öffentliche MethodeGetType (Geerbt von Object.)
Öffentliche MethodeReadBackupHeaderLiest den Sicherungsheader und gibt Informationen zum Medieninhalt zurück.
Öffentliche MethodeReadFileListGibt die Liste der Datenbankdateien auf den Zielmedien zurück.
Öffentliche MethodeReadMediaHeaderLiest den Medienheader und gibt die Medienheaderwerte zurück.
Öffentliche MethodeReadSuspectPageTableGibt die suspect_page-Tabelle für die SQL Server-Zielinstanz zurück.
Öffentliche MethodeScriptGeneriert ein Transact-SQL-Skript, das zum Neuerstellen des Wiederherstellungsvorgangs verwendet werden kann.
Öffentliche MethodeSetMediaPassword(SecureString) Veraltet Legt das Kennwort für einen Mediensatz fest. (Geerbt von BackupRestoreBase.)
Öffentliche MethodeSetMediaPassword(String) Veraltet Legt das Kennwort für einen Mediensatz fest. (Geerbt von BackupRestoreBase.)
Öffentliche MethodeSetPassword(SecureString)Legt das Kennwort für einen Sicherungssatz fest. (Geerbt von BackupRestoreBase.)
Öffentliche MethodeSetPassword(String)Legt das Kennwort für einen Sicherungssatz fest. (Geerbt von BackupRestoreBase.)
Öffentliche MethodeSqlRestoreFührt einen Wiederherstellungsvorgang auf dem angegebenen Server aus.
Öffentliche MethodeSqlRestoreAsyncFührt einen Wiederherstellungsvorgang asynchron aus.
Öffentliche MethodeSqlVerify(Server)Überprüft die Medien für die SQL Server-Instanz, die durch das angegebene Server-Objekt dargestellt wird.
Öffentliche MethodeSqlVerify(Server, Boolean)Überprüft die Medien in der SQL Server-Instanz, die durch das angegebene Server-Objekt dargestellt wird, und lädt Sicherungsverlaufsinformationen in die Verlaufstabellen.
Öffentliche MethodeSqlVerify(Server, String)Überprüft die Medien für die SQL Server-Instanz, die durch das angegebene Server-Objekt dargestellt wird, und gibt eine Fehlermeldung zurück.
Öffentliche MethodeSqlVerify(Server, Boolean, String)Überprüft die Medien für die SQL Server-Instanz, die durch das angegebene Server-Objekt dargestellt wird, lädt Sicherungsverlaufsinformationen in die Verlaufstabellen und gibt eine Fehlermeldung zurück.
Öffentliche MethodeSqlVerifyAsync(Server)Überprüft die Medien für die SQL Server-Instanz, die asynchron durch das angegebene Server-Objekt dargestellt wird.
Öffentliche MethodeSqlVerifyAsync(Server, Boolean)Überprüft die Medien für die SQL Server-Instanz, die asynchron durch das angegebene Server-Objekt dargestellt wird, und lädt Sicherungsverlaufsinformationen in die Verlaufstabellen.
Öffentliche MethodeSqlVerifyLatest(Server)Überprüft die letzte Sicherung, stellt sie jedoch nicht wieder her, und überprüft die Vollständigkeit des Sicherungssatzes sowie die Lesbarkeit der gesamten Sicherung.
Öffentliche MethodeSqlVerifyLatest(Server, SqlVerifyAction)Überprüft die letzte Sicherung mit der angegebenen Aktion sowie die Vollständigkeit des Sicherungssatzes und die Lesbarkeit der gesamten Sicherung.
Öffentliche MethodeSqlVerifyLatest(Server, String)Überprüft die letzte Sicherung, stellt sie jedoch nicht wieder her, und überprüft die Vollständigkeit des Sicherungssatzes sowie die Lesbarkeit der gesamten Sicherung und gibt eine Fehlermeldung zurück.
Öffentliche MethodeSqlVerifyLatest(Server, SqlVerifyAction, String)Überprüft die letzte Sicherung mit der angegebenen Aktion sowie die Vollständigkeit des Sicherungssatzes und die Lesbarkeit der gesamten Sicherung und gibt eine Fehlermeldung zurück.
Öffentliche MethodeToString (Geerbt von Object.)
Öffentliche MethodeWaitWartet das Ende des aktuellen Sicherungs- oder Wiederherstellungsvorgangs ab, bevor der nächste Prozess gestartet wird. (Geerbt von BackupRestoreBase.)
Nach oben

  NameBeschreibung
Öffentliches EreignisCompleteTritt auf, sobald der Sicherungs- oder Wiederherstellungsvorgang abgeschlossen ist. (Geerbt von BackupRestoreBase.)
Öffentliches EreignisInformationTritt auf, wenn eine beliebige Informationsmeldung von Microsoft SQL Server ausgegeben wird, die von den Ereignissen NextMedia, PercentComplete oder Complete nicht behandelt werden kann. (Geerbt von BackupRestoreBase.)
Öffentliches EreignisNextMediaTritt auf, wenn die Kapazität des Mediums in einem Zielgerät vom Sicherungs- oder Wiederherstellungsvorgang aufgebraucht ist. (Geerbt von BackupRestoreBase.)
Öffentliches EreignisPercentCompleteTritt auf, wenn bei einem Sicherungs- oder Wiederherstellungsvorgang eine Abschlusseinheit erreicht wird. (Geerbt von BackupRestoreBase.)
Nach oben

Wenn Sie ein Restore-Objekt verwenden, können Sie folgende Aufgaben ausführen:

  • Wiederherstellungsalles oder zum teil einer Datenbank.

  • Wiederherstellungsbackup-Bilder von Transaktionsprotokoll-Datensätzen.

  • Überprüfen Sie die Integrität von Sicherungsmedien.

  • Bericht den Inhalt von Sicherungsmedien.

  • Überwachen Sie einen Wiederherstellungsvorgang, Berichterstellung Status für den Benutzer.

SQL Server kann eine Sicherung zu einem von vier Medientypen schreiben: Datenträger, Band, Pipe oder Sicherungsmedien. SQL Server Unterstützungsbackup-Striping. Eine gestreifte Sicherung ist eine, die auf mehr als eines einzelnen verwiesen wird. Striping wird nur auf einem einzigen Medientyp unterstützt. Das heißt, dass eine Sicherung zu zwei Bandmedien geschrieben werden. Hälfte einer Sicherung kann nicht auf ein Bandmedium und die andere Hälfte auf einen Datenträger geschrieben werden.

Mindestens eine stellen Werte für Wiederherstellungsquelle, wenn ein Restore-Objekt verwendet wird. Verwenden Sie ein Medientypeigenschaft, um die Wiederherstellungsvorgangsquelle anzugeben.

Das Festlegen anderer Eigenschaften im Restore-Objekt wird von den gewünschten Wiederherstellungsvorgang erforderlich sein.

Threadsicherheit

Alle öffentlichen, statischen Elemente dieses Typs (Shared in Microsoft Visual Basic) sind für Vorgänge mit mehreren Threads sicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Um Restore-Objekteigenschaften abzurufen, können Benutzer Mitglied der festen Serverrolle public sein.

Um Restore-Objekteigenschaften festzulegen, müssen Benutzer die CREATE DATABASE-Berechtigung für den Server verfügen oder Mitglied von sysadmin oder dbcreator festen Serverrollen, oder Mitglied der festen Datenbankrolle db_owner sein.

Um einen Wiederherstellungsvorgang auszuführen, müssen Benutzer die CREATE DATABASE-Berechtigung für den Server verfügen oder Mitglied von sysadmin oder dbcreator festen Serverrollen. Wenn die Datenbank bereits vorhanden ist, können Mitglieder der festen Datenbankrolle db_owner einen Wiederherstellungsvorgang ausführen.

Im folgenden Codebeispiel wird veranschaulicht, wie eine normale und asynchrone Sicherung der AdventureWorks2012  - Datenbank erstellt und jede dieser Sicherungen verwendet, um ihn wiederherzustellen.

VB

'Connect to the local, default instance of SQL Server.
Dim srv As Server
srv = New Server
'Reference the AdventureWorks2012 database.
Dim db As Database
db = srv.Databases("AdventureWorks2012")
'Store the current recovery model in a variable.
Dim recoverymod As Integer
recoverymod = db.DatabaseOptions.RecoveryModel
'Define a Backup object variable. 
Dim bk As New Backup
'Specify the type of backup, the description, the name, and the database to be backed up.
bk.Action = BackupActionType.Database
bk.BackupSetDescription = "Full backup of AdventureWorks2012"
bk.BackupSetName = "AdventureWorks2012 Backup"
bk.Database = "AdventureWorks2012"
'Declare a BackupDeviceItem by supplying the backup device file name in the constructor, and the type of device is a file.
Dim bdi As BackupDeviceItem
bdi = New BackupDeviceItem("Test_Full_Backup1", DeviceType.File)
'Add the device to the Backup object.
bk.Devices.Add(bdi)
'Set the Incremental property to False to specify that this is a full database backup.
bk.Incremental = False
'Set the expiration date.
Dim backupdate As New Date
backupdate = New Date(2006, 10, 5)
bk.ExpirationDate = backupdate
'Specify that the log must be truncated after the backup is complete.
bk.LogTruncation = BackupTruncateLogType.Truncate
'Run SqlBackup to perform the full database backup on the instance of SQL Server.
bk.SqlBackup(srv)
'Inform the user that the backup has been completed.
Console.WriteLine("Full Backup complete.")
'Remove the backup device from the Backup object.
bk.Devices.Remove(bdi)
'Make a change to the database: in this case, add a table called test_table.
Dim t As Table
t = New Table(db, "test_table")
Dim c As Column
c = New Column(t, "col", DataType.Int)
t.Columns.Add(c)
t.Create()
'Create another file device for the differential backup and add the Backup object.
Dim bdid As BackupDeviceItem
bdid = New BackupDeviceItem("Test_Differential_Backup1", DeviceType.File)
'Add the device to the Backup object.
bk.Devices.Add(bdid)
'Set the Incremental property to True for a differential backup.
bk.Incremental = True
'Run SqlBackup to perform the incremental database backup on the instance of SQL Server.
bk.SqlBackup(srv)
'Inform the user that the differential backup is complete.
Console.WriteLine("Differential Backup complete.")
'Remove the device from the Backup object.
bk.Devices.Remove(bdid)
'Delete the AdventureWorks2012 database before restoring it.
srv.Databases("AdventureWorks2012").Drop()
'Define a Restore object variable.
Dim rs As Restore
rs = New Restore
'Set the NoRecovery property to true, so the transactions are not recovered.
rs.NoRecovery = True
'Add the device that contains the full database backup to the Restore object.
rs.Devices.Add(bdi)
'Specify the database name.
rs.Database = "AdventureWorks2012"
'Restore the full database backup with no recovery.
rs.SqlRestore(srv)
'Inform the user that the Full Database Restore is complete.
Console.WriteLine("Full Database Restore complete.")
'Remove the device from the Restore object.
rs.Devices.Remove(bdi)
'Set te NoRecovery property to False.
rs.NoRecovery = False
'Add the device that contains the differential backup to the Restore object.
rs.Devices.Add(bdid)
'Restore the differential database backup with recovery.
rs.SqlRestore(srv)
'Inform the user that the differential database restore is complete.
Console.WriteLine("Differential Database Restore complete.")
'Remove the device.
rs.Devices.Remove(bdid)
'Set the database recovery mode back to its original value.
srv.Databases("AdventureWorks2012").DatabaseOptions.RecoveryModel = recoverymod
'Drop the table that was added.
srv.Databases("AdventureWorks2012").Tables("test_table").Drop()
srv.Databases("AdventureWorks2012").Alter()
'Remove the backup files from the hard disk.
My.Computer.FileSystem.DeleteFile("C:\Program Files\Microsoft SQL Server\MSSQL.1\MSSQL\Backup\Test_Full_Backup1")
My.Computer.FileSystem.DeleteFile("C:\Program Files\Microsoft SQL Server\MSSQL.1\MSSQL\Backup\Test_Differential_Backup1")

PowerShell

$srv = new-object Microsoft.SqlServer.Management.Smo.Server("(local)")
$db = New-Object Microsoft.SqlServer.Management.Smo.Database
$db = $srv.Databases.Item("AdventureWorks2012")
$rs = new-object Microsoft.SqlServer.Management.Smo.Restore
$rs.NoRecovery = $TRUE
$rs.Devices.Add($bdi)
$recoverymod = $db.DatabaseOptions.RecoveryModel
$bk = new-object Microsoft.SqlServer.Management.Smo.Backup
$bk.Action = [Microsoft.SqlServer.Management.Smo.BackupActionType]::Database
$bk.BackupSetDescription = "Full backup of AdventureWorks2012"
$bk.BackupSetName = "AdventureWorks2012 Backup"
$bk.Database = "AdventureWorks2012"
$bdi = new-object Microsoft.SqlServer.management.Smo.BackupDeviceItem("Test_Full_Backup1", [Microsoft.SqlServer.Management.Smo.DeviceType]::File)
$bk.Devices.Add($bdi)
$bk.Incremental = $FALSE
$backupdate = new-object System.DateTime(2009, 3, 2)
$bk.ExpirationDate = $backupdate
$bk.LogTruncation = [Microsoft.SqlServer.Management.Smo.BackupTruncateLogType]::Truncate
$bk.SqlBackup($srv)
Write-Host "Full Backup complete."
$bk.Devices.Remove($bdi)
$t = new-object Microsoft.SqlServer.Management.Smo.Table($db, "test_table")
$c = new-object Microsoft.SqlServer.Management.Smo.Column($t, "col", [Microsoft.SqlServer.Management.Smo.DataType]::Int)
$t.Columns.Add($c)
$t.Create()
$bdid = new-object Microsoft.SqlServer.Management.Smo.BackupDeviceItem("Test_Differential_Backup1", [Microsoft.SqlServer.Management.Smo.DeviceType]::File)
$bk.Devices.Add($bdid)
$bk.Incremental = $TRUE
$bk.SqlBackup($srv)
Write-Host "Differential Backup complete."
$bk.Devices.Remove($bdid)
$rs.Database = "AdventureWorks2012"
$srv.Databases["AdventureWorks2012"].Drop()
$rs.SqlRestore($srv)
Write-Host "Full Database Restore complete."
$rs.Devices.Remove($bdi)
$rs.NoRecovery = $FALSE
$rs.Devices.Add($bdid)
$rs.SqlRestore($srv)
Write-Host "Differential Database Restore complete."
$rs.Devices.Remove($bdid)
$srv.Databases["AdventureWorks2012"].DatabaseOptions.RecoveryModel = $recoverymod
$srv.Databases["AdventureWorks2012"].Tables["test_table"].Drop()
$srv.Databases["AdventureWorks2012"].Alter()
remove-item C:\Program Files\Microsoft SQL Server\MSSQL.1\MSSQL\Backup\Test_Full_Backup1
remove-item C:\Program Files\Microsoft SQL Server\MSSQL.1\MSSQL\Backup\Test_Differential_Backup1

Alle öffentlichen static (Shared in Visual Basic)-Elemente dieses Typs sind Threadsicher. Für Instanzelemente wird die Threadsicherheit nicht gewährleistet.

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2015 Microsoft