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

Aplica-se a: SQL Server Instância Gerenciada de SQL do Azure Sem suporte Azure Synapse Analytics Sem suporte PDW (Analytics Platform System)

Retorna um conjunto de resultados que contém informações sobre as mídias de backup identificadas pelo dispositivo de backup designado.

Observação

Para obter as descrições dos argumentos, confira Argumentos de RESTORE (Transact-SQL).

Topic link iconConvenções de sintaxe do Transact-SQL

Sintaxe

  
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) 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.

Argumentos

Para obter descrições dos argumentos de RESTORE LABELONLY, confira Argumentos de RESTORE (Transact-SQL).

Conjuntos de resultados

O conjunto de resultados de RESTORE LABELONLY consiste em uma única linha com essas informações.

Nome da coluna Tipo de dados Descrição
MediaName nvarchar(128) Nome da mídia.
MediaSetId uniqueidentifier Número de identificação exclusivo do conjunto de mídias.
FamilyCount int Número de famílias de mídias no conjunto de mídias.
FamilySequenceNumber int Número de sequência desta família.
MediaFamilyId uniqueidentifier Número de identificação exclusivo da família de mídia.
MediaSequenceNumber int Número de sequência dessa mídia na família de mídias.
MediaLabelPresent tinyint Se a descrição de mídia contiver:

1 = Rótulo da mídia de formato de fita da Microsoft

0 = descrição da mídia
MediaDescription nvarchar(255) Descrição da mídia, em texto de formato livre, ou rótulo de mídia de formato de fita.
SoftwareName nvarchar(128) Nome do software de backup que gravou o rótulo.
SoftwareVendorId int Número exclusivo de identificação do fornecedor do software que gravou o backup.
MediaDate datetime Data e hora em que o rótulo foi gravado.
Mirror_Count int Número de espelhos no conjunto (1-4).

Observação: os rótulos gravados para espelhos diferentes em um conjunto são idênticos.
IsCompressed bit Se o backup é compactado:

0 = não compactado

1 = compactado

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.

Comentários gerais

A execução de RESTORE LABELONLY é um modo rápido de descobrir o que a mídia de backup contém. 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.

Segurança

Uma operação de backup pode opcionalmente especificar senhas para um conjunto de mídias. Quando uma senha tiver sido definida em um conjunto de mídias, será preciso especificar a senha correta na instrução RESTORE. A senha impede operações de restauração não autorizadas e acréscimos não autorizados de conjuntos de backup à mídia usando ferramentas do Microsoft SQL Server. Porém, uma senha não impede a substituição da mídia usando a opção FORMAT da instrução BACKUP.

Importante

A proteção fornecida por esta senha é fraca. Destina-se a evitar uma restauração incorreta com o uso de ferramentas do SQL Server por usuários autorizados ou não autorizados. Não impede a leitura dos dados de backup por outros meios ou a substituição da senha. Esse recurso será removido em uma versão futura do Microsoft SQL Server. Evite usar esse recurso em um novo trabalho de desenvolvimento e planeje modificar aplicativos que atualmente usam esse recurso. A melhor prática para proteger backups é armazenar fitas de backup em um local seguro ou fazer backup de arquivos de disco protegidos por ACLs (listas de controle de acesso) adequadas. As ACLs devem ser definidas no diretório raiz em que os backups são criados.

Permissões

No SQL 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. Para obter mais informações, confira GRANT Database Permissions (Transact-SQL).

Consulte Também

BACKUP (Transact-SQL)
Conjuntos de mídias, famílias de mídia e conjuntos de backup (SQL Server)
RESTORE REWINDONLY (Transact-SQL)
RESTORE VERIFYONLY (Transact-SQL)
RESTORE (Transact-SQL)
Informações de histórico e cabeçalho de backup (SQL Server)