sp_addumpdevice (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
  disk	File del disco rigido impostato come dispositivo di backup.
  tape	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 utilizzare 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, non prevede alcun valore predefinito e non può essere NULL.

• [ @physicalname = ] 'physical_name'
  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), 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 in Windows, ad esempio \\.\TAPE0 per il primo dispositivo nastro aggiunto al 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. Utilizzando sp_addumpdevice in futuro, omettere questo parametro.

• [ @devstatus = ] 'device_status'
  Obsoleto. Se specificato, questo parametro viene ignorato. È supportato solo per motivi di compatibilità con le versioni precedenti. Utilizzando sp_addumpdevice in futuro, omettere questo parametro.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Set di risultati

Nessuno

Osservazioni

La stored procedure 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).

La stored procedure sp_addumpdevice non può essere eseguita all'interno di una transazione.

Per eliminare un dispositivo, utilizzare sp_dropdevice o SQL Server Management Studio.

Autorizzazioni

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

Richiede l'autorizzazione di scrittura sul disco.

Esempi

A. Aggiunta di un dispositivo di dump su disco

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

B. Aggiunta di un dispositivo di backup su disco di rete

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

C. Aggiunta di un dispositivo di backup su nastro

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

D. Backup in un dispositivo di backup logico

USE master
GO
EXEC sp_addumpdevice 'disk', 'AdvWorksData', 
'C:\Program Files\Microsoft SQL Server\MSSQL10.MSSQLSERVER\MSSQL\BACKUP\AdvWorksData.bak';
GO
BACKUP DATABASE AdventureWorks 
 TO AdvWorksData
   WITH FORMAT;
GO

Vedere anche

Attivitá

Riferimento

Concetti