Backup Backup Backup Class

Définition

Le Backup objet fournit l’accès par programme aux opérations de sauvegarde de Microsoft SQL Server. The Backup object provides programmatic access to Microsoft SQL Server backup operations.

public ref class Backup sealed : Microsoft::SqlServer::Management::Smo::BackupRestoreBase
public sealed class Backup : Microsoft.SqlServer.Management.Smo.BackupRestoreBase
Public NotInheritable Class Backup
Inherits BackupRestoreBase
Héritage

Exemples

Sauvegarde et restauration de bases de données et de journaux de transactionsBacking Up and Restoring Databases and Transaction Logs

Remarques

Un objet Backup vous permet d'effectuer les opérations suivantes :A Backup object allows you to do the following:

  • Sauvegarder une base de données SQL Server ou un journal des transactions de base de données.Back up a SQL Server database or database transaction log.

  • Générer une instruction Transact-SQL BACKUP définissant une sauvegarde.Generate a Transact-SQL BACKUP statement defining a backup.

  • Surveiller une opération de sauvegarde, qui signale l'état à l'utilisateur.Monitor a backup operation, reporting status to the user.

    Pour SQL Server, une base de données délimite la plus grande unité de sauvegarde.For SQL Server, a database delimits the largest backup unit. Bien que plusieurs images de sauvegarde de base de données distinctes puissent être gérées sur un seul support, une sauvegarde ne peut couvrir qu'une seule base de données.Although many different database backup images can be maintained on any single medium, a backup cannot span more than a single database. Par défaut, les opérations de sauvegarde effectuées à l'aide d'un objet Backup sauvegardent une base de données complète.By default, backup operations performed with a Backup object back up a complete database.

    SQL Server peut écrire une sauvegarde sur l'un des types suivants de support : disque, bande ou support propriétaire appelé unité de sauvegarde. can write a backup to one of the following media types: disk, tape, or a proprietary medium called a backup device.

    SQL Server prend en charge l'entrelacement de sauvegardes. supports backup striping. Une sauvegarde entrelacée est destinée à plusieurs unités.A striped backup is one directed to more than a single device. Une fois entrelacée, une sauvegarde est écrite sur les unités dans des segments égaux.When striped, a backup is written across the devices in equal chunks. L'entrelacement est pris en charge sur un seul type de support.Striping is supported to a single media type only. Par exemple, une sauvegarde peut être écrite sur deux périphériques à bandes, mais SQL Server ne peut pas écrire une partie d'une sauvegarde sur un périphérique à bandes et l'autre sur un disque.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.

    Vous devez au moins spécifier les valeurs d'une source de sauvegarde et d'une cible de sauvegarde lorsque vous utilisez un objet Backup.At a minimum, you must supply values for a backup source and a backup target when using a Backup object. La propriété Database (héritée de la classe BackupRestoreBase) spécifie la source de l'opération de sauvegarde.The Database property (inherited from BackupRestoreBase class) specifies the backup operation source.

    Pour obtenir les propriétés de l'objet Backup, les utilisateurs peuvent être membres du rôle serveur fixe public.To get Backup object properties, users can be a member of the public fixed server role.

    Pour définir les propriétés de l'objet Backup, les utilisateurs doivent avoir les autorisations BACKUP DATABASE et BACKUP LOG sur la base de données, ou être membres des rôles de base de données fixes db_owner et db_backupoperator et du rôle serveur fixe sysadmin.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.

    Pour exécuter la méthode SqlBackup, les utilisateurs doivent avoir les autorisations BACKUP DATABASE et BACKUP LOG sur la base de données, ou être membres des rôles de base de données fixes db_owner et db_backupoperator et du rôle serveur fixe sysadmin.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.

Constructeurs

Backup() Backup() Backup()

Initialise une nouvelle instance de la classe Backup. Initializes a new instance of the Backup class.

Propriétés

Action Action Action

Obtient ou définit le type de sauvegarde à effectuer. Gets or sets the type of backup to be performed.

AsyncStatus AsyncStatus AsyncStatus

Obtient l'état asynchrone d'un processus de sauvegarde ou de restauration. Gets the asynchronous status of a backup or restore process.

(Inherited from BackupRestoreBase)
BackupSetDescription BackupSetDescription BackupSetDescription

Obtient ou définit une description textuelle pour un jeu de sauvegarde donné. Gets or sets a textual description for a particular backup set.

BackupSetName BackupSetName BackupSetName

Obtient ou définit le nom utilisé pour identifier un jeu de sauvegarde donné. Gets or sets the name used to identify a particular backup set.

BlockSize BlockSize BlockSize

Obtient ou définit la taille des blocs physiques de la sauvegarde ou de la restauration, en octets. Gets or sets the physical block size of the backup or restore, in bytes.

(Inherited from BackupRestoreBase)
BufferCount BufferCount BufferCount

Obtient ou définit le nombre total de tampons d'E/S à utiliser pour l'opération de sauvegarde ou de restauration. Gets or sets the total number of I/O buffers to be used for the backup or restore operation.

(Inherited from BackupRestoreBase)
Checksum Checksum Checksum

Obtient ou définit une valeur de propriété Boolean qui détermine si une valeur de somme de contrôle est calculée pendant les opérations de sauvegarde ou de restauration. Gets or sets a Boolean property value that determines whether a checksum value is calculated during backup or restore operations.

(Inherited from BackupRestoreBase)
CompressionOption CompressionOption CompressionOption

Obtient ou définit l'option de compression de la sauvegarde. Gets or sets the backup compression option.

ContinueAfterError ContinueAfterError ContinueAfterError

Obtient ou définit une valeur de propriété Boolean qui détermine si la sauvegarde ou la restauration continue après une erreur de somme de contrôle. Gets or sets a Boolean property value that determines whether the backup or restore continues after a checksum error occurs.

(Inherited from BackupRestoreBase)
CopyOnly CopyOnly CopyOnly

Obtient ou définit une valeur de propriété Boolean qui spécifie si la sauvegarde est une sauvegarde de copie unique. Gets or sets a Boolean property value that specifies the backup is a copy-only backup. Cela n'affecte pas la séquence des sauvegardes dans la planification de sauvegarde habituelle. This does not affect the sequence of backups in the usual backup schedule.

CredentialName CredentialName CredentialName

Obtient ou définit la valeur de la propriété Credential, qui est utilisée pour identifier le compte de stockage Windows Azure. Gets or sets the Credential property value, which is used to authenticate to the Windows Azure storage account.

(Inherited from BackupRestoreBase)
Database Database Database

Obtient ou définit la base de données sur laquelle l'opération de sauvegarde ou de restauration s'exécute. Gets or sets the database on which the backup or restore operation runs.

(Inherited from BackupRestoreBase)
DatabaseFileGroups DatabaseFileGroups DatabaseFileGroups

Obtient les groupes de fichiers SQL Server ciblées par l’opération de sauvegarde ou de restauration. Gets the SQL Server file groups targeted by the backup or restore operation.

(Inherited from BackupRestoreBase)
DatabaseFiles DatabaseFiles DatabaseFiles

Obtient les fichiers de système d'exploitation ciblés par l'opération de sauvegarde ou de restauration. Gets the operating system files targeted by the backup or restore operation.

(Inherited from BackupRestoreBase)
Devices Devices Devices

Obtient les unités de sauvegarde spécifiées pour l'opération de sauvegarde ou de restauration. Gets the backup devices specified for the backup or restore operation.

(Inherited from BackupRestoreBase)
EncryptionOption EncryptionOption EncryptionOption

Obtient ou définit l'option de chiffrement de la sauvegarde. Gets or sets the backup encryption option.

ExpirationDate ExpirationDate ExpirationDate

Obtient ou définit la date et l'heure d'expiration du jeu de sauvegarde, c'est-à-dire lorsque les données de sauvegarde ne sont plus considérées comme pertinentes. Gets or sets the date and time when the backup set expires and the backup data is no longer considered relevant.

FormatMedia FormatMedia FormatMedia

Obtient ou définit une valeur de propriété Boolean qui détermine si une bande est formatée comme première étape de l'opération de sauvegarde. Gets or sets a Boolean property value that determines whether a tape is formatted as the first step of the backup operation.

Incremental Incremental Incremental

Obtient ou définit un Boolean valeur de propriété qui détermine s’il faut effectuer une sauvegarde différentielle. Gets or sets a Boolean property value that determines whether to perform a differential backup.

Initialize Initialize Initialize

Obtient ou définit un Boolean valeur de propriété qui détermine si les périphériques associés à une opération de sauvegarde sont initialisés dans le cadre de l’opération de sauvegarde. 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 LogTruncation LogTruncation

Obtient ou définit la méthode utilisée pour tronquer le journal de base de données dans le cadre de l'opération de sauvegarde. Gets or sets the method used to truncate the database log as part of the backup operation.

MaxTransferSize MaxTransferSize MaxTransferSize

Obtient ou définit le nombre maximal d'octets à transférer entre le support de sauvegarde et l'instance de SQL Server. Gets or sets the maximum number of bytes to be transferred between the backup media and the instance of SQL Server.

(Inherited from BackupRestoreBase)
MediaDescription MediaDescription MediaDescription

Obtient ou définit une description textuelle du support qui contient un jeu de sauvegarde. Gets or sets a textual description of the medium that contains a backup set.

MediaName MediaName MediaName

Obtient ou définit le nom utilisé pour identifier un support de sauvegarde donné. Gets or sets the name used to identify a particular media set.

(Inherited from BackupRestoreBase)
Mirrors Mirrors Mirrors

Obtient ou définit la liste des unités de sauvegarde utilisées par la sauvegarde en miroir. Gets or sets the list of backup devices used by the mirrored backup.

NoRecovery NoRecovery NoRecovery

Obtient ou définit une valeur de propriété Boolean qui détermine si la fin du journal est sauvegardée et si la base de données est restaurée dans l'état de restauration. Gets or sets a Boolean property value that determines whether the tail of the log is backed up and whether the database is restored into the Restoring state.

(Inherited from BackupRestoreBase)
NoRewind NoRewind NoRewind

Obtient ou définit un Boolean valeur de propriété qui détermine si Microsoft SQL Server maintient la bande ouverte après la sauvegarde ou l’opération de restauration. Gets or sets a Boolean property value that determines whether Microsoft SQL Server will keep the tape open after the backup or restore operation.

(Inherited from BackupRestoreBase)
PercentCompleteNotification PercentCompleteNotification PercentCompleteNotification

Obtient ou définit l’intervalle en pourcentage pour PercentCompleteEventHandler appels du Gestionnaire d’événements. Gets or sets the percentage interval for PercentCompleteEventHandler event handler calls.

(Inherited from BackupRestoreBase)
Restart Restart Restart

Obtient ou définit une valeur de propriété Boolean qui détermine si l'opération de sauvegarde ou de restauration redémarre en cas d'interruption. Gets or sets a Boolean property value that determines whether the backup or restore operation will restart if it is interrupted.

(Inherited from BackupRestoreBase)
RetainDays RetainDays RetainDays

Obtient ou définit le nombre de jours qui doivent s'écouler avant de pouvoir remplacer un jeu de sauvegarde. Gets or sets the number of days that must elapse before a backup set can be overwritten.

SkipTapeHeader SkipTapeHeader SkipTapeHeader

Obtient ou définit Boolean propriété qui détermine si l’en-tête de la bande est en lecture. Gets or sets Boolean property that determines whether the tape header is read.

UndoFileName UndoFileName UndoFileName

Obtient ou définit le nom du fichier journal des annulations utilisé pour stocker des transactions non validées restaurées pendant la récupération. Gets or sets the name of the undo file used to store uncommitted transactions that are rolled back during recovery.

UnloadTapeAfter UnloadTapeAfter UnloadTapeAfter

Obtient ou définit une valeur de propriété Boolean qui détermine si le support de bande est rembobiné et déchargé à la fin de l'opération de sauvegarde ou de restauration. Gets or sets a Boolean property value that determines whether tape media are rewound and unloaded after the backup or restore operation completes.

(Inherited from BackupRestoreBase)

Méthodes

Abort() Abort() Abort()

Arrête une opération de sauvegarde ou de restauration en cours d'exécution. Terminates a running backup or restore operation.

(Inherited from BackupRestoreBase)
CheckForHADRMaintPlan(Server, StringBuilder) CheckForHADRMaintPlan(Server, StringBuilder) CheckForHADRMaintPlan(Server, StringBuilder)

Vérifications pour HADR Maintenance plan. Checks for HADR Maintenance plan.

(Inherited from BackupRestoreBase)
ExecuteSql(Server, StringCollection) ExecuteSql(Server, StringCollection) ExecuteSql(Server, StringCollection)

Exécute un lot de Transact-des instructions SQL qui n’attend pas d’un ensemble de résultats est définie sur l’instance spécifiée de SQL Server. Executes a batch of Transact-SQL statements that does not expect a returned results set on the specified instance of SQL Server.

(Inherited from BackupRestoreBase)
ExecuteSqlAsync(Server, StringCollection) ExecuteSqlAsync(Server, StringCollection) ExecuteSqlAsync(Server, StringCollection)

Exécute un lot de Transact-des instructions SQL en mode asynchrone qui n’attend pas d’un ensemble de résultats est définie sur l’instance spécifiée de SQL Server. Executes a batch of Transact-SQL statements asynchronously that does not expect a returned results set on the specified instance of SQL Server.

(Inherited from BackupRestoreBase)
ExecuteSqlWithResults(Server, String) ExecuteSqlWithResults(Server, String) ExecuteSqlWithResults(Server, String)

Exécute un lot de Transact-des instructions SQL qui attend un ou plusieurs résultats définit sur l’instance spécifiée de SQL Server. Executes a batch of Transact-SQL statements that expects one or more returned results sets on the specified instance of SQL Server.

(Inherited from BackupRestoreBase)
GetDevicesScript(StringBuilder, BackupDeviceList, ServerVersion) GetDevicesScript(StringBuilder, BackupDeviceList, ServerVersion) GetDevicesScript(StringBuilder, BackupDeviceList, ServerVersion)

Obtient le script utilisé pour créer des périphériques. Gets the script that is used to create devices.

(Inherited from BackupRestoreBase)
IsStringValid(String) IsStringValid(String) IsStringValid(String)

Vérifie si la chaîne spécifiée est valide. Verifies whether the specified string is valid.

(Inherited from BackupRestoreBase)
Script(Server) Script(Server) Script(Server)

Retourne un String contenant Transact-instruction SQL qui peut être utilisée pour exécuter la sauvegarde référencée. Returns a String containing the Transact-SQL statement that can be used to execute the referenced backup.

SetMediaPassword(SecureString) SetMediaPassword(SecureString) SetMediaPassword(SecureString)

Définit le mot de passe utilisé pour un support de sauvegarde. Sets the password for a media set.

(Inherited from BackupRestoreBase)
SetMediaPassword(String) SetMediaPassword(String) SetMediaPassword(String)

Définit le mot de passe utilisé pour un support de sauvegarde. Sets the password for a media set.

(Inherited from BackupRestoreBase)
SetPassword(SecureString) SetPassword(SecureString) SetPassword(SecureString)

Définit le mot de passe utilisé pour un jeu de sauvegarde. Sets the password for a backup set.

(Inherited from BackupRestoreBase)
SetPassword(String) SetPassword(String) SetPassword(String)

Définit le mot de passe utilisé pour un jeu de sauvegarde. Sets the password for a backup set.

(Inherited from BackupRestoreBase)
SqlBackup(Server) SqlBackup(Server) SqlBackup(Server)

Effectue l’opération de sauvegarde de base de données comme spécifié par les propriétés de la Backup objet utilisé. Performs the database backup operation as specified by the properties of the Backup object used.

SqlBackupAsync(Server) SqlBackupAsync(Server) SqlBackupAsync(Server)

Effectue l’opération de sauvegarde de base de données en mode asynchrone, comme spécifié par les propriétés de la Backup objet utilisé. Performs the database backup operation asynchronously as specified by the properties of the Backup object used.

Wait() Wait() Wait()

Attend la fin de l'opération de sauvegarde ou de restauration en cours avant de passer au processus suivant. Waits for the current backup or restore operation to complete before moving on to the next process.

(Inherited from BackupRestoreBase)

Événements

Complete Complete Complete

Se produit lorsque l'opération de sauvegarde ou de restauration est terminée. Occurs when the backup or restore operation completes.

(Inherited from BackupRestoreBase)
Information Information Information

Se produit lorsqu’un message d’information émis par Microsoft SQL Server ne peut pas être gérée par le CompleteNextMedia ou PercentComplete événements. Occurs when any informational message is issued by Microsoft SQL Server that cannot be handled by the CompleteNextMedia or PercentComplete events.

(Inherited from BackupRestoreBase)
NextMedia NextMedia NextMedia

Se produit lorsque l'opération de sauvegarde ou de restauration épuise le média dans un périphérique cible. Occurs when the backup or restore operation exhausts the medium in a target device.

(Inherited from BackupRestoreBase)
PercentComplete PercentComplete PercentComplete

Se produit lorsqu'une opération de sauvegarde ou de restauration atteint une unité d'achèvement. Occurs when a backup or restore operation reaches a completion unit.

(Inherited from BackupRestoreBase)

Champs

currentAsyncOperation currentAsyncOperation currentAsyncOperation

Spécifie l'opération asynchrone actuelle, telle que la sauvegarde, la restauration, ou aucune opération. Specifies the current asynchronous operation, such as backup, restore, or none.

(Inherited from BackupRestoreBase)
m_BackupAction m_BackupAction m_BackupAction

Spécifie le type d'action de sauvegarde, telle qu'une sauvegarde de base de données ou de journal. Specifies the backup action type, such as database or log.

(Inherited from BackupRestoreBase)
m_LogTruncation m_LogTruncation m_LogTruncation

Spécifie s'il faut tronquer le journal. Specifies whether to truncate the log.

(Inherited from BackupRestoreBase)
m_RestoreAction m_RestoreAction m_RestoreAction

Spécifie le type d'action de restauration, telle qu'une restauration de base de données ou de journal. Specifies the restore action type, such as database or log.

(Inherited from BackupRestoreBase)

S’applique à