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.

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

Convenções da sintaxe Transact-SQL

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 arquivo físico ou do sistema operacional.
Type	char(1)	O tipo de arquivo, um dentre: 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 de sequência de log no 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, na qual o grupo de arquivos que contém o arquivo, foi 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, na qual o grupo de arquivos que contém o arquivo, foi 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 igual a DifferentialBaseLSN serão incluídas no diferencial. Para outros tipos de backup, o valor é NULL.
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 Criptografia de Dados Transparente (TDE).

Segurança

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

Permissões

A partir do SQL Server 2008, 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).

Exemplos

O exemplo a seguir retorna informações de um dispositivo de backup denominado AdventureWorksBackups. O exemplo usa a opção FILE para especificar o segundo conjunto de backup no dispositivo.

RESTORE FILELISTONLY FROM AdventureWorksBackups 
   WITH FILE=2;
GO

Consulte também

Referência

BACKUP (Transact-SQL)

RESTORE REWINDONLY (Transact-SQL)

RESTORE VERIFYONLY (Transact-SQL)

RESTORE (Transact-SQL)

Conceitos

Conjuntos de mídias, famílias de mídia e conjuntos de backup (SQL Server)

Informações de histórico e cabeçalho de backup (SQL Server)