sp_help_log_shipping_secondary_database (Transact-SQL)

This stored procedure retrieves the settings for one or more secondary databases.

Transact-SQL Syntax Conventions

Syntax

sp_help_log_shipping_secondary_database
[ @secondary_database = ] 'secondary_database' OR
[ @secondary_id = ] 'secondary_id'

Arguments

• [ @secondary_database = ] 'secondary_database'
  Is the name of the secondary database. secondary_database is sysname, with no default.

• [ @secondary_id = ] 'secondary_id'
  The ID for the secondary server in the log shipping configuration. secondary_id is uniqueidentifier and cannot be NULL.

Return Code Values

0 (success) or 1 (failure)

Result Sets

Column name	Description
secondary_id	The ID for the secondary server in the log shipping configuration.
primary_server	The name of the primary instance of the Microsoft SQL Server Database Engine in the log shipping configuration.
primary_database	The name of the primary database in the log shipping configuration.
backup_source_directory	The directory where transaction log backup files from the primary server are stored.
backup_destination_directory	The directory on the secondary server where backup files are copied to.
file_retention_period	The length of time, in minutes, that a backup file is retained on the secondary server before being deleted.
copy_job_id	The ID associated with the copy job on the secondary server.
restore_job_id	The ID associated with the restore job on the secondary server.
monitor_server	The name of the instance of the SQL Server Database Engine being used as a monitor server in the log shipping configuration.
monitor_server_security_mode	The security mode used to connect to the monitor server. 1 = Microsoft Windows Authentication. 0 = SQL Server Authentication.
secondary_database	The name of the secondary database in the log shipping configuration.
restore_delay	The amount of time, in minutes, that the secondary server waits before restoring a given backup file. The default is 0 minutes.
restore_all	If set to 1, the secondary server restores all available transaction log backups when the restore job runs. Otherwise, it stops after one file has been restored.
restore_mode	The restore mode for the secondary database. 0 = Restore log with NORECOVERY. 1 = Restore log with STANDBY.
disconnect_users	If set to 1, users are disconnected from the secondary database when a restore operation is performed. Default = 0.
block_size	The size, in bytes, that is used as the block size for the backup device.
buffer_count	The total number of buffers used by the backup or restore operation.
max_transfer_size	The size, in bytes, of the maximum input or output request which is issued by SQL Server to the backup device.
restore_threshold	The number of minutes allowed to elapse between restore operations before an alert is generated.
threshold_alert	The alert to be raised when the restore threshold is exceeded.
threshold_alert_enabled	Determines if restore threshold alerts are enabled. 1 = Enabled. 0 = Disabled.
last_copied_file	The filename of the last backup file copied to the secondary server.
last_copied_date	The time and date of the last copy operation to the secondary server.
last_copied_date_utc	The time and date of the last copy operation to the secondary server, expressed in Coordinated Universal Time.
last_restored_file	The filename of the last backup file restored to the secondary database.
last_restored_date	The time and date of the last restore operation on the secondary database.
last_restored_date_utc	The time and date of the last restore operation on the secondary database, expressed in Coordinated Universal Time.
history_retention_period	The amount of time, in minutes, that log shipping history records are retained for a given secondary database before being deleted.
last_restored_latency	The amount of time, in minutes, that elapsed between when the log backup was created on the primary and when it was restored on the secondary. The initial value is NULL.

Remarks

If you include the secondary_database parameter, the result set will contain information about that secondary database; if you include the secondary_id parameter, the result set will contain information about all secondary databases associated with that secondary ID.

sp_help_log_shipping_secondary_database must be run from the master database on the secondary server.

Permissions

Only members of the sysadmin fixed server role can run this procedure.

See Also

Reference

sp_help_log_shipping_secondary_primary (Transact-SQL)

System Stored Procedures (Transact-SQL)

Concepts

About Log Shipping (SQL Server)