RESTORE Uttalanden - LABELONLY (Transact-SQL)

gäller för:SQL ServerAzure SQL Managed Instance

Returnerar en resultatuppsättning som innehåller information om säkerhetskopieringsmediet som identifieras av den angivna säkerhetskopieringsenheten.

Anmärkning

För beskrivningar av argumenten, se RESTORE Argument (Transact-SQL).

Transact-SQL syntaxkonventioner

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

Anmärkning

URL är det format som används för att ange platsen och filnamnet för Microsoft Azure Blob Storage och stöds från och med SQL Server 2012 (11.x) SP1 CU2. Även om Microsoft Azure Storage är en tjänst liknar implementeringen disk och band för att ge en konsekvent och sömlös återställningsupplevelse för alla de tre enheterna.

Argumentpunkter

För beskrivningar av argumenten RESTORE LABELONLY , se RESTORE Argument (Transact-SQL).

Resultatuppsättningar

Resultatmängden från RESTORE LABELONLY består av en enda rad med denna information.

Kolumnnamn Datatyp Beskrivning
MediaName nvarchar(128) Namnet på mediet.
MediaSetId unika identifierare Unikt identifieringsnummer för medieuppsättningen.
FamilyCount Int Antal mediefamiljer i medieuppsättningen.
FamilySequenceNumber Int Sekvensnummer för den här familjen.
MediaFamilyId unika identifierare Unikt ID-nummer för mediefamiljen.
MediaSequenceNumber Int Sekvensnummer för det här mediet i mediefamiljen.
MediaLabelPresent tinyint Om mediebeskrivningen innehåller:

1 = Medieetikett för Microsoft Tape Format

0 = Mediebeskrivning
MediaDescription nvarchar(255) Mediebeskrivning, i fritext eller medieetiketten Bandformat.
SoftwareName nvarchar(128) Namnet på säkerhetskopieringsprogrammet som skrev etiketten.
SoftwareVendorId Int Unikt leverantörsidentifieringsnummer för programvaruleverantören som skrev säkerhetskopian.
MediaDate datetime Datum och tid då etiketten skrevs.
Mirror_Count Int Antal speglar i uppsättningen (1–4).

Obs! Etiketterna som skrivs för olika speglar i en uppsättning är identiska.
IsCompressed bit Om säkerhetskopieringen är komprimerad:

0 = inte komprimerad

1 =komprimerad

Anmärkning

Om lösenord är definierade för medieuppsättningen, RESTORE LABELONLY returnerar information endast om rätt medielösenord anges i MEDIAPASSWORD-alternativet i kommandot.

Allmänna kommentarer

Att köra RESTORE LABELONLY är ett snabbt sätt att ta reda på vad backupmediet innehåller. Eftersom RESTORE LABELONLY den endast läser mediehuvudet avslutas detta uttalande snabbt även vid användning av högkapacitets bandenheter.

Säkerhet

En säkerhetskopieringsåtgärd kan också ange lösenord för en medieuppsättning. När ett lösenord har definierats på en medieuppsättning måste du ange rätt lösenord i uttalandet RESTORE . Lösenordet förhindrar obehöriga återställningsåtgärder och obehöriga tillägg av säkerhetskopieringsuppsättningar till media med hjälp av Microsoft SQL Server-verktyg. Ett lösenord förhindrar dock inte att media skrivs över med BACKUP uttalandets FORMAT-alternativ.

Viktigt!

Skyddet som tillhandahålls av det här lösenordet är svagt. Den är avsedd att förhindra en felaktig återställning med hjälp av SQL Server-verktyg av auktoriserade eller obehöriga användare. Det förhindrar inte läsning av säkerhetskopierade data på annat sätt eller ersättning av lösenordet. Den här funktionen tas bort i en framtida version av SQL Server. Undvik att använda den här funktionen i nytt utvecklingsarbete och planera att ändra program som för närvarande använder den här funktionen. Det bästa sättet att skydda säkerhetskopior är att lagra säkerhetskopieringsband på en säker plats eller säkerhetskopiera till diskfiler som skyddas av lämpliga åtkomstkontrollistor (ACL). ACL:erna ska anges i katalogroten under vilken säkerhetskopior skapas.

Behörigheter

I SQL Server 2008 (10.0.x) och senare versioner kräver CREATE DATABASE det behörighet att hämta information om en säkerhetskopia eller en säkerhetskopieringsenhet. Mer information finns i GRANT Databasbehörigheter (Transact-SQL).

Se även

BACKUP (Transact-SQL)
Medieuppsättningar, Mediefamiljer och Säkerhetskopiauppsättningar (SQL Server)
RESTORE REWINDONLY (Transact-SQL)
RESTORE VERIFYONLY (Transact-SQL)
RESTORE (Transact-SQL)
Säkerhetskopieringshistorik och Huvudinformation (SQL Server)