RESTORE Declarações - LABELONLY (Transact-SQL)

Aplica-se a:SQL ServerInstância Gerenciada de SQL do Azure

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 as descrições dos argumentos, veja RESTORE Argumentos (Transact-SQL).

Convenções de sintaxe de 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 descrições dos RESTORE LABELONLY argumentos, veja RESTORE Argumentos (Transact-SQL).

Conjuntos de resultados

O conjunto de resultados de RESTORE LABELONLY consiste em uma única linha com essa informação.

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 data e hora 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ídia, a RESTORE LABELONLY informação retorna somente se a senha correta for especificada na opção MEDIAPASSWORD do comando.

Comentários gerais

Executar RESTORE LABELONLY é uma forma rápida de descobrir o que a mídia de backup contém. Como RESTORE LABELONLY lê apenas o cabeçalho de mídia, essa declaração termina rapidamente mesmo usando 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 é definida em um conjunto de mídia, você deve especificar a senha correta na RESTORE instrução. 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. No entanto, uma senha não impede a sobrescritura de mídia usando a BACKUP opção FORMAT da instrução.

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 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 (10.0.x) e versões posteriores, obter informações sobre um conjunto de backup ou dispositivo de backup requer CREATE DATABASE permissão. Para obter mais informações, consulte GRANT Permissões de Banco de Dados (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)

  • Last updated on