Compartilhar via


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çãoObservação

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

Ícone de vínculo de tópicoConvençõ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çãoObservaçã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çãoObservaçã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çaObservaçã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.