Classe Backup
The Backup object provides programmatic access to Microsoft SQL Server backup operations.
Hierarquia de herança
System.Object
Microsoft.SqlServer.Management.Smo.BackupRestoreBase
Microsoft.SqlServer.Management.Smo.Backup
Namespace: Microsoft.SqlServer.Management.Smo
Assembly: Microsoft.SqlServer.SmoExtended (em Microsoft.SqlServer.SmoExtended.dll)
Sintaxe
'Declaração
Public NotInheritable Class Backup _
Inherits BackupRestoreBase
'Uso
Dim instance As Backup
public sealed class Backup : BackupRestoreBase
public ref class Backup sealed : public BackupRestoreBase
[<SealedAttribute>]
type Backup =
class
inherit BackupRestoreBase
end
public final class Backup extends BackupRestoreBase
O tipo Backup expõe os membros a seguir.
Construtores
Nome | Descrição | |
---|---|---|
Backup | Initializes a new instance of the Backup class. |
Início
Propriedades
Nome | Descrição | |
---|---|---|
Action | Gets or sets the type of backup to be performed. | |
AsyncStatus | Obtém o status assíncrono de um processo de backup ou restauração. (Herdado de BackupRestoreBase.) | |
BackupSetDescription | Gets or sets a textual description for a particular backup set. | |
BackupSetName | Gets or sets the name used to identify a particular backup set. | |
BlockSize | Obtém ou define o tamanho do bloco físico do backup ou da restauração, em bytes. (Herdado de BackupRestoreBase.) | |
BufferCount | Obtém ou define o número total de buffers de E/S a serem usados para a operação de backup ou restauração. (Herdado de BackupRestoreBase.) | |
Checksum | Obtém ou define um valor da propriedade Boolean que determina se um valor de soma de verificação é calculado durante as operações de backup ou restauração. (Herdado de BackupRestoreBase.) | |
CompressionOption | Gets or sets the backup compression option. | |
ContinueAfterError | Obtém ou define um valor de propriedade Boolean que determina se o backup ou a restauração continuará após um erro de soma de verificação. (Herdado de BackupRestoreBase.) | |
CopyOnly | Gets or sets a Boolean property value that specifies the backup is a copy-only backup. This does not affect the sequence of backups in the usual backup schedule. | |
Database | Obtém ou define o banco de dados no qual a operação de backup ou restauração é executada. (Herdado de BackupRestoreBase.) | |
DatabaseFileGroups | Obtém os grupos de arquivos do SQL Server que constituem o destino da operação de backup ou restauração. (Herdado de BackupRestoreBase.) | |
DatabaseFiles | Obtém arquivos do sistema operacional que constituem o destino da operação de backup ou restauração. (Herdado de BackupRestoreBase.) | |
Devices | Obtém os dispositivos de backup especificados para a operação de backup ou restauração. (Herdado de BackupRestoreBase.) | |
ExpirationDate | Gets or sets the date and time when the backup set expires and the backup data is no longer considered relevant. | |
FormatMedia | Gets or sets a Boolean property value that determines whether a tape is formatted as the first step of the backup operation. | |
Incremental | Gets or sets a Boolean property value that determines whether to perform a differential backup. | |
Initialize | Gets or sets a Boolean property value that determines whether the devices associated with a backup operation are initialized as part of the backup operation. | |
LogTruncation | Gets or sets the method used to truncate the database log as part of the backup operation. | |
MaxTransferSize | Obtém ou define o número máximo de bytes a serem transferidos entre a mídia de backup e a instância do SQL Server. (Herdado de BackupRestoreBase.) | |
MediaDescription | Gets or sets a textual description of the medium that contains a backup set. | |
MediaName | Obtém ou define o nome usado para identificar um determinado conjunto de mídias. (Herdado de BackupRestoreBase.) | |
Mirrors | Gets or sets the list of backup devices used by the mirrored backup. | |
NoRecovery | Obtém ou define um valor de propriedade Boolean que determina se o backup da parte final do log é realizado e se o banco de dados é restaurado ao estado Restauração. (Herdado de BackupRestoreBase.) | |
NoRewind | Obtém ou define um valor de propriedade Boolean que determinará se o Microsoft SQL Server manterá a fita aberta após a operação de backup ou restauração. (Herdado de BackupRestoreBase.) | |
PercentCompleteNotification | Obtém ou define o intervalo percentual para chamadas de manipulador de eventos PercentCompleteEventHandler. (Herdado de BackupRestoreBase.) | |
Restart | Obtém ou define um valor de propriedade Boolean que determina se a operação de backup ou restauração será reiniciada, caso seja interrompida. (Herdado de BackupRestoreBase.) | |
RetainDays | Gets or sets the number of days that must elapse before a backup set can be overwritten. | |
SkipTapeHeader | Gets or sets Boolean property that determines whether the tape header is read. | |
UndoFileName | Gets or sets the name of the undo file used to store uncommitted transactions that are rolled back during recovery. | |
UnloadTapeAfter | Obtém ou define um valor de propriedade Boolean, que determina se a mídia de fita será retrocedida e descarregada após a conclusão da operação de backup ou restauração. (Herdado de BackupRestoreBase.) |
Início
Métodos
Nome | Descrição | |
---|---|---|
Abort | Termina uma operação de backup ou restauração em execução. (Herdado de BackupRestoreBase.) | |
Equals | (Herdado de Object.) | |
GetHashCode | (Herdado de Object.) | |
GetType | (Herdado de Object.) | |
Script | Returns a String containing the Transact-SQL statement that can be used to execute the referenced backup. | |
SetMediaPassword(SecureString) | Obsoleto. Define a senha de um conjunto de mídias. (Herdado de BackupRestoreBase.) | |
SetMediaPassword(String) | Obsoleto. Define a senha de um conjunto de mídias. (Herdado de BackupRestoreBase.) | |
SetPassword(SecureString) | Define a senha de um conjunto de backup. (Herdado de BackupRestoreBase.) | |
SetPassword(String) | Define a senha de um conjunto de backup. (Herdado de BackupRestoreBase.) | |
SqlBackup | Performs the database backup operation as specified by the properties of the Backup object used. | |
SqlBackupAsync | Performs the database backup operation asynchronously as specified by the properties of the Backup object used. | |
ToString | (Herdado de Object.) | |
Wait | Espera a conclusão da operação atual de backup ou restauração, antes de passar para o próximo processo. (Herdado de BackupRestoreBase.) |
Início
Eventos
Nome | Descrição | |
---|---|---|
Complete | Ocorre quando a operação de backup ou restauração é concluída. (Herdado de BackupRestoreBase.) | |
Information | Ocorre quando uma mensagem informativa é emitida pelo Microsoft SQL Server e não pode ser manipulada pelos eventos Complete NextMedia ou PercentComplete. (Herdado de BackupRestoreBase.) | |
NextMedia | Ocorre quando a operação de backup ou restauração esgota a mídia em um dispositivo de destino. (Herdado de BackupRestoreBase.) | |
PercentComplete | Ocorre quando uma operação de backup ou restauração atinge uma unidade de conclusão. (Herdado de BackupRestoreBase.) |
Início
Comentários
A Backup object allows you to do the following:
Back up a SQL Server database or database transaction log.
Generate a Transact-SQL BACKUP statement defining a backup.
Monitor a backup operation, reporting status to the user.
For SQL Server, a database delimits the largest backup unit. Although many different database backup images can be maintained on any single medium, a backup cannot span more than a single database. By default, backup operations performed with a Backup object back up a complete database.
SQL Server can write a backup to one of the following media types: disk, tape, or a proprietary medium called a backup device.
SQL Server supports backup striping. A striped backup is one directed to more than a single device. When striped, a backup is written across the devices in equal chunks. Striping is supported to a single media type only. For example, a backup can be written to two tape devices, but SQL Server cannot write part of a backup to a tape device and the rest to a disk.
At a minimum, you must supply values for a backup source and a backup target when using a Backup object. The Database property (inherited from BackupRestoreBase class) specifies the backup operation source.
To get Backup object properties, users can be a member of the public fixed server role.
To set Backup object properties, users must have BACKUP DATABASE or BACKUP LOG permissions on the database, or be a member of the db_owner and db_backupoperator fixed database role and the sysadmin fixed server role.
To run the SqlBackup method, users must have BACKUP DATABASE or BACKUP LOG permissions on the database, or be a member of the db_owner and db_backupoperator fixed database role and the sysadmin fixed server role.
Exemplos
Fazendo backup e restaurando bancos de dados e logs de transações
Segurança de thread
Qualquer membro público static (Shared no Visual Basic) desse tipo é seguro para threads. Não há garantia de que qualquer membro de instância seja seguro para threads.
Consulte também
Referência
Namespace Microsoft.SqlServer.Management.Smo
Outros recursos
Fazendo backup e restaurando bancos de dados e logs de transações