Instruções RESTORE – LABELONLY (Transact-SQL)
Aplica-se a: 
SQL Server Instância Gerenciada de SQL do Azure
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 as descrições dos argumentos, confira Argumentos de RESTORE (Transact-SQL).
Convenções de sintaxe de 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 | 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 o suporte a ele começa no 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 direta para todos os três dispositivos.
Argumentos
Para obter descrições dos argumentos de RESTORE LABELONLY, confira 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 = Rótulo da mídia de formato de fita da Microsoft 0 = descrição da 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 acréscimos não autorizados de conjuntos de backup à mídia usando ferramentas do 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.
Importante
A proteção fornecida por esta senha é fraca. Destina-se a evitar uma restauração incorreta com o uso de 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 um novo trabalho de desenvolvimento e planeje modificar aplicativos que atualmente usam esse recurso. A melhor prática para proteger backups é armazenar fitas de backup em um local seguro ou fazer backup de 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 (10.0.x) e versões posteriores, a obtenção de informações sobre um conjunto ou um dispositivo de backup exige a permissão CREATE DATABASE. Para obter mais informações, confira GRANT Database Permissions (Transact-SQL).
Consulte Também
BACKUP (Transact-SQL)
Conjuntos de mídias, famílias de mídia e conjuntos de backup (SQL Server)
RESTORE REWINDONLY (Transact-SQL)
RESTORE VERIFYONLY (Transact-SQL)
RESTORE (Transact-SQL)
Informações de histórico e cabeçalho de backup (SQL Server)