Article
09/27/2010

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).

Icône Lien de rubrique Conventions de la syntaxe de Transact-SQL

Syntaxe

RESTORE LABELONLY 
FROM <backup_device> 
[ WITH 
 {
--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 } 
}

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 média Microsoft Tape Format 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.
IsCompressed	bit	Indique si la sauvegarde est compressée : 0 = non compressée 1 =compressée

[!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

Dans SQL Server 2008 et les versions ultérieures, obtenir des informations à propos d'un jeu de sauvegarde ou une unité de sauvegarde requiert l'autorisation CREATE DATABASE. Pour plus d'informations, consultez GRANT – octroi d'autorisations de base de données (Transact-SQL).

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'ajout de jeux de sauvegarde au support par le biais des outils MicrosoftSQL Server. 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. 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. Cette fonctionnalité sera supprimée dans une prochaine version de 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é. 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.

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. 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. Cette fonctionnalité sera supprimée dans une prochaine version de 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é. 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.