Instrucciones RESTORE: FILELISTONLY (Transact-SQL)RESTORE Statements - FILELISTONLY (Transact-SQL)

SE APLICA A: síSQL Server síAzure SQL Database (solo Instancia administrada) noAzure SQL Data Warehouse noAlmacenamiento de datos paralelos APPLIES TO: yesSQL Server yesAzure SQL Database (Managed Instance only) noAzure SQL Data Warehouse noParallel Data Warehouse

Devuelve un conjunto de resultados que contiene una lista con los archivos de base de datos y de registro del conjunto de copia de seguridad de 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.

Nota

Para obtener las descripciones de los argumentos, vea Argumentos de RESTORE (Transact-SQL).For the descriptions of the arguments, see RESTORE Arguments (Transact-SQL).

Icono de vínculo de tema Convenciones de sintaxis de Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintaxisSyntax

  
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 }   
}  
  

Nota

URL es el formato que se usa para especificar la ubicación y el nombre del archivo para Microsoft Azure Blob Storage y se admite a partir de 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. Aunque Microsoft Azure Storage es un servicio, la implementación es similar al disco y la cinta para permitir una experiencia de restauración coherente y sin problemas para los tres 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 obtener las descripciones de los argumentos de RESTORE FILELISTONLY, vea Argumentos de RESTORE (Transact-SQL).For descriptions of the RESTORE FILELISTONLY arguments, see RESTORE Arguments (Transact-SQL).

Conjuntos de resultadosResult Sets

Un cliente puede utilizar RESTORE FILELISTONLY para obtener una lista de los archivos que contiene el conjunto de copia de seguridad.A client can use RESTORE FILELISTONLY to obtain a list of the files contained in a backup set. Esta información se devuelve como conjunto de resultados que contiene una fila por cada archivo.This information is returned as a result set containing one row for each file.

Nombre de columnaColumn name Tipo de datosData type DescripciónDescription
LogicalNameLogicalName nvarchar(128)nvarchar(128) Nombre lógico del archivo.Logical name of the file.
PhysicalNamePhysicalName nvarchar(260)nvarchar(260) Nombre físico o del sistema operativo del archivo.Physical or operating-system name of the file.
TipoType char(1)char(1) Uno de los tipos de archivo:The type of file, one of:

L = archivo de registro de Microsoft SQL ServerSQL ServerL = Microsoft SQL ServerSQL Server log file

D = archivo de datos de SQL ServerSQL ServerD = SQL ServerSQL Server data file

F = catálogo de texto completoF = Full Text Catalog

S = FileStream, FileTable o contenedor OLTP en memoriaIn-Memory OLTPS = FileStream, FileTable, or OLTP en memoriaIn-Memory OLTP container
FileGroupNameFileGroupName nvarchar(128) NULLnvarchar(128) NULL Nombre del grupo de archivos que contiene el archivo.Name of the filegroup that contains the file.
TamañoSize numeric(20,0)numeric(20,0) Tamaño actual, en bytes.Current size in bytes.
MaxSizeMaxSize numeric(20,0)numeric(20,0) Tamaño máximo permitido, en bytes.Maximum allowed size in bytes.
FileIDFileID bigintbigint Identificador de archivo, único en la base de datos.File identifier, unique within the database.
CreateLSNCreateLSN numeric(25,0)numeric(25,0) Número de secuencia de registro en el que se creó el archivo.Log sequence number at which the file was created.
DropLSNDropLSN numeric(25,0) NULLnumeric(25,0) NULL Número de secuencia de registro en que se quitó el archivo.The log sequence number at which the file was dropped. Si el archivo no se ha quitado, este valor es NULL.If the file has not been dropped, this value is NULL.
UniqueIDUniqueID uniqueidentifieruniqueidentifier Identificador único global del archivo.Globally unique identifier of the file.
ReadOnlyLSNReadOnlyLSN numeric(25,0) NULLnumeric(25,0) NULL Número de flujo de registro en el que el grupo de archivos que contiene el archivo cambió de lectura/escritura a solo lectura (el cambio más reciente).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 de secuencia de registro en el que el grupo de archivos que contiene el archivo cambió de solo lectura a lectura/escritura (el cambio más reciente).Log sequence number at which the filegroup containing the file changed from read-only to read-write (the most recent change).
BackupSizeInBytesBackupSizeInBytes bigintbigint Tamaño en bytes de la copia de seguridad de este archivo.Size of the backup for this file in bytes.
SourceBlockSizeSourceBlockSize intint Tamaño de bloque (en bytes) del dispositivo físico que contiene el archivo (no el dispositivo de copia de seguridad).Block size of the physical device containing the file in bytes (not the backup device).
FileGroupIDFileGroupID intint Id. del grupo de archivos.ID of the filegroup.
LogGroupGUIDLogGroupGUID uniqueidentifier NULLuniqueidentifier NULL NULL.NULL.
DifferentialBaseLSNDifferentialBaseLSN numeric(25,0) NULLnumeric(25,0) NULL En el caso de las copias de seguridad diferenciales, los cambios cuyo número de secuencia de registro sea mayor o igual que DifferentialBaseLSN se incluyen en la copia diferencial.For differential backups, changes with log sequence numbers greater than or equal to DifferentialBaseLSN are included in the differential.

Para otros tipos de copia de seguridad, el valor es NULL.For other backup types, the value is NULL.
DifferentialBaseGUIDDifferentialBaseGUID uniqueidentifier NULLuniqueidentifier NULL Identificador único de la base diferencial, en el caso de las copias de seguridad diferenciales.For differential backups, the unique identifier of the differential base.

Para otros tipos de copia de seguridad, el valor es NULL.For other backup types, the value is NULL.
IsReadOnlyIsReadOnly bitbit 1 = El archivo es de solo lectura.1 = The file is read-only.
IsPresentIsPresent bitbit 1 = El archivo se encuentra en la copia de seguridad.1 = The file is present in the backup.
TDEThumbprintTDEThumbprint varbinary(32) NULLvarbinary(32) NULL Muestra la huella digital de la clave de cifrado de base de datos.Shows the thumbprint of the Database Encryption Key. La huella digital de la clave de cifrado es el valor hash SHA-1 del certificado con el que se cifra la clave.The encryptor thumbprint is a SHA-1 hash of the certificate with which the key is encrypted. Para más información sobre el cifrado de bases de datos, vea Cifrado de datos transparente (TDE).For information about database encryption, see Transparent Data Encryption (TDE).
SnapshotURLSnapshotURL nvarchar(360) NULLnvarchar(360) NULL Dirección URL de la instantánea de Azure del archivo de base de datos incluido en la copia de seguridad de FILE_SNAPSHOT.The URL for the Azure snapshot of the database file contained in the FILE_SNAPSHOT backup. Devuelve NULL si no hay ninguna copia de seguridad de FILE_SNAPSHOT.Returns NULL if no FILE_SNAPSHOT backup.

SeguridadSecurity

La operación de copia de seguridad puede especificar opcionalmente contraseñas para un conjunto de medios, para un conjunto de copia de seguridad o para ambos.A backup operation may optionally specify passwords for a media set, a backup set, or both. Si se ha definido una contraseña en un conjunto de medios o un conjunto de copia de seguridad, debe especificar la contraseña o contraseñas correctas en la instrucción 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. Estas contraseñas impiden operaciones de restauración y anexiones no autorizadas de los conjuntos de copia de seguridad en medios que usan herramientas de MicrosoftMicrosoft SQL ServerSQL Server.These passwords prevent unauthorized restore operations and unauthorized appends of backup sets to media using MicrosoftMicrosoft SQL ServerSQL Server tools. No obstante, la contraseña no impide que se sobrescriba el medio con la opción FORMAT de la instrucción BACKUP.However, a password does not prevent overwrite of media using the BACKUP statement's FORMAT option.

Importante

El nivel de protección que proporciona esta contraseña es bajo.The protection provided by this password is weak. El objetivo es impedir una restauración incorrecta con las herramientas de SQL ServerSQL Server, ya sea por parte de usuarios autorizados o no autorizados.It is intended to prevent an incorrect restore using SQL ServerSQL Server tools by authorized or unauthorized users. No impide la lectura de los datos de las copias de seguridad por otros medios o el reemplazo de la contraseña.It does not prevent the reading of the backup data by other means or the replacement of the password. Esta característica está en modo de mantenimiento y es posible que no se incluya en una versión futura de Microsoft SQL Server.This feature is in maintenance mode and may be removed in a future version of Microsoft SQL Server. Evite utilizar esta característica en nuevos trabajos de desarrollo y tenga previsto modificar las aplicaciones que actualmente la utilizan.Avoid using this feature in new development work, and plan to modify applications that currently use this feature. La práctica recomendada para proteger las copias de seguridad consiste en almacenar las cintas de copia de seguridad en una ubicación segura o hacer una copia de seguridad en archivos de disco protegidos mediante las listas de control de acceso (ACL) adecuadas.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). Las ACL se deben establecer en el directorio raíz en el que se crean las copias de seguridad.The ACLs should be set on the directory root under which backups are created.

PermisosPermissions

A partir de SQL Server 2008SQL Server 2008, para obtener información sobre un conjunto de copia de seguridad o un dispositivo de copia de seguridad, es necesario el permiso CREATE DATABASE.Beginning in SQL Server 2008SQL Server 2008, obtaining information about a backup set or backup device requires CREATE DATABASE permission. Para obtener más información, vea GRANT (permisos de base de datos de Transact-SQL).For more information, see GRANT Database Permissions (Transact-SQL).

EjemplosExamples

En el siguiente ejemplo se devuelve la información de un dispositivo de copia de seguridad denominado AdventureWorksBackups.The following example returns the information from a backup device named AdventureWorksBackups. El ejemplo utiliza la opción FILE para especificar el segundo conjunto de copias de seguridad del 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 tambiénSee Also

BACKUP (Transact-SQL) BACKUP (Transact-SQL)
Conjuntos de medios, familias de medios y conjuntos de copias de seguridad (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)
Historial de copias de seguridad e información de encabezados (SQL Server)Backup History and Header Information (SQL Server)