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

Aplica-se a:SQL ServerAzure SQL Managed Instance

Retorna um conjunto de resultados contendo informações sobre a mídia de backup identificada pelo dispositivo de backup fornecido.

Observação

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

Transact-SQL convenções de sintaxe

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 tem suporte a partir do 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 contínua 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 numa única linha com esta informação.

Nome da coluna Tipo de dados Descrição
MediaName Nvarchar(128) Nome dos meios de comunicação social.
MediaSetId identificador único Número de identificação único do conjunto multimédia.
FamíliaCount Int Número de famílias de mídia no conjunto de mídia.
FamilySequenceNumber Int Número sequencial desta família.
MediaFamilyId identificador único Número de identificação único para a família de media.
MediaSequenceNumber Int Número de sequência desta mídia na família de mídia.
MediaLabelPresente tinyint Se a descrição da mídia contém:

1 = etiqueta de mídia Microsoft Tape Format

0 = Descrição dos meios de comunicação social
Descrição da mídia Nvarchar(255) Descrição da mídia, em texto de forma livre, ou o rótulo de mídia em formato de fita.
SoftwareName Nvarchar(128) Nome do software de backup que escreveu o rótulo.
SoftwareVendorId Int Número de identificação exclusivo do fornecedor do software que escreveu o backup.
MediaDate datetime Data e hora em que o rótulo foi escrito.
Mirror_Count Int Número de espelhos no conjunto (1-4).

Nota: As etiquetas escritas para diferentes espelhos num conjunto são idênticas.
IsCompressed bit Se o backup está compactado:

0 = não comprimido

1 =comprimido

Observação

Se forem definidas palavras-passe para o conjunto de meios, só RESTORE LABELONLY retorna informação se a palavra-passe correta for especificada na opção MEDIAPASSWORD do comando.

Observações gerais

Executar RESTORE LABELONLY é uma forma rápida de descobrir o que contém o suporte de backup. Como RESTORE LABELONLY apenas lê o cabeçalho de multimédia, esta declaração termina rapidamente mesmo ao usar 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 palavra-passe é definida num conjunto multimédia, deve especificar a palavra-passe 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 palavra-passe não impede a sobrescrição de conteúdos multimé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 usando 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 novos trabalhos de desenvolvimento e planeje modificar aplicativos que atualmente usam esse recurso. A prática recomendada para proteger backups é armazenar fitas de backup em um local seguro ou fazer backup em arquivos de disco protegidos por ACLs (listas de controle de acesso) adequadas. As ACLs devem ser definidas na raiz do diretório sob a qual 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 mais informações, consulte GRANT Permissões de Base de Dados (Transact-SQL).

Ver também

BACKUP (Transact-SQL)
conjuntos de mídia, famílias de mídia e conjuntos de backup (SQL Server)
RESTORE REWINDONLY (Transact-SQL)
RESTORE VERIFYONLY (Transact-SQL)
RESTORE (Transact-SQL)
Histórico de Backup e Informações de Cabeçalho (SQL Server)

  • Last updated on