sp_addumpdevice (Transact-SQL)

S’applique à : ouiSQL Server (toutes les versions prises en charge)

S’applique à: SQL Server (de SQL Server 2008 à la version actuelle).

Ajoute une unité de sauvegarde à une instance du SQL Server.

Icône Lien de rubrique Conventions de la syntaxe Transact-SQL

Syntaxe

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

Arguments

[ @devtype = ] 'device_type' Type de l’unité de sauvegarde. device_type est de type varchar (20), sans valeur par défaut et peut prendre l’une des valeurs suivantes.

Valeur Description
libérer Fichier de disque dur comme unité de sauvegarde.
déroule Tout périphérique à bandes géré par Microsoft Windows.

Remarque : La prise en charge des unités de sauvegarde sur bande sera supprimée dans une prochaine version de SQL 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é.

[ @logicalname = ] 'logical_name' Nom logique de l’unité de sauvegarde utilisée dans les instructions BACKUP et Restore. logical_name est de type sysname, sans valeur par défaut et ne peut pas avoir la valeur null.

[ @physicalname = ] 'physical_name' Nom physique de l’unité de sauvegarde. 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_name est de type nvarchar (260), sans valeur par défaut, et ne peut pas être 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ées a été démarré est capable d'assurer les opérations d'écriture sur l'ordinateur distant.

Si vous ajoutez un périphérique à bandes, ce paramètre doit être le nom physique affecté à l’unité de bande locale par Windows ; par exemple, \ \ .\TAPE0 pour le premier périphérique à bandes sur l’ordinateur. Ce périphérique à bandes doit être relié à l'ordinateur serveur, il ne peut être utilisé à distance. Insérez les noms comportant des caractères non alphanumériques entre guillemets.

Notes

Cette procédure entre le nom physique spécifié dans le catalogue, mais elle ne tente pas de créer l'unité ou d'y accéder.

[ @cntrltype = ] 'controller_type' Périmé. S'il est spécifié, ce paramètre est ignoré. Il est conservé uniquement pour des raisons de compatibilité descendante. Les nouvelles utilisations de sp_addumpdevice doivent omettre ce paramètre.

[ @devstatus = ] 'device_status' Périmé. S'il est spécifié, ce paramètre est ignoré. Il est conservé uniquement pour des raisons de compatibilité descendante. Les nouvelles utilisations de sp_addumpdevice doivent omettre ce paramètre.

Codet de retour

0 (réussite) ou 1 (échec)

Jeux de résultats

None

Notes

sp_addumpdevice ajoute une unité de sauvegarde à l’affichage catalogue sys.backup_devices . Vous pouvez ensuite faire référence à cette unité de manière logique dans les instructions BACKUP et RESTORE. sp_addumpdevice n’effectue pas d’accès à l’appareil physique. L'accès à l'unité spécifié survient uniquement lorsqu'une instruction BACKUP ou RESTORE est exécutée. 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é.

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. Assurez-vous que le compte Windows sous lequel le Moteur de base de données a été démarré bénéficie des autorisations de fichiers adéquates.

Le Moteur de base de données assure les sauvegardes sur des périphériques à bandes pris en charge par 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. Pour afficher les périphériques à bandes disponibles sur l'ordinateur, utilisez SQL Server Management Studio.

N'utilisez dans le lecteur de bande que les bandes recommandées par le fabricant du lecteur. Si vous utilisez des lecteurs DAT, utilisez des bandes DAT conçues pour fonctionner avec un ordinateur (Digital Data Storage-DDS).

sp_addumpdevice ne peut pas être exécutée dans une transaction.

Pour supprimer un appareil, utilisez sp_dropdevice ouSQL Server Management Studio.

Autorisations

Nécessite l'appartenance au rôle serveur fixe diskadmin .

Requiert l'autorisation d'écrire sur le disque.

Exemples

R. Ajout d'une unité de sauvegarde sur disque

L'exemple suivant ajoute une unité de sauvegarde sur disque appelée mydiskdump, dont le nom physique est c:\dump\dump1.bak.

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

B. Ajout d'une unité de sauvegarde sur disque du réseau

L'exemple suivant ajoute une unité de sauvegarde sur disque distant appelée networkdevice. Le nom sous lequel le Moteur de base de données a été démarré doit avoir les autorisations pour ce fichier distant ( \\<servername>\<sharename>\<path>\<filename>.bak ).

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

C. Ajout d'une unité de sauvegarde sur bande

L'exemple suivant ajoute le périphérique à bandes tapedump1 dont le nom physique est \\.\tape0.

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

D. Sauvegarde sur une unité de sauvegarde logique

L'exemple suivant crée une unité de sauvegarde logique, AdvWorksData, pour un fichier de sauvegarde sur disque. Il sauvegarde ensuite la base de données AdventureWorks2012 sur cette unité de sauvegarde logique.

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 aussi

Unités de sauvegarde (SQL Server)
BACKUP (Transact-SQL)
Définir une unité de sauvegarde logique pour un fichier de disque (SQL Server)
Définir une unité de sauvegarde logique pour un lecteur de bande (SQL Server)
RESTORE (Transact-SQL)
sp_dropdevice (Transact-SQL)
sys.backup_devices (Transact-SQL)
Procédures stockées système (Transact-SQL)