Instruções RESTORE – FILELISTONLY (Transact-SQL)

Aplica-se a: Instância Gerenciada de SQL do Azure do SQL Server

Retorna um conjunto de resultados que contém uma lista dos arquivos do banco de dados e de log contidos no conjunto de backup no SQL Server.

Observação

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

Convenções de sintaxe de 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 }   
 | [ METADATA_ONLY | SNAPSHOT ] [ DBNAME = { database_name | @database_name_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 | 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 FILELISTONLY, confira 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

S = FileStream, FileTable ou contêiner OLTP in-memory
FileGroupName nvarchar(128) NULL Nome do grupo de arquivos que contém o arquivo.
Tamanho 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 O número de sequência de log no qual o arquivo foi removido. 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 ou iguais a DifferentialBaseLSN são incluídas no diferencial.

Para outros tipos de backup, o valor é NULL.
DifferentialBaseGUID uniqueidentifier NULL 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) NULL 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 do banco de dados, confira TDE (Transparent Data Encryption).
SnapshotURL nvarchar(360) NULL Aplica-se a: SQL Server (SQL Server 2016 (13.x) (CU1) até a versão atual.

A URL para o instantâneo do Azure do arquivo de banco de dados contido no backup FILE_SNAPSHOT. Retorna NULL se não há nenhum backup FILE_SNAPSHOT.

Segurança

Uma operação de backup pode, opcionalmente, especificar senhas 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 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 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 (10.0.x), para obter informações sobre um conjunto ou um dispositivo de backup, é necessário ter a permissão CREATE DATABASE. Para obter mais informações, confira 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

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)