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).
.gif "Icona di collegamento a un argomento")
Sintassi
RESTORE FILELISTONLY
FROM <backup_device>
[ WITH
{
--Backup Set Options
FILE = { backup_set_file_number | @backup_set_file_number }
| PASSWORD = { password | @password_variable }
--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 di RESTORE FILELISTONLY, vedere Argomenti dell'istruzione RESTORE (Transact-SQL).
Set di risultati
Un client può utilizzare RESTORE FILELISTONLY per ottenere l'elenco dei file contenuti in un set di backup. Queste informazioni vengono restituite come set di risultati contenente 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 |
Identificatore del file, univoco all'interno del database. |
CreateLSN |
numeric(25,0) |
Numero di sequenza del file di log in corrispondenza del quale è stato creato il file. |
DropLSN |
numeric(25,0) NULL |
Numero di sequenza del file di log in corrispondenza del quale è stato eliminato il file. 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 (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 (modifica più recente). |
BackupSizeInBytes |
bigint |
Dimensioni in byte del backup di questo file. |
SourceBlockSize |
int |
Dimensione in byte del blocco del dispositivo fisico contenente il file, non del dispositivo 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. |
TDEThumbprint |
varbinary(32) |
Indica l'identificazione digitale della chiave di crittografia del database. L'identificazione digitale del componente di crittografia è un hash SHA-1 del certificato con cui viene crittografata la chiave. Per informazioni sulla crittografia del database, vedere Informazioni sulla crittografia trasparente dei dati (TDE, Transparent Data Encryption). |
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).
Per un'operazione di backup è eventualmente possibile specificare 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, è necessario specificare la password o le password corrette nell'istruzione RESTORE. Tali password impediscono operazioni di ripristino non autorizzate e l'aggiunta non autorizzata di set di backup ai supporti tramite gli strumenti di MicrosoftSQL Server. Una password, tuttavia, non impedisce la sovrascrittura dei supporti tramite l'opzione FORMAT dell'istruzione BACKUP.
.gif "Nota sulla protezione") Nota sulla protezione |
|---|
Il livello di protezione garantito da questa password è ridotto. Lo scopo consiste nell'impedire un ripristino non corretto da parte di utenti autorizzati o non autorizzati mediante gli strumenti di SQL Server. Non viene impedita la lettura dei dati di backup eseguita con altri mezzi, né la sostituzione della password. Questa caratteristica 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. |
Esempi
Nell'esempio seguente vengono restituite le informazioni contenute in un dispositivo di backup denominato AdventureWorksBackups. Nell'esempio viene utilizzata l'opzione FILE per specificare il secondo set di backup nel dispositivo.
RESTORE FILELISTONLY FROM AdventureWorksBackups
WITH FILE=2;
GO
Cronologia modifiche
Aggiornamento del contenuto |
|---|
Aggiunta della colonna TDEThumbprint alla tabella "Set di risultati". |