RESTORE FILELISTONLY (Transact-SQL)
Retorna um conjunto de resultados que contém uma lista dos arquivos de banco de dados e de log contidos no conjunto de backup.
.gif "Observação") Observação |
|---|
Para obter descrições dos argumentos, consulte Argumentos de RESTORE (Transact-SQL). |
.gif "Ícone de vínculo de tópico")
Sintaxe
RESTORE FILELISTONLY
FROM <backup_device>
[ WITH
{
--Backup Set Options
FILE = { backup_set_file_number | @backup_set_file_number }
| PASSWORD = { password | @password_variable }
--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 de RESTORE FILELISTONLY, consulte Argumentos de RESTORE (Transact-SQL).
Conjuntos de resultados
Um cliente pode usar RESTORE FILELISTONLY para obter uma lista dos arquivos contidos em um conjunto de backups. Essas informações são retornadas como um conjunto de resultados que contém uma linha para cada arquivo.
Nome da coluna |
Tipo de dados |
Descrição |
LogicalName |
nvarchar(128) |
Nome lógico do arquivo. |
PhysicalName |
nvarchar(260) |
Nome do sistema físico ou operacional do arquivo. |
Tipo |
char(1) |
O tipo de arquivo, pode ser: L = Arquivo de log do Microsoft SQL Server D = Arquivo de dados do SQL Server F = Catálogo de texto completo |
FileGroupName |
nvarchar(128) |
Nome do grupo de arquivos que contém o arquivo. |
Size |
numeric(20,0) |
Tamanho atual em bytes. |
MaxSize |
numeric(20,0) |
Tamanho máximo permitido em bytes. |
FileID |
bigint |
Identificador de arquivo, exclusivo no banco de dados. |
CreateLSN |
numeric(25,0) |
Número da sequência de log na qual o arquivo foi criado. |
DropLSN |
numeric(25,0) NULL |
Número da sequência de log na qual o arquivo foi descartado. Se o arquivo não tiver sido descartado, esse valor será NULL. |
UniqueID |
uniqueidentifier |
Identificador exclusivo global do arquivo. |
ReadOnlyLSN |
numeric(25,0) NULL |
Número da sequência de log em que o grupo de arquivos que contém o arquivo alterado de leitura/gravação para somente leitura (a alteração mais recente). |
ReadWriteLSN |
numeric(25,0) NULL |
Número da sequência de log em que o grupo de arquivos que contém o arquivo alterado de somente leitura para leitura/gravação (a alteração mais recente). |
BackupSizeInBytes |
bigint |
Tamanho do backup do arquivo em bytes. |
SourceBlockSize |
int |
Tamanho do bloco do dispositivo físico que contém o arquivo em bytes (não o dispositivo de backup). |
FileGroupID |
int |
ID do grupo de arquivos. |
LogGroupGUID |
uniqueidentifier NULL |
NULL. |
DifferentialBaseLSN |
numeric(25,0) NULL |
Para backups diferenciais, as alterações com números de sequência de log maiores que ou iguais a DifferentialBaseLSN são incluídas no diferencial. Para outros tipos de backup, o valor é NULL. Para obter informações sobre números de sequência de log (LSNs), consulte a Introdução a Introdução aos números de seqüência de logs. |
DifferentialBaseGUID |
uniqueidentifier |
Para backups diferenciais, o identificador exclusivo da base diferencial. Para outros tipos de backup, o valor é NULL. |
IsReadOnly |
bit |
1 = O arquivo é somente leitura. |
IsPresent |
bit |
1 = O arquivo está presente no backup. |
TDEThumbprint |
varbinary(32) |
Mostra a impressão digital da Chave de Criptografia do Banco de dados. A impressão digital do criptografador é um hash SHA-1 do certificado com o qual a chave é criptografada. Para obter informações sobre a criptografia de banco de dados, consulte Compreendendo a TDE (Criptografia de Dados Transparente). |
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).
Uma operação de backup pode especificar senhas opcionalmente para um conjunto de mídias, um conjunto de backup ou ambos. Quando uma senha tiver sido definida em um conjunto de backup ou de mídias, será necessário especificar a senha ou as senhas corretas na instrução RESTORE. Essas senhas impedem operações de restauração e anexações não autorizadas 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.
.gif "Observação sobre segurança") Observação sobre segurança |
|---|
A proteção fornecida por esta senha é fraca. Ela tem o objetivo de evitar uma restauração incorreta com o uso de ferramentas do SQL Server por usuários autorizados ou não autorizados. Ela 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 em 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. |
Exemplos
O exemplo a seguir retorna informações de um dispositivo de backup denominado AdventureWorks2008R2Backups. O exemplo usa a opção FILE para especificar o segundo conjunto de backup no dispositivo.
RESTORE FILELISTONLY FROM AdventureWorks2008R2Backups
WITH FILE=2;
GO