RESTORE LABELONLY (Transact-SQL)

Renvoie un jeu de résultats contenant des informations sur le support de sauvegarde identifié par l'unité de sauvegarde spécifiée.

Remarque :
Pour obtenir une description des arguments, consultez Arguments RESTORE (Transact-SQL).

Conventions de la syntaxe de Transact-SQL

Syntaxe

RESTORE LABELONLY 
FROM <backup_device> 
[ WITH 
   [ { CHECKSUM | NO_CHECKSUM } ]
   [ [ , ] { CONTINUE_AFTER_ERROR | STOP_ON_ERROR } ]
   [ [ , ] MEDIANAME = { media_name | @media_name_variable } ] 
   [ [ , ] MEDIAPASSWORD = { mediapassword |
                    @mediapassword_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 RESTORE LABELONLY, consultez Arguments RESTORE (Transact-SQL).

Jeux de résultats

Le jeu de résultats renvoyé par RESTORE LABELONLY comporte une seule ligne avec les informations suivantes :

Nom de colonne

Type de données

Description

MediaName

nvarchar(128)

Nom du support de sauvegarde.

MediaSetId

uniqueidentifier

Numéro d'identification unique du jeu de supports.

FamilyCount

int

Nombre de familles de supports contenues dans le jeu de supports de sauvegardes

FamilySequenceNumber

int

Numéro de séquence de la famille.

MediaFamilyId

uniqueidentifier

Numéro d'identification unique de la famille de supports de sauvegardes.

MediaSequenceNumber

int

Numéro de séquence de ce support dans la famille.

MediaLabelPresent

tinyint

Indique si la description du support contient :

1 = Étiquette du support au format de bande Microsoft

0 = Description du support

MediaDescription

nvarchar(255)

Description du support, au format libre, ou étiqueté au format de bande.

SoftwareName

nvarchar(128)

Nom du logiciel de sauvegarde qui a permis l'écriture de l'étiquette du support de sauvegarde.

SoftwareVendorId

int

Numéro d'identification du fournisseur du logiciel qui a permis l'écriture de la sauvegarde.

MediaDate

datetime

Date et heure de création de l'étiquette.

Mirror_Count

int

Nombre de miroirs dans le jeu (1-4).

Remarque :

Les étiquettes créées pour différents miroirs d'un jeu sont identiques.

Remarque :
Si des mots de passe sont définis pour le support de sauvegarde, RESTORE LABELONLY ne retourne des informations que si le mot de passe de support adéquat est spécifié dans l'option MEDIAPASSWORD de la commande.

Notes

L'exécution de RESTORE LABELONLY permet de déterminer rapidement le contenu du support de sauvegarde. Parce qu'elle lit uniquement l'en-tête du support, cette instruction s'exécute vite, même pour des unités de bande de grande capacité.

Autorisations

Tout utilisateur peut utiliser RESTORE LABELONLY.

Une opération de sauvegarde peut éventuellement spécifier les mots de passe d'un support de sauvegarde. Si un mot de passe est défini dans un support de sauvegarde, vous devez spécifier le mot de passe approprié dans l'instruction RESTORE. Le mot de passe empêche les opérations non autorisées de restauration et d'ajouts de jeux de sauvegardes au support par le biais des outils Microsoft SQL Server 2005, mais pas l'écrasement du support avec l'option FORMAT de l'instruction BACKUP.

Remarque relative à la sécurité :

Le niveau de protection de ce mot de passe est faible. 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.

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)

Aide et Informations

Assistance sur SQL Server 2005