分享方式：

sp_helpmergepullsubscription （Transact-SQL）

  • 文章

適用於：SQL Server

傳回存在於訂閱者端之提取訂閱的資訊。 這個預存程式會在訂閱資料庫的訂閱者端執行。

Transact-SQL 語法慣例

語法

sp_helpmergepullsubscription
    [ [ @publication = ] N'publication' ]
    [ , [ @publisher = ] N'publisher' ]
    [ , [ @publisher_db = ] N'publisher_db' ]
    [ , [ @subscription_type = ] N'subscription_type' ]
[ ; ]

引數

[ @publication = ] N'publication '

發行集的名稱。 @publication為 sysname ，預設值為 % 。 如果 @publication 為 % ，則會傳回目前資料庫中所有合併式發行集和訂閱的相關資訊。

[ @publisher = ] N'publisher '

發行者的名稱。 @publisher為 sysname ，預設值為 % 。

[ @publisher_db = ] N'publisher_db '

發行者資料庫的名稱。 @publisher_db 為 sysname ，預設值為 % 。

[ @subscription_type = ] N'subscription_type '

指定是否要顯示提取訂閱。 @subscription_type 為 Nvarchar（10） ，預設值為 pull 。 有效值為 push 、 pull 、 both 。

結果集

資料行名稱 資料類型 描述
subscription_name Nvarchar（1000） 訂用帳戶的名稱。
publication sysname 發行集的名稱。
publisher sysname 發行者的名稱。
publisher_db sysname 發行者資料庫的名稱。
subscriber sysname 訂閱者的名稱。
subscriber_db sysname 訂閱資料庫的名稱。
status int 訂用帳戶狀態：

0 = 非使用中的訂用帳戶

1 = 作用中訂用帳戶

2 = 已刪除的訂用帳戶

3 = 已中斷連結的訂用帳戶

4 = 附加的訂用帳戶

5 = 訂閱已標示為使用上傳重新初始化

6 = 附加訂用帳戶失敗

7 = 從備份還原的訂用帳戶
subscriber_type int 訂閱者類型：

1 = 全域

2 = 本機

3 = 匿名
subscription_type int 訂用帳戶的類型：

0 = 推送

1 = 提取

2 = 匿名
priority float（8） 訂用帳戶優先順序。 值必須小於 100.00 。
sync_type tinyint 訂用帳戶同步處理類型：

1 = 自動

2 = 未使用快照集。
description nvarchar(255) 提取訂閱的簡短描述。
merge_jobid 二進位（16） 合併代理程式的工作識別碼。
enabled_for_syncmgr int 指定是否可以透過 Microsoft Synchronization Manager 同步處理訂閱。
last_updated Nvarchar（26） 合併代理程式上次成功同步處理訂用帳戶的時間。
publisher_login sysname 發行者登入名稱。
publisher_password sysname 發行者密碼。
publisher_security_mode int 指定發行者的安全性模式：

0 = SQL Server 驗證

1 = Windows 驗證
distributor sysname 散發者的名稱。
distributor_login sysname 散發者登入名稱。
distributor_password sysname 散發者密碼。
distributor_security_mode int 指定散發者的安全性模式：

0 = SQL Server 驗證

1 = Windows 驗證
ftp_address sysname 僅適用于回溯相容性。 散發者的檔案傳輸通訊協定 （FTP） 服務網路位址。
ftp_port int 僅適用于回溯相容性。 散發者的 FTP 服務埠號碼。
ftp_login sysname 僅適用于回溯相容性。 用來連線到 FTP 服務的使用者名稱。
ftp_password sysname 僅適用于回溯相容性。 用來連線到 FTP 服務的使用者密碼。
alt_snapshot_folder nvarchar(255) 如果位置不是或預設位置以外，則儲存快照集資料夾的位置。
working_directory nvarchar(255) 指定此選項時，使用 FTP 傳輸快照集檔案之目錄的完整路徑。
use_ftp bit 訂閱會透過網際網路訂閱發行集，並設定 FTP 定址屬性。 如果 0 為 ，則訂用帳戶未使用 FTP。 如果 1 為 ，則訂用帳戶使用 FTP。
offload_agent bit 指定代理程式是否可以從遠端啟動和執行。 如果 0 為 ，則無法從遠端啟用代理程式。
offload_server sysname 用於遠端啟用的伺服器名稱。
use_interactive_resolver int 傳回在對帳期間是否使用互動式解析程式。 如果 0 為 ，則不會使用互動式解析程式。
subid uniqueidentifier 訂閱者的識別碼。
dynamic_snapshot_location nvarchar(255) 儲存快照集檔案的資料夾路徑。
last_sync_status int 同步處理狀態：

1 = 啟動

2 = 成功

3 = 進行中

4 = 閒置

5 = 在先前失敗之後重試

6 = 失敗

7 = 驗證失敗

8 = 通過驗證

9 = 要求關機
last_sync_summary sysname 上次同步處理結果的描述。
use_web_sync bit 指定是否可以透過 HTTPS 同步處理訂閱，其中 的值 1 表示此功能已啟用。
internet_url nvarchar(260) 表示 Web 同步處理之複寫接聽程式位置的 URL。
internet_login nvarchar(128) 當使用基本驗證連接到裝載 Web 同步處理的 Web 服務器時，合併代理程式所使用的登入。
internet_password Nvarchar（524） 合併代理程式 連線到使用基本身份驗證裝載 Web 同步處理之 Web 伺服器時所使用的登入密碼。
internet_security_mode int 連接到裝載 Web 同步處理的 Web 伺服器時所使用的驗證模式。 值 1 表示 Windows 驗證，而 值則 0 表示 SQL Server 驗證。
internet_timeout int Web 同步處理要求到期前，以秒為單位的時間長度。
hostname nvarchar(128) 指定當參數化數據列篩選的 WHERE 子句中使用這個函式時，HOST_NAME的多載值。
job_login nvarchar(512) 合併代理程式執行所在的 Windows 帳戶，其會以網域\使用者名稱格式傳回。
job_password sysname 基於安全性考慮，一律會傳回的值 ** 。

傳回碼值

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

備註

sp_helpmergepullsubscription 用於合併式複寫。 在結果集中，傳回 last_updated 的日期會格式化為 yyyyMMdd hh:mm:ss.fff。

權限

只有系統管理員固定伺服器角色和db_owner固定資料庫角色的成員才能執行 sp_helpmergepullsubscription。

相關內容