sqllogship (aplicación)

Nuevo: 12 de diciembre de 2006

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.

 Si desea obtener información acerca de las convenciones de sintaxis, vea Utilidades del símbolo del sistema.

Sintaxis

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

Argumentos

• -serverinstance_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 primario 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.

• -backupprimary_id
  Realiza una operación de copia de seguridad de la base de datos primaria 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 primario 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.

• -copysecondary_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.

• -restoresecondary_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.

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

  Nivel (level)	Descripción
  0	No se obtienen mensajes de depuración ni de traza.
  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.

• –logintimeouttimeout_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 timeout_value es de tipo int*.*

• -querytimeouttimeout_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 timeout_value es de tipo int*.*

Notas

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 de proceso 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 Cómo deshabilitar un trabajo (SQL Server Management Studio).

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.

[!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.

Vea también

Otros recursos

Cómo habilitar el trasvase de registros (SQL Server Management Studio)
Cómo habilitar el trasvase de registros (Transact-SQL)
Trasvase de registros
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)
log_shipping_secondary (Transact-SQL)
log_shipping_primary_databases (Transact-SQL)

Ayuda e información

Obtener ayuda sobre SQL Server 2005