sp_delete_log_shipping_primary_secondary (Transact-SQL)

Article
02/28/2023

Applies to: SQL Server

Removes the entry for a secondary database on the primary server.

Syntax

  
sp_delete_log_shipping_primary_secondary  
    [ @primary_database = ] 'primary_database',   
    [ @secondary_server = ] 'secondary_server',   
    [ @secondary_database = ] 'secondary_database'

Arguments

[ @primary_database = ] 'primary_database' Is the name of the database on the primary server. primary_database is sysname, with no default.

[ @secondary_server = ] 'secondary_server' Is the name of the secondary server. secondary_server is sysname, with no default.

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

Return Code Values

0 (success) or 1 (failure)

Result Sets

None.

Remarks

sp_delete_log_shipping_primary_secondary must be run from the master database on the primary server. This stored procedure removes the entry for a secondary database from log_shipping_primary_secondaries on the primary server.

Permissions

Requires membership in the sysadmin fixed server role.

Examples

In the following example, sp_delete_log_shipping_primary_secondary is used to delete the secondary database LogShipAdventureWorks from the secondary server FLATIRON.

EXEC master.dbo.sp_delete_log_shipping_primary_secondary  
@primary_database = N'AdventureWorks'  
,@secondary_server = N'FLATIRON'  
,@secondary_database = N'LogShipAdventureWorks';  
GO