sp_helppullsubscription (Transact-SQL)
顯示在訂閱者端的一或多項訂閱的相關資訊。這個預存程序執行於訂閱資料庫的訂閱者端。
.gif "主題連結圖示")
語法
sp_helppullsubscription [ [ @publisher = ] 'publisher' ]
[ , [ @publisher_db = ] 'publisher_db' ]
[ , [ @publication = ] 'publication' ]
[ , [ @show_push = ] 'show_push' ]
引數
- [ @publisher=] 'publisher'
這是遠端伺服器的名稱。publisher 是 sysname，預設值是 %，傳回所有發行者的資訊。
- [ @publisher_db=] 'publisher_db'
這是發行者資料庫的名稱。publisher_db 是 sysname，預設值是 %，傳回所有發行者資料庫。
- [ @publication=] 'publication'
這是發行集的名稱。publication 是 sysname，預設值是 %，傳回所有發行集。如果這個參數等於 ALL，就會傳回所有 independent_agent = 0 的提取訂閱。
- [ @show_push=] 'show_push'
這是指是否傳回所有發送訂閱。show_push 是 nvarchar(5)，預設值是 FALSE，不會傳回發送訂閱。
傳回碼值
0 (成功) 或 1 (失敗)
結果集
| 資料行名稱 | 資料類型 | 描述 |
|---|---|---|
publisher |
sysname |
發行者的名稱。 |
publisher database |
sysname |
發行者資料庫的名稱。 |
publication |
sysname |
發行集的名稱。 |
independent_agent |
bit |
指出這個發行集是否有獨立的散發代理程式。 |
subscription type |
int |
發行集的訂閱類型。 |
distribution agent |
nvarchar(100) |
處理訂閱的散發代理程式。 |
publication description |
nvarchar(255) |
發行集的描述。 |
last updating time |
date |
更新訂閱資訊的時間。這是 ISO 日期 (114) + ODBC 時間 (121) 的 UNICODE 字串。格式為 yyyymmdd hh:mi:sss.mmm，其中 'yyyy' 是年份，'mm' 是月份，'dd' 是日期，'hh' 是小時，'mi' 是分鐘，'sss' 是秒鐘，'mmm' 是毫秒。 |
subscription name |
varchar(386) |
訂閱的名稱。 |
last transaction timestamp |
varbinary(16) |
最後一次複寫交易的時間戳記。 |
update mode |
tinyint |
允許的更新類型。 |
distribution agent job_id |
int |
散發代理程式的作業識別碼。 |
enabled_for_synmgr |
int |
是否能夠利用 Microsoft Synchronization Manager 同步處理訂閱。 |
subscription guid |
binary(16) |
發行集訂閱版本的全域識別碼。 |
subid |
binary(16) |
匿名訂閱的全域識別碼。 |
immediate_sync |
bit |
每次執行快照集代理程式時，是否要建立或重新建立同步處理檔案。 |
publisher login |
sysname |
用於發行者端之 SQL Server 驗證的登入識別碼。 |
publisher password |
nvarchar(524) |
用於發行者端之 SQL Server 驗證的密碼 (加密)。 |
publisher security_mode |
int |
在發行者端實作的安全性模式： 0 = SQL Server 驗證 1 = Windows 驗證 2 = 同步處理觸發程序會利用靜態 sysservers 項目來執行遠端程序呼叫 (RPC)，publisher 必須定義在 sysservers 資料表中，成為遠端伺服器或連結伺服器。 |
distributor |
sysname |
散發者的名稱。 |
distributor_login |
sysname |
用於散發者端之 SQL Server 驗證的登入識別碼。 |
distributor_password |
nvarchar(524) |
用於散發者端之 SQL Server 驗證的密碼 (加密)。 |
distributor_security_mode |
int |
在散發者端實作的安全性模式： 0 = SQL Server 驗證 1 = Windows 驗證 |
ftp_address |
sysname |
只是為了與舊版相容。 |
ftp_port |
int |
只是為了與舊版相容。 |
ftp_login |
sysname |
只是為了與舊版相容。 |
ftp_password |
nvarchar(524) |
只是為了與舊版相容。 |
alt_snapshot_folder |
nvarchar(255) |
當位置不是預設位置，或在預設位置之外還有其他位置時，快照集資料夾的儲存位置。 |
working_directory |
nvarchar(255) |
當指定利用檔案傳輸通訊協定 (FTP) 來傳送快照集檔案的選項時，傳送快照集檔案之目錄的完整路徑。 |
use_ftp |
bit |
訂閱是透過網際網路來訂閱發行集，並設定 FTP 定址屬性。如果是 0，訂閱便不使用 FTP。如果是 1，訂閱便使用 FTP。 |
publication_type |
int |
指定發行集的複寫類型： 0 = 交易式複寫 1 = 快照式複寫 2 = 合併式複寫 |
dts_package_name |
sysname |
指定 Data Transformation Services (DTS) 封裝的名稱。 |
dts_package_location |
int |
DTS 封裝的儲存位置： 0 = 散發者 1 = 訂閱者 |
offload_agent |
bit |
指定是否能從遠端啟動代理程式。如果是 0，就表示不能從遠端啟動代理程式。 |
offload_server |
sysname |
指定遠端啟動所用之伺服器的網路名稱。 |
last_sync_status |
int |
訂閱狀態： 0 = 所有作業都在等待啟動 1 = 一或多項作業都在啟動中 2 = 所有作業都已執行成功 3 = 至少有一項作業在執行中 4 = 所有作業都已排程且閒置 5 = 在上一次失敗之後，至少試圖執行一項作業 6 = 至少有一項作業執行失敗 |
last_sync_summary |
sysname |
上次同步處理結果的描述。 |
last_sync_time |
datetime |
更新訂閱資訊的時間。這是 ISO 日期 (114) + ODBC 時間 (121) 的 UNICODE 字串。格式為 yyyymmdd hh:mi:sss.mmm，其中 'yyyy' 是年份，'mm' 是月份，'dd' 是日期，'hh' 是小時，'mi' 是分鐘，'sss' 是秒鐘，'mmm' 是毫秒。 |
job_login |
nvarchar(512) |
這是用來執行散發代理程式的 Windows 帳戶，傳回的格式如下：domain\username。 |
job_password |
sysname |
基於安全性的考量，一律會傳回 "**********" 值。 |
備註
sp_helppullsubscription 用於快照式和交易式複寫中。
權限
只有系統管理員 (sysadmin) 固定伺服器角色或 db_owner 固定資料庫角色的成員，才能夠執行 sp_helppullsubscription。
請參閱
參考
sp_addpullsubscription (Transact-SQL)
sp_droppullsubscription (Transact-SQL)
系統預存程序 (Transact-SQL)