共用方式為


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。 合法值為pushpullboth

結果集

資料行名稱 資料類型 描述
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