Instruções RESTORE – LABELONLY (Transact-SQL)RESTORE Statements - LABELONLY (Transact-SQL)

APLICA-SE A: simSQL Server simBanco de Dados SQL do Azure (somente a Instância Gerenciada) nãoSQL Data Warehouse do Azure nãoParallel Data Warehouse APPLIES TO: yesSQL Server yesAzure SQL Database (Managed Instance only) noAzure SQL Data Warehouse noParallel Data Warehouse

Retorna um conjunto de resultados que contém informações sobre as mídias de backup identificadas pelo dispositivo de backup designado.Returns a result set containing information about the backup media identified by the given backup device.

Observação

Para obter as descrições dos argumentos, consulte Argumentos de RESTORE (Transact-SQL).For the descriptions of the arguments, see RESTORE Arguments (Transact-SQL).

Ícone de link do tópico Convenções de sintaxe de Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintaxeSyntax

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

Observação

URL é o formato usado para especificar o local e o nome do arquivo para o Armazenamento de Blobs do Microsoft Azure e o suporte a ele começa no SQL Server 2012 (11.x)SQL Server 2012 (11.x) SP1 CU2.URL is the format used to specify the location and the file name for Microsoft Azure Blob Storage and is supported starting with SQL Server 2012 (11.x)SQL Server 2012 (11.x) SP1 CU2. Embora o Armazenamento do Microsoft Azure seja um serviço, a implementação é semelhante ao disco e à fita para permitir uma experiência de restauração consistente e direta para todos os três dispositivos.Although Microsoft Azure storage is a service, the implementation is similar to disk and tape to allow for a consistent and seamless restore experience for all the three devices.

ArgumentosArguments

Para obter descrições dos argumentos de RESTORE LABELONLY, confira Argumentos de RESTORE (Transact-SQL).For descriptions of the RESTORE LABELONLY arguments, see RESTORE Arguments (Transact-SQL).

Conjuntos de resultadosResult Sets

O conjunto de resultados de RESTORE LABELONLY consiste em uma única linha com essas informações.The result set from RESTORE LABELONLY consists of a single row with this information.

Nome da colunaColumn name Tipo de dadosData type DescriçãoDescription
MediaNameMediaName nvarchar(128)nvarchar(128) Nome da mídia.Name of the media.
MediaSetIdMediaSetId uniqueidentifieruniqueidentifier Número de identificação exclusivo do conjunto de mídias.Unique identification number of the media set.
FamilyCountFamilyCount intint Número de famílias de mídias no conjunto de mídias.Number of media families in the media set.
FamilySequenceNumberFamilySequenceNumber intint Número de sequência desta família.Sequence number of this family.
MediaFamilyIdMediaFamilyId uniqueidentifieruniqueidentifier Número de identificação exclusivo da família de mídia.Unique identification number for the media family.
MediaSequenceNumberMediaSequenceNumber intint Número de sequência dessa mídia na família de mídias.Sequence number of this media in the media family.
MediaLabelPresentMediaLabelPresent tinyinttinyint Se a descrição de mídia contiver:Whether the media description contains:

1 = MicrosoftMicrosoft Rótulo da mídia de formato de fita1 = MicrosoftMicrosoft Tape Format media label

0 = descrição da mídia0 = Media description
MediaDescriptionMediaDescription nvarchar(255)nvarchar(255) Descrição da mídia, em texto de formato livre, ou rótulo de mídia de formato de fita.Media description, in free-form text, or the Tape Format media label.
SoftwareNameSoftwareName nvarchar(128)nvarchar(128) Nome do software de backup que gravou o rótulo.Name of the backup software that wrote the label.
SoftwareVendorIdSoftwareVendorId intint Número exclusivo de identificação do fornecedor do software que gravou o backup.Unique vendor identification number of the software vendor that wrote the backup.
MediaDateMediaDate datetimedatetime Data e hora em que o rótulo foi gravado.Date and time the label was written.
Mirror_CountMirror_Count intint Número de espelhos no conjunto (1-4).Number of mirrors in the set (1-4).

Observação: Os rótulos escritos para espelhos diferentes em um conjunto são idênticos.Note: The labels written for different mirrors in a set are identical.
IsCompressedIsCompressed bitbit Se o backup é compactado:Whether the backup is compressed:

0 = não compactado0 = not compressed

1 = compactado1 =compressed

Observação

Se as senhas forem definidas para o conjunto de mídias, RESTORE LABELONLY retornará informações apenas se a senha de mídia correta for especificada na opção MEDIAPASSWORD do comando.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.

Comentários geraisGeneral Remarks

A execução de RESTORE LABELONLY é um modo rápido de descobrir o que a mídia de backup contém.Executing RESTORE LABELONLY is a quick way to find out what the backup media contains. Como RESTORE LABELONLY lê só o cabeçalho da mídia, essa instrução terminará rapidamente mesmo quando estiverem sendo usados dispositivos de fita de alta capacidade.Because RESTORE LABELONLY reads only the media header, this statement finishes quickly even when using high-capacity tape devices.

SegurançaSecurity

Uma operação de backup pode opcionalmente especificar senhas para um conjunto de mídias.A backup operation may optionally specify passwords for a media set. Quando uma senha tiver sido definida em um conjunto de mídias, será preciso especificar a senha correta na instrução RESTORE.When a password has been defined on a media set, you must specify the correct password in the RESTORE statement. A senha impede operações de restauração não autorizadas e acréscimos não autorizados de conjuntos de backup na mídia usando as ferramentas do MicrosoftMicrosoftSQL ServerSQL Server.The password prevents unauthorized restore operations and unauthorized appends of backup sets to media using MicrosoftMicrosoft SQL ServerSQL Server tools. Porém, uma senha não impede a substituição da mídia usando a opção FORMAT da instrução BACKUP.However, a password does not prevent overwrite of media using the BACKUP statement's FORMAT option.

Importante

A proteção fornecida por esta senha é fraca.The protection provided by this password is weak. Destina-se a evitar uma restauração incorreta com o uso de ferramentas de SQL ServerSQL Server por usuários autorizados ou não autorizados.It is intended to prevent an incorrect restore using SQL ServerSQL Server tools by authorized or unauthorized users. Não impede a leitura dos dados de backup por outros meios ou a substituição da senha.It does not prevent the reading of the backup data by other means or the replacement of the password. Este recurso está em modo de manutenção e talvez seja removido em uma versão futura do Microsoft SQL Server.This feature is in maintenance mode and may be removed in a future version of Microsoft SQL Server. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam.Avoid using this feature in new development work, and plan to modify applications that currently use this feature.A melhor prática para proteger backups é armazenar as fitas de backup em um local seguro ou fazer backup em arquivos de disco protegidos por ACLs (listas de controle de acesso) adequadas.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). As ACLs devem ser definidas no diretório raiz em que os backups são criados.The ACLs should be set on the directory root under which backups are created.

PermissõesPermissions

No SQL Server 2008SQL Server 2008 e em versões posteriores, a obtenção de informações sobre um conjunto ou dispositivo de backup exige a permissão CREATE DATABASE.In SQL Server 2008SQL Server 2008 and later versions, obtaining information about a backup set or backup device requires CREATE DATABASE permission. Para obter mais informações, veja GRANT Database Permissions (Transact-SQL).For more information, see GRANT Database Permissions (Transact-SQL).

Consulte TambémSee Also

BACKUP (Transact-SQL) BACKUP (Transact-SQL)
Conjuntos de mídias, famílias de mídia e conjuntos de backup (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)
Informações de histórico e cabeçalho de backup (SQL Server)Backup History and Header Information (SQL Server)