sp_addumpdevice (Transact-SQL)

Articolo
12/15/2008

Aggiunge una periferica di backup a un'istanza di Microsoft Motore di database di SQL Server 2005.

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 periferica 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 periferica di backup.

tape

Qualsiasi periferica nastro supportata da Microsoft.

Valore	Descrizione
disk	File del disco rigido impostato come periferica di backup.
tape	Qualsiasi periferica nastro supportata da Microsoft.

[ @logicalname = ] 'logical_name'
Nome logico della periferica di backup utilizzata 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 della periferica 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 le periferiche 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 una periferica 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 una periferica nastro, questo parametro deve corrispondere al nome fisico assegnato alla periferica nastro locale in Windows, ad esempio \\.\TAPE0 per la prima periferica nastro aggiunta al computer. La periferica nastro deve essere collegata al computer server. Non può pertanto essere utilizzata 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 la periferica.

[ @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.

Set di risultati

Nessuno

Osservazioni

La stored procedure sp_addumpdevice aggiunge una periferica di backup alla vista del catalogo sys.backup_devices. È possibile includere riferimenti logici alla periferica nelle istruzioni BACKUP e RESTORE. sp_addumpdevice non esegue alcun accesso alla periferica fisica. L'accesso alla periferica specificata avviene solo quando viene eseguita un'istruzione BACKUP o RESTORE. La creazione di una periferica di backup logica consente di semplificare le istruzioni BACKUP e RESTORE. L'indicazione del nome di periferica costituisce infatti un'alternativa all'utilizzo della clausola "TAPE =" o "DISK =" per specificare il percorso della periferica.

Eventuali problemi correlati alla proprietà e alle autorizzazioni possono interferire con l'utilizzo di periferiche 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 periferiche nastro supportate da Windows. Per ulteriori informazioni sulle periferiche nastro supportate da Windows, vedere l'elenco di compatibilità hardware di Windows. Per visualizzare le periferiche 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.

Autorizzazioni

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

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Esempi

A. Aggiunta di una periferica di dump su disco

Nell'esempio seguente viene aggiunta la periferica 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 una periferica di backup su disco di rete

Nell'esempio seguente viene illustrata l'aggiunta di una periferica di backup su disco remoto chiamata 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 una periferica di backup su nastro

Nell'esempio seguente viene aggiunta la periferica tapedump1 con nome fisico \\.\tape0.

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

D. Backup in una periferica di backup logica

Nell'esempio seguente viene creata una periferica di backup logica, AdvWorksData, per un file del disco di backup. Nell'esempio viene quindi eseguito il backup del database AdventureWorks nella periferica di backup logica.

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

Vedere anche