sp_addumpdevice (Transact-SQL)sp_addumpdevice (Transact-SQL)

S’APPLIQUE À : ouiSQL Server nonAzure SQL Database nonAzure Synapse Analytics (SQL DW) nonParallel Data Warehouse APPLIES TO: yesSQL Server noAzure SQL Database noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse

S’applique à: SQL ServerSQL Server (de SQL Server 2008SQL Server 2008 à la version actuelle).Applies to: SQL ServerSQL Server ( SQL Server 2008SQL Server 2008 through current version).

Ajoute une unité de sauvegarde à une instance du SQL ServerSQL Server.Adds a backup device to an instance of SQL ServerSQL Server.

Icône de lien de rubrique Conventions de la syntaxe Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SyntaxeSyntax

  
sp_addumpdevice [ @devtype = ] 'device_type'   
    , [ @logicalname = ] 'logical_name'   
    , [ @physicalname = ] 'physical_name'  
      [ , { [ @cntrltype = ] controller_type |  
          [ @devstatus = ] 'device_status' }  
      ]  

ArgumentsArguments

[ @devtype = ] 'device_type' Est le type d’unité de sauvegarde.[ @devtype = ] 'device_type' Is the type of backup device. device_type est varchar (20) , sans valeur par défaut et peut prendre l’une des valeurs suivantes.device_type is varchar(20), with no default, and can be one of the following values.

ValueValue DescriptionDescription
diskdisk Fichier de disque dur comme unité de sauvegarde.Hard disk file as a backup device.
tapetape Tout périphérique à bandes géré par MicrosoftMicrosoft Windows.Any tape devices supported by MicrosoftMicrosoft Windows.

Remarque : La prise en charge des unités de sauvegarde sur bande sera supprimée dans une prochaine version de SQL ServerSQL Server.Note: Support for tape backup devices will be removed in a future version of SQL ServerSQL Server. Évitez d'utiliser cette fonctionnalité dans de nouveaux travaux de développement, et prévoyez de modifier les applications qui utilisent actuellement cette fonctionnalité.Avoid using this feature in new development work, and plan to modify applications that currently use this feature.

[ @logicalname = ] 'logical_name' Est le nom logique de l’unité de sauvegarde utilisée dans les instructions BACKUP et RESTORE.[ @logicalname = ] 'logical_name' Is the logical name of the backup device used in the BACKUP and RESTORE statements. nom_logique est sysname, sans valeur par défaut, et ne peut pas être NULL.logical_name is sysname, with no default, and cannot be NULL.

[ @physicalname = ] 'physical_name' Est le nom physique de l’unité de sauvegarde.[ @physicalname = ] 'physical_name' Is the physical name of the backup device. Les noms physiques doivent respecter les règles en vigueur pour les noms de fichiers du système d'exploitation ou les conventions d'affectation des noms pour les unités réseau, et doivent comprendre un chemin d'accès complet.Physical names must follow the rules for operating-system file names or universal naming conventions for network devices, and must include a full path. physical_name est nvarchar (260) , sans valeur par défaut de valeur et ne peut pas être NULL.physical_name is nvarchar(260), with no default value, and cannot be NULL.

Lorsque vous créez une unité de sauvegarde sur un site de réseau distant, assurez-vous que le nom sous lequel le Moteur de base de donnéesDatabase Engine a été démarré est capable d'assurer les opérations d'écriture sur l'ordinateur distant.When creating a backup device on a remote network location, be sure that the name under which the Moteur de base de donnéesDatabase Engine was started has appropriate write capabilities on the remote computer.

Si vous ajoutez un périphérique à bandes, ce paramètre doit être le nom physique affecté sur le périphérique à bandes local de Windows ; par exemple, \ \. \TAPE0 pour la première unité de bande sur l’ordinateur.If you add a tape device, this parameter must be the physical name assigned to the local tape device by Windows; for example, \\.\TAPE0 for the first tape device on the computer. Ce périphérique à bandes doit être relié à l'ordinateur serveur, il ne peut être utilisé à distance.The tape device must be attached to the server computer; it cannot be used remotely. Insérez les noms comportant des caractères non alphanumériques entre guillemets.Enclose names that contain nonalphanumeric characters in quotation marks.

Notes

Cette procédure entre le nom physique spécifié dans le catalogue,This procedure enters the specified physical name into the catalog. mais elle ne tente pas de créer l'unité ou d'y accéder.The procedure does not attempt to access or create the device.

[ @cntrltype = ] 'controller_type' Obsolète.[ @cntrltype = ] 'controller_type' Obsolete. S'il est spécifié, ce paramètre est ignoré.If specified, this parameter is ignored. Il est conservé uniquement pour des raisons de compatibilité descendante.It is supported purely for backward compatibility. Les nouvelles utilisations de sp_addumpdevice doit omettre ce paramètre.New uses of sp_addumpdevice should omit this parameter.

[ @devstatus = ] 'device_status' Obsolète.[ @devstatus = ] 'device_status' Obsolete. S'il est spécifié, ce paramètre est ignoré.If specified, this parameter is ignored. Il est conservé uniquement pour des raisons de compatibilité descendante.It is supported purely for backward compatibility. Les nouvelles utilisations de sp_addumpdevice doit omettre ce paramètre.New uses of sp_addumpdevice should omit this parameter.

Valeurs des codes de retourReturn Code Values

0 (réussite) ou 1 (échec)0 (success) or 1 (failure)

Jeux de résultatsResult Sets

AucunNone

NotesRemarks

sp_addumpdevice ajoute une unité de sauvegarde à la sys.backup_devices vue de catalogue.sp_addumpdevice adds a backup device to the sys.backup_devices catalog view. Vous pouvez ensuite faire référence à cette unité de manière logique dans les instructions BACKUP et RESTORE.The device can then be referred to logically in BACKUP and RESTORE statements. sp_addumpdevice n’effectue pas l’accès à l’appareil physique.sp_addumpdevice does not perform any access to the physical device. L'accès à l'unité spécifié survient uniquement lorsqu'une instruction BACKUP ou RESTORE est exécutée.Access to the specified device only occurs when a BACKUP or RESTORE statement is performed. La création d'une unité de sauvegarde logique peut simplifier les instructions BACKUP et RESTORE, car la définition du nom de l'unité est une solution via l'utilisation d'une clause « TAPE = » ou « DISK = » pour spécifier le chemin d'accès de l'unité.Creating a logical backup device can simplify BACKUP and RESTORE statements, where specifying the device name is an alternative using a "TAPE =" or "DISK =" clause to specify the device path.

Des problèmes de propriété et de permissions sont susceptibles de perturber l'utilisation des unités de sauvegarde sur disque ou sur fichiers.Ownership and permissions problems can interfere with the use of disk or file backup devices. Assurez-vous que le compte Windows sous lequel le Moteur de base de donnéesDatabase Engine a été démarré bénéficie des autorisations de fichiers adéquates.Make sure that appropriate file permissions are given to the Windows account under which the Moteur de base de donnéesDatabase Engine was started.

Le Moteur de base de donnéesDatabase Engine assure les sauvegardes sur des périphériques à bandes pris en charge par Windows.The Moteur de base de donnéesDatabase Engine supports tape backups to tape devices that are supported by Windows. Pour plus d'informations sur les périphériques à bandes pris en charge par Windows, consultez la liste de compatibilité du matériel de Windows.For more information about Windows-supported tape devices, see the hardware compatibility list for Windows. Pour afficher les périphériques à bandes disponibles sur l'ordinateur, utilisez SQL Server Management StudioSQL Server Management Studio.To view the tape devices available on the computer, use SQL Server Management StudioSQL Server Management Studio.

N'utilisez dans le lecteur de bande que les bandes recommandées par le fabricant du lecteur.Use only the recommended tapes for the specific tape drive that are suggested by the drive manufacturer. Si vous utilisez des lecteurs DAT, utilisez des bandes DAT conçues pour fonctionner avec un ordinateur (Digital Data Storage-DDS).If you are using digital audio tape (DAT) drives, use computer-grade DAT tapes (Digital Data Storage (DDS)).

sp_addumpdevice ne peut pas être exécutée à l’intérieur d’une transaction.sp_addumpdevice cannot be executed inside a transaction.

Pour supprimer un appareil, utilisez sp_dropdevice ouSQL Server Management Studio.To delete a device, use sp_dropdevice orSQL Server Management Studio.

AutorisationsPermissions

Nécessite l'appartenance au rôle serveur fixe diskadmin .Requires membership in the diskadmin fixed server role.

Requiert l'autorisation d'écrire sur le disque.Requires permission to write to the disk.

ExemplesExamples

R.A. Ajout d'une unité de sauvegarde sur disqueAdding a disk dump device

L'exemple suivant ajoute une unité de sauvegarde sur disque appelée mydiskdump, dont le nom physique est c:\dump\dump1.bak.The following example adds a disk backup device named mydiskdump, with the physical name c:\dump\dump1.bak.

USE master;  
GO  
EXEC sp_addumpdevice 'disk', 'mydiskdump', 'c:\dump\dump1.bak';  

B.B. Ajout d'une unité de sauvegarde sur disque du réseauAdding a network disk backup device

L'exemple suivant ajoute une unité de sauvegarde sur disque distant appelée networkdevice.The following example shows adding a remote disk backup device called networkdevice. Le nom sous lequel le Moteur de base de donnéesDatabase Engine a été démarré doit disposer des autorisations à ce fichier à distance (\\<servername>\<sharename>\<path>\<filename>.bak).The name under which the Moteur de base de donnéesDatabase Engine was started must have permissions to that remote file (\\<servername>\<sharename>\<path>\<filename>.bak).

USE master;  
GO  
EXEC sp_addumpdevice 'disk', 'networkdevice',  
    '\\<servername>\<sharename>\<path>\<filename>.bak';  

C.C. Ajout d'une unité de sauvegarde sur bandeAdding a tape backup device

L'exemple suivant ajoute le périphérique à bandes tapedump1 dont le nom physique est \\.\tape0.The following example adds the tapedump1 device with the physical name \\.\tape0.

USE master;  
GO  
EXEC sp_addumpdevice 'tape', 'tapedump1', '\\.\tape0';  

D.D. Sauvegarde sur une unité de sauvegarde logiqueBacking up to a logical backup device

L'exemple suivant crée une unité de sauvegarde logique, AdvWorksData, pour un fichier de sauvegarde sur disque.The following example creates a logical backup device, AdvWorksData, for a backup disk file. Il sauvegarde ensuite la base de données AdventureWorks2012AdventureWorks2012 sur cette unité de sauvegarde logique.The example then backs up the AdventureWorks2012AdventureWorks2012 database to this logical backup device.

USE master;  
GO  
EXEC sp_addumpdevice 'disk', 'AdvWorksData',   
'C:\Program Files\Microsoft SQL Server\MSSQL13.MSSQLSERVER\MSSQL\BACKUP\AdvWorksData.bak';  
GO  
BACKUP DATABASE AdventureWorks2012   
 TO AdvWorksData  
   WITH FORMAT;  
GO  

Voir aussiSee Also

Unités de sauvegarde (SQL Server) Backup Devices (SQL Server)
BACKUP (Transact-SQL) BACKUP (Transact-SQL)
Définir une unité de sauvegarde logique pour un fichier de disque (SQL Server) Define a Logical Backup Device for a Disk File (SQL Server)
Définir une unité de sauvegarde logique pour un lecteur de bande (SQL Server) Define a Logical Backup Device for a Tape Drive (SQL Server)
RESTORE (Transact-SQL) RESTORE (Transact-SQL)
sp_dropdevice (Transact-SQL) sp_dropdevice (Transact-SQL)
sys.backup_devices (Transact-SQL) sys.backup_devices (Transact-SQL)
Procédures stockées système (Transact-SQL)System Stored Procedures (Transact-SQL)