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

APLICA-SE A: simSQL Server simBanco de Dados SQL do Azure (somente a Instância Gerenciada) nãoSQL Data Warehouse do Azure nãoParallel Data Warehouse APPLIES TO: yesSQL Server yesAzure SQL Database (Managed Instance only) noAzure SQL Data Warehouse noParallel Data Warehouse

Retorna um conjunto de resultados que contém uma lista dos arquivos de banco de dados e de log contidos no conjunto de backup no SQL ServerSQL Server.Returns a result set containing a list of the database and log files contained in the backup set in SQL ServerSQL Server.

Observação

Para obter as descrições dos argumentos, consulte Argumentos de RESTORE (Transact-SQL).For the descriptions of the arguments, see RESTORE Arguments (Transact-SQL).

Ícone de link do tópico Convenções de sintaxe de Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintaxeSyntax

  
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 | 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)SQL Server 2012 (11.x) SP1 CU2.URL is the format used to specify the location and the file name for Microsoft Azure Blob Storage and is supported starting with SQL Server 2012 (11.x)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.Although Microsoft Azure storage is a service, the implementation is similar to disk and tape to allow for a consistent and seamless restore experience for all the three devices.

ArgumentosArguments

Para obter descrições dos argumentos de RESTORE FILELISTONLY, consulte Argumentos de RESTORE (Transact-SQL).For descriptions of the RESTORE FILELISTONLY arguments, see RESTORE Arguments (Transact-SQL).

Conjuntos de resultadosResult Sets

Um cliente pode usar RESTORE FILELISTONLY para obter uma lista dos arquivos contidos em um conjunto de backups.A client can use RESTORE FILELISTONLY to obtain a list of the files contained in a backup set. Essas informações são retornadas como um conjunto de resultados que contém uma linha para cada arquivo.This information is returned as a result set containing one row for each file.

Nome da colunaColumn name Tipo de dadosData type DescriçãoDescription
LogicalNameLogicalName nvarchar(128)nvarchar(128) Nome lógico do arquivo.Logical name of the file.
PhysicalNamePhysicalName nvarchar(260)nvarchar(260) Nome do arquivo físico ou do sistema operacional.Physical or operating-system name of the file.
TipoType char(1)char(1) O tipo de arquivo, um dentre:The type of file, one of:

L = arquivo de log do Microsoft SQL ServerSQL ServerL = Microsoft SQL ServerSQL Server log file

D = arquivo de dados do SQL ServerSQL ServerD = SQL ServerSQL Server data file

F = Catálogo de Texto CompletoF = Full Text Catalog

S = FileStream, FileTable ou contêiner do OLTP na memóriaIn-Memory OLTPS = FileStream, FileTable, or OLTP na memóriaIn-Memory OLTP container
FileGroupNameFileGroupName nvarchar(128) NULLnvarchar(128) NULL Nome do grupo de arquivos que contém o arquivo.Name of the filegroup that contains the file.
TamanhoSize numeric(20,0)numeric(20,0) Tamanho atual em bytes.Current size in bytes.
MaxSizeMaxSize numeric(20,0)numeric(20,0) Tamanho máximo permitido em bytes.Maximum allowed size in bytes.
FileIDFileID bigintbigint Identificador de arquivo, exclusivo no banco de dados.File identifier, unique within the database.
CreateLSNCreateLSN numeric(25,0)numeric(25,0) Número da sequência de log na qual o arquivo foi criado.Log sequence number at which the file was created.
DropLSNDropLSN numeric(25,0) NULLnumeric(25,0) NULL O número de sequência de log no qual o arquivo foi removido.The log sequence number at which the file was dropped. Se o arquivo não tiver sido descartado, esse valor será NULL.If the file has not been dropped, this value is NULL.
UniqueIDUniqueID uniqueidentifieruniqueidentifier Identificador exclusivo global do arquivo.Globally unique identifier of the file.
ReadOnlyLSNReadOnlyLSN numeric(25,0) NULLnumeric(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).Log sequence number at which the filegroup containing the file changed from read-write to read-only (the most recent change).
ReadWriteLSNReadWriteLSN numeric(25,0) NULLnumeric(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).Log sequence number at which the filegroup containing the file changed from read-only to read-write (the most recent change).
BackupSizeInBytesBackupSizeInBytes bigintbigint Tamanho do backup do arquivo em bytes.Size of the backup for this file in bytes.
SourceBlockSizeSourceBlockSize intint Tamanho do bloco do dispositivo físico que contém o arquivo em bytes (não o dispositivo de backup).Block size of the physical device containing the file in bytes (not the backup device).
FileGroupIDFileGroupID intint ID do grupo de arquivos.ID of the filegroup.
LogGroupGUIDLogGroupGUID uniqueidentifier NULLuniqueidentifier NULL NULL.NULL.
DifferentialBaseLSNDifferentialBaseLSN numeric(25,0) NULLnumeric(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.For differential backups, changes with log sequence numbers greater than or equal to DifferentialBaseLSN are included in the differential.

Para outros tipos de backup, o valor é NULL.For other backup types, the value is NULL.
DifferentialBaseGUIDDifferentialBaseGUID uniqueidentifier NULLuniqueidentifier NULL Para backups diferenciais, o identificador exclusivo da base diferencial.For differential backups, the unique identifier of the differential base.

Para outros tipos de backup, o valor é NULL.For other backup types, the value is NULL.
IsReadOnlyIsReadOnly bitbit 1 = O arquivo é somente leitura.1 = The file is read-only.
IsPresentIsPresent bitbit 1 = O arquivo está presente no backup.1 = The file is present in the backup.
TDEThumbprintTDEThumbprint varbinary(32) NULLvarbinary(32) NULL Mostra a impressão digital da Chave de Criptografia do Banco de dados.Shows the thumbprint of the Database Encryption Key. A impressão digital do criptografador é um hash SHA-1 do certificado com o qual a chave é criptografada.The encryptor thumbprint is a SHA-1 hash of the certificate with which the key is encrypted. Para obter informações sobre a criptografia de banco de dados, consulte TDE (Transparent Data Encryption).For information about database encryption, see Transparent Data Encryption (TDE).
SnapshotURLSnapshotURL nvarchar(360) NULLnvarchar(360) NULL A URL para o instantâneo do Azure do arquivo de banco de dados contido no backup FILE_SNAPSHOT.The URL for the Azure snapshot of the database file contained in the FILE_SNAPSHOT backup. Retorna NULL se não há nenhum backup FILE_SNAPSHOT.Returns NULL if no FILE_SNAPSHOT backup.

SegurançaSecurity

Uma operação de backup pode, opcionalmente, especificar senhas para um conjunto de mídias, um conjunto de backup ou ambos.A backup operation may optionally specify passwords for a media set, a backup set, or both. 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.When a password has been defined on a media set or backup set, you must specify the correct password or passwords in the RESTORE statement. Essas senhas impedem operações de restauração e anexações não autorizadas de conjuntos de backup em uma mídia usando ferramentas do MicrosoftMicrosoft SQL ServerSQL Server.These passwords prevent unauthorized restore operations and unauthorized appends of backup sets to media using MicrosoftMicrosoft SQL ServerSQL Server tools. Porém, uma senha não impede a substituição da mídia usando a opção FORMAT da instrução BACKUP.However, a password does not prevent overwrite of media using the BACKUP statement's FORMAT option.

Importante

A proteção fornecida por esta senha é fraca.The protection provided by this password is weak. Destina-se a evitar uma restauração incorreta com o uso de ferramentas de SQL ServerSQL Server por usuários autorizados ou não autorizados.It is intended to prevent an incorrect restore using SQL ServerSQL Server tools by authorized or unauthorized users. Não impede a leitura dos dados de backup por outros meios ou a substituição da senha.It does not prevent the reading of the backup data by other means or the replacement of the password. Este recurso está em modo de manutenção e talvez seja removido em uma versão futura do Microsoft SQL Server.This feature is in maintenance mode and may be removed in a future version of Microsoft SQL Server. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam.Avoid using this feature in new development work, and plan to modify applications that currently use this feature. 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.The best practice for protecting backups is to store backup tapes in a secure location or back up to disk files that are protected by adequate access control lists (ACLs). As ACLs devem ser definidas no diretório raiz em que os backups são criados.The ACLs should be set on the directory root under which backups are created.

PermissõesPermissions

A partir do SQL Server 2008SQL Server 2008, para obter informações sobre um conjunto ou dispositivo de backup, é necessário ter a permissão CREATE DATABASE.Beginning in SQL Server 2008SQL Server 2008, obtaining information about a backup set or backup device requires CREATE DATABASE permission. Para obter mais informações, veja GRANT Database Permissions (Transact-SQL).For more information, see GRANT Database Permissions (Transact-SQL).

ExemplosExamples

O exemplo a seguir retorna informações de um dispositivo de backup denominado AdventureWorksBackups.The following example returns the information from a backup device named AdventureWorksBackups. O exemplo usa a opção FILE para especificar o segundo conjunto de backup no dispositivo.The example uses the FILE option to specify the second backup set on the device.

RESTORE FILELISTONLY FROM AdventureWorksBackups   
   WITH FILE=2;  
GO  

Consulte TambémSee Also

BACKUP (Transact-SQL) BACKUP (Transact-SQL)
Conjuntos de mídias, famílias de mídia e conjuntos de backup (SQL Server) Media Sets, Media Families, and Backup Sets (SQL Server)
RESTORE REWINDONLY (Transact-SQL) RESTORE REWINDONLY (Transact-SQL)
RESTORE VERIFYONLY (Transact-SQL) RESTORE VERIFYONLY (Transact-SQL)
RESTORE (Transact-SQL) RESTORE (Transact-SQL)
Informações de histórico e cabeçalho de backup (SQL Server)Backup History and Header Information (SQL Server)