Partager via


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

RemarqueRemarque
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é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.