RESTORE LABELONLY (Transact-SQL)

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).

Icona di collegamento a un argomentoConvenzioni 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).

NotaNota
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

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

Autorizzazioni

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

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 sicurezzaNota sulla sicurezza

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 caratteristica verrà rimossa a partire da una delle prossime versioni di Microsoft SQL Server. Evitare di utilizzare questa caratteristica 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 protetto 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.