sqllogship (aplicación)

Artículo
05/08/2013

La aplicación sqllogship realiza una operación de copia de seguridad, copia o restauración y las tareas de limpieza asociadas en una configuración de trasvase de registros. La operación se realiza en una instancia específica de Microsoft SQL Server 2005 para una base de datos determinada.

Icono de vínculo a temas Si desea obtener información acerca de las convenciones de sintaxis, vea Referencia de la utilidad del símbolo del sistema (motor de base de datos).

Sintaxis

sqllogship -server instance_name { -backup primary_id | -copy secondary_id | -restore secondary_id } [ –verboselevel level ] [ –logintimeout timeout_value ] [ -querytimeout timeout_value ]

Argumentos

-server instance_name
Especifica la instancia de SQL Server donde se ejecutará la operación. La instancia del servidor que se va a especificar depende de la operación de trasvase de registros indicada. Para -backup, instance_name debe ser el nombre del servidor principal en una configuración de trasvase de registros. Para -copy o -restore, instance_name debe ser el nombre de un servidor secundario en una configuración de trasvase de registros.
-backup primary_id
Realiza una operación de copia de seguridad de la base de datos principal cuyo Id. principal se especifica en primary_id. Para obtener este Id., selecciónelo en la tabla del sistema log_shipping_primary_databases o use el procedimiento almacenado sp_help_log_shipping_primary_database.

La operación de copia de seguridad crea la copia de seguridad del registro en el directorio de copia de seguridad. A continuación, la aplicación sqllogship limpia los archivos de copia de seguridad antiguos, basándose en el período de retención de archivos. Más tarde, la aplicación registra el historial de la operación de copia de seguridad en el servidor principal y en el servidor de supervisión. Por último, la aplicación ejecuta sp_cleanup_log_shipping_history, que limpia la información del historial antigua, basándose en el período de retención.
-copy secondary_id
Realiza una operación de copia para copiar copias de seguridad desde el servidor secundario especificado de la base de datos o bases de datos secundarias cuyo Id. secundario se indica en secondary_id. Para obtener este Id., selecciónelo en la tabla del sistema log_shipping_secondary o use el procedimiento almacenado sp_help_log_shipping_secondary_database.

La operación copia los archivos de copia de seguridad desde el directorio de copia de seguridad al directorio de destino. A continuación, la aplicación sqllogship registra el historial de la operación de copia en el servidor secundario y en el servidor de supervisión.
-restore secondary_id
Realiza una operación de restauración en el servidor secundario especificado de la base de datos o bases de datos secundarias cuyo Id. secundario se indica en secondary_id. Para obtener este Id., use el procedimiento almacenado sp_help_log_shipping_secondary_database.

Los archivos de copia de seguridad del directorio de destino creados después del punto de restauración más reciente se restauran en la base de datos o bases de datos secundarias. A continuación, la aplicación sqllogship limpia los archivos de copia de seguridad antiguos, basándose en el período de retención de archivos. Más tarde, la aplicación registra el historial de la operación de restauración en el servidor secundario y en el servidor de supervisión. Por último, la aplicación ejecuta sp_cleanup_log_shipping_history, que limpia la información del historial antigua, basándose en el período de retención.

–verboselevel level
Especifica el nivel de mensajes agregados al historial de trasvase de registros. level es uno de los siguientes enteros:

Nivel	Descripción
0	No se obtienen mensajes de depuración ni de seguimiento.
1	Se obtienen mensajes de control de errores.
2	Se obtienen mensajes de control de errores y advertencias.
3	Se obtienen mensajes de control de errores, advertencias e informativos. Es el valor predeterminado.
4	Se obtienen todos los mensajes de depuración y traza.

–logintimeout timeout_value
Especifica la cantidad de tiempo asignado al intento de iniciar sesión en la instancia del servidor antes de que se agote el tiempo de espera del intento. El valor predeterminado es 15 segundos. El valor de timeout_value es de tipo int.
-querytimeout timeout_value
Especifica la cantidad de tiempo asignado para iniciar la operación especificada antes de que se agote el tiempo de espera. El valor predeterminado es sin tiempo de espera. El valor de timeout_value es de tipo int.

Comentarios

Se recomienda que use los trabajos de copia de seguridad, copia y restauración para realizar la copia de seguridad, copia y restauración cuando sea posible. Para iniciar estos trabajos desde una operación por lotes u otra aplicación, llame al procedimiento almacenado sp_start_job.

El historial de trasvase de registros creado por sqllogship se combina con el historial creado por los trabajos de copia de seguridad, copia y restauración de trasvase de registros. Si tiene previsto usar sqllogship repetidamente para realizar operaciones de copia de seguridad, copia y restauración para una configuración de trasvase de registros, considere la posibilidad de deshabilitar los trabajos de trasvase de registros correspondientes. Para obtener más información, vea Deshabilitar o habilitar un trabajo.

La aplicación sqllogship, SqlLogShip.exe, está instalada en el directorio x:\Archivos de programa\Microsoft SQL Server\90\Tools\Binn.

Permisos

sqllogship usa la autenticación de Windows. La cuenta de la autenticación de Windows donde se ejecuta el comando requiere acceso al directorio de Windows y permisos de SQL Server. El requisito depende de si el comando sqllogship especifica la opción -backup, -copy o -restore.

Opción	Acceso al directorio	Permisos
-backup	Requiere acceso de lectura/escritura al directorio de copia de seguridad.	Requiere los mismos permisos que la instrucción BACKUP. Para obtener más información, vea BACKUP (Transact-SQL).
-copy	Requiere acceso de lectura al directorio de copia de seguridad y acceso de escritura al directorio de copia.	Requiere los mismos permisos que el procedimiento almacenado sp_help_log_shipping_secondary_database.
-restore	Requiere acceso de lectura/escritura al directorio de copia.	Requiere los mismos permisos que la instrucción RESTORE. Para obtener más información, vea RESTORE (Transact-SQL).

[!NOTA]

Para conocer las rutas de acceso de los directorios de copia de seguridad y copia, puede ejecutar el procedimiento almacenado sp_help_log_shipping_secondary_database o examinar la tabla log_shipping_secondary en msdb. Las rutas de acceso al directorio de copia de seguridad y al de destino se encuentran en las columnas backup_source_directory y backup_destination_directory respectivamente.