Artigo
04/01/2012

RESTORE LABELONLY (Transact-SQL)

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

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 seqüência desta família.
MediaFamilyId	uniqueidentifier	Número de identificação exclusivo da família de mídia.
MediaSequenceNumber	int	Número de seqüê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 for 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

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.

Permissões

No SQL Server 2008 e em versões posteriores, para obter informações sobre um conjunto ou dispositivo de backup, é necessário ter a permissão CREATE DATABASE. Para obter mais informações, consulte Permissões de banco de dados GRANT (Transact-SQL).

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

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 na raiz do diretório no qual 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 na raiz do diretório no qual os backups são criados.