Condividi tramite


sp_addumpdevice (Transact-SQL)

Si applica a: SQL Server

Aggiunge un dispositivo di backup a un'istanza di SQL Server.

Convenzioni relative alla sintassi Transact-SQL

Sintassi

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

Argomenti

[ @devtype = ] 'devtype'

Tipo di dispositivo di backup. @devtype è varchar(20), senza impostazione predefinita e può essere uno dei valori seguenti.

Valore Descrizione
disk File del disco rigido impostato come dispositivo di backup.
tape Qualsiasi dispositivo nastro supportato da Microsoft Windows.

Nota: il supporto per i dispositivi di backup su nastro verrà rimosso in una versione futura di SQL Server. Evitare di usare questa funzionalità in un nuovo progetto di sviluppo e prevedere interventi di modifica nelle applicazioni in cui è attualmente implementata.

[ @logicalname = ] N'logicalname'

Nome logico del dispositivo di backup usato nelle istruzioni BACKUP e RESTORE. @logicalname è sysname, senza impostazione predefinita e non può essere NULL.

[ @physicalname = ] N'physicalname'

Nome fisico del dispositivo di backup. @physicalname è nvarchar(260), senza impostazione predefinita e non può essere NULL. I nomi fisici devono seguire le regole per i nomi dei file del sistema operativo o le convenzioni di denominazione universali per i dispositivi di rete e devono includere un percorso completo.

Quando si crea un dispositivo di backup in un percorso di rete remoto, assicurarsi che il nome con cui è stato avviato il motore di database abbia funzionalità di scrittura appropriate nel computer remoto.

Se si aggiunge un dispositivo nastro, questo parametro deve essere il nome fisico assegnato al dispositivo nastro locale da Windows; ad esempio, \\.\TAPE0 per il primo dispositivo nastro nel computer. Il dispositivo nastro deve essere collegato al computer server; non può essere usato in remoto. I nomi contenenti caratteri non alfanumerici devono essere racchiusi tra virgolette.

Nota

Questa procedura consente di immettere nel catalogo il nome fisico specificato La procedura non tenta di accedere o creare il dispositivo.

[ @cntrltype = ] cntrltype

Obsoleta. Se specificato, questo parametro viene ignorato. Supportato per la compatibilità con le versioni precedenti. I nuovi usi di sp_addumpdevice devono omettere questo parametro.

[ @devstatus = ] 'devstatus'

Obsoleta. Se specificato, questo parametro viene ignorato. Supportato per la compatibilità con le versioni precedenti. I nuovi usi di sp_addumpdevice devono omettere questo parametro.

Valori del codice restituito

0 (esito positivo) o 1 (errore).

Set di risultati

Nessuno.

Osservazioni:

sp_addumpdevice aggiunge un dispositivo di backup alla vista del sys.backup_devices catalogo. Il dispositivo può quindi essere fatto riferimento a istruzioni e RESTORE in BACKUP modo logico. sp_addumpdevice non esegue alcun accesso al dispositivo fisico. L'accesso al dispositivo specificato si verifica solo quando viene eseguita un'istruzione BACKUP o RESTORE . La creazione di un dispositivo di backup logico può semplificare BACKUP e RESTORE istruzioni, in cui specificare il nome del dispositivo è un'alternativa usando una TAPE = clausola o DISK = per specificare il percorso del dispositivo.

Eventuali problemi correlati alla proprietà e alle autorizzazioni possono interferire con l'utilizzo di dispositivi di backup su disco o su file. Assicurarsi che le autorizzazioni di file appropriate vengano concesse all'account di Windows in cui è stato avviato il motore di database.

Il motore di database supporta i backup su nastro nei dispositivi nastro supportati da Windows. Per ulteriori informazioni sui dispositivi nastro supportati da Windows, vedere l'elenco di compatibilità hardware di Windows. Per visualizzare i dispositivi nastro disponibili nel computer, usare SQL Server Management Studio.

Usare solo i nastri consigliati per l'unità nastro specifica suggerita dal produttore dell'unità. Se si usano unità DAT (Digital Audio Tape), usare nastri DAT (Digital Data Storage)).

sp_addumpdevice non può essere eseguito all'interno di una transazione.

Per eliminare un dispositivo, usare sp_dropdevice o Eliminare un dispositivo di backup (SQL Server).

Autorizzazioni

È richiesta l'appartenenza al ruolo predefinito del server diskadmin .

Richiede l'autorizzazione di scrittura sul disco.

Esempi

R. Aggiungere un dispositivo di dump del disco

Nell'esempio seguente viene aggiunto il dispositivo di backup su disco mydiskdump con nome fisico C:\dump\dump1.bak.

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

B. Aggiungere un dispositivo di backup del disco di rete

Nell'esempio seguente viene illustrata l'aggiunta di un dispositivo di backup su disco remoto chiamato networkdevice. Il nome con cui è stato avviato il motore di database deve disporre delle autorizzazioni per tale file remoto (\\<servername>\<sharename>\<path>\<filename>.bak).

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

C. Aggiungere un dispositivo di backup su nastro

Nell'esempio seguente viene aggiunto il dispositivo tapedump1 con nome fisico \\.\tape0.

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

D. Eseguire il backup in un dispositivo di backup logico

Nell'esempio seguente viene creato in un dispositivo di backup logico, AdvWorksData, per un file del disco di backup. Nell'esempio viene quindi eseguito il backup del database AdventureWorks2022 nel dispositivo di backup logico.

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