sp_addumpdevice (Transact-SQL)

Article
08/20/2013

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 périphérique de sauvegarde. L'argument device_type est de type varchar(20) sans valeur par défaut et peut correspondre à l'une des valeurs ci-dessous.

Valeur	Description
disk	Fichier de disque dur comme unité de sauvegarde.
tape	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 ; sa valeur ne peut pas être 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 ; sa valeur 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é par Windows au périphérique à bandes local, par exemple \\.\TAPE0 pour le premier périphérique à bandes de 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.

[!REMARQUE]

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'
Obsolète. S'il est spécifié, ce paramètre est ignoré. Il est conservé uniquement pour des raisons de compatibilité descendante. Les nouveaux utilisateurs de sp_addumpdevice doivent donc omettre ce paramètre.
[ @devstatus = ] 'device_status'
Obsolète. S'il est spécifié, ce paramètre est ignoré. Il est conservé uniquement pour des raisons de compatibilité descendante. Les nouveaux utilisateurs de sp_addumpdevice doivent donc omettre ce paramètre.

Valeurs des codes de retour

0 (succès) ou 1 (échec)

Jeux de résultats

Aucun

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 aucune tentative d'accès à l'unité 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).

La procédure stockée sp_addumpdevice ne peut pas être exécutée dans une transaction.

Pour supprimer un périphérique, utilisez sp_dropdevice ou SQL Server Management Studio.

Autorisations

Nécessite l'appartenance en tant que membre au rôle de serveur fixe diskadmin.

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

Exemples

A.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 disposer des autorisations d'accès adéquates 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\MSSQL11.MSSQLSERVER\MSSQL\BACKUP\AdvWorksData.bak';
GO
BACKUP DATABASE AdventureWorks2012 
 TO AdvWorksData
   WITH FORMAT;
GO