sp_addumpdevice (Transact-SQL)

S'applique à : SQL Server

Ajoute un appareil de sauvegarde à une instance de SQL Server.

Conventions de la syntaxe Transact-SQL

Syntaxe

sp_addumpdevice
    [ @devtype = ] 'devtype'
    , [ @logicalname = ] N'logicalname'
    , [ @physicalname = ] N'physicalname'
    [ , [ @cntrltype = ] cntrltype ]
    [ , [ @devstatus = ] 'devstatus' ]
[ ; ]

Arguments

[ @devtype = ] 'devtype'

Type d’appareil de sauvegarde. @devtype est varchar(20), sans valeur par défaut et peut être l’une des valeurs suivantes.

Valeur Description
disk Fichier de disque dur comme unité de sauvegarde.
tape Tous les appareils sur bande pris en charge par Microsoft Windows.

Remarque : la prise en charge des périphériques de sauvegarde sur bande sera supprimée dans une version ultérieure 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 = ] N’logicalname'

Nom logique de l’appareil de sauvegarde utilisé dans les instructions BACKUP et RESTORE. @logicalname est sysname, sans valeur par défaut et ne peut pas être NULL.

[ @physicalname = ] N’physicalname'

Nom physique de l’appareil de sauvegarde. @physicalname est nvarchar(260), sans valeur par défaut et ne peut pas être NULL. Les noms physiques doivent respecter les règles relatives aux noms de fichiers du système d’exploitation ou aux conventions d’affectation de noms universelles pour les appareils réseau, et doivent inclure un chemin complet.

Lors de la création d’un périphérique de sauvegarde sur un emplacement réseau distant, assurez-vous que le nom sous lequel l’Moteur de base de données a été démarré a des fonctionnalités d’écriture appropriées sur l’ordinateur distant.

Si vous ajoutez un périphérique de bande, ce paramètre doit être le nom physique attribué à l’appareil de bande local par Windows ; par exemple, \\.\TAPE0 pour le premier appareil sur bande sur l’ordinateur. L’appareil de bande doit être attaché à l’ordinateur serveur ; elle ne peut pas être utilisée à 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, La procédure ne tente pas d’accéder ou de créer l’appareil.

[ @cntrltype = ] cntrltype

Obsolète. S'il est spécifié, ce paramètre est ignoré. Prise en charge pour la compatibilité descendante. De nouvelles utilisations doivent sp_addumpdevice omettre ce paramètre.

[ @devstatus = ] 'devstatus'

Obsolète. S'il est spécifié, ce paramètre est ignoré. Prise en charge pour la compatibilité descendante. De nouvelles utilisations doivent sp_addumpdevice omettre ce paramètre.

Valeurs des codes de retour

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

Jeu de résultats

Aucune.

Notes

sp_addumpdevice ajoute un appareil de sauvegarde à l’affichage sys.backup_devices catalogue. L’appareil peut ensuite être référencé logiquement dans et RESTORE des BACKUP instructions. sp_addumpdevice n’effectue aucun accès à l’appareil physique. L’accès à l’appareil spécifié se produit uniquement lorsqu’une instruction ou RESTORE une BACKUP instruction est effectuée. La création d’un périphérique de sauvegarde logique peut simplifier BACKUP et RESTORE indiquer des instructions, où la spécification du nom de l’appareil est une alternative à l’aide d’une ou DISK = d’une TAPE = clause pour spécifier le chemin d’accès de l’appareil.

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. Vérifiez que les autorisations de fichier appropriées sont accordées au compte Windows sous lequel la Moteur de base de données a été démarrée.

Le Moteur de base de données prend en charge les sauvegardes sur bande sur des périphériques à bande 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 de bande disponibles sur l’ordinateur, utilisez SQL Server Management Studio.

Utilisez uniquement les bandes recommandées pour le lecteur de bande spécifique suggéré par le fabricant du lecteur. Si vous utilisez des lecteurs de bande audio numérique (DAT), utilisez des bandes DAT de niveau ordinateur (DDS)).

sp_addumpdevice ne peut pas être exécuté à l’intérieur d’une transaction.

Pour supprimer un appareil, utilisez sp_dropdevice ou supprimez un appareil de sauvegarde (SQL Server).

autorisations

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

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

Exemples

R. Ajouter un appareil de vidage de 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. Ajouter un périphérique de sauvegarde de disque réseau

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

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

C. Ajouter un périphérique 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. Sauvegarder sur un appareil 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 AdventureWorks2022 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 AdventureWorks2022
 TO AdvWorksData WITH FORMAT;
GO