sp_reinitpullsubscription (Transact-SQL)

  • 项目

适用于：SQL ServerAzure SQL 托管实例

将事务请求订阅或匿名订阅标记为在下次运行分发代理时重新初始化。 此存储过程在订阅服务器上对请求订阅数据库执行。

Transact-SQL 语法约定

语法

  
sp_reinitpullsubscription [ @publisher = ] 'publisher'  
        , [ @publisher_db = ] 'publisher_db'  
        , [ @publication = ] 'publication'

参数

[ @publisher = ] 'publisher' 发布服务器的名称。 publisher 为 sysname，没有默认值。

[ @publisher_db = ] 'publisher_db' 发布服务器数据库的名称。 publisher_db为 sysname，无默认值。

[ @publication = ] 'publication' 发布的名称。 发布 是 sysname，默认值为 all，用于标记要重新初始化的所有订阅。

返回代码值

0 （成功） 或 1 （失败）

备注

sp_reinitpullsubscription用于事务副本 (replica)。

对等事务副本 (replica)不支持sp_reinitpullsubscription。

sp_reinitpullsubscription可以从订阅服务器调用，以在分发代理的下一次运行期间重新初始化订阅。

无法从订阅服务器重新初始化使用值为 false 的发布订阅@immediate_sync。

可以通过在订阅服务器上执行sp_reinitpullsubscription或在发布服务器上执行sp_reinitsubscription来重新初始化请求订阅。

示例

-- This script uses sqlcmd scripting variables. They are in the form
-- $(MyVariable). For information about how to use scripting variables  
-- on the command line and in SQL Server Management Studio, see the 
-- "Executing Replication Scripts" section in the topic
-- "Programming Replication Using System Stored Procedures".

DECLARE @publicationDB AS sysname;
DECLARE @publication AS sysname;
SET @publicationDB = N'AdventureWorks2022';
SET @publication = N'AdvWorksProductTran';

USE [AdventureWorks2022Replica]

-- Execute at the Subscriber to reinitialize the pull subscription. 
EXEC sp_reinitpullsubscription 
    @publisher = $(PubServer),
    @publisher_db = @publicationDB,
    @publication = @publication;
GO

-- Start the Distribution Agent.

权限

只有 sysadmin 固定服务器角色的成员或db_owner固定数据库角色的成员才能执行sp_reinitpullsubscription。

另请参阅

重新初始化订阅
重新初始化订阅
系统存储过程 (Transact-SQL)