RESTORE LABELONLY (Transact-SQL)

Artigo
06/18/2013

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

Ícone de vínculo de tópico Convenções da sintaxe 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 } = { 'physical_backup_device_name' |
       @physical_backup_device_name_var } 
}

Argumentos

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

Conjuntos de resultados

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

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 = Microsoft Rótulo de mídia de formato de fita

0 = Descrição de 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 anexações não autorizadas de conjuntos de backup para mídia que usa ferramentas de MicrosoftSQL Server. Porém, uma senha não impede a substituição da mídia usando a opção FORMAT da instrução BACKUP.

Observação sobre segurança
A proteção fornecida por esta senha é fraca. Destina-se a evitar uma restauração incorreta com o uso de ferramentas de 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 desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam. A prática recomendada 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. As ACLs devem ser definidas no diretório raiz em que os backups são criados.

A proteção fornecida por esta senha é fraca. Destina-se a evitar uma restauração incorreta com o uso de ferramentas de 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 desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam. A prática recomendada 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. 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, consulte Permissões de banco de dados GRANT (Transact-SQL).