sp_addumpdevice (Transact-SQL)

Si applica a: sìSQL Server (tutte le versioni supportate)

Si applica a: SQL Server (da SQL Server 2008 alla versione corrente).

Viene aggiunto un dispositivo di backup a un'istanza di SQL Server.

Icona di collegamento a un argomento Convenzioni della sintassi Transact-SQL

Sintassi

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

Argomenti

[ @devtype = ] 'device_type' Tipo di dispositivo di backup. device_type è di tipo varchar (20) e non prevede alcun valore predefinito. i possibili valori sono i seguenti.

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

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 = ] 'logical_name' Nome logico del dispositivo di backup utilizzato nelle istruzioni BACKUP e RESTOre. logical_name è di tipo sysname e non prevede alcun valore predefinito e non può essere null.

[ @physicalname = ] 'physical_name' È il nome fisico del dispositivo di backup. I nomi fisici devono essere conformi alle regole per i nomi di file del sistema operativo o alle convenzioni di denominazione universali per i dispositivi di rete e devono includere un percorso completo. physical_name è di tipo nvarchar (260) e non prevede alcun valore predefinito e non può essere null.

Quando si crea un dispositivo di backup in un percorso di rete remoto, assicurarsi che all'account specificato per l'avvio di Motore di database siano associate le autorizzazioni di scrittura necessarie nel computer remoto.

Se si aggiunge un dispositivo nastro, questo parametro deve corrispondere al 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ò pertanto essere utilizzato 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 ma non di accedere o creare il dispositivo.

[ @cntrltype = ] 'controller_type' Obsoleto. Se specificato, questo parametro viene ignorato. È supportato solo per motivi di compatibilità con le versioni precedenti. I nuovi utilizzi di sp_addumpdevice devono omettere questo parametro.

[ @devstatus = ] 'device_status' Obsoleto. Se specificato, questo parametro viene ignorato. È supportato solo per motivi di compatibilità con le versioni precedenti. I nuovi utilizzi di sp_addumpdevice devono omettere questo parametro.

Valori del codice restituito

0 (operazione completata) o 1 (operazione non riuscita)

Set di risultati

nessuno

Osservazioni

sp_addumpdevice aggiunge un dispositivo di backup alla vista del catalogo sys.backup_devices . È possibile includere riferimenti logici al dispositivo nelle istruzioni BACKUP e RESTORE. sp_addumpdevice non esegue alcun accesso al dispositivo fisico. L'accesso al dispositivo specificato avviene solo quando viene eseguita un'istruzione BACKUP o RESTORE. La creazione di un dispositivo di backup logico consente di semplificare le istruzioni BACKUP e RESTORE. L'indicazione del nome di dispositivo costituisce infatti un'alternativa all'utilizzo della clausola "TAPE =" 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 all'account di Windows utilizzato per l'avvio di Motore di database siano associate le autorizzazioni per i file appropriate.

Motore di database supporta i backup su 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, utilizzare SQL Server Management Studio.

Utilizzare solo i tipi di nastro consigliati dal produttore per l'unità nastro in uso. Se si utilizzano unità DAT (Digital Audio Tape), utilizzare nastri DAT per computer (Digital Data Storage, DDS).

Impossibile eseguire sp_addumpdevice all'interno di una transazione.

Per eliminare un dispositivo, usare sp_dropdevice oSQL Server Management Studio.

Autorizzazioni

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

Richiede l'autorizzazione di scrittura sul disco.

Esempi

R. Aggiunta di un dispositivo di dump su 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. Aggiunta di un dispositivo di backup su disco di rete

Nell'esempio seguente viene illustrata l'aggiunta di un dispositivo di backup su disco remoto chiamato networkdevice. All'account utilizzato per l'avvio di Motore di database devono essere associate le autorizzazioni per tale file remoto (\\<servername>\<sharename>\<path>\<filename>.bak).

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

C. Aggiunta di 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. 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 AdventureWorks2012 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 AdventureWorks2012   
 TO AdvWorksData  
   WITH FORMAT;  
GO  

Vedere anche

Dispositivi di backup (SQL Server)
BACKUP (Transact-SQL)
Definire un dispositivo di backup logico per un file su disco (SQL Server)
Definizione di un dispositivo di backup logico per un'unità nastro (SQL Server)
RESTORE (Transact-SQL)
sp_dropdevice (Transact-SQL)
sys.backup_devices (Transact-SQL)
Stored procedure di sistema (Transact-SQL)