Skip to content

sp-add-log-shipping-primary-secondary-transact-sql.md

Latest commit

 

History

History
82 lines (57 loc) · 2.41 KB

sp-add-log-shipping-primary-secondary-transact-sql.md

File metadata and controls

82 lines (57 loc) · 2.41 KB
title sp_add_log_shipping_primary_secondary (Transact-SQL)
description This stored procedure adds an entry for a secondary database on the primary server.
author MashaMSFT
ms.author mathoma
ms.reviewer randolphwest
ms.date 06/23/2025
ms.service sql
ms.subservice system-objects
ms.topic reference
f1_keywords
sp_add_log_shipping_primary_secondary_TSQL
sp_add_log_shipping_primary_secondary
helpviewer_keywords
sp_add_log_shipping_primary_secondary
dev_langs
TSQL

sp_add_log_shipping_primary_secondary (Transact-SQL)

[!INCLUDE SQL Server]

This stored procedure adds an entry for a secondary database on the primary server.

:::image type="icon" source="../../includes/media/topic-link-icon.svg" border="false"::: Transact-SQL syntax conventions

Syntax

sp_add_log_shipping_primary_secondary
[ @primary_database = ] 'primary_database' ,
[ @secondary_server = ] 'secondary_server' ,
[ @secondary_database = ] 'secondary_database'
[ ; ]

Arguments

[ @primary_database = ] 'primary_database'

The name of the database on the primary server. @primary_database is sysname, with no default.

[ @secondary_server = ] 'secondary_server'

The name of the secondary server. @secondary_server is sysname, with no default.

[ @secondary_database = ] 'secondary_database'

The name of the secondary database. @secondary_database is sysname, with no default.

Return code values

0 (success) or 1 (failure).

Result set

None.

Remarks

sp_add_log_shipping_primary_secondary must be run from the master database on the primary server.

Permissions

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

Examples

This example uses sp_add_log_shipping_primary_secondary to add an entry for the secondary database LogShipAdventureWorks to the secondary server FLATIRON.

EXECUTE master.dbo.sp_add_log_shipping_primary_secondary
    @primary_database = N'AdventureWorks',
    @secondary_server = N'flatiron',
    @secondary_database = N'LogShipAdventureWorks';
GO

Related content