sp_helppullsubscription （Transact-SQL）

  • 發行項

適用於：SQL ServerAzure 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，預設值%為 ，它會傳回所有 Publisher 資料庫。

[ @publication = ] 'publication' 這是發行集的名稱。 publication 是 sysname，預設值為 %，它會傳回所有發行集。 如果此參數等於 ALL，則只會傳回具有 independent_agent = 0 的提取訂閱。

[ @show_push = ] 'show_push' 這是是否要傳回所有發送訂閱。 show_push為 nvarchar（5），預設值為 FALSE，不會傳回發送訂閱。

結果集

資料行名稱 資料類型 描述
publisher sysname 發行者的名稱。
publisher 資料庫 sysname 發行者資料庫的名稱。
出版 sysname 發行集的名稱。
independent_agent bit 指出此出版物是否有獨立 散發代理程式。
訂用帳戶類型 int 發行集的訂閱類型。
散發代理程式 nvarchar(100) 散發代理程式 處理訂用帳戶。
發行集描述 nvarchar(255) 發行集的描述。
上次更新時間 date 訂閱資訊更新的時間。 這是 ISO 日期 （114） + ODBC 時間 （121） 的 UNICODE 字串。 格式為 yyyymmdd hh:mi:sss.mmm 'yyyy' 為 year、'mm' 為 month、'dd' 為 day、'hh' 為 hour、'mi' 為 minute、'sss' 為 seconds，而 'mmm' 為毫秒。
訂用帳戶名稱 varchar（386） 訂用帳戶的名稱。
上次交易時間戳 varbinary（16） 上次復寫交易的時間戳。
更新模式 tinyint 允許的更新類型。
散發代理程式job_id int 散發代理程式 的工作標識碼。
enabled_for_synmgr int 是否可以透過 Microsoft Synchronization Manager 同步處理訂閱。
訂用帳戶 guid 二進位（16） 發行集上訂閱版本的全域標識符。
subid 二進位（16） 匿名訂閱的全域標識碼。
immediate_sync bit 每次執行 快照集代理程式 時，都會建立或重新建立同步處理檔案。
發行者登入 sysname 在發行者端用於 SQL Server 驗證的登入標識碼。
publisher password nvarchar（524） 在發行者端用於 SQL Server 驗證的密碼（加密）。
publisher security_mode int 在發行者端實作的安全性模式：

0 = SQL Server 驗證

1 = Windows 驗證

2 = 同步處理觸發程式會使用靜態 sysservers 專案來執行遠端過程調用 （RPC），而且發行者必須在 sysservers 數據表中定義為遠端伺服器或連結伺服器。
轉銷商 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 訂閱是透過因特網訂閱 Publication，並已設定 FTP 尋址屬性。 如果 為 0，則訂用帳戶未使用 FTP。 如果 為 1，則訂用帳戶使用 FTP。
publication_type int 指定發行集的復寫型態：

0 = 事務複製

1 = 快照式複寫

2 = 合併式複寫
dts_package_name sysname 指定資料轉換服務 （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' 為 year、'mm' 為 month、'dd' 為 day、'hh' 為 hour、'mi' 為 minute、'sss' 為 seconds，而 'mmm' 為毫秒。
job_login nvarchar(512) 這是散發代理程序執行所在的 Windows 帳戶，其會以網域\使用者名稱格式傳回。
job_password sysname 基於安全性考慮，一律會傳回 “**********” 的值。

傳回碼值

0 （成功） 或 1 （失敗）

備註

快照式和事務複製會使用sp_helppullsubscription。

權限

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

另請參閱

sp_addpullsubscription （Transact-SQL）
sp_droppullsubscription （Transact-SQL）
系統預存程序 (Transact-SQL)