RESTORE Enunciados - Argumentos (Transact-SQL)

Se aplica a:SQL Server

Este artículo documenta los argumentos que se describen en las secciones de Sintaxis del RESTORE {DATABASE|LOG} y del conjunto asociado de sentencias auxiliares: RESTORERESTORE FILELISTONLY,RESTORE HEADERONLYRESTORE ,RESTORE LABELONLYRESTORE ,RESTORE REWINDONLYRESTORE , y .RESTORERESTORE VERIFYONLY Solo un subconjunto de estas seis instrucciones admite la mayoría de los argumentos. En la descripción del argumento se indica si éste está admitido.

Convenciones de sintaxis de Transact-SQL

Sintaxis

Para comprobar la sintaxis, vea los siguientes artículos:

• RESTORE (Transact-SQL)

• RESTORE FILELISTONLY (Transact-SQL)

• RESTORE HEADERONLY (Transact-SQL)

• RESTORE LABELONLY (Transact-SQL)

• RESTORE REWINDONLY (Transact-SQL)

• RESTORE VERIFYONLY (Transact-SQL)

Argumentos

DATABASE

Apoyado por:RESTORE

Especifica la base de datos de destino. Si se especifica una lista de archivos o de grupos de archivos, solo se restauran esos archivos y grupos de archivos.

En el caso de una base de datos que utilice el modelo de recuperación completa o el modelo de recuperación optimizado para cargas masivas de registros, SQL Server requiere en la mayoría de los casos que realice una copia de seguridad de registros después del error antes de restaurar la base de datos. Restaurar una base de datos sin hacer antes una copia de seguridad de la cola del registro resulta en un error, a menos que la RESTOREDATABASE instrucción contenga la cláusula WITH REPLACE o la cláusula WITH STOPAT, que debe especificar un tiempo o transacción que ocurrió tras el final de la copia de seguridad. Para obtener más información sobre las copias del final del registro, vea Copias del final del registro (SQL Server).

REGISTRO

Apoyado por:RESTORE

Especifica que se va a aplicar una copia de seguridad de registros de transacciones a esta base de datos. Los registros de transacciones deben aplicarse en orden secuencial. SQL Server comprueba el registro de transacciones del que se ha realizado la copia de seguridad para asegurarse de que las transacciones se cargan en la base de datos y en la secuencia correctas. Para aplicar varios registros de transacciones, utilice la opción NORECOVERY en todas las operaciones de restauración, excepto en la última.

Para obtener más información, vea Aplicar copias de seguridad del registro de transacciones (SQL Server).

{ database_name | @database_name_var }

Apoyado por:RESTORE

Es la base de datos en la que se restaura el registro o la base de datos completa. Si se proporciona como una variable (@database_name_var), este nombre se puede especificar como una constante de cadena (@database_name_var = database_name) o como una variable de un tipo de datos de cadena de caracteres, excepto los tipos de datos ntext o text.

< > file_or_filegroup_or_page [ ,... n ]

Apoyado por:RESTORE

Especifica el nombre de un archivo, grupo de archivos o página lógico que debe incluir en una RESTOREDATABASE instrucción o RESTORE LOG. Puede especificar una lista de archivos o grupos de archivos.

En una base de datos que usa el modelo de recuperación simple, las opciones FILE y FILEGROUP solo se admiten si los archivos o grupos de archivos de destino son de solo lectura, o bien si se trata de una restauración de tipo PARTIAL (el resultado es un grupo de archivos inactivo).

Para una base de datos que utiliza el modelo de recuperación completo o con registro masivo, después de restaurar RESTOREDATABASE uno o más archivos, grupos de archivos y/o páginas, normalmente debes aplicar el registro de transacciones a los archivos que contienen los datos restaurados; aplicar el registro hace que esos archivos sean consistentes con el resto de la base de datos. Existen las siguientes excepciones:

• Si los archivos que se restauran eran de solo lectura antes de la última copia de seguridad, entonces no es necesario aplicar un registro de transacciones, y el RESTORE extracto te informa de esta situación.

• Si la copia de seguridad contiene el grupo de archivos principal y se va a realizar una restauración parcial. En este caso, el registro de restauración no es necesario, porque se restaura automáticamente desde el conjunto de copia de seguridad.

ARCHIVO = { logical_file_name_in_backup | @logical_file_name_in_backup_var }

Especifica el nombre de un archivo que se va a incluir en la restauración de la base de datos.

FILEGROUP = { logical_filegroup_name | @logical_filegroup_name_var }

Especifica el nombre de un grupo de archivos que se va a incluir en la restauración de la base de datos.

FILEGROUP solo se admite en el modelo de recuperación simple si el grupo de archivos especificado es de solo lectura y se trata de una restauración parcial, es decir, si se usa WITH PARTIAL. Los grupos de archivos de lectura y escritura sin restaurar se marcan como inactivos y, en consecuencia, no se podrán restaurar en la base de datos resultante.

READ_WRITE_FILEGROUPS

Selecciona todos los grupos de archivos de lectura y escritura. Esta opción es especialmente útil cuando se desean restaurar grupos de archivos de solo lectura después de los grupos de archivos de lectura y escritura anteriores a los grupos de archivos de solo lectura.

PAGE = 'file:page [ ,... n ]'

Especifica una lista de una o varias páginas para una restauración de página (que solo se admite en bases de datos que utilizan los modelos de recuperación completa o de recuperación optimizado para cargas masivas de registros). Éstos son sus valores:

PAGE
Indica una lista de uno o varios archivos y páginas.

file
Es el Id. del archivo que contiene la página específica que se va a restaurar.

page
Es el Id. de la página que se va a restaurar en el archivo.

n
Es un marcador de posición que indica que se pueden especificar varias páginas.

El número máximo de páginas que se pueden restaurar en cualquier archivo único en una secuencia de restauración es 1000. Sin embargo, si la cantidad de páginas dañadas en un archivo no es pequeña, plantéese restaurar el archivo entero en lugar de las páginas.

Para más información sobre la restauración de páginas, vea Restaurar páginas (SQL Server).

[ , ...n ]
Es un marcador de posición que indica que se pueden especificar varios archivos y grupos de archivos y páginas en una lista separada por comas. El número es ilimitado.

FROM { <backup_device> [ ,... n ] | <> database_snapshot }

Normalmente, especifica los dispositivos de copia de seguridad desde los que se restaurará la copia de seguridad. Alternativamente, en una RESTOREDATABASE sentencia, la cláusula FROM puede especificar el nombre de una instantánea de la base de datos a la que se está revirtiendo la base de datos, en cuyo caso no se permite ninguna cláusula WITH.

Si se omite la cláusula FROM, no se produce la restauración de la copia de seguridad. En su lugar, se recupera la base de datos. Esto permite recuperar una base de datos restaurada con la opción NORECOVERY o cambiar a un servidor en espera. Si se omite la cláusula FROM, se debe especificar NORECOVERY, RECOVERY o STANDBY en la cláusula WITH.

< > backup_device [ ,... n ]

Especifica los dispositivos de copia de seguridad físicos o lógicos que se utilizarán para la operación de restauración.

Apoyado por:RESTORE, RESTORE FILELISTONLY, RESTORE HEADERONLY, RESTORE LABELONLY, RESTORE REWINDONLY, y RESTORE VERIFYONLY.

<backup_device>::= Especifica el dispositivo de copia de seguridad físico o lógico que se va a usar en la operación de copia de seguridad, así:

{ logical_backup_device_name | @logical_backup_device_name_var }
Es el nombre lógico, que debe seguir las reglas de los identificadores, de los dispositivos de copia de seguridad creados por sp_addumpdevice desde los que se restaura la base de datos. Si se proporciona como una variable (@logical_backup_device_name_var), el nombre del dispositivo de copia de seguridad se puede especificar como una constante de cadena (@logical_backup_device_name_var = logical_backup_device_name) o como una variable de tipo de datos de cadena de caracteres, excepto los tipos de datos ntext o text.

{DISK | TAPE } = { 'physical_backup_device_name'physical_backup_device_name_var | @ }
Permite restaurar las copias de seguridad guardadas en el dispositivo de disco o cinta con nombre. Los tipos de dispositivo de disco y cinta deben especificarse con el nombre real (por ejemplo, nombre de archivo y ruta de acceso completa) del dispositivo: DISK ='Z:\SQLServerBackups\AdventureWorks.bak' o TAPE ='\\\\.\TAPE0'. Si se especifica como una variable (@physical_backup_device_name_var), el nombre del dispositivo se puede especificar como una constante de cadena (@physical_backup_device_name_var = "physical_backup_device_name") o como una variable de tipo de datos de cadena de caracteres, excepto los tipos de datos ntext o text.

Si utiliza un servidor de red con un nombre UNC (que debe contener el nombre del equipo), especifique un tipo de dispositivo de disco. Para más información sobre cómo usar los nombres UNC, vea Dispositivos de copia de seguridad (SQL Server).

La cuenta bajo la que ejecutas SQL Server debe tener acceso READ al ordenador remoto o al servidor de red para poder realizar una RESTORE operación.

n
Es un marcador de posición que indica que se pueden especificar hasta 64 dispositivos de copia de seguridad en una lista separada por comas.

El hecho de que una secuencia de restauración requiera tantos dispositivos de copia de seguridad como los utilizados para crear el conjunto de medios al que pertenecen las copias de seguridad depende de si la restauración se realiza sin conexión o en línea de la forma siguiente.

• La restauración sin conexión permite restaurar una copia de seguridad con menos dispositivos que los utilizados para crear la copia de seguridad.

• La restauración en línea necesita todos los dispositivos de copia de seguridad para la copia de seguridad. Si se intenta la restauración con menos dispositivos, se obtiene un error.

Por ejemplo, suponga que se realiza la copia de seguridad de una base de datos en cuatro unidades de cinta conectadas al servidor. Una restauración en línea requiere que las cuatro unidades estén conectadas al servidor, mientras que una restauración sin conexión permite restaurar la copia de seguridad con menos de cuatro unidades en el equipo.

< >database_snapshot::=

Apoyado por:RESTORE DATABASE

= DATABASE_SNAPSHOT database_snapshot_name
Revierte la base de datos a la instantánea de base de datos especificada por database_snapshot_name. La opción DATABASE_SNAPSHOT solo está disponible para una restauración de base de datos completa. En una operación de reversión, la instantánea de base de datos ocupa el lugar de una copia de seguridad de base de datos completa.

En una operación de reversión se requiere que la instantánea de base de datos especificada sea la única en la base de datos. Durante la operación de reversión, la instantánea de base de datos y la base de datos de destino se marcan como In restore. Para obtener más información, vea la sección "Comentarios" en RESTORE DATABASE.

Opciones de WITH

Especifica las opciones que han de utilizarse en una operación de restauración. Para obtener un resumen de las instrucciones que utilizan cada opción, vea "Resumen de compatibilidad para las opciones de WITH", más adelante en este artículo.

PARTIAL

Apoyado por:RESTORE DATABASE

Especifica una operación de restauración parcial que solo restaura el grupo de archivos principal y cualquiera de los grupos de archivos secundarios especificados. La opción PARTIAL selecciona implícitamente el grupo de archivos principal; por tanto, no es necesario especificar FILEGROUP = 'PRIMARY'. Para restaurar un grupo de archivos secundario, debe especificarlo de forma explícita mediante la opción FILE o FILEGROUP.

La opción PARCIAL no está permitida en RESTORE las sentencias LOG.

La opción PARTIAL abre la fase inicial de una restauración por etapas, que permite restaurar los grupos de archivos restantes más adelante. Para obtener más información, vea Restauraciones por etapas (SQL Server).

[ RECUPERACIÓN | NOLA RECUPERACIÓN | ESPERA ]

Apoyado por:RESTORE

RECOVERY
Indica a la operación de restauración que revierta las transacciones no confirmadas. Después del proceso de recuperación, la base de datos está preparada para ser utilizada. Si no se especifica NORECOVERY, RECOVERY o STANDBY, la opción predeterminada es RECOVERY.

Si se planifican operaciones posteriores RESTORE (RESTORE LOG o RESTOREDATABASE desde diferencial), se deben especificar NORECOVERY o STANDBY.

Al restaurar los conjuntos de copia de seguridad de una versión anterior de SQL Server, puede ser necesaria una actualización de la base de datos. Esta actualización se realiza automáticamente al especificar WITH RECOVERY. Para obtener más información, vea Aplicar copias de seguridad del registro de transacciones (SQL Server).

NORECOVERY

Indica a la operación de restauración que no revierta las transacciones no confirmadas. Si debe aplicarse otro registro de transacciones más adelante, especifique la opción NORECOVERY o STANDBY. Si no se especifica NORECOVERY, RECOVERY o STANDBY, la opción predeterminada es RECOVERY. Si se utiliza la opción NORECOVERY durante una operación de restauración sin conexión, la base de datos no puede utilizarse.

Para restaurar una copia de seguridad de base de datos y uno o más registros de transacciones, o siempre que sean necesarias varias RESTORE sentencias (por ejemplo, al restaurar una copia de seguridad completa de la base de datos seguida de una copia de seguridad diferencial), RESTORE se requiere la opción WITH NORECOVERY en todas las sentencias excepto en la final RESTORE . Una buena práctica es usar WITH NORECOVERY en TODAS las sentencias en una secuencia de restauración de varios pasos hasta alcanzar el punto de recuperación deseado, y luego usar una instrucción WITH RECOVERY separada RESTORE solo para la recuperación.

Cuando se utiliza en la operación de restauración de un archivo o grupo de archivos, NORECOVERY obliga a la base de datos a permanecer en estado de restauración después de la operación de restauración. Esto resulta útil en cualquiera de las situaciones siguientes:

• Se está ejecutando un script de restauración y se aplica el registro en todo momento.

• Se está utilizando una secuencia de restauraciones de archivos y no está previsto que la base de datos se pueda utilizar entre dos de las operaciones de restauración.

En algunos casos RESTORE , CON NORECOVERY rolls, el rollback forward se coloca lo suficientemente adelantado como para ser consistente con la base de datos. En esos casos, no se produce la reversión y los datos permanecen sin conexión, como cabe esperar con esta opción. No obstante, Motor de base de datos genera un mensaje informativo donde indica que el conjunto de puestas al día se puede recuperar mediante la opción RECOVERY.

ESPERA = standby_file_name

Especifica un archivo en espera que permite deshacer los efectos de la recuperación. La opción STANDBY se puede utilizar en operaciones de restauración sin conexión (incluida la restauración parcial). Esta opción no se permite en operaciones de restauración en línea. Si se intenta especificar la opción STANDBY para una operación de restauración en línea, se producirá un error en la operación. STANDBY tampoco se permite cuando es necesario actualizar una base de datos.

El archivo de espera se utiliza para mantener una preimagen de "copiar al escribir" para las páginas modificadas durante el paso de deshacer de un RESTORE CON ESPERA. El archivo en espera permite abrir una base de datos para el acceso de solo lectura entre las restauraciones del registro de transacciones, y utilizarla cuando haya un servidor en espera semiactiva o en situaciones de recuperación especiales en las que resulte útil inspeccionar la base de datos entre las restauraciones del registro. Tras una RESTORE operación CON ESPERA, el archivo de deshacer se elimina automáticamente en la siguiente RESTORE operación. Si este archivo de espera se elimina manualmente antes de la siguiente RESTORE operación, entonces toda la base de datos debe restaurarse de nuevo. Mientras la base de datos está en estado STANDBY, debe tratar el archivo en espera con el mismo cuidado que cualquier otro archivo de base de datos. A diferencia de lo que sucede con los demás archivos de base de datos, Motor de base de datos mantiene abierto este archivo solo durante las operaciones de restauración activas.

standby_file_name especifica un archivo en espera cuya ubicación se almacena en el registro de la base de datos. Si hay otro archivo con el mismo nombre, se sobrescribe; en caso contrario, Motor de base de datos crea el archivo.

Los requisitos de tamaño de un archivo en espera determinado dependen del volumen de las acciones de deshacer resultantes de las transacciones no confirmadas durante la operación de restauración.

Para una comparación de RECUPERACIÓN y NORECUPERACIÓN, véase la sección "Observaciones" en RESTORE.

LOADHISTORY

Apoyado por:RESTORE VERIFYONLY

Especifica que la operación de restauración cargará la información en las tablas de historial de msdb. La opción LOADHISTORY carga en las tablas de historial de copias de seguridad y restauración de la base de datos msdb la información sobre las copias de seguridad de SQL Server almacenadas en el conjunto de medios para el conjunto de copia de seguridad que se comprueba. Para más información sobre las tablas de historial, vea System Tables (Transact-SQL) (Tablas del sistema [Transact-SQL]).

Tenga en cuenta que el uso de LOADHISTORY para copias de seguridad que ya existen en las msdb tablas de historial agregará la misma información con un nuevo backup_set_id. Además, si usa LOADHISTORY para volver a crear el historial de copia de seguridad en msdb, ya sea en un servidor diferente o después de eliminarlo del servidor original, se recomienda ejecutar los comandos de restauración para las copias de seguridad en el orden en que se realizaron. Esto garantiza que la cadena LSN permanezca intacta y el Asistente para restauración de SSMS lea correctamente el historial de copia de seguridad para generar la secuencia de restauración correcta. Si no se sigue el orden previsto al volver a crear el historial de copia de seguridad y se usa LOADHISTORY, puede producirse un error al intentar restaurar ("No se puede crear el plan de restauraciones debido a una interrupción en la cadena LSN. [Microsoft.SqlServer.SmoExtended]").

< > general_WITH_options [ ,... n ]

Las siguientes opciones generales WITH están todas soportadas en RESTOREDATABASE y RESTORE en sentencias LOG. Algunas de estas opciones también son compatibles con una o varias instrucciones auxiliares, tal y como se indica aquí.

Opciones de la operación de restauración

Estas opciones afectan al comportamiento de la operación de restauración.

MOVER "logical_file_name_in_backup" A "operating_system_file_name" [ ,... n ]

Apoyado por:RESTORE y RESTORE VERIFYONLY

Especifica que el archivo de datos o de registro cuyo nombre lógico está especificado por logical_file_name_in_backup debe moverse restaurándolo en la ubicación especificada por operating_system_file_name. El nombre de archivo lógico de un archivo de datos o de registro de un conjunto de copia de seguridad coincide con el nombre lógico que tenía en la base de datos cuando se creó el conjunto de copia de seguridad.

n es un marcador de posición que indica que puede especificar instrucciones MOVE adicionales. Especifique una instrucción MOVE para cada archivo lógico del conjunto de copia de seguridad que desee restaurar en otra ubicación. El archivo logical_file_name_in_backup se restaura de forma predeterminada en su ubicación original.

Si se utiliza una RESTORE instrucción para reubicar una base de datos en el mismo servidor o copiarla a otro servidor, la opción MOVE puede ser necesaria para reubicar los archivos de la base de datos y evitar colisiones con archivos existentes.

Cuando se usa con RESTORE LOG, la opción MOVE solo puede usarse para reubicar archivos añadidos durante el intervalo cubierto por la restauración del log. Por ejemplo, si la copia de seguridad de log contiene una operación de añadir archivo por archivo file23, este archivo puede reubicarse usando la opción MOVER en RESTORE LOG.

Cuando se usa con la copia de seguridad de instantánea de SQL Server, la opción MOVE solo se puede usar para reubicar archivos en un blob de Azure dentro de la misma cuenta de almacenamiento que el blob original. La opción MOVE no se puede usar para restaurar la copia de seguridad de instantánea en un archivo local o en otra cuenta de almacenamiento.

Si se utiliza una RESTORE VERIFYONLY instrucción cuando planeas reubicar una base de datos en el mismo servidor o copiarla a otro servidor, la opción MOVE puede ser necesaria para verificar que hay suficiente espacio disponible en el destino e identificar posibles colisiones con archivos existentes.

Para obtener más información, vea Copiar bases de datos con Copias de seguridad y restauración.

CREDENTIAL

Apoyado por:RESTORE, RESTORE FILELISTONLY, RESTORE HEADERONLY, RESTORE LABELONLY, y RESTORE VERIFYONLY.

Se aplica a: SQL Server 2012 (11.x) SP1 CU2 y versiones posteriores

Se usa solo al restaurar una copia de seguridad desde Microsoft Azure Blob Storage.

REPLACE

Apoyado por:RESTORE

Especifica que SQL Server debe crear la base de datos especificada y sus archivos relacionados aunque ya exista otra base de datos con el mismo nombre. En ese caso, se elimina la base de datos existente. Si no se especifica la opción REPLACE, se realiza una comprobación de seguridad. Así se evita sobrescribir por accidente una base de datos distinta. La comprobación de seguridad asegura que la RESTOREDATABASE instrucción no restaure la base de datos en el servidor actual si existen las siguientes condiciones:

• La base de datos mencionada en la RESTORE instrucción ya existe en el servidor actual, y

• El nombre de la base de datos es diferente del nombre de la base de datos registrado en el conjunto de copia de seguridad.

REPLACE también permite RESTORE sobrescribir un archivo existente que no puede verificarse como perteneciente a la base de datos que se está restaurando. Normalmente, RESTORE se niega a sobrescribir archivos preexistentes. WITH REPLACE también puede usarse de la misma manera para la RESTORE opción LOG.

REPLACE elimina el requisito de que se realice una copia del final del registro antes de restaurar la base de datos.

Para información sobre el impacto de usar la opción REEMPLAZAR, véaseRESTORE (Transact-SQL).

RESTART

Apoyado por:RESTORE

Especifica que SQL Server debe reiniciar una operación de restauración que se ha interrumpido. RESTART reinicia la operación de restauración en el punto en que se interrumpió.

RESTRICTED_USER

Apoyado por:RESTORE.

Restringe el acceso a la base de datos recién restaurada a los miembros de los roles db_owner, dbcreator o sysadmin. RESTRICTED_USER sustituye a la opción DBO_ONLY. DBO_ONLY no está incluida en SQL Server 2008 (10.0.x).

Utilícela con la opción RECOVERY.

Opciones de conjunto de copia de seguridad

Estas opciones funcionan en el conjunto de copia de seguridad que contiene la copia de seguridad que se va a restaurar.

ARCHIVO = { backup_set_file_number | @backup_set_file_number }

Apoyado por:RESTORE, RESTORE FILELISTONLY, RESTORE HEADERONLY, y RESTORE VERIFYONLY.

Identifica el conjunto de copia de seguridad que se va a restaurar. Por ejemplo, si backup_set_file_number es 1 , indica el primer conjunto de copia de seguridad del medio de copia, y si backup_set_file_number es 2 , indica el segundo conjunto de copia de seguridad. Puedes obtener la backup_set_file_number de un conjunto de respaldo usando la RESTORE HEADERONLY instrucción.

Cuando no se especifica, el valor predeterminado es 1, salvo en RESTORE HEADERONLY cuyo caso se procesan todos los conjuntos de copia de seguridad del conjunto de medios. Para obtener más información, consulte Especificar un conjunto de copia de seguridad.

CONTRASEÑA = { contraseña | @password_variable }

Apoyado por:RESTORE, RESTORE FILELISTONLY, RESTORE HEADERONLY, y RESTORE VERIFYONLY.

Proporciona la contraseña del conjunto de copia de seguridad. Una contraseña de conjunto de copia de seguridad es una cadena de caracteres.

Si se especificó una contraseña al crear el conjunto de copia de seguridad, ésta es necesaria para realizar operaciones de restauración desde ese conjunto de copia de seguridad. Es un error especificar una contraseña incorrecta o especificar una contraseña si el conjunto de copia de seguridad no tiene ninguna.

[ METADATA_ONLY | INSTANTÁNEA ] [ DBNAME = { <database_name> | @database_name_variable } ]

Introducido en SQL Server 2022 (16.x).

Necesario para restaurar a partir de la copia de seguridad de instantáneas. BACKUP SERVER, o BACKUP GROUP... Consulte Creación de una copia de seguridad de instantáneas de Transact-SQL.

METADATA_ONLY es sinónimo de SNAPSHOT. La interfaz de dispositivo virtual (VDI) usa SNAPSHOT. Para obtener información sobre VDI, consulte Referencia de interfaces de dispositivo virtual (VDI).

Opciones de conjuntos de medios

Estas opciones funcionan para todo el conjunto de medios.

MEDIANAME = { media_name | @media_name_variable }

Apoyado por:RESTORE, RESTORE FILELISTONLY, RESTORE HEADERONLY, RESTORE LABELONLY, y RESTORE VERIFYONLY.

Especifica el nombre de los medios. Si se proporciona, el nombre de los medios debe coincidir con el nombre de los medios de los volúmenes de copia de seguridad; en caso contrario, la operación de restauración finaliza. Si no se indica ningún nombre de medio en la RESTORE instrucción, no se realiza la comprobación de un nombre de medio coincidente en los volúmenes de respaldo.

MEDIAPASSWORD = { mediapassword | @mediapassword_variable }

Apoyado por:RESTORE, RESTORE FILELISTONLY, RESTORE HEADERONLY, RESTORE LABELONLY, y RESTORE VERIFYONLY.

Proporciona la contraseña del conjunto de medios. Una contraseña de conjunto de medios es una cadena de caracteres.

Si se proporcionó una contraseña al dar formato al conjunto de medios, ésta será necesaria para tener acceso a cualquier conjunto de copia de seguridad de ese conjunto de medios. Es un error especificar una contraseña incorrecta o especificar una contraseña si el conjunto de medios no tiene ninguna.

TAMAÑO BLOQUE = { tamaño | de bloque@blocksize_variable }

Apoyado por:RESTORE

Especifica el tamaño de bloque físico, en bytes. Los tamaños admitidos son 512, 1024, 2048, 4096, 8192, 16384, 32768 y 65536 (64 KB) bytes. El valor predeterminado es 65536 para dispositivos de cinta y 512 para otros dispositivos. Normalmente, esta opción no es necesaria porque RESTORE selecciona automáticamente un tamaño de bloque adecuado para el dispositivo. La especificación explícita de un tamaño de bloque invalida la selección automática del tamaño de bloque.

Si va a restaurar una copia de seguridad desde un CD-ROM, especifique BLOCKSIZE=2048.

Opciones de transferencia de datos

Las opciones le permiten optimizar la transferencia de datos desde el dispositivo de copia de seguridad.

BUFFERCOUNT = { buffercount | @buffercount_variable }

Apoyado por:RESTORE

Especifica el número total de búferes de E/S que se van a utilizar para la operación de restauración. Puede especificar cualquier entero positivo; no obstante, un número de búferes demasiado grande podría provocar errores de "memoria insuficiente" a causa de un espacio de direcciones virtuales inadecuado en el proceso Sqlservr.exe.

El espacio total usado por los búferes viene determinado por: buffercount****maxtransfersize.

MAXTRANSFERSIZE = { maxtransfersize | @maxtransfersize_variable }

Apoyado por:RESTORE

Especifica la unidad de transferencia más grande (en bytes) que se debe utilizar entre el medio de copia de seguridad y SQL Server. Los valores posibles son múltiplos de 65536 bytes (64 KB), hasta un máximo de 4194304 bytes (4 MB).

Opciones de administración de errores

Estas opciones permiten determinar si se habilitarán las sumas de comprobación de copia de seguridad para la operación de restauración y si ésta se detiene al encontrar un error.

{ SUMA DE CONTROL | NO_CHECKSUM }

Apoyado por:RESTORE, RESTORE FILELISTONLY, RESTORE HEADERONLY, RESTORE LABELONLY, y RESTORE VERIFYONLY.

El comportamiento predeterminado es comprobar las sumas de comprobación, si están presentes, y continuar sin esta comprobación si no lo están.

CHECKSUM
Especifica que se comprueben las sumas de comprobación de copia de seguridad y que, si la copia de seguridad no dispone de ellas, la operación de restauración genere un error, con un mensaje que indique que no hay sumas de comprobación presentes.

Por defecto, al encontrar una suma de comprobación inválida, RESTORE se informa de un error de suma de comprobación y se detiene. Sin embargo, si especificas CONTINUE_AFTER_ERROR, RESTORE procede tras devolver un error de suma de comprobación y el número de la página que contiene la suma de comprobación inválida, si la corrupción lo permite.

Para más información sobre cómo trabajar con sumas de comprobación de copia de seguridad, vea Errores posibles de medios durante copia de seguridad y restauración (SQL Server).

NO_CHECKSUM
Deshabilita explícitamente la validación de las sumas de comprobación en la operación de restauración.

{ STOP_ON_ERROR | CONTINUE_AFTER_ERROR }

Apoyado por:RESTORE, RESTORE FILELISTONLY, RESTORE HEADERONLY, RESTORE LABELONLY, y RESTORE VERIFYONLY.

STOP_ON_ERROR
Especifica que la operación de restauración debe detenerse con el primer error encontrado. Este es el comportamiento por defecto para RESTORE, excepto para VERIFYONLY, que tiene a CONTINUE_AFTER_ERROR como predeterminado.

CONTINUE_AFTER_ERROR
Especifica que la operación de restauración debe continuar después de encontrar un error.

Si una copia de seguridad contiene páginas dañadas, se recomienda repetir la operación de restauración usando una copia de seguridad alternativa que no contenga esos errores (por ejemplo, una copia de seguridad realizada antes de que se produjeran daños en las páginas). Sin embargo, como último recurso, puede restaurar la copia de seguridad dañada con la opción CONTINUE_AFTER_ERROR de la instrucción de restauración e intentar recuperar los datos.

Opciones de FILESTREAM

FILESTREAM ( DIRECTORY_NAME =directory_name )

Apoyado por:RESTORE y RESTORE VERIFYONLY

Válido para SQL Server 2012 (11.x) y versiones posteriores.

Un nombre de directorio compatible con Windows. Este nombre debe ser único entre todos los nombres de directorio de FILESTREAM de base de datos en la instancia de SQL Server. La comparación de unicidad se realiza sin distinción entre mayúsculas y minúsculas, independientemente de la configuración de intercalación de SQL Server.

Opciones de supervisión

Estas opciones le permiten supervisar la transferencia de datos desde el dispositivo de copia de seguridad.

ESTADÍSTICAS [ = porcentaje ]

Apoyado por:RESTORE y RESTORE VERIFYONLY

Muestra un mensaje cada vez que se completa otro porcentaje; se utiliza para indicar el progreso. Si percentage se omite, SQL Server muestra un mensaje después de completar cada 10 por ciento (aproximadamente).

La opción STATS informa del porcentaje completado desde el umbral para informar del próximo intervalo. Esto sucede más o menos en el porcentaje especificado. Por ejemplo, con STATS=10, Motor de base de datos informa aproximadamente en ese intervalo; en lugar de mostrar exactamente el 40%, la opción podría mostrar el 43%. En el caso de los conjuntos de copia de seguridad de gran tamaño, esto no representa ningún problema porque el porcentaje completado se mueve muy lentamente entre las llamadas de E/S.

Opciones de cinta

Estas opciones solo se utilizan para dispositivos de cinta. Se omitirán si se utiliza otro tipo de dispositivo.

{ REBOBINAR | NOREWIND }

Estas opciones solo se utilizan para dispositivos de cinta. Se omitirán si se usa otro tipo de dispositivo.

REWIND
Apoyado por:RESTORE, RESTORE FILELISTONLY, RESTORE HEADERONLY, RESTORE LABELONLY, y RESTORE VERIFYONLY.

Especifica que SQL Server liberará y rebobinará la cinta. REWIND es la opción predeterminada.

NOREWIND
Apoyado por:RESTORE y RESTORE VERIFYONLY

Si se especifica NOREWIND en alguna otra instrucción de restauración, se produce un error.

Especifica que SQL Server mantendrá la cinta abierta tras la operación de copia de seguridad. Puede utilizar esta opción para mejorar el rendimiento al realizar varias operaciones de copia de seguridad en una cinta.

NOREWIND implica NOUNLOAD, y estas opciones son incompatibles dentro de una sola RESTORE sentencia.

{ DESCARGAR | DESCARGA }

Apoyado por:RESTORE, RESTORE FILELISTONLY, RESTORE HEADERONLY, RESTORE LABELONLY, RESTORE REWINDONLY, y RESTORE VERIFYONLY.

Estas opciones solo se utilizan para dispositivos de cinta. Se omitirán si se usa otro tipo de dispositivo.

UNLOAD
Especifica que la cinta se rebobina y descarga automáticamente al terminar la copia de seguridad. UNLOAD es el valor predeterminado cuando se inicia una sesión.

NOUNLOAD
Especifica que después de la RESTORE operación, la cinta permanece cargada en la unidad de cinta.

<replication_WITH_option>

Esta opción solo es pertinente si la base de datos se replicó cuando se creó la copia de seguridad.

KEEP_REPLICATION
Apoyado por:RESTORE

Use KEEP_REPLICATION al configurar la replicación para que funcione con el trasvase de registros. Evita que se quite la configuración de replicación al restaurar una copia de seguridad de base de datos o de registros en un servidor en espera semiactiva, y la base de datos se recupera. No se permite especificar esta opción para restaurar una copia de seguridad con la opción NORECOVERY. Para garantizar que la replicación funciona correctamente después de la restauración:

• Las bases de datos msdb y master del servidor en espera semiactiva deben estar sincronizadas con las bases de datos msdb y master del servidor principal.

• El nombre del servidor en espera semiactiva debe cambiarse de manera que sea igual que el del servidor principal.

<change_data_capture_WITH_option>

Esta opción solo es pertinente si la base de datos se habilitó para la captura de datos modificados cuando se creó la copia de seguridad.

KEEP_CDC

Apoyado por:RESTORE

KEEP_CDC se debe usar para evitar que la configuración de la captura de datos modificados se quite cuando una copia de seguridad de bases de datos o de registros se restaura en otro servidor y se recupera la base de datos. No se permite especificar esta opción para restaurar una copia de seguridad con la opción NORECOVERY.

Al restaurar la base de datos con KEEP_CDC, no se crean los trabajos de la captura de datos modificados. Para extraer los cambios del registro después de restaurar la base de datos, deberá volver a crear el trabajo del proceso de captura y el trabajo de limpieza para la base de datos restaurada. Para más información, vea sys.sp_cdc_add_job (Transact-SQL).

Para más información sobre cómo usar la captura de datos modificados con la creación de reflejo de la base de datos, vea Captura de datos modificados y otras características de SQL Server.

<service_broker_WITH_options>

Activa o desactiva la entrega de mensajes de Service Broker o establece un nuevo identificador de Service Broker. Esta opción solo es pertinente si Service Broker se habilitó (activó) para la base de datos cuando se creó la copia de seguridad.

{ ENABLE_BROKER | ERROR_BROKER_CONVERSATIONS | NEW_BROKER }

Apoyado por:RESTORE DATABASE

ENABLE_BROKER
Especifica que la entrega de mensajes de Service Broker está habilitada al final de la restauración para que los mensajes se puedan enviar inmediatamente. De forma predeterminada, la entrega de mensajes de Service Broker está deshabilitada durante una restauración. La base de datos conserva el identificador de Service Broker existente.

ERROR_BROKER_CONVERSATIONS
Finaliza todas las conversaciones con un error que indica que la base de datos está adjunta o restaurada. Esto permite que las aplicaciones realicen una limpieza regular de las conversaciones existentes. La entrega de mensajes de Service Broker está deshabilitada hasta que se completa esta operación y, después, se habilita. La base de datos conserva el identificador de Service Broker existente.

NEW_BROKER
Especifica que se asigne a la base de datos un nuevo identificador de Service Broker. Dado que la base de datos se considera como un nuevo Service Broker, todas las conversaciones existentes en la base de datos se quitan inmediatamente sin generar mensajes de fin de diálogo. Cualquier ruta que haga referencia al identificador de Service Broker anterior debe volverse a crear con el nuevo identificador.

<point_in_time_WITH_options>

Apoyado por:RESTORE {DATABASE|LOG} y solo para los modelos de recuperación completo o con registro masivo.

Puede restaurar una base de datos hasta un momento concreto o transacción especificando el punto de recuperación de destino en una cláusula STOPAT, STOPBEFOREMARK o STOPATMARK. Un momento o transacción especificada siempre se restaura a partir de una copia de seguridad de registros. En cada RESTORE sentencia LOG de la secuencia de restauración, debes especificar tu tiempo o transacción objetivo en una cláusula idéntica de STOPAT, STOPATMARK o STOPBEFOREMARK.

Como requisito previo para realizar una restauración a un momento dado, primero debe restaurar una copia de seguridad total de la base de datos cuyo final sea anterior al punto de recuperación de destino. Para ayudarte a identificar qué copia de seguridad de la base de datos restaurar, puedes opcionalmente especificar tu cláusula WITH STOPAT, STOPATMARK o STOPBEFOREMARK en una RESTOREDATABASE instrucción para generar un error si una copia de seguridad de datos es demasiado reciente para el tiempo objetivo especificado. Pero la copia de seguridad completa de los datos se restaura siempre, aunque contenga el momento de destino.

{ STOPAT | STOPATMARK | PARADANTEMARCA }

STOPAT = { "datetime" | @_datetime_var* }
Especifica que se va restaurar la base de datos al estado en que estaba en la fecha y hora especificadas por el parámetro datetime o @datetime_var. Para más información sobre cómo especificar una fecha y una hora, vea Tipos de datos y funciones de fecha y hora (Transact-SQL).

Si se usa una variable para STOPAT, la variable debe ser del tipo de datos varchar, char, smalldatetime o datetime. Solo se aplican a la base de datos los datos del registro de transacciones escritos antes de la fecha y hora especificadas.

Para obtener más información, vea Restaurar una base de datos de SQL Server a un momento dado (modelo de recuperación completa).

STOPATMARK = { 'mark_name' | "lsn:lsn_number" } [ AFTER "datetime" ]
Especifica que la recuperación se realice en un punto de recuperación especificado. La transacción especificada se incluye en la recuperación, pero solo se confirma si estaba confirmada inicialmente cuando se generó.

Tanto RESTOREDATABASE LOG RESTORE como LOG soportan el parámetro lsn_number . Este parámetro especifica un número de secuencia de registro.

El parámetro mark_name solo es compatible con la RESTORE sentencia LOG. Este parámetro identifica una marca de transacción en la copia de seguridad de registros.

En una RESTORE instrucción LOG, si se omite la fecha y hora POSTERIOR, la recuperación se detiene en la primera marca con el nombre especificado. Si se especifica AFTER datetime, la recuperación se detiene en la primera marca que tenga el nombre especificado, ya coincida con datetime o ya sea posterior.

Para más información, vea Usar transacciones marcadas para recuperar bases de datos relacionadas sistemáticamente (modelo de recuperación completa) y Recuperar a un número de secuencia de registro (SQL Server).

STOPBEFOREMARK = { "mark_name" | "lsn:lsn_number" } [ AFTER "datetime" ]
Especifica que la recuperación se realice en un punto de recuperación especificado. La transacción especificada no se incluye en la recuperación y se revertirá cuando se utilice WITH RECOVERY.

Tanto RESTOREDATABASE LOG RESTORE como LOG soportan el parámetro lsn_number . Este parámetro especifica un número de secuencia de registro.

El parámetro mark_name solo es compatible con la RESTORE sentencia LOG. Este parámetro identifica una marca de transacción en la copia de seguridad de registros.

En una RESTORE instrucción LOG, si se omite la fecha DESPUÉS de la hora, la recuperación se detiene justo antes de la primera marca con el nombre especificado. Si se especifica AFTER datetime, la recuperación se detiene justo antes de la primera marca que tenga el nombre especificado, ya coincida con datetime o ya sea posterior.

Conjuntos de resultados

Para obtener los conjuntos de resultados, consulte los siguientes artículos:

• RESTORE FILELISTONLY (Transact-SQL)

• RESTORE HEADERONLY (Transact-SQL)

• RESTORE LABELONLY (Transact-SQL)

Observaciones

Para comprobar las notas adicionales, consulte los siguientes artículos:

• RESTORE (Transact-SQL)

• RESTORE HEADERONLY (Transact-SQL)

• RESTORE LABELONLY (Transact-SQL)

• RESTORE REWINDONLY (Transact-SQL)

• RESTORE VERIFYONLY (Transact-SQL)

Especificar un conjunto de copia de seguridad

Un conjunto de copia de seguridad contiene la copia de seguridad de una sola operación de copia de seguridad realizada correctamente. RESTORE, RESTORERESTORE FILELISTONLY, RESTORERESTORE HEADERONLY, y RESTORERESTORE VERIFYONLY las sentencias operan sobre un único conjunto de copia de seguridad dentro del conjunto de medios en el dispositivo o dispositivos de copia de seguridad especificados. Debe especificar la copia de seguridad que necesita del conjunto de medios. Puedes obtener la backup_set_file_number de un conjunto de respaldo usando la RESTORE HEADERONLY instrucción.

La opción para especificar el conjunto de copia de seguridad que se desea restaurar es:

FILE ={ backup_set_file_number | @backup_set_file_number }

Donde backup_set_file_number indica la posición de la copia de seguridad en el conjunto de medios. Un valor de backup_set_file_number de 1 (FILE = 1) indica el primer conjunto de copia de seguridad del medio de copia, y si backup_set_file_number es 2 (FILE = 2), indica el segundo conjunto de copia de seguridad, y así sucesivamente.

El comportamiento de esta opción varía en función de la instrucción, como se indica en la siguiente tabla:

Resumen de compatibilidad para las opciones de WITH

Las siguientes opciones WITH solo están soportadas por la RESTORE sentencia: BLOCKSIZE, BUFFERCOUNT, MAXTRANSFERSIZE, PARTIAL, KEEP_REPLICATION, { RECOVERY | NOLA RECUPERACIÓN | ESPERA }, REEMPLAZA, REINICIA, RESTRICTED_USER y { STOPAT | STOPATMARK | PARADANTEMARCA }

En la tabla siguiente se enumeran las opciones de WITH que se utilizan en una o más instrucciones, y se indica qué instrucciones admiten cada opción. Una marca de verificación (√) indica que la opción se admite; el guion (-) indica que la opción no se admite.

¹ FILE =backup_set_file_number, que es distinto de {FILE | FILEGROUP}.

Permisos

Para comprobar los permisos, consulte los siguientes artículos:

• RESTORE (Transact-SQL)

• RESTORE FILELISTONLY (Transact-SQL)

• RESTORE HEADERONLY (Transact-SQL)

• RESTORE LABELONLY (Transact-SQL)

• RESTORE REWINDONLY (Transact-SQL)

• RESTORE VERIFYONLY (Transact-SQL)

Ejemplos

Consulte algunos ejemplos en los artículos siguientes:

• RESTORE (Transact-SQL)

• RESTORE FILELISTONLY (Transact-SQL)

• RESTORE HEADERONLY (Transact-SQL)

Pasos siguientes

• BACKUP (Transact-SQL)
• RESTORE (Transact-SQL)
• RESTORE FILELISTONLY (Transact-SQL)
• RESTORE HEADERONLY (Transact-SQL)
• RESTORE LABELONLY (Transact-SQL)
• RESTORE REWINDONLY (Transact-SQL)
• RESTORE VERIFYONLY (Transact-SQL)
• Copia de seguridad y restauración de bases de datos de SQL Server
• FILESTREAM (SQL Server)