RESTORE Déclarations - LABELONLY (Transact-SQL)

S’applique à :SQL ServerAzure SQL Managed Instance

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

Notes

Pour les descriptions des arguments, voir RESTORE Arguments (Transact-SQL).

Conventions de la syntaxe 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 | 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) 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.

Les arguments

Pour des descriptions des RESTORE LABELONLY arguments, voir RESTORE Arguments (Transact-SQL).

Jeux de résultats

L’ensemble de résultats de RESTORE LABELONLY consiste en une seule ligne contenant cette information.

Nom de la colonne Type de données Descriptif
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 dans le support de sauvegarde.
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 de support 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 d’écriture de l’étiquette.
Mirror_Count Int Nombre de miroirs dans le jeu (1-4).

Remarque : les étiquettes écrites pour différents miroirs d’un jeu sont identiques.
IsCompressed mors Indique si la sauvegarde est compressée :

0 = non compressée

1 =compressée

Notes

Si des mots de passe sont définis pour l’ensemble média, il RESTORE LABELONLY ne retourne l’information que si le mot de passe média correct est spécifié dans l’option MEDIAPASSWORD de la commande.

Remarques d'ordre général

L’exécution RESTORE LABELONLY est un moyen rapide de découvrir ce que contient le support de sauvegarde. Comme RESTORE LABELONLY il ne lit que l’en-tête média, cette déclaration se termine rapidement même avec des dispositifs à bande à grande capacité.

Sécurité

Une opération de sauvegarde peut éventuellement spécifier les mots de passe d'un support de sauvegarde. Lorsqu’un mot de passe est défini sur un multimédia, vous devez spécifier le mot de passe correct dans la RESTORE déclaration. 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 Microsoft SQL Server. Cependant, un mot de passe n’empêche pas la réécriture des médias en utilisant l’option BACKUP FORMAT de la déclaration.

Important

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, elle 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 version future de 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 meilleure pratique pour protéger les sauvegardes consiste à stocker des bandes de sauvegarde dans un emplacement sécurisé ou à sauvegarder sur des fichiers de disque protégés par des listes de contrôle d’accès adéquates (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.

Autorisations

Dans SQL Server 2008 (10.0.x) et versions ultérieures, l’obtention d’informations sur un jeu de sauvegarde ou un périphérique de sauvegarde nécessite CREATE DATABASE une autorisation. Pour plus d’informations, consultez GRANT Autorisations de base de données (Transact-SQL).

Voir aussi

BACKUP (Transact-SQL)
Jeux de supports, familles de supports et jeux de sauvegarde (SQL Server)
RESTORE REWINDONLY (Transact-SQL)
RESTORE VERIFYONLY (Transact-SQL)
RESTORE (Transact-SQL)
Historique de sauvegarde et informations d'en-tête (SQL Server)

  • Last updated on