RESTORE LABELONLY (Transact-SQL)

Artigo
03/07/2014

Retorna um conjunto de resultados que contém informações sobre as mídias de backup identificadas pelo dispositivo de backup designado.

Dica

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

Aplica-se a: SQL Server (SQL Server 2008 à versão atual).

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

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 = 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). Dica 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

Dica

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