Compartir a través de

  • Artículo

RESTORE FILELISTONLY (Transact-SQL)

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.

[!NOTA]

Para obtener descripciones de los argumentos, vea RESTORE (argumentos, Transact-SQL).

Icono de vínculo a temasConvenciones de sintaxis de Transact-SQL

Sintaxis

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 obtener la descripción de los argumentos de RESTORE FILELISTONLY, vea RESTORE (argumentos, Transact-SQL).

Conjuntos de resultados

Un cliente puede utilizar RESTORE FILELISTONLY para obtener una lista de los archivos que contiene el conjunto de copia de seguridad. Esta información se devuelve como un conjunto de resultados que contiene una fila por cada archivo.

Nombre de columna

Tipo de datos

Descripción

LogicalName

nvarchar(128)

Nombre lógico del archivo.

PhysicalName

nvarchar(260)

Nombre físico o del sistema operativo del archivo.

Type

char(1)

Uno de los tipos de archivo:

L = archivo de registro de Microsoft SQL Server

D = archivo de datos de SQL Server

F = catálogo de texto completo

FileGroupName

nvarchar(128)

Nombre del grupo de archivos que contiene el archivo.

Tamaño

numeric(20,0)

Tamaño actual, en bytes.

MaxSize

numeric(20,0)

Tamaño máximo permitido, en bytes.

FileID

bigint

Identificador de archivo, único en la base de datos.

CreateLSN

numeric(25,0)

Número de secuencia de registro en que se creó el archivo.

DropLSN

numeric(25,0) NULL

Número de secuencia de registro en que se quitó el archivo. Si el archivo no se ha quitado, este valor es NULL.

UniqueID

uniqueidentifier

Identificador único global del archivo.

ReadOnlyLSN

numeric(25,0) NULL

Número de secuencia de registro en el que el grupo de archivos que contiene el archivo cambió de lectura y escritura a sólo lectura (el cambio más reciente).

ReadWriteLSN

numeric(25,0) NULL

Número de secuencia de registro en el que el grupo de archivos que contiene el archivo cambió de sólo lectura a lectura y escritura (el cambio más reciente).

BackupSizeInBytes

bigint

Tamaño en bytes de la copia de seguridad de este archivo.

SourceBlockSize

int

Tamaño de bloque (en bytes) del dispositivo físico que contiene el archivo (no el dispositivo de copia de seguridad).

FileGroupID

int

Identificador del grupo de archivos.

LogGroupGUID

uniqueidentifier NULL

NULL.

DifferentialBaseLSN

numeric(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.

Para otros tipos de copia de seguridad, el valor es NULL.

Para obtener información acerca de los números de secuencia de registro (LSN), vea la introducción a Introducción a los números de secuencia de registro.

DifferentialBaseGUID

uniqueidentifier

Identificador único de la base diferencial, en el caso de las copias de seguridad diferenciales.

Para otros tipos de copia de seguridad, el valor es NULL.

IsReadOnly

bit

1 = El archivo es de sólo lectura.

IsPresent

bit

1 = El archivo se encuentra en la copia de seguridad.

TDEThumbprint

varbinary(32)

Muestra la huella digital de la clave de cifrado de base de datos. La huella digital de la clave de cifrado es el valor hash SHA-1 del certificado con el que se cifra la clave. Para obtener información acerca del cifrado de bases de datos, vea Descripción del Cifrado de datos transparente (TDE).

Permisos

En SQL Server 2008 y versiones posteriores, la obtención de información sobre un conjunto de copia de seguridad o un dispositivo de copia de seguridad requiere el permiso CREATE DATABASE. Para obtener más información, vea GRANT (permisos de base de datos de Transact-SQL).

La operación de copia de seguridad puede especificar opcionalmente contraseñas de un conjunto de medios, de un conjunto de copia de seguridad o de ambos. 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. Estas contraseñas impiden operaciones de restauración y anexiones no autorizadas de los conjuntos de copia de seguridad en medios que utilizan herramientas de MicrosoftSQL Server. No obstante, la contraseña no impide que se sobrescriba el medio con la opción FORMAT de la instrucción BACKUP.

Nota de seguridadNota de seguridad

El nivel de protección que proporciona esta contraseña es bajo. El objetivo es impedir una restauración incorrecta mediante las herramientas de SQL Server ya sea por parte de usuarios autorizados o no autorizados. No impide la lectura de los datos de las copias de seguridad por otros medios o el reemplazo de la contraseña. Esta característica se quitará en una versión futura de Microsoft SQL Server. Evite utilizar esta característica en nuevos trabajos de desarrollo y tenga previsto modificar las aplicaciones que actualmente la utilizan. 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. Las ACL se deben establecer en el directorio raíz en el que se crean las copias de seguridad.

Ejemplos

El siguiente ejemplo devuelve la información de un dispositivo de copia de seguridad denominado AdventureWorksBackups. El ejemplo utiliza la opción FILE para especificar el segundo conjunto de copias de seguridad del dispositivo.

RESTORE FILELISTONLY FROM AdventureWorksBackups 
   WITH FILE=2;
GO

Historial de cambios

Contenido actualizado

Se agregó la columna TDEThumbprint a la tabla "Conjuntos de resultados".