sp_helppullsubscription (Transact-SQL)

顯示在訂閱者端的一或多項訂閱的相關資訊。這個預存程序執行於訂閱資料庫的訂閱者端。

Transact-SQL 語法慣例

語法

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，不會傳回發送訂閱。

結果集

資料行名稱	資料類型	描述
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	基於安全性的考量，一律會傳回 "**********" 值。

傳回碼值

0 (成功) 或 1 (失敗)

備註

sp_helppullsubscription 用於快照式和交易式複寫中。

權限

只有系統管理員 (sysadmin) 固定伺服器角色或 db_owner 固定資料庫角色的成員，才能夠執行 sp_helppullsubscription。

請參閱

參考

sp_addpullsubscription (Transact-SQL)

sp_droppullsubscription (Transact-SQL)

系統預存程序 (Transact-SQL)