Istruzioni RESTORE - LABELONLY (Transact-SQL)

Si applica a: SQL Server Istanza gestita di SQL di Azure

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

Nota

Per le descrizioni degli argomenti, vedere Argomenti RESTORE (Transact-SQL).

Convenzioni relative alla 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 | URL } = { 'physical_backup_device_name' |  
       @physical_backup_device_name_var }   
}  
  

Nota

URL è il formato usato per specificare il percorso e il nome file per Archiviazione BLOB di Microsoft Azure ed è supportato a partire da SQL Server 2012 (11.x) SP1 CU2. Anche se l'archiviazione di Microsoft Azure è un servizio, l'implementazione è simile a quella per dischi e nastri, in modo da consentire un'esperienza di ripristino coerente e trasparente per tutti e tre i dispositivi.

Argomenti

Per le descrizioni degli argomenti RESTORE LABELONLY, vedere Argomenti 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.

Importante

Il livello di protezione garantito da questa password è vulnerabile. 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 nelle versioni future 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. 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 (10.0.x) e versioni successive, per ottenere informazioni su un set o un dispositivo di backup è necessario disporre dell'autorizzazione CREATE DATABASE. Per altre informazioni, vedere GRANT - autorizzazioni per database (Transact-SQL).

Vedi anche

BACKUP (Transact-SQL)
Set di supporti, gruppi di supporti e set di backup (SQL Server)
RESTORE REWINDONLY (Transact-SQL)
RESTORE VERIFYONLY (Transact-SQL)
RESTORE (Transact-SQL)
Informazioni sulla cronologia e sull'intestazione del backup (SQL Server)