aplicación sqllogship

Se aplica a:SQL Server

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 SQL Server para una base de datos específica.

Para conocer las convenciones de sintaxis, consulte Utilidades de la línea de comandos de SQL (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 ]
[ -connectionoptions "<key_value_pairs>; [ ... ]" ]

Argumentos

-server instance_name

Especifica la instancia de SQL Server donde se ejecuta 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 identificador principal se especifica en primary_id. Para obtener este identificador, 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.

-copiar 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 identificador secundario se indica en secondary_id. Para obtener este identificador, 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.

-restaurar 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 identificador secundario se indica en secondary_id. Puede obtener este identificador mediante el sp_help_log_shipping_secondary_database procedimiento almacenado.

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 antigua del historial, en función del 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 (valor predeterminado)	Se obtienen mensajes de control de errores, advertencias e informativos.
4	Se obtienen todos los mensajes de depuración y traza.

-logintimeout timeout_value

Especifica la cantidad de tiempo asignado para intentar 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. timeout_value es 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. timeout_value es int.

-connectionoptions "<key_value_pairs>; [ ... n ] "

Aplica a: SQL Server 2025 (17.x) y versiones posteriores.

Especifica opciones de conectividad adicionales en forma de pares clave-valor.

En la tabla siguiente se enumeran las opciones de conectividad disponibles:

Key	Importancia
Encrypt	strict, mandatory, optional, , true, false
TrustServerCertificate	true, false, , yes, no
ServerCertificate	Ruta del sistema de archivos al certificado del servidor. Esta opción tiene una longitud máxima de 260 caracteres.
HostNameInCertificate	Invalidación de nombre de host para el certificado. Esta opción tiene una longitud máxima de 255 caracteres.

Observaciones

Use los trabajos de copia de seguridad, copia y restauración para realizar la copia de seguridad, copia y restauración siempre que 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, consulte Disable or Enable a Job.

La aplicación sqllogship , SqlLogShip.exe, se instala en el <drive>:\Program Files\Microsoft SQL Server\130\Tools\Binn directorio .

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 -backupopción , -copyo -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 BACKUP instrucción . Para obtener más información, consulte BACKUP.
-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 RESTORE instrucción . Para obtener más información, consulte Instrucciones RESTORE.

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

Contenido relacionado

• Acerca del trasvase de registros (SQL Server)
• base_de_datos_primarias_de_envío_de_registros (Transact-SQL)
• log_shipping_secondary (Transact-SQL)
• sp_cleanup_log_shipping_history (Transact-SQL)
• sp_help_log_shipping_primary_database (Transact-SQL)
• sp_help_log_shipping_secondary_database (Transact-SQL)
• sp_start_job (Transact-SQL)