sp_droppullsubscription （Transact-SQL）

  • 發行項

適用於：SQL ServerAzure SQL 受控執行個體

卸除訂閱者目前資料庫的訂閱。 這個預存程式會在提取訂閱資料庫的訂閱者端執行。

Transact-SQL 語法慣例

語法

sp_droppullsubscription
    [ @publisher = ] N'publisher'
    [ , [ @publisher_db = ] N'publisher_db' ]
    , [ @publication = ] N'publication'
    [ , [ @reserved = ] reserved ]
    [ , [ @from_backup = ] from_backup ]
[ ; ]

引數

[ @publisher = ] N'publisher'

遠端伺服器名稱。 @publisher為 sysname，沒有預設值。 如果 all為 ，則會在所有發行者端卸除訂閱。

[ @publisher_db = ] N'publisher_db'

發行者資料庫的名稱。 @publisher_db為 sysname，預設值為 NULL。 all 表示所有發行者資料庫。

[ @publication = ] N'publication'

發行集名稱。 @publication為 sysname，沒有預設值。 如果 all為 ，則訂閱會卸除至所有發行集。

[ @reserved = ] 保留

僅供參考之用。 不支援。 我們無法保證未來的相容性。

[ @from_backup = ] from_backup

僅供參考之用。 不支援。 我們無法保證未來的相容性。

傳回碼值

0 （成功）或 1 （失敗）。

備註

sp_droppullsubscription 用於快照式複寫和事務複製。

sp_droppullsubscription會刪除 MSreplication_subscriptions （Transact-SQL） 數據表中的對應數據列，以及訂閱者端對應的散發者代理程式。 如果MSreplication_subscriptions中沒有留下 任何數據列（Transact-SQL），則會卸除數據表。

範例

-- 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".

-- This is the batch executed at the Subscriber to drop 
-- a pull subscription to a transactional publication.
DECLARE @publication AS sysname;
DECLARE @publisher AS sysname;
DECLARE @publicationDB     AS sysname;
SET @publication = N'AdvWorksProductTran';
SET @publisher = $(PubServer);
SET @publicationDB = N'AdventureWorks2022';

USE [AdventureWorks2022Replica]
EXEC sp_droppullsubscription 
  @publisher = @publisher, 
  @publisher_db = @publicationDB, 
  @publication = @publication;
GO

權限

只有系統管理員固定伺服器角色的成員或建立提取訂閱的使用者才能執行 sp_droppullsubscription。 db_owner固定資料庫角色只有在建立提取訂閱的用戶屬於此角色時，才能執行sp_droppullsubscription。

相關內容