Partilhar via

Declarações RESTORE - 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 obter as descrições dos argumentos, consulte RESTORE Arguments (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 obter descrições dos argumentos RESTORE LABELONLY, consulte RESTORE Arguments (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 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 as senhas forem definidas para o conjunto de mídias, RESTORE LABELONLY retornará informações somente se a senha de mídia correta for especificada na opção MEDIAPASSWORD do comando.

Observações gerais

Executar RESTORE LABELONLY é uma maneira rápida de descobrir o que a mídia de backup contém. Como RESTORE LABELONLY lê apenas o cabeçalho da mídia, essa instrução é concluída 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 senha tiver sido definida em um conjunto de mídias, você deverá 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. No entanto, uma senha não impede a substituição de 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 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, a obtenção de informações sobre um conjunto de backup ou dispositivo de backup requer a permissão CREATE DATABASE. Para obter mais informações, consulte GRANT Database Permissions (Transact-SQL).

Ver também

CÓPIA DE SEGURANÇA (Transact-SQL)
conjuntos de mídia, famílias de mídia e conjuntos de backup (SQL Server)
RESTAURAR REWINDONLY (Transact-SQL)
RESTORE VERIFYONLY (Transact-SQL)
RESTAURAR (Transact-SQL)
Histórico de Backup e Informações de Cabeçalho (SQL Server)

  • Last updated on