sp_helpmergepullsubscription (Transact-SQL)
傳回存在於訂閱者端之提取訂閱的相關資訊。這個預存程序執行於訂閱資料庫的訂閱者端。
語法
sp_helpmergepullsubscription [ [ @publication=] 'publication']
[ , [ @publisher=] 'publisher']
[ , [ @publisher_db=] 'publisher_db']
[ , [ @subscription_type=] 'subscription_type']
引數
[ @publication=] 'publication'
這是發行集的名稱。publication 是 sysname,預設值是 %。如果 publication 是 %,就會傳回目前資料庫中所有合併式發行集和訂閱的相關資訊。[ @publisher=] 'publisher'
這是發行者的名稱。publisher 是 sysname,預設值是 %。[ @publisher_db=] 'publisher_db'
這是發行者資料庫的名稱。publisher_db 是 sysname,預設值是 %。[ @subscription_type=] 'subscription_type'
指出是否要顯示提取訂閱。subscription_type 是 nvarchar(10),預設值是 'pull'。有效值是 'push'、'pull' 或 'both'。
結果集
資料行名稱 |
資料類型 |
描述 |
---|---|---|
subscription_name |
nvarchar(1000) |
訂閱的名稱。 |
publication |
sysname |
發行集的名稱。 |
publisher |
sysname |
發行者的名稱。 |
publisher_db |
sysname |
發行者資料庫的名稱。 |
subscriber |
sysname |
訂閱者的名稱。 |
subscription_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 |
binary(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 帳戶,傳回的格式如下:domain\username。 |
job_password |
sysname |
基於安全性的考量,一律會傳回 "**********" 值。 |
傳回碼值
0 (成功) 或 1 (失敗)
備註
sp_helpmergepullsubscription 用於合併式複寫中。在結果集中,last_updated 傳回的日期格式是設定為 YYYYMMDD hh:mm:ss.fff。
權限
只有系統管理員 (sysadmin) 固定伺服器角色和 db_owner 固定資料庫角色的成員,才能夠執行 sp_helpmergepullsubscription。