sp_helpmergepullsubscription （Transact-SQL）
適用於：
SQL Server
傳回存在於訂閱者端之提取訂閱的資訊。 這個預存程式會在訂閱資料庫的訂閱者端執行。
語法
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同步處理訂閱。 |
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。