Skip to content

sp-resetsnapshotdeliveryprogress-transact-sql.md

Latest commit

 

History

History
65 lines (45 loc) · 2.34 KB

sp-resetsnapshotdeliveryprogress-transact-sql.md

File metadata and controls

65 lines (45 loc) · 2.34 KB
title sp_resetsnapshotdeliveryprogress (Transact-SQL)
description sp_resetsnapshotdeliveryprogress resets the snapshot delivery process for a pull subscription so that snapshot delivery can be restarted.
author markingmyname
ms.author maghan
ms.reviewer randolphwest
ms.date 06/23/2025
ms.service sql
ms.subservice replication
ms.topic reference
f1_keywords
sp_resetsnapshotdeliveryprogress
sp_resetsnapshotdeliveryprogress_TSQL
helpviewer_keywords
sp_resetsnapshotdeliveryprogress
dev_langs
TSQL

sp_resetsnapshotdeliveryprogress (Transact-SQL)

[!INCLUDE SQL Server]

Resets the snapshot delivery process for a pull subscription so that snapshot delivery can be restarted. Executed at the Subscriber on the subscription database.

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

Syntax

sp_resetsnapshotdeliveryprogress
    [ [ @verbose_level = ] verbose_level ]
    [ , [ @drop_table = ] N'drop_table' ]
[ ; ]

Arguments

[ @verbose_level = ] verbose_level

Specifies the amount of information returned. @verbose_level is int, with a default of 1.

A value of 1 means that an error is returned if the necessary locks can't be obtained on the MSsnapshotdeliveryprogress table. A value of 0 means that no error is returned.

[ @drop_table = ] N'drop_table'

Whether to drop or truncate the table containing information on the progress of the snapshot. @drop_table is nvarchar(5), with a default of false.

  • false means that the table is truncated.
  • true means the table is dropped.

Return code values

0 (success) or 1 (failure).

Remarks

sp_resetsnapshotdeliveryprogress removes all rows in the MSsnapshotdeliveryprogress table. This stored procedure effectively removes all metadata left behind at the subscription database by any previous progress made in the snapshot delivery processes.

Permissions

Only members of the sysadmin fixed server role or the db_owner fixed database role can execute sp_resetsnapshotdeliveryprogress.

Related content