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).
.gif "Icono de vínculo a temas")
Convenciones de sintaxis de Transact-SQL
Sintaxis
RESTORE FILELISTONLY
FROM <backup_device>
[ WITH
[ { CHECKSUM | NO_CHECKSUM } ]
[ [ , ] { CONTINUE_AFTER_ERROR | STOP_ON_ERROR } ]
[ [ , ] FILE = backup_set_file_number ]
[ [ , ] MEDIANAME = { media_name | @media_name_variable } ]
[ [ , ] MEDIAPASSWORD = { mediapassword |
@mediapassword_variable } ]
[ [ , ] PASSWORD = { password | @password_variable } ]
[ [ , ] REWIND ]
[ [ , ] { UNLOAD | NOUNLOAD } ]
]
[;]
<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 descripciones 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 |
FileGroupName |
nvarchar(128) |
Nombre del grupo de archivos que contiene el archivo. |
Size |
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 |
Id. 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. |
Permisos
Cualquier usuario puede utilizar RESTORE FILELISTONLY.
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 Microsoft SQL Server 2005. No obstante, la contraseña no impide que se sobrescriba el medio con la opción FORMAT de la instrucción BACKUP.
.gif "ms173778.security(es-es,SQL.90).gif") Nota de seguridad: |
|---|
| El nivel de protección que proporciona esta contraseña es bajo. Está diseñado para impedir que los usuarios autorizados o no autorizados realicen una restauración incorrecta con las herramientas de SQL Server 2005. No impide la lectura de los datos de las copias de seguridad por otros medios o el reemplazo de la contraseña. 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 llamado 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
Vea también
Referencia
BACKUP (Transact-SQL)
RESTORE REWINDONLY (Transact-SQL)
RESTORE VERIFYONLY (Transact-SQL)
RESTORE (Transact-SQL)
Otros recursos
Conjuntos de medios, familias de medios y conjuntos de copias de seguridad
Ver información acerca de las copias de seguridad
Introducción a los números de secuencia de registro