Instructions RESTORE - LABELONLY (Transact-SQL)RESTORE Statements - LABELONLY (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

Renvoie un jeu de résultats contenant des informations sur le support de sauvegarde identifié par l'unité de sauvegarde spécifiée.Returns a result set containing information about the backup media identified by the given backup device.

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 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 | 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 URL 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 une description des arguments RESTORE LABELONLY, consultez Arguments RESTORE (Transact-SQL).For descriptions of the RESTORE LABELONLY arguments, see RESTORE Arguments (Transact-SQL).

Jeux de résultatsResult Sets

Le jeu de résultats renvoyé par RESTORE LABELONLY comporte une seule ligne avec les informations suivantes :The result set from RESTORE LABELONLY consists of a single row with this information.

Nom de colonneColumn name Type de donnéesData type DescriptionDescription
MediaNameMediaName nvarchar(128)nvarchar(128) Nom du support de sauvegarde.Name of the media.
MediaSetIdMediaSetId uniqueidentifieruniqueidentifier Numéro d'identification unique du jeu de supports.Unique identification number of the media set.
FamilyCountFamilyCount Intint Nombre de familles de supports dans le support de sauvegarde.Number of media families in the media set.
FamilySequenceNumberFamilySequenceNumber Intint Numéro de séquence de la famille.Sequence number of this family.
MediaFamilyIdMediaFamilyId uniqueidentifieruniqueidentifier Numéro d'identification unique de la famille de supports de sauvegardes.Unique identification number for the media family.
MediaSequenceNumberMediaSequenceNumber Intint Numéro de séquence de ce support dans la famille.Sequence number of this media in the media family.
MediaLabelPresentMediaLabelPresent tinyinttinyint Indique si la description du support contient :Whether the media description contains:

1 = Étiquette de support MicrosoftMicrosoft Tape Format1 = MicrosoftMicrosoft Tape Format media label

0 = Description du support0 = Media description
MediaDescriptionMediaDescription nvarchar(255)nvarchar(255) Description du support, au format libre, ou étiqueté au format de bande.Media description, in free-form text, or the Tape Format media label.
SoftwareNameSoftwareName nvarchar(128)nvarchar(128) Nom du logiciel de sauvegarde qui a permis l'écriture de l'étiquette du support de sauvegarde.Name of the backup software that wrote the label.
SoftwareVendorIdSoftwareVendorId Intint Numéro d'identification du fournisseur du logiciel qui a permis l'écriture de la sauvegarde.Unique vendor identification number of the software vendor that wrote the backup.
MediaDateMediaDate datetimedatetime Date et heure d’écriture de l’étiquette.Date and time the label was written.
Mirror_CountMirror_Count Intint Nombre de miroirs dans le jeu (1-4).Number of mirrors in the set (1-4).

Remarque : Les étiquettes créées pour différents miroirs d’un jeu sont identiques.Note: The labels written for different mirrors in a set are identical.
IsCompressedIsCompressed bitbit Indique si la sauvegarde est compressée :Whether the backup is compressed:

0 = non compressée0 = not compressed

1 =compressée1 =compressed

Notes

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.If passwords are defined for the media set, RESTORE LABELONLY returns information only if the correct media password is specified in the MEDIAPASSWORD option of the command.

Remarques d'ordre généralGeneral Remarks

L'exécution de RESTORE LABELONLY permet de déterminer rapidement le contenu du support de sauvegarde.Executing RESTORE LABELONLY is a quick way to find out what the backup media contains. Comme elle lit uniquement l'en-tête de support, l'instruction RESTORE LABELONLY s'exécute vite, même pour des unités de bande de grande capacité.Because RESTORE LABELONLY reads only the media header, this statement finishes quickly even when using high-capacity tape devices.

SécuritéSecurity

Une opération de sauvegarde peut éventuellement spécifier les mots de passe d'un support de sauvegarde.A backup operation may optionally specify passwords for a media set. 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.When a password has been defined on a media set, you must specify the correct password in the RESTORE statement. Le mot de passe empêche les opérations non autorisées de restauration et d’ajout de jeux de sauvegarde sur le support à l’aide d’outils MicrosoftMicrosoft SQL ServerSQL Server.The password prevents 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 bonne pratique 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 et les versions ultérieures, l'obtention d'informations relatives à un jeu de sauvegarde ou une unité de sauvegarde requiert l'autorisation CREATE DATABASE.In SQL Server 2008SQL Server 2008 and later versions, 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).

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)