RESTORE FILELISTONLY (Transact-SQL)
Retourne un ensemble de résultats avec une liste des fichiers journaux et des fichiers de base de données contenus dans le jeu de sauvegarde.
.gif "ms173778.note(fr-fr,SQL.90).gif") Remarque : |
|---|
| Pour obtenir une description des arguments, consultez Arguments RESTORE (Transact-SQL). |
.gif "Icône Lien de rubrique")
Conventions de la syntaxe de Transact-SQL
Syntaxe
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 }
}
Arguments
Pour obtenir une description des arguments de RESTORE FILELISTONLY, consultez Arguments RESTORE (Transact-SQL).
Autorisations
Tous les utilisateurs peuvent utiliser RESTORE FILELISTONLY.
Une opération de sauvegarde peut éventuellement spécifier des mots de passe pour un support, un jeu de sauvegarde ou les deux. Lorsqu'un mot de passe a été défini sur un support ou un jeu de sauvegarde, vous devez spécifier le ou les mots de passe corrects dans l'instruction RESTORE. Ces mots de passe empêchent les restaurations et les ajouts non autorisés de jeux de sauvegarde sur un support à l'aide des outils Microsoft SQL Server 2005. Toutefois, un mot de passe n'empêche pas de remplacer le contenu d'un support à l'aide de l'option FORMAT de l'instruction BACKUP.
.gif "ms173778.security(fr-fr,SQL.90).gif") Remarque relative à la sécurité : |
|---|
| Ce mot de passe n'offre qu'une protection limitée. Son but est d'éviter que des utilisateurs autorisés ou non autorisés effectuent une restauration incorrecte à l'aide des outils SQL Server 2005. En aucun cas, il n'empêche la lecture des données de la sauvegarde par d'autres moyens ou le remplacement du mot de passe. 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). La liste de contrôle d'accès doit être définie à la racine du répertoire dans lequel les sauvegardes sont effectuées. |
Ensembles de résultats
Un client peut utiliser RESTORE FILELISTONLY pour obtenir une liste des fichiers contenus dans un jeu de sauvegarde. Les informations suivantes sont retournées sous la forme d'un ensemble de résultats contenant une ligne par fichier.
| Nom de colonne | Type de données | Description |
|---|---|---|
LogicalName |
nvarchar(128) |
Nom logique du fichier. |
PhysicalName |
nvarchar(260) |
Nom physique ou nom système du fichier. |
Type |
char(1) |
Type de fichier : L = fichier journal Microsoft SQL Server D = fichier de données SQL Server F = catalogue de texte intégral |
FileGroupName |
nvarchar(128) |
Nom du groupe de fichiers contenant le fichier. |
Size |
numeric(20,0) |
Taille actuelle en octets. |
MaxSize |
numeric(20,0) |
Taille maximale autorisée en octets. |
FileID |
bigint |
Identificateur de fichier, unique dans la base de données. |
CreateLSN |
numeric(25,0) |
Numéro de séquence d'enregistrement auquel le fichier a été créé. |
DropLSN |
numeric(25,0) NULL |
Numéro de séquence d'enregistrement auquel le fichier a été supprimé. Si le fichier n'a pas été supprimé, cette valeur est NULL. |
UniqueID |
uniqueidentifier |
Identificateur global unique (GUID) du fichier. |
ReadOnlyLSN |
numeric(25,0) NULL |
Numéro de séquence d'enregistrement auquel le groupe de fichiers contenant le fichier est passé du mode lecture-écriture au mode lecture seule (la modification la plus récente). |
ReadWriteLSN |
numeric(25,0) NULL |
Numéro de séquence d'enregistrement auquel le groupe de fichiers contenant le fichier est passé du mode lecture seule au mode lecture-écriture (la modification la plus récente). |
BackupSizeInBytes |
bigint |
Taille, en octets, de la sauvegarde de ce fichier. |
SourceBlockSize |
int |
Taille en octets des blocs du périphérique physique contenant le fichier (pas l'unité de sauvegarde). |
FileGroupID |
int |
Identificateur du groupe de fichiers. |
LogGroupGUID |
uniqueidentifier NULL |
NULL. |
DifferentialBaseLSN |
numeric(25,0) NULL |
Pour des sauvegardes différentielles, les modifications avec des numéros de séquence d'enregistrement égaux ou supérieurs à DifferentialBaseLSN sont incluses. Pour les autres types de sauvegarde, la valeur est NULL. Pour plus d'informations sur les numéros de séquence d'enregistrement, consultez la rubrique d'introduction Présentation des numéros de séquence d'enregistrement (LSN). |
DifferentialBaseGUID |
uniqueidentifier |
Pour les sauvegardes différentielles, il s'agit de l'identificateur unique de la base différentielle. Pour les autres types de sauvegarde, la valeur est NULL. |
IsReadOnly |
bit |
1 = le fichier est en lecture seule. |
IsPresent |
bit |
1 = le fichier est présent dans la sauvegarde. |
Exemples
Cet exemple retourne les informations d'une unité de sauvegarde nommée AdventureWorksBackups. L'exemple utilise l'option FILE pour spécifier le deuxième jeu de sauvegarde sur l'unité.
RESTORE FILELISTONLY FROM AdventureWorksBackups
WITH FILE=2;
GO
Voir aussi
Référence
BACKUP (Transact-SQL)
RESTORE REWINDONLY (Transact-SQL)
RESTORE VERIFYONLY (Transact-SQL)
RESTORE (Transact-SQL)
Autres ressources
Supports, familles et jeux de sauvegarde
Visualisation des informations concernant les sauvegardes
Présentation des numéros de séquence d'enregistrement (LSN)