RESTORE-Anweisungen: LABELONLY (Transact-SQL)RESTORE Statements - LABELONLY (Transact-SQL)

Dieses Thema gilt für:JaSQL Server (ab 2008)JaAzure SQL-Datenbank (nur verwaltete Instanz)keineAzure SQL Data Warehouse keineParallel Datawarehouse THIS TOPIC APPLIES TO:yesSQL Server (starting with 2008)yesAzure SQL Database (Managed Instance only)noAzure SQL Data Warehouse noParallel Data Warehouse

Gibt ein Resultset mit Informationen zu den durch das gegebene Sicherungsmedium identifizierten Sicherungsmedien zurück.Returns a result set containing information about the backup media identified by the given backup device.

Wichtig

Auf Azure SQL-Datenbank verwaltete Instanz, diese T-SQL-Funktion hat bestimmte verhaltensänderungen.On Azure SQL Database Managed Instance, this T-SQL feature has certain behavior changes. Finden Sie unter Azure SQL-Datenbank verwaltet Instanz T-SQL-Unterschiede zu SQL Server Details für alle T-SQL-verhaltensänderungen.See Azure SQL Database Managed Instance T-SQL differences from SQL Server for details for all T-SQL behavior changes.

Hinweis

Eine Beschreibung der Argumente finden Sie unter RESTORE-Argumente (Transact-SQL).For the descriptions of the arguments, see RESTORE Arguments (Transact-SQL).

Themenlinksymbol Transact-SQL Syntax Conventions (Transact-SQL-Syntaxkonventionen)Topic link icon Transact-SQL Syntax Conventions

SyntaxSyntax


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 }   
}  

ArgumenteArguments

Eine Beschreibung der RESTORE LABELONLY-Argumente finden Sie unter RESTORE-Argumente (Transact-SQL).For descriptions of the RESTORE LABELONLY arguments, see RESTORE Arguments (Transact-SQL).

ResultsetsResult Sets

Das Resultset von RESTORE LABELONLY besteht aus einer Zeile mit diesen Informationen.The result set from RESTORE LABELONLY consists of a single row with this information.

SpaltennameColumn name DatentypData type BeschreibungDescription
MediaNameMediaName nvarchar(128)nvarchar(128) Name des Mediums.Name of the media.
MediaSetIdMediaSetId uniqueidentifieruniqueidentifier Eindeutige ID des Mediensatzes.Unique identification number of the media set.
FamilyCountFamilyCount intint Anzahl der Medienfamilien im Mediensatz.Number of media families in the media set.
FamilySequenceNumberFamilySequenceNumber intint Sequenznummer dieser Familie.Sequence number of this family.
MediaFamilyIdMediaFamilyId uniqueidentifieruniqueidentifier Eindeutige ID für die Medienfamilie.Unique identification number for the media family.
MediaSequenceNumberMediaSequenceNumber intint Sequenznummer dieses Mediums in der Medienfamilie.Sequence number of this media in the media family.
MediaLabelPresentMediaLabelPresent tinyinttinyint Gibt an, ob die Medienbeschreibung Folgendes enthält:Whether the media description contains:

1 = MicrosoftMicrosoft Medienbezeichnung von Tape Format1 = MicrosoftMicrosoft Tape Format media label

0 = Medienbeschreibung0 = Media description
MediaDescriptionMediaDescription nvarchar(255)nvarchar(255) Medienbeschreibung als Text oder die Medienbezeichnung von Tape Format.Media description, in free-form text, or the Tape Format media label.
SoftwareNameSoftwareName nvarchar(128)nvarchar(128) Name der Sicherungssoftware, die die Bezeichnung geschrieben hat.Name of the backup software that wrote the label.
SoftwareVendorIdSoftwareVendorId intint Eindeutige ID des Softwareanbieters, der die Sicherung geschrieben hat.Unique vendor identification number of the software vendor that wrote the backup.
MediaDateMediaDate datetimedatetime Datum und Uhrzeit des Zeitpunkts, an dem die Bezeichnung geschrieben wurde.Date and time the label was written.
Mirror_CountMirror_Count intint Die Anzahl von Spiegeln in einem Spiegelsatz (1-4).Number of mirrors in the set (1-4).

Hinweis: Für verschiedene Spiegel in einem Satz werden identische Bezeichnungen geschrieben.Note: The labels written for different mirrors in a set are identical.
IsCompressedIsCompressed bitbit Gibt an, ob die Sicherung komprimiert ist:Whether the backup is compressed:

0 = Nicht komprimiert0 = not compressed

1 = komprimiert1 =compressed

Hinweis

Wenn für den Mediensatz Kennwörter definiert sind, gibt RESTORE LABELONLY nur dann Informationen zurück, wenn im Befehl in der Option MEDIAPASSWORD das richtige Kennwort angegeben ist.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.

Allgemeine HinweiseGeneral Remarks

Die Ausführung von RESTORE LABELONLY stellt eine schnelle Möglichkeit dar, den Inhalt des Sicherungsmediums herauszufinden.Executing RESTORE LABELONLY is a quick way to find out what the backup media contains. Da RESTORE LABELONLY nur den Medienheader liest, wird diese Anweisung schnell abgeschlossen, auch wenn Bandmedien mit hoher Kapazität verwendet werden.Because RESTORE LABELONLY reads only the media header, this statement finishes quickly even when using high-capacity tape devices.

SecuritySecurity

In einem Sicherungsvorgang können optional Kennwörter für einen Mediensatz angegeben werden.A backup operation may optionally specify passwords for a media set. Wenn ein Kennwort für einen Mediensatz definiert wurde, müssen Sie in der RESTORE-Anweisung das richtige Kennwort angeben.When a password has been defined on a media set, you must specify the correct password in the RESTORE statement. Das Kennwort verhindert nicht autorisierte Wiederherstellungsoptionen und unbefugtes Anfügen von Sicherungssätzen an Medien mithilfe der Tools von MicrosoftMicrosoft SQL ServerSQL Server.The password prevents unauthorized restore operations and unauthorized appends of backup sets to media using MicrosoftMicrosoft SQL ServerSQL Server tools. Mit einem Kennwort kann jedoch das Überschreiben eines Mediums mithilfe der Option FORMAT der BACKUP-Anweisung nicht verhindert werden.However, a password does not prevent overwrite of media using the BACKUP statement's FORMAT option.

Wichtig

Dieses Kennwort bietet also nur unzureichenden Schutz.The protection provided by this password is weak. Es soll vermeiden, dass autorisierte wie nicht autorisierte Benutzer mithilfe von SQL ServerSQL Server-Tools fehlerhafte Wiederherstellungen durchführen.It is intended to prevent an incorrect restore using SQL ServerSQL Server tools by authorized or unauthorized users. Es verhindert jedoch nicht das Lesen der Sicherungsdaten mit anderen Mitteln oder das Ersetzen des Kennworts.It does not prevent the reading of the backup data by other means or the replacement of the password. Dieses Feature wird in einer künftigen Version von Microsoft SQL Server entfernt.This feature will be removed in a future version of Microsoft SQL Server. Verwenden Sie diese Funktion beim Entwickeln neuer Anwendungen nicht, und planen Sie das Ändern von Anwendungen, in denen es zurzeit verwendet wird.Avoid using this feature in new development work, and plan to modify applications that currently use this feature.Eine bewährte Methode für den Schutz von Sicherungen ist das Verwahren von Sicherungsbändern an einem sicheren Ort oder das Sichern in Datenträgerdateien, die durch eine adäquate Zugriffssteuerungsliste (ACL, Access Control List) geschützt sind.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). Die ACLs sollten für den Verzeichnisstamm eingerichtet werden, unter dem die Sicherungen erstellt werden.The ACLs should be set on the directory root under which backups are created.

BerechtigungenPermissions

In SQL Server 2008SQL Server 2008 und höheren Versionen benötigen Sie die CREATE DATABASE-Berechtigung, um Informationen zu Sicherungssätzen oder Sicherungsmedien abzurufen.In SQL Server 2008SQL Server 2008 and later versions, obtaining information about a backup set or backup device requires CREATE DATABASE permission. Weitere Informationen finden Sie unter GRANT (Datenbankberechtigungen) (Transact-SQL).For more information, see GRANT Database Permissions (Transact-SQL).

Weitere Informationen finden Sie unterSee Also

BACKUP (Transact-SQL) BACKUP (Transact-SQL)
Mediensätze, Medienfamilien und Sicherungssätze (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)
Sicherungsverlauf und Headerinformationen (SQL Server)Backup History and Header Information (SQL Server)