RESTORE FILELISTONLY (Transact-SQL)

Restituisce un set di risultati che include l'elenco dei file di database e log contenuti nel set di backup.

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

Convenzioni della sintassi Transact-SQL

Sintassi

RESTORE FILELISTONLY 
FROM <backup_device> 
[ WITH 
   [ { CHECKSUM | NO_CHECKSUM } ]
   [ [ , ] { CONTINUE_AFTER_ERROR | STOP_ON_ERROR } ]
   [ [ , ] FILE = backup_set_file_number ] 
   [ [ , ] MEDIANAME = { media_name | @media_name_variable } ] 
   [ [ , ] MEDIAPASSWORD = { mediapassword |
                    @mediapassword_variable } ] 
   [ [ , ] PASSWORD = { password | @password_variable } ] 
   [ [ , ] REWIND ] 
   [ [ , ] { UNLOAD | NOUNLOAD } ]  
]
[;]

<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 di RESTORE FILELISTONLY, vedere Argomenti dell'istruzione RESTORE (Transact-SQL).

Set di risultati

In un client è possibile utilizzare RESTORE FILELISTONLY per ottenere l'elenco dei file di un set di backup. Queste informazioni vengono restituite come set di risultati con una riga per ogni file.

Nome colonna	Tipo di dati	Descrizione
LogicalName	nvarchar(128)	Nome logico del file.
PhysicalName	nvarchar(260)	Nome fisico o del sistema operativo del file.
Type	char(1)	Tipo di file. I tipi possibili sono: L = file di log di Microsoft SQL Server D = file di dati di SQL Server F = catalogo full-text
FileGroupName	nvarchar(128)	Nome del filegroup che contiene il file.
Size	numeric(20,0)	Dimensioni correnti in byte.
MaxSize	numeric(20,0)	Dimensioni massime consentite in byte.
FileID	bigint	ID del file, univoco all'interno del database.
CreateLSN	numeric(25,0)	Numero di sequenza del file di log in corrispondenza del quale il file è stato creato.
DropLSN	numeric(25,0) NULL	Numero di sequenza del file di log in corrispondenza del quale il file è stato eliminato. Se il file non è stato eliminato, questo valore è NULL.
UniqueID	uniqueidentifier	Identificatore univoco globale (GUI) del file.
ReadOnlyLSN	numeric(25,0) NULL	Numero di sequenza del file di log in corrispondenza del quale la modalità del filegroup contenente il file è passata da lettura/scrittura a sola lettura (la modifica più recente).
ReadWriteLSN	numeric(25,0) NULL	Numero di sequenza del file di log in corrispondenza del quale la modalità del filegroup contenente il file è passata da sola lettura a lettura/scrittura (la modifica più recente).
BackupSizeInBytes	bigint	Dimensioni in byte del backup di questo file.
SourceBlockSize	int	Dimensione in byte del blocco della periferica fisica contenente il file (non la periferica di backup).
FileGroupID	int	ID del filegroup.
LogGroupGUID	uniqueidentifier NULL	NULL.
DifferentialBaseLSN	numeric(25,0) NULL	Per i backup differenziali, le modifiche con numeri di sequenza del file di log maggiori o uguali a DifferentialBaseLSN saranno inclusi nel backup differenziale. Per gli altri tipi di backup il valore è NULL. Per ulteriori informazioni sui numeri di sequenza del file di log (LSN), vedere la sezione introduttiva in Introduzione ai numeri di sequenza del file di log.
DifferentialBaseGUID	uniqueidentifier	Per i backup differenziali, identificatore univoco della base differenziale. Per gli altri tipi di backup il valore è NULL.
IsReadOnly	bit	1 = il campo è di sola lettura.
IsPresent	bit	1 = il file è incluso nel backup.

Autorizzazioni

L'istruzione RESTORE FILELISTONLY può essere eseguita da qualsiasi utente.

Per un'operazione di backup è possibile specificare facoltativamente una password per un set di supporti o un set di backup oppure per entrambi. Se è stata impostata una password per un set di supporti o un set di backup, la password o le password corrette devono essere specificate nell'istruzione RESTORE. Queste password impediscono operazioni non autorizzate di ripristino e aggiunta di set di backup nei supporti eseguite tramite gli strumenti di Microsoft SQL Server 2005. 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 2005. Non impedisce la lettura dei dati di backup eseguita con altri mezzi o la sostituzione della password. 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 appropriati. Gli elenchi di controllo di accesso devono essere impostati a livello della directory principale in cui vengono creati i backup.

Esempi

Nell'esempio seguente vengono restituite le informazioni contenute in una periferica di backup denominata AdventureWorksBackups. L'opzione FILE è utilizzata per specificare il secondo set di backup nella periferica.

RESTORE FILELISTONLY FROM AdventureWorksBackups 
   WITH FILE=2;
GO

Vedere anche

Riferimento

BACKUP (Transact-SQL)
RESTORE REWINDONLY (Transact-SQL)
RESTORE VERIFYONLY (Transact-SQL)
RESTORE (Transact-SQL)

Altre risorse

Set di supporti, gruppi di supporti e set di backup
Visualizzazione di informazioni sui backup
Introduzione ai numeri di sequenza del file di log

Guida in linea e informazioni

Assistenza su SQL Server 2005