sp_help_log_shipping_secondary_database (Transact-SQL)

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

Topic link iconTransact-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.