RESTORE LABELONLY (Transact-SQL)

Articolo
03/07/2014

Restituisce un set di risultati che include informazioni sul supporto di backup identificato dal dispositivo di backup specificato.

Nota

Per una descrizione degli argomenti, vedere Argomenti dell'istruzione RESTORE (Transact-SQL).

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

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

Sintassi

RESTORE LABELONLY 
FROM <backup_device> 
[ WITH 
 {
--Media Set Options
   MEDIANAME = { media_name | @media_name_variable } 
 | MEDIAPASSWORD = { mediapassword | @mediapassword_variable }
  
--Error Management Options
 | { CHECKSUM | NO_CHECKSUM } 
 | { STOP_ON_ERROR | CONTINUE_AFTER_ERROR }

--Tape Options
 | { REWIND | NOREWIND } 
 | { UNLOAD | NOUNLOAD }  
 } [ ,...n ]
]
[;]

<backup_device> ::=
{ 
   { logical_backup_device_name |
      @logical_backup_device_name_var }
   | { DISK | TAPE } = { 'physical_backup_device_name' |
       @physical_backup_device_name_var } 
}

Argomenti

Per una descrizione degli argomenti RESTORE LABELONLY, vedere Argomenti dell'istruzione RESTORE (Transact-SQL).

Set di risultati

Il set di risultati dall'istruzione RESTORE LABELONLY consiste in una riga singola che include le informazioni seguenti.

Nome colonna	Tipo di dati	Descrizione
MediaName	nvarchar(128)	Nome del supporto.
MediaSetId	uniqueidentifier	Numero di identificazione univoco del set di supporti.
FamilyCount	int	Numero di gruppi di supporti nel set di supporti.
FamilySequenceNumber	int	Numero di sequenza del gruppo.
MediaFamilyId	uniqueidentifier	Numero di identificazione univoco del gruppo di supporti.
MediaSequenceNumber	int	Numero di sequenza del supporto nel gruppo di supporti.
MediaLabelPresent	tinyint	Specifica se la descrizione del supporto include: 1 = etichetta di supporto Microsoft Tape Format 0 = descrizione dei supporti
MediaDescription	nvarchar(255)	Descrizione del supporto come testo in formato libero o etichetta del supporto Microsoft Tape Format
SoftwareName	nvarchar(128)	Nome del software di backup con cui è stata scritta l'etichetta.
SoftwareVendorId	int	Numero di identificazione univoco del produttore del software che ha scritto il backup.
MediaDate	datetime	Data e ora in cui è stata scritta l'etichetta.
Mirror_Count	int	Numero di mirror nel set (1-4). Nota Le etichette scritte per mirror diversi in un set sono identiche
IsCompressed	bit	Specifica se il backup è compresso: 0 = non compresso 1 = compresso

Nota

Se per il set di supporti sono state definite password, l'istruzione RESTORE LABELONLY restituisce informazioni solo se nell'opzione MEDIAPASSWORD del comando si specifica la password di supporto corretta.

Osservazioni generali

L'esecuzione di RESTORE LABELONLY consente di individuare rapidamente il contenuto del supporto di backup. Poiché viene letta solo l'intestazione supporto, l'esecuzione dell'istruzione risulta veloce anche con dispositivi nastro ad alta capacità.

Sicurezza

Per un'operazione di backup è possibile specificare facoltativamente una password per un set di supporti. Se è stata impostata una password per un set di supporti, la password corretta deve essere specificata nell'istruzione RESTORE. La password impedisce operazioni di ripristino non autorizzate e l'aggiunta non autorizzata di set di backup ai supporti tramite gli strumenti di Microsoft SQL Server. Tuttavia, la password non impedisce la sovrascrittura dei supporti tramite l'opzione FORMAT dell'istruzione BACKUP.

Nota sulla protezione
Il livello di protezione garantito da questa password è ridotto.Lo scopo è impedire un ripristino non corretto da parte di utenti autorizzati o non autorizzati mediante gli strumenti di SQL Server.Non impedisce la lettura dei dati di backup eseguita con altri mezzi o la sostituzione della password.Questa funzionalità verrà rimossa a partire da una delle prossime versioni di Microsoft SQL Server. Evitare di utilizzare questa funzionalità in un nuovo progetto di sviluppo e prevedere interventi di modifica nelle applicazioni in cui è attualmente implementata. Per ottenere un livello di protezione adeguato dei backup è consigliabile archiviare i nastri di backup in un luogo sicuro oppure eseguire il backup su file su disco protetti da elenchi di controllo di accesso (ACL) appropriati.Gli elenchi di controllo di accesso devono essere impostati a livello della directory radice in cui vengono creati i backup.

Il livello di protezione garantito da questa password è ridotto.Lo scopo è impedire un ripristino non corretto da parte di utenti autorizzati o non autorizzati mediante gli strumenti di SQL Server.Non impedisce la lettura dei dati di backup eseguita con altri mezzi o la sostituzione della password.Questa funzionalità verrà rimossa a partire da una delle prossime versioni di Microsoft SQL Server. Evitare di utilizzare questa funzionalità in un nuovo progetto di sviluppo e prevedere interventi di modifica nelle applicazioni in cui è attualmente implementata. Per ottenere un livello di protezione adeguato dei backup è consigliabile archiviare i nastri di backup in un luogo sicuro oppure eseguire il backup su file su disco protetti da elenchi di controllo di accesso (ACL) appropriati.Gli elenchi di controllo di accesso devono essere impostati a livello della directory radice in cui vengono creati i backup.

Autorizzazioni

In SQL Server 2008 e versioni successive, per ottenere informazioni su un set o un dispositivo di backup è necessario disporre dell'autorizzazione CREATE DATABASE. Per ulteriori informazioni, vedere GRANT - autorizzazioni per database (Transact-SQL).