Backup 类

The Backup object provides programmatic access to Microsoft SQL Server backup operations.

继承层次结构

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

命名空间：  Microsoft.SqlServer.Management.Smo
程序集：  Microsoft.SqlServer.SmoExtended（在 Microsoft.SqlServer.SmoExtended.dll 中）

语法

声明
Public NotInheritable Class Backup _
    Inherits BackupRestoreBase
用法
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

Backup 类型公开以下成员。

构造函数

	名称	说明
	Backup	Initializes a new instance of the Backup class.

页首

属性

	名称	说明
	Action	Gets or sets the type of backup to be performed.
	AsyncStatus	获取备份或还原过程的异步状态。 （从 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	获取或设置备份或还原的物理块大小（以字节为单位）。 （从 BackupRestoreBase 继承。）
	BufferCount	获取或设置要用于备份或还原操作的 I/O 缓冲区总数。 （从 BackupRestoreBase 继承。）
	Checksum	获取或设置 Boolean 属性值，该值确定是否在备份或还原操作中计算校验和值。 （从 BackupRestoreBase 继承。）
	CompressionOption	Gets or sets the backup compression option.
	ContinueAfterError	获取或设置 Boolean 属性值，该值确定在出现校验和错误后是否继续执行备份或还原操作。 （从 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	获取或设置执行备份或还原操作所在的数据库。 （从 BackupRestoreBase 继承。）
	DatabaseFileGroups	获取备份或还原操作所针对的 SQL Server 文件组。 （从 BackupRestoreBase 继承。）
	DatabaseFiles	获取备份或还原操作所针对的操作系统文件。 （从 BackupRestoreBase 继承。）
	Devices	获取为备份或还原操作指定的备份设备。 （从 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	获取或设置要在备份介质和 SQL Server 实例之间传输的最大字节数。 （从 BackupRestoreBase 继承。）
	MediaDescription	Gets or sets a textual description of the medium that contains a backup set.
	MediaName	获取或设置用于标识特定介质集的名称。 （从 BackupRestoreBase 继承。）
	Mirrors	Gets or sets the list of backup devices used by the mirrored backup.
	NoRecovery	获取或设置 Boolean 属性值，该值确定是否备份日志尾部以及是否将数据库还原到“正在还原”状态。 （从 BackupRestoreBase 继承。）
	NoRewind	获取或设置 Boolean 属性值，该值确定 MicrosoftSQL Server 是否在备份或还原操作后保持磁带打开。 （从 BackupRestoreBase 继承。）
	PercentCompleteNotification	获取或设置 PercentCompleteEventHandler 事件处理程序调用的百分比间隔。 （从 BackupRestoreBase 继承。）
	Restart	获取或设置 Boolean 属性值，该值确定备份或还原操作在中断后是否重新启动。 （从 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	获取或设置 Boolean 属性值，该值确定在完成备份或还原操作后是否倒带并卸载磁带介质。 （从 BackupRestoreBase 继承。）

页首

方法

	名称	说明
	Abort	终止正在运行的备份或还原操作。 （从 BackupRestoreBase 继承。）
	Equals	（从 Object 继承。）
	GetHashCode	（从 Object 继承。）
	GetType	（从 Object 继承。）
	Script	Returns a String containing the Transact-SQL statement that can be used to execute the referenced backup.
	SetMediaPassword(SecureString)	已过时。为介质集设置密码。 （从 BackupRestoreBase 继承。）
	SetMediaPassword(String)	已过时。为介质集设置密码。 （从 BackupRestoreBase 继承。）
	SetPassword(SecureString)	为备份集设置密码。 （从 BackupRestoreBase 继承。）
	SetPassword(String)	为备份集设置密码。 （从 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	（从 Object 继承。）
	Wait	等待当前备份或还原操作完成后再进入下一进程。 （从 BackupRestoreBase 继承。）

页首

事件

	名称	说明
	Complete	在备份或还原操作完成后发生。 （从 BackupRestoreBase 继承。）
	Information	当 Microsoft SQL Server 发出不能被 Complete NextMedia 或 PercentComplete 事件处理的任何信息性消息时发生。 （从 BackupRestoreBase 继承。）
	NextMedia	在备份或还原操作耗尽目标设备中的介质时发生。 （从 BackupRestoreBase 继承。）
	PercentComplete	在备份或还原操作达到完成单元时发生。 （从 BackupRestoreBase 继承。）

页首

注释

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.

示例

备份和还原数据库和事务日志

线程安全

此类型的任何公共 static（在 Visual Basic 中为 Shared） 成员都是线程安全的。不保证所有实例成员都是线程安全的。

请参阅

参考

Microsoft.SqlServer.Management.Smo 命名空间

其他资源

备份和还原数据库和事务日志

BACKUP (Transact-SQL)