Instructions RESTORE - REWINDONLY (Transact-SQL)RESTORE Statements - FILELISTONLY (Transact-SQL)

S’APPLIQUE À : ouiSQL Server ouiAzure SQL Database (Managed Instance uniquement) nonAzure Synapse Analytics (SQL DW) nonParallel Data Warehouse APPLIES TO: yesSQL Server yesAzure SQL Database (Managed Instance only) noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse

Retourne un jeu de résultats avec une liste des fichiers journaux et des fichiers de base de données contenus dans le jeu de sauvegarde SQL ServerSQL Server.Returns a result set containing a list of the database and log files contained in the backup set in SQL ServerSQL Server.

Notes

Pour une description des arguments, consultez Arguments RESTORE (Transact-SQL).For the descriptions of the arguments, see RESTORE Arguments (Transact-SQL).

Icône de lien de rubrique Conventions de la syntaxe Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SyntaxeSyntax

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

Notes

Pour spécifier l’emplacement et le nom de fichier du Stockage Blob Microsoft Azure, utilisez le format de l’URL qui est pris en charge à compter de SQL Server 2012 (11.x)SQL Server 2012 (11.x) SP1 Cu2.URL is the format used to specify the location and the file name for Microsoft Azure Blob Storage and is supported starting with SQL Server 2012 (11.x)SQL Server 2012 (11.x) SP1 CU2. Bien que le stockage Microsoft Azure soit un service, son implémentation est similaire à celle d’un disque ou d’une bande afin d’offrir une expérience de restauration cohérente et fluide pour les trois appareils.Although Microsoft Azure storage is a service, the implementation is similar to disk and tape to allow for a consistent and seamless restore experience for all the three devices.

ArgumentsArguments

Pour voir la description des arguments RESTORE FILELISTONLY, consultez Arguments RESTORE (Transact-SQL).For descriptions of the RESTORE FILELISTONLY arguments, see RESTORE Arguments (Transact-SQL).

Jeux de résultatsResult Sets

Un client peut utiliser RESTORE FILELISTONLY pour obtenir une liste des fichiers contenus dans un jeu de sauvegarde.A client can use RESTORE FILELISTONLY to obtain a list of the files contained in a backup set. Ces informations sont retournées sous forme d'un jeu de résultats contenant une ligne par fichier.This information is returned as a result set containing one row for each file.

Nom de colonneColumn name Type de donnéesData type DescriptionDescription
LogicalNameLogicalName nvarchar(128)nvarchar(128) Nom logique du fichier.Logical name of the file.
PhysicalNamePhysicalName nvarchar(260)nvarchar(260) Nom physique ou nom système du fichier.Physical or operating-system name of the file.
TypeType char(1)char(1) Type de fichier (l’un des suivants) :The type of file, one of:

L = Fichier journal Microsoft SQL ServerSQL ServerL = Microsoft SQL ServerSQL Server log file

D = Fichier de données SQL ServerSQL ServerD = SQL ServerSQL Server data file

F = Catalogue de texte intégralF = Full Text Catalog

S = FileStream, FileTable ou conteneur OLTP en mémoireIn-Memory OLTPS = FileStream, FileTable, or OLTP en mémoireIn-Memory OLTP container
FileGroupNameFileGroupName nvarchar(128) NULLnvarchar(128) NULL Nom du groupe de fichiers contenant le fichier.Name of the filegroup that contains the file.
TailleSize numeric(20,0)numeric(20,0) Taille actuelle en octets.Current size in bytes.
MaxSizeMaxSize numeric(20,0)numeric(20,0) Taille maximale autorisée en octets.Maximum allowed size in bytes.
FileIDFileID bigintbigint Identificateur de fichier, unique dans la base de données.File identifier, unique within the database.
CreateLSNCreateLSN numeric(25,0)numeric(25,0) Numéro séquentiel dans le journal auquel le fichier a été créé.Log sequence number at which the file was created.
DropLSNDropLSN numeric(25,0) NULLnumeric(25,0) NULL Numéro séquentiel dans le journal auquel le fichier a été supprimé.The log sequence number at which the file was dropped. Si le fichier n'a pas été supprimé, cette valeur est NULL.If the file has not been dropped, this value is NULL.
UniqueIDUniqueID uniqueidentifieruniqueidentifier Identificateur global unique (GUID) du fichier.Globally unique identifier of the file.
ReadOnlyLSNReadOnlyLSN numeric(25,0) NULLnumeric(25,0) NULL Numéro séquentiel dans le journal auquel le groupe de fichiers contenant le fichier est passé de lecture-écriture à lecture seule (modification la plus récente).Log sequence number at which the filegroup containing the file changed from read-write to read-only (the most recent change).
ReadWriteLSNReadWriteLSN numeric(25,0) NULLnumeric(25,0) NULL Numéro séquentiel dans le journal auquel le groupe de fichiers contenant le fichier est passé de lecture seule à lecture-écriture (modification la plus récente).Log sequence number at which the filegroup containing the file changed from read-only to read-write (the most recent change).
BackupSizeInBytesBackupSizeInBytes bigintbigint Taille de la sauvegarde en octets pour ce fichier.Size of the backup for this file in bytes.
SourceBlockSizeSourceBlockSize Intint Taille en octets des blocs du périphérique physique contenant le fichier (pas l'unité de sauvegarde).Block size of the physical device containing the file in bytes (not the backup device).
FileGroupIDFileGroupID Intint Identificateur du groupe de fichiers.ID of the filegroup.
LogGroupGUIDLogGroupGUID uniqueidentifier NULLuniqueidentifier NULL NULL.NULL.
DifferentialBaseLSNDifferentialBaseLSN numeric(25,0) NULLnumeric(25,0) NULL Pour des sauvegardes différentielles, les modifications avec des numéros séquentiels dans le journal supérieurs ou égaux à DifferentialBaseLSN sont incluses.For differential backups, changes with log sequence numbers greater than or equal to DifferentialBaseLSN are included in the differential.

Pour les autres types de sauvegarde, la valeur est NULL.For other backup types, the value is NULL.
DifferentialBaseGUIDDifferentialBaseGUID uniqueidentifier NULLuniqueidentifier NULL Pour les sauvegardes différentielles, il s'agit de l'identificateur unique de la base différentielle.For differential backups, the unique identifier of the differential base.

Pour les autres types de sauvegarde, la valeur est NULL.For other backup types, the value is NULL.
IsReadOnlyIsReadOnly bitbit 1 = Le fichier est en lecture seule.1 = The file is read-only.
IsPresentIsPresent bitbit 1 = Le fichier est présent dans la sauvegarde.1 = The file is present in the backup.
TDEThumbprintTDEThumbprint varbinary(32) NULLvarbinary(32) NULL Affiche l'empreinte numérique de la clé de chiffrement de la base de données.Shows the thumbprint of the Database Encryption Key. L'empreinte numérique de chiffrement est un hachage SHA-1 du certificat avec lequel la clé est chiffrée.The encryptor thumbprint is a SHA-1 hash of the certificate with which the key is encrypted. Pour plus d’informations sur le chiffrement des bases de données, consultez Transparent Data Encryption (TDE).For information about database encryption, see Transparent Data Encryption (TDE).
SnapshotURLSnapshotURL nvarchar(360) NULLnvarchar(360) NULL URL de l’instantané Azure du fichier de base de données contenu dans la sauvegarde FILE_SNAPSHOT.The URL for the Azure snapshot of the database file contained in the FILE_SNAPSHOT backup. Retourne NULL en cas d’absence de sauvegarde FILE_SNAPSHOT.Returns NULL if no FILE_SNAPSHOT backup.

SécuritéSecurity

Une opération de sauvegarde peut éventuellement spécifier des mots de passe pour un support de sauvegarde, un jeu de sauvegarde ou les deux.A backup operation may optionally specify passwords for a media set, a backup set, or both. Lorsqu'un mot de passe a été défini sur un support de sauvegarde ou un jeu de sauvegarde, vous devez entrer le ou les mots de passe corrects dans l'instruction RESTORE.When a password has been defined on a media set or backup set, you must specify the correct password or passwords in the RESTORE statement. Ces mots de passe empêchent les opérations de restauration non autorisées, ainsi que les ajouts non autorisés de jeux de sauvegarde sur les supports à l’aide des outils MicrosoftMicrosoft SQL ServerSQL Server.These passwords prevent unauthorized restore operations and unauthorized appends of backup sets to media using MicrosoftMicrosoft SQL ServerSQL Server tools. En revanche, un mot de passe n'empêche pas d'écraser les supports en cas d'utilisation de l'option FORMAT de l'instruction BACKUP.However, a password does not prevent overwrite of media using the BACKUP statement's FORMAT option.

Important

Le niveau de protection de ce mot de passe est faible.The protection provided by this password is weak. Son but est d'éviter que des utilisateurs autorisés ou non autorisés effectuent une restauration incorrecte à l'aide des outils SQL ServerSQL Server.It is intended to prevent an incorrect restore using SQL ServerSQL Server tools by authorized or unauthorized users. En aucun cas, elle n'empêche la lecture des données de la sauvegarde par d'autres moyens ou le remplacement du mot de passe.It does not prevent the reading of the backup data by other means or the replacement of the password. Cette fonctionnalité est en mode de maintenance et risque d’être supprimée dans une prochaine version de Microsoft SQL Server.This feature is in maintenance mode and may be removed in a future version of Microsoft SQL Server. Évitez d'utiliser cette fonctionnalité dans de nouveaux travaux de développement, et prévoyez de modifier les applications qui utilisent actuellement cette fonctionnalité.Avoid using this feature in new development work, and plan to modify applications that currently use this feature. La méthode conseillé en matière de protection des sauvegardes consiste à stocker les bandes de sauvegarde dans un emplacement sûr ou à sauvegarder les fichiers disque protégés par une liste de contrôle d'accès (ACL).The best practice for protecting backups is to store backup tapes in a secure location or back up to disk files that are protected by adequate access control lists (ACLs). La liste de contrôle d'accès doit être définie à la racine du répertoire dans lequel les sauvegardes sont effectuées.The ACLs should be set on the directory root under which backups are created.

AutorisationsPermissions

Dans SQL Server 2008SQL Server 2008, vous devez avoir l'autorisation CREATE DATABASE pour pouvoir obtenir des informations sur un jeu de sauvegardes ou sur une unité de sauvegarde.Beginning in SQL Server 2008SQL Server 2008, obtaining information about a backup set or backup device requires CREATE DATABASE permission. Pour plus d’informations, consultez GRANT – octroi d’autorisations de base de données (Transact-SQL).For more information, see GRANT Database Permissions (Transact-SQL).

ExemplesExamples

L'exemple suivant retourne les informations d'une unité de sauvegarde nommée AdventureWorksBackups.The following example returns the information from a backup device named AdventureWorksBackups. L'exemple utilise l'option FILE pour spécifier le deuxième jeu de sauvegarde sur l'unité.The example uses the FILE option to specify the second backup set on the device.

RESTORE FILELISTONLY FROM AdventureWorksBackups   
   WITH FILE=2;  
GO  

Voir aussiSee Also

BACKUP (Transact-SQL) BACKUP (Transact-SQL)
Jeux de supports, familles de supports et jeux de sauvegarde (SQL Server) Media Sets, Media Families, and Backup Sets (SQL Server)
RESTORE REWINDONLY (Transact-SQL) RESTORE REWINDONLY (Transact-SQL)
RESTORE VERIFYONLY (Transact-SQL) RESTORE VERIFYONLY (Transact-SQL)
RESTORE (Transact-SQL) RESTORE (Transact-SQL)
Historique de sauvegarde et informations d’en-tête (SQL Server)Backup History and Header Information (SQL Server)