Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Aplica-se a: 
SQL ServerAzure SQL Managed Instance
Devolve um conjunto de resultados contendo uma lista da base de dados e dos ficheiros de registo contidos no conjunto de backup no SQL Server.
Note
Para as descrições dos argumentos, veja RESTORE Argumentos (Transact-SQL).
Transact-SQL convenções de sintaxe
Syntax
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 }
}
Note
URL é o formato utilizado para especificar a localização e o nome do ficheiro para o Microsoft Armazenamento de Blobs do Azure e é suportado a partir do SQL Server 2012 (11.x) SP1 CU2. Embora o armazenamento Microsoft Azure seja um serviço, a implementação é semelhante ao disco e fita para permitir uma experiência de restauro consistente e fluida para os três dispositivos.
Arguments
Para descrições dos RESTORE FILELISTONLY argumentos, veja RESTORE Argumentos (Transact-SQL).
Conjuntos de resultados
Um cliente pode usar RESTORE FILELISTONLY para obter uma lista dos ficheiros contidos num conjunto de backup. Esta informação é devolvida como um conjunto de resultados contendo uma linha para cada ficheiro.
| Nome da coluna | Tipo de dados | Description |
|---|---|---|
| LogicalName | nvarchar(128) | Nome lógico do ficheiro. |
| Nome Físico | nvarchar(260) | Nome físico ou do sistema operativo do ficheiro. |
| Tipo | char(1) | O tipo de ficheiro, um dos: L = ficheiro de registo do Microsoft SQL Server D = ficheiro de dados SQL Server F = Catálogo de Texto Completo S = FileStream, FileTable ou In-Memory contentor OLTP |
| FileGroupName | nvarchar (128) NULL | Nome do grupo de ficheiros que contém o ficheiro. |
| Size | numérico(20,0) | Tamanho atual em bytes. |
| MaxSize | numérico(20,0) | Tamanho máximo permitido em bytes. |
| ID do ficheiro | bigint | Identificador de ficheiro, único dentro da base de dados. |
| CreateLSN | numérico(25,0) | Número de sequência de log no qual o ficheiro foi criado. |
| DropLSN | numérico(25,0) NULL | O número da sequência de logarista em que o ficheiro foi descartado. Se o ficheiro não tiver sido eliminado, este valor é NULL. |
| UniqueID | uniqueidentifier | Identificador globalmente único do ficheiro. |
| ReadOnlyLSN | numeric(25,0) NULL | Número de sequência de log em que o grupo de ficheiros que contém o ficheiro mudou de leitura-escrita para apenas leitura (a alteração mais recente). |
| ReadWriteLSN | numérico(25,0) NULL | Número de sequência de log em que o grupo de ficheiros contendo o ficheiro mudou de apenas leitura para leitura-escrita (a alteração mais recente). |
| BackupSizeInBytes | bigint | Tamanho do backup deste ficheiro em bytes. |
| SourceBlockSize | int | Tamanho do bloco do dispositivo físico que contém o ficheiro em bytes (não do dispositivo de backup). |
| FileGroupID | int | ID do grupo de ficheiros. |
| LogGroupGUID | Identificador único NULL | NULO. |
| DiferencialBaseLSN | numérico(25,0) NULL | Para backups diferenciais, alterações com números de sequência logarítmica maiores ou iguais ao DiferencialBaseLSN são incluídas no diferencial. Para outros tipos de backup, o valor é NULL. |
| DiferencialBaseGUID | Identificador único NULL | Para backups diferenciais, o identificador único da base diferencial. Para outros tipos de backup, o valor é NULL. |
| IsReadOnly | bit | 1 = O ficheiro é só de leitura. |
| EstáPresente | bit | 1 = O ficheiro está presente na cópia de segurança. |
| TDEThumbprint | varbinary(32) NULL | Mostra a impressão digital da Chave de Encriptação da Base de Dados. A impressão digital do encriptador é um hash SHA-1 do certificado com o qual a chave está encriptada. Para informações sobre encriptação de bases de dados, consulte Encriptação de Dados Transparente (TDE). |
| SnapshotURL | nvarchar(360) NULL |
Aplica-se a: SQL Server (SQL Server 2016 (13.x) (CU1) até à versão atual. A URL para o Azure instantâneo do ficheiro da base de dados contido no backup FILE_SNAPSHOT. Devolve NULL se não houver FILE_SNAPSHOT backup. |
Segurança
Uma operação de backup pode, opcionalmente, especificar senhas para um conjunto de mídia, um conjunto de backup ou ambos. Quando uma palavra-passe é definida num conjunto de media ou conjunto de backup, deve especificar a palavra-passe correta ou palavras-passe na RESTORE declaração. Estas palavras-passe impedem operações de restauro não autorizadas e acréscimos não autorizados de conjuntos de backup a suportes usando ferramentas do Microsoft SQL Server. No entanto, uma palavra-passe não impede a sobrescrição de conteúdos multimédia usando a BACKUP opção FORMAT da instrução.
Important
A proteção fornecida por esta senha é fraca. Destina-se a evitar uma restauração incorreta usando 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 novos trabalhos de desenvolvimento e planeje modificar aplicativos que atualmente usam esse recurso. A prática recomendada para proteger backups é armazenar 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 na raiz do diretório sob a qual os backups são criados.
Permissions
A partir do SQL Server 2008 (10.0.x), obter informações sobre um conjunto de backup ou dispositivo de backup requer CREATE DATABASE permissão. Para mais informações, consulte GRANT Permissões de Base de Dados (Transact-SQL).
Examples
O exemplo seguinte devolve a informação de um dispositivo de backup chamado AdventureWorksBackups. O exemplo utiliza a FILE opção de especificar o segundo conjunto de backup no dispositivo.
RESTORE FILELISTONLY FROM AdventureWorksBackups
WITH FILE=2;
GO
Ver também
BACKUP (Transact-SQL)
Conjuntos de Multimédia, Famílias de Media e Conjuntos de Backup (SQL Server)
RESTORE REWINDONLY (Transact-SQL)
RESTORE VERIFYONLY (Transact-SQL)
RESTORE (Transact-SQL)
Histórico de Backup e Informações de Cabeçalho (SQL Server)