• Artykuł

Klasa Restore

Restore Obiektu umożliwia programistyczny dostęp do przywracanie operacji.

Hierarchia dziedziczenia

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

Przestrzeń nazw:  Microsoft.SqlServer.Management.Smo
Zestaw:  Microsoft.SqlServer.SmoExtended (w Microsoft.SqlServer.SmoExtended.dll)

Składnia

'Deklaracja
Public NotInheritable Class Restore _
    Inherits BackupRestoreBase
'Użycie
Dim instance As Restore

public sealed class Restore : BackupRestoreBase

public ref class Restore sealed : public BackupRestoreBase

[<SealedAttribute>]
type Restore =  
    class
        inherit BackupRestoreBase
    end

public final class Restore extends BackupRestoreBase

Typ Restore uwidacznia następujące elementy członkowskie.

Konstruktorzy

  Nazwa Opis
Metoda publiczna Restore Inicjuje nowe wystąpienie Restore klasy

Do góry

Właściwości

  Nazwa Opis
Właściwość publiczna Action Pobiera lub ustawia typ przywracanie ma być wykonana.
Właściwość publiczna AsyncStatus Pobiera asynchroniczny stan procesu wykonywania kopia zapasowa lub przywracanie. (Dziedziczony z BackupRestoreBase).
Właściwość publiczna BlockSize Pobiera lub ustawia rozmiar blok fizycznego z kopia zapasowa lub przywracanie, w bajtach. (Dziedziczony z BackupRestoreBase).
Właściwość publiczna BufferCount Pobiera lub ustawia całkowita liczba buforów We/Wy używane dla kopia zapasowa lub operacji przywracanie. (Dziedziczony z BackupRestoreBase).
Właściwość publiczna Checksum Pobiera lub ustawia Boolean wartości właściwość, które określa, czy wartość suma kontrolna jest obliczana podczas operacji wykonywania kopia zapasowa lub przywracanie. (Dziedziczony z BackupRestoreBase).
Właściwość publiczna ClearSuspectPageTableAfterRestore Pobiera lub ustawia Boolean wartość określa, czy wpisy w tabela podejrzanych strona zostaną usunięte po operacji przywracanie.
Właściwość publiczna ContinueAfterError Pobiera lub ustawia Boolean wartość właściwość, która określa, czy kopia zapasowa lub przywracanie jest kontynuowany po wystąpieniu błędu suma kontrolna. (Dziedziczony z BackupRestoreBase).
Właściwość publiczna Database Pobiera lub ustawia bazy danych, na którym jest uruchomiona operacja wykonywania kopia zapasowa lub przywracanie. (Dziedziczony z BackupRestoreBase).
Właściwość publiczna DatabaseFileGroups Pobiera SQL Server grup plików skierowana kopia zapasowa lub przywracanie operacji. (Dziedziczony z BackupRestoreBase).
Właściwość publiczna DatabaseFiles Pobiera skierowane przez operację wykonywania kopia zapasowa lub przywracanie plików systemu operacyjnego. (Dziedziczony z BackupRestoreBase).
Właściwość publiczna Devices Pobiera urządzeń kopii zapasowych określone dla operacji wykonywania kopia zapasowa lub przywracanie. (Dziedziczony z BackupRestoreBase).
Właściwość publiczna FileNumber Pobiera lub ustawia numer indeksu używany do identyfikowania ukierunkowanych zestaw kopii zapasowych na nośniku kopia zapasowa.
Właściwość publiczna KeepReplication Pobiera lub ustawia Boolean wartości właściwość, która określa, czy zachować konfiguracja replikacja podczas operacji przywracanie.
Właściwość publiczna MaxTransferSize Pobiera lub ustawia maksymalną liczbę bajtów, które mają być przenoszone między nośnika kopia zapasowa i wystąpienie programu SQL Server. (Dziedziczony z BackupRestoreBase).
Właściwość publiczna MediaName Pobiera lub ustawia nazwę używaną do identyfikowania określonego zestaw nośników. (Dziedziczony z BackupRestoreBase).
Właściwość publiczna NoRecovery Pobiera lub ustawia Boolean wartości właściwość, które określa, czy tworzona jest kopia zapasowa ogona dziennika i czy baza danych zostanie przywrócony do stanu przywracanie. (Dziedziczony z BackupRestoreBase).
Właściwość publiczna NoRewind Gets or sets a Boolean property value that determines whether Microsoft SQL Server will keep the tape open after the backup or restore operation. (Dziedziczony z BackupRestoreBase).
Właściwość publiczna Offset Pobiera lub ustawia tablicę strona adresy zostaną przywrócone.
Właściwość publiczna Partial Pobiera lub ustawia Boolean wartości właściwość, która określa, czy będzie można wykonać operacji przywracanie pełne lub częściowe.
Właściwość publiczna PercentCompleteNotification Pobiera lub ustawia interwał procent dla PercentCompleteEventHandler obsługa zdarzeń wywołań. (Dziedziczony z BackupRestoreBase).
Właściwość publiczna RelocateFiles Pobiera tablicę bazy danych logicznych nazw plików i systemu operacyjnego fizycznym pliku używany do przekierowania przechowywania bazy danych po przywróceniu bazy danych do nowej lokalizacji.
Właściwość publiczna ReplaceDatabase Pobiera lub ustawia Boolean wartość, która określa, czy operacja przywracanie utworzy nowy obraz przywróconej bazy danych.
Właściwość publiczna Restart Pobiera lub ustawia Boolean wartość właściwość, która określa, czy operacja wykonywania kopia zapasowa lub przywracanie zostanie ponownie uruchomiony, jeśli zostanie przerwana. (Dziedziczony z BackupRestoreBase).
Właściwość publiczna RestrictedUser Pobiera lub ustawia Boolean wartości właściwość, która określa, czy dostęp do przywróconej bazy danych jest ograniczony do członków db_owner stała rola bazy danych i dbcreator i sysadmin stałe role serwera.
Właściwość publiczna StandbyFile Pobiera lub ustawia nazwę pliku cofnąć, który jest używany jako część strategii tworzenia obrazów dla wystąpienie SQL Server.
Właściwość publiczna StopAtMarkAfterDate Pobiera lub ustawia data ma być używany w połączeniu z nazwą znak określony przez StopAtMarkName do określenia punktu zatrzymania operacji odzyskiwanie.
Właściwość publiczna StopAtMarkName Pobiera lub ustawia nazwę znak ma być używany w połączeniu z data określoną przez StopAtMarkAfterDate do określenia punktu zatrzymania operacji odzyskiwanie.
Właściwość publiczna StopBeforeMarkAfterDate Pobiera lub ustawia data ma być używany w połączeniu z nazwą znak określony przez StopBeforeMarkName do określenia punktu zatrzymania operacji odzyskiwanie.
Właściwość publiczna StopBeforeMarkName Pobiera lub ustawia nazwę znak ma być używany w połączeniu z data określoną przez StopBeforeMarkAfterDate do określenia punktu zatrzymania operacji odzyskiwanie.
Właściwość publiczna ToPointInTime Pobiera lub ustawia punkt końcowy dla przywrócenia dziennika bazy danych.
Właściwość publiczna UnloadTapeAfter Pobiera lub ustawia Boolean wartości właściwość, która określa, czy przewinięta nośniki taśmowe i wyładowanego po wykonaniu kopia zapasowa lub operacji przywracanie kończy. (Dziedziczony z BackupRestoreBase).

Do góry

Metody

  Nazwa Opis
Metoda publiczna Abort Kończy działanie kopia zapasowa lub operacji przywracanie. (Dziedziczony z BackupRestoreBase).
Metoda publiczna ClearSuspectPageTable Usuwa wpisy w podejrzane strona tabela.
Metoda publiczna Equals (Dziedziczony z Object).
Metoda chroniona ExecuteSql Wykonuje partia Transact-SQL instrukcji, które nie oczekuje zestaw wyniki zwróconych na wystąpienie określonego SQL Server. (Dziedziczony z BackupRestoreBase).
Metoda chroniona ExecuteSqlAsync Wykonuje partia Transact-SQL instrukcji asynchronicznie zwracane wyniki nie oczekuje zestaw na wystąpienie określonego SQL Server. (Dziedziczony z BackupRestoreBase).
Metoda chroniona ExecuteSqlWithResults Wykonuje partia Transact-SQL instrukcji, które spodziewa się jeden lub więcej wyniki zwróconych ustawia określone wystąpienie SQL Server. (Dziedziczony z BackupRestoreBase).
Metoda chroniona Finalize (Dziedziczony z Object).
Metoda chroniona GetDevicesScript Pobiera skrypt, który jest używany do tworzenia urządzenia. (Dziedziczony z BackupRestoreBase).
Metoda publiczna GetHashCode (Dziedziczony z Object).
Metoda publiczna GetType (Dziedziczony z Object).
Metoda chroniona IsStringValid Sprawdza, czy określony ciąg znaków. (Dziedziczony z BackupRestoreBase).
Metoda chroniona MemberwiseClone (Dziedziczony z Object).
Metoda publiczna ReadBackupHeader Odczyty kopia zapasowa nagłówka i zwraca informacje o zawartość nośnika.
Metoda publiczna ReadFileList Zwraca listę plików bazy danych na nośnik docelowy.
Metoda publiczna ReadMediaHeader Odczytuje nagłówka multimediów i zwraca wartości nagłówka nośnika.
Metoda publiczna ReadSuspectPageTable Zwraca tabela podejrzanych strona docelowej wystąpienie SQL Server.
Metoda publiczna Script Generuje Transact-SQL skryptu, który może służyć do odtworzenia operacji przywracanie.
Metoda publiczna SetMediaPassword(SecureString) Ustawia hasło dla zestaw nośników. (Dziedziczony z BackupRestoreBase).
Metoda publiczna SetMediaPassword(String) Ustawia hasło dla zestaw nośników. (Dziedziczony z BackupRestoreBase).
Metoda publiczna SetPassword(SecureString) Ustawia hasło dla zestaw kopii zapasowych. (Dziedziczony z BackupRestoreBase).
Metoda publiczna SetPassword(String) Ustawia hasło dla zestaw kopii zapasowych. (Dziedziczony z BackupRestoreBase).
Metoda publiczna SqlRestore Wykonuje operację przywracanie na określonym serwerze.
Metoda publiczna SqlRestoreAsync Wykonuje operację przywracanie asynchronicznie.
Metoda publiczna SqlVerify(Server) Sprawdza nośnik na wystąpienie z SQL Server jest reprezentowany przez określony Server obiektu.
Metoda publiczna SqlVerify(Server, Boolean) Sprawdza nośnik na wystąpienie SQL Server jest reprezentowany przez określony Server obiektu i ładunków informacji o historia kopia zapasowa do tabel historia.
Metoda publiczna SqlVerify(Server, String%) Sprawdza nośnik na wystąpienie z SQL Server jest reprezentowany przez określony Server obiektu i zwraca komunikat o błędzie.
Metoda publiczna SqlVerify(Server, Boolean, String%) Sprawdza nośnik na wystąpienie z SQL Server jest reprezentowany przez określony Server obiekt, ładuje historia kopia zapasowa informacji na tabele historia i zwraca komunikat o błędzie.
Metoda publiczna SqlVerifyAsync(Server) Sprawdza nośnik na wystąpienie z SQL Server jest reprezentowany przez określony Server obiektu asynchronicznie.
Metoda publiczna SqlVerifyAsync(Server, Boolean) Sprawdza nośnik na wystąpienie z SQL Server jest reprezentowany przez określony Server object asynchronicznie i ładuje informacje o historia kopia zapasowa do tabel historia.
Metoda publiczna SqlVerifyLatest(Server) Weryfikuje ostatniej kopii zapasowej, ale nie przywracanie i sprawdza, czy zestaw kopii zapasowych jest zakończona i cała kopia zapasowa jest czytelny.
Metoda publiczna SqlVerifyLatest(Server, SqlVerifyAction) Weryfikuje najnowszej kopii zapasowej z określonej akcja, a następnie sprawdza czy zestaw kopii zapasowych jest pełny, a cała kopia zapasowa jest czytelny.
Metoda publiczna SqlVerifyLatest(Server, String%) Weryfikuje ostatniej kopii zapasowej, ale nie przywracanie , sprawdza zestaw kopii zapasowych jest zakończona i cała kopia zapasowa jest czytelny i zwraca komunikat o błędzie.
Metoda publiczna SqlVerifyLatest(Server, SqlVerifyAction, String%) Weryfikuje najnowszej kopii zapasowej z określonej akcja sprawdza zestaw kopii zapasowych jest zakończona i cała kopia zapasowa jest czytelny i zwraca komunikat o błędzie.
Metoda publiczna ToString (Dziedziczony z Object).
Metoda publiczna Wait Czeka bieżącego kopia zapasowa lub operacji do wykonania przed przejściem do następnego procesu przywracanie. (Dziedziczony z BackupRestoreBase).

Do góry

Zdarzenia

  Nazwa Opis
Zdarzenie publiczne Complete Występuje po zakończeniu operacji wykonywania kopia zapasowa lub przywracanie. (Dziedziczony z BackupRestoreBase).
Zdarzenie publiczne Information Occurs when any informational message is issued by Microsoft SQL Server that cannot be handled by the Complete NextMedia or PercentComplete events. (Dziedziczony z BackupRestoreBase).
Zdarzenie publiczne NextMedia Występuje, gdy operacja wykonywania kopia zapasowa lub przywracanie zmagazynowane nośnik w miejsce docelowe urządzenia. (Dziedziczony z BackupRestoreBase).
Zdarzenie publiczne PercentComplete Występuje, gdy jednostka zakończenia operacji wykonywania kopia zapasowa lub przywracanie. (Dziedziczony z BackupRestoreBase).

Do góry

Pola

  Nazwa Opis
Pole chronione currentAsyncOperation Określa bieżący operacja asynchroniczna, takie jak Kopia zapasowa, przywracanie lub none. (Dziedziczony z BackupRestoreBase).
Pole chronione m_BackupAction Określa typ kopia zapasowa akcja, takich jak bazy danych lub dziennika. (Dziedziczony z BackupRestoreBase).
Pole chronione m_LogTruncation Określa, czy do obcinania dziennika. (Dziedziczony z BackupRestoreBase).
Pole chronione m_RestoreAction Określa typ akcja przywracanie, takich jak bazy danych lub dziennika. (Dziedziczony z BackupRestoreBase).
Pole publiczne VerifyComplete Określa VerifyCompleteEventHandler.

Do góry

Uwagi

Za pomocą Restore obiektu, można wykonać następujące czynności:

  • Przywracanie wszystkich lub części bazy danych.

  • Przywracanie kopia zapasowa obrazów rekordy dziennika transakcji.

  • Sprawdź integralność nośnika kopia zapasowa.

  • Raport zawartość nośnika kopia zapasowa.

  • Monitorowanie operacji przywracanie raportowania stanu użytkownika.

SQL Servermożna zapisywać kopia zapasowa jednego z czterech typów nośników: dysku, taśmie, nazwany potok, lub urządzenie kopia zapasowa.SQL Serverobsługuje rozkładanie kopia zapasowa.Rozłożone kopia zapasowa jest jeden skierowaną do więcej niż jednego urządzenia.Rozkładanie jest obsługiwany tylko na typ jednego nośnika.Oznacza to, że kopia zapasowa można zapisać do dwóch urządzeń taśmowych.Połowa kopia zapasowa nie można zapisać urządzenie taśmowe, a druga połowa na dysku.

Co najmniej podać wartości dla źródło przywracanie przy użyciu Restore obiektu.Umożliwia określenie źródło operacji przywracanie jedną właściwość typu nośnika.

Ustawienie innych właściwości w Restore obiektu może być wymagane przez operację przywracanie pożądane.

Bezpieczeństwo wątków

Wszystkie publiczne, statyczne (udostępnione w programie Microsoft Visual Basic) elementy członkowskie tego typu są bezpieczne dla operacji wielowątkowych. Nie ma gwarancji, że elementy członkowskie wystąpień będą bezpieczne dla wątków.

Aby uzyskać Restore Właściwości obiektu, użytkownicy mogą być element członkowski z publicznych roli serwera stałych.

Aby zestaw Restore Właściwości obiektu, użytkownicy muszą mieć uprawnienie Tworzenie bazy danych na serwerze, lub być członkiem sysadmin lub dbcreator ustalone ról serwera lub być członkiem db_owner ustaloną rola bazy danych.

Do operacji przywracanie użytkowników musi mieć uprawnienie Tworzenie bazy danych na serwerze lub być element członkowski z sysadmin lub dbcreator stałe role serwera.Jeśli baza danych już istnieje, następnie członków db_owner stała rola bazy danych można również wykonać operację przywracanie.

Przykłady

Poniższy przykład kodu pokazuje jak utworzyć zwykły i asynchronicznych kopii AdventureWorks2008R2 bazy danych i korzystania z każdego z tych kopii zapasowych do przywracanie go

VB

'Connect to the local, default instance of SQL Server.
Dim srv As Server
srv = New Server
'Reference the AdventureWorks2008R2 database.
Dim db As Database
db = srv.Databases("AdventureWorks2008R2")
'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 AdventureWorks2008R22008R2"
bk.BackupSetName = "AdventureWorks2008R22008R2 Backup"
bk.Database = "AdventureWorks2008R22008R2"
'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 AdventureWorks2008R22008R2 database before restoring it.
srv.Databases("AdventureWorks2008R22008R2").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 = "AdventureWorks2008R22008R2"
'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("AdventureWorks2008R22008R2").DatabaseOptions.RecoveryModel = recoverymod
'Drop the table that was added.
srv.Databases("AdventureWorks2008R22008R2").Tables("test_table").Drop()
srv.Databases("AdventureWorks2008R22008R2").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("AdventureWorks2008R22008R2")
$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 AdventureWorks2008R22008R2"
$bk.BackupSetName = "AdventureWorks2008R22008R2 Backup"
$bk.Database = "AdventureWorks2008R22008R2"
$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 = "AdventureWorks2008R22008R2"
$srv.Databases["AdventureWorks2008R22008R2"].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["AdventureWorks2008R22008R2"].DatabaseOptions.RecoveryModel = $recoverymod
$srv.Databases["AdventureWorks2008R22008R2"].Tables["test_table"].Drop()
$srv.Databases["AdventureWorks2008R22008R2"].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

Bezpieczeństwo wątków

Wszystkie publiczne statyczny (Shared w języku Visual Basic) elementy członkowskie tego typu są bezpieczne dla wątków. Nie ma gwarancji, że elementy członkowskie wystąpień będą bezpieczne dla wątków.