RESTORE-Anweisungen: LABELONLY (Transact-SQL)

Gilt für:SQL ServerAzure SQL Managed Instance

Gibt ein Resultset mit Informationen zu den durch das gegebene Sicherungsmedium identifizierten Sicherungsmedien zurück.

Hinweis

Eine Beschreibung der Argumente finden Sie unter RESTORE-Argumente (Transact-SQL).

Transact-SQL-Syntaxkonventionen

Syntax

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

Hinweis

URL ist das Format, das verwendet wird, um den Speicherort und den Dateinamen für Microsoft Azure Blob Storage anzugeben und wird ab SQL Server 2012 (11.x) SP1 mit dem kumulativen Update 2 (CU2) unterstützt. Obwohl es sich bei Microsoft Azure Storage um einen Dienst handelt, ist die Implementierung mit einem Datenträger und Band vergleichbar, um für alle drei Geräte eine konsistente und nahtlose Wiederherstellung zu ermöglichen.

Argumente

Eine Beschreibung der RESTORE LABELONLY-Argumente finden Sie unter RESTORE-Argumente (Transact-SQL).

Resultsets

Das Resultset von RESTORE LABELONLY besteht aus einer Zeile mit diesen Informationen.

Spaltenname Datentyp BESCHREIBUNG
MediaName nvarchar(128) Name des Mediums.
MediaSetId uniqueidentifier Eindeutige ID des Mediensatzes.
FamilyCount int Anzahl der Medienfamilien im Mediensatz.
FamilySequenceNumber int Sequenznummer dieser Familie.
MediaFamilyId uniqueidentifier Eindeutige ID für die Medienfamilie.
MediaSequenceNumber int Sequenznummer dieses Mediums in der Medienfamilie.
MediaLabelPresent tinyint Gibt an, ob die Medienbeschreibung Folgendes enthält:

1 = Medienbezeichnung von Microsoft Tape Format

0 = Medienbeschreibung
MediaDescription nvarchar(255) Medienbeschreibung als Text oder die Medienbezeichnung von Tape Format.
SoftwareName nvarchar(128) Name der Sicherungssoftware, die die Bezeichnung geschrieben hat.
SoftwareVendorId int Eindeutige ID des Softwareanbieters, der die Sicherung geschrieben hat.
MediaDate datetime Datum und Uhrzeit des Zeitpunkts, an dem die Bezeichnung geschrieben wurde.
Mirror_Count int Die Anzahl von Spiegeln in einem Spiegelsatz (1-4).

Hinweis: Für verschiedene Spiegel in einem Satz werden identische Bezeichnungen geschrieben.
IsCompressed bit Gibt an, ob die Sicherung komprimiert ist:

0 = Nicht komprimiert

1 = komprimiert

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.

Allgemeine Hinweise

Die Ausführung von RESTORE LABELONLY stellt eine schnelle Möglichkeit dar, den Inhalt des Sicherungsmediums herauszufinden. Da RESTORE LABELONLY nur den Medienheader liest, wird diese Anweisung schnell abgeschlossen, auch wenn Bandmedien mit hoher Kapazität verwendet werden.

Sicherheit

In einem Sicherungsvorgang können optional Kennwörter für einen Mediensatz angegeben werden. Wenn ein Kennwort für einen Mediensatz definiert wurde, müssen Sie in der RESTORE-Anweisung das richtige Kennwort angeben. Über dieses Kennwort werden nicht autorisierte Wiederherstellungsoptionen und unbefugtes Anfügen von Sicherungssätzen an Medien mithilfe der Tools von Microsoft SQL Server verhindert. Mit einem Kennwort kann jedoch das Überschreiben eines Mediums mithilfe der Option FORMAT der BACKUP-Anweisung nicht verhindert werden.

Wichtig

Dieses Kennwort bietet also nur unzureichenden Schutz. Es soll vermeiden, dass autorisierte wie nicht autorisierte Benutzer mithilfe von SQL Server-Tools fehlerhafte Wiederherstellungen durchführen. Es verhindert jedoch nicht das Lesen der Sicherungsdaten mit anderen Mitteln oder das Ersetzen des Kennworts. Diese Funktion wird in einer zukünftigen Version von SQL Serverentfernt. Nutzen Sie diese Features bei Neuentwicklungen nicht mehr, und planen Sie die Änderung von Anwendungen, die dieses Feature zurzeit verwenden. 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 (Access Control List, ACL) geschützt sind. Die ACLs sollten für den Verzeichnisstamm eingerichtet werden, unter dem die Sicherungen erstellt werden.

Berechtigungen

In SQL Server 2008 (10.0.x) und höheren Versionen benötigen Sie die CREATE DATABASE-Berechtigung, um Informationen zu Sicherungssätzen oder Sicherungsmedien abzurufen. Weitere Informationen finden Sie unter GRANT (Datenbankberechtigungen) (Transact-SQL).

Weitere Informationen

BACKUP (Transact-SQL)
Mediensätze, Medienfamilien und Sicherungssätze (SQL Server)
RESTORE REWINDONLY (Transact-SQL)
RESTORE VERIFYONLY (Transact-SQL)
RESTORE (Transact-SQL)
Sicherungsverlauf und Headerinformationen (SQL Server)