Delen via

RESTORE-instructies - LABELONLY (Transact-SQL)

Van toepassing op:SQL ServerAzure SQL Managed Instance

Retourneert een resultatenset met informatie over de back-upmedia die zijn geïdentificeerd door het opgegeven back-upapparaat.

Opmerking

Zie RESTORE-argumenten (Transact-SQL) voor de beschrijvingen van de argumenten.

Transact-SQL syntaxis-conventies

Syntaxis

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

Opmerking

URL is de indeling die wordt gebruikt om de locatie en de bestandsnaam voor Microsoft Azure Blob Storage op te geven en wordt ondersteund vanaf SQL Server 2012 (11.x) SP1 CU2. Hoewel Microsoft Azure Storage een service is, is de implementatie vergelijkbaar met schijf en tape om een consistente en naadloze herstelervaring voor alle drie de apparaten mogelijk te maken.

Argumenten

Zie RESTORE-argumenten (Transact-SQL) voor beschrijvingen van de argumenten RESTORE LABELONLY.

Resultaatsets

De resultatenset van RESTORE LABELONLY bestaat uit één rij met deze informatie.

Kolomnaam Gegevenstype Beschrijving
MediaName Nvarchar(128) De naam van de media.
MediaSetId uniqueidentifier Uniek identificatienummer van de mediaset.
FamilyCount Int Aantal mediafamilies in de mediaset.
FamilySequenceNumber Int Volgnummer van deze familie.
MediaFamilyId uniqueidentifier Uniek identificatienummer voor de mediafamilie.
MediaSequenceNumber Int Volgnummer van deze media in de mediafamilie.
MediaLabelPresent tinyint Of de mediabeschrijving het volgende bevat:

1 = Medialabel van Microsoft Tape Format

0 = Mediabeschrijving
MediaDescription nvarchar(255) Mediabeschrijving, in vrije tekst of het medialabel Tape Format.
SoftwareName- Nvarchar(128) Naam van de back-upsoftware die het label heeft geschreven.
SoftwareVendorId Int Uniek identificatienummer van de leverancier van de software die de back-up heeft geschreven.
MediaDate datum en tijd Datum en tijd waarop het label is geschreven.
Mirror_Count Int Aantal spiegels in de set (1-4).

Opmerking: de labels die zijn geschreven voor verschillende spiegels in een set, zijn identiek.
IsCompressed bit Of de back-up wordt gecomprimeerd:

0 = niet gecomprimeerd

1 =gecomprimeerd

Opmerking

Als wachtwoorden zijn gedefinieerd voor de mediaset, retourneert RESTORE LABELONLY alleen informatie als het juiste mediawachtwoord is opgegeven in de optie MEDIAPASSWORD van de opdracht.

Algemene opmerkingen

Het uitvoeren van RESTORE LABELONLY is een snelle manier om erachter te komen wat de back-upmedia bevatten. Omdat RESTORE LABELONLY alleen de mediaheader leest, wordt deze instructie snel voltooid, zelfs wanneer er tapeapparaten met hoge capaciteit worden gebruikt.

Veiligheid

Een back-upbewerking kan eventueel wachtwoorden voor een mediaset opgeven. Wanneer een wachtwoord is gedefinieerd voor een mediaset, moet u het juiste wachtwoord opgeven in de INSTRUCTIE RESTORE. Met het wachtwoord voorkomt u niet-geautoriseerde herstelbewerkingen en niet-geautoriseerde toevoegbewerkingen van back-upsets aan media met behulp van Microsoft SQL Server-hulpprogramma's. Een wachtwoord voorkomt echter niet dat media worden overschreven met behulp van de optie FORMAT van de BACKUP-instructie.

Belangrijk

De beveiliging die door dit wachtwoord wordt geboden, is zwak. Het is bedoeld om een onjuiste herstelbewerking te voorkomen met behulp van SQL Server-hulpprogramma's door geautoriseerde of niet-geautoriseerde gebruikers. Het voorkomt niet dat de back-upgegevens op een andere wijze worden gelezen of dat het wachtwoord wordt vervangen. Deze functie wordt verwijderd in een toekomstige versie van SQL Server. Vermijd het gebruik van deze functie in nieuwe ontwikkelwerkzaamheden en plan om toepassingen te wijzigen die momenteel gebruikmaken van deze functie. De aanbevolen procedure voor het beveiligen van back-ups is het opslaan van back-uptapes op een veilige locatie of een back-up maken van schijfbestanden die worden beveiligd door adequate toegangsbeheerlijsten (ACL's). De ACL's moeten worden ingesteld in de hoofdmap van de map waarin back-ups worden gemaakt.

Machtigingen

In SQL Server 2008 (10.0.x) en latere versies is voor het verkrijgen van informatie over een back-upset of back-upapparaat een CREATE DATABASE-machtiging vereist. Zie Databasemachtigingen verlenen (Transact-SQL)voor meer informatie.

Zie ook

BACKUP (Transact-SQL)
Mediasets, Mediafamilies en Back-upsets (SQL Server)
HERSTEL REWINDONLY (Transact-SQL)
VERIFYONLY (Transact-SQL) herstellen
RESTORE (Transact-SQL)
Back-upproceduregeschiedenis en kopinformatie (SQL Server)