sp_helppullsubscription （Transact-SQL）
適用於：
SQL Server Azure SQL 受控執行個體
顯示訂閱者端一或多個訂閱的相關信息。 這個預存程式會在訂閱資料庫的訂閱者端執行。
語法
sp_helppullsubscription
[ [ @publisher = ] N'publisher' ]
[ , [ @publisher_db = ] N'publisher_db' ]
[ , [ @publication = ] N'publication' ]
[ , [ @show_push = ] N'show_push' ]
[ ; ]
引數
[ @publisher = ] N'publisher'
遠端伺服器的名稱。 @publisher是 sysname，預設值%為 ，它會傳回所有發行者的資訊。
[ @publisher_db = ] N'publisher_db'
發行者資料庫的名稱。 @publisher_db是 sysname，預設值為 %，它會傳回所有 Publisher 資料庫。
[ @publication = ] N'publication'
發行集的名稱。 @publication是 sysname，預設值為 %，它會傳回所有發行集。 如果此參數等於 ALL，則只會傳回具有 independent_agent = 0 的提取訂閱。
[ @show_push = ] N'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 字串。 格式為 year、is month、 dd is day、 HH is hour、 mm is minute、 ss is seconds、is nnn 毫秒。 MM yyyy yyyyMMdd HH:mm:ss.nnn |
subscription name |
varchar（386） | 訂用帳戶的名稱。 |
last transaction timestamp |
varbinary（16） | 上次復寫交易的時間戳。 |
update mode |
tinyint | 允許的更新類型。 |
distribution agent job_id |
int | 散發代理程式 的工作標識碼。 |
enabled_for_synmgr |
int | 指定是否可以透過同步處理管理員Microsoft同步處理訂閱。 |
subscription guid |
二進位（16） | 發行集上訂閱版本的全域標識符。 |
subid |
二進位（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），而且發行者必須在 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 | 訂閱是透過因特網訂閱 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 字串。 格式為 year、is month、 dd is day、 HH is hour、 mm is minute、 ss is seconds、is nnn 毫秒。 MM yyyy yyyyMMdd HH:mm:ss.nnn |
job_login |
nvarchar(512) | 這是散發代理程序執行所在的 Windows 帳戶，其會以網域\使用者名稱格式傳回。 |
job_password |
sysname | 基於安全性考慮，一律會傳回的值 ********** 。 |
傳回碼值
0 (成功) 或 1 (失敗)。
備註
sp_helppullsubscription 用於快照式和事務複製。
權限
只有系統管理員固定伺服器角色或db_owner固定資料庫角色的成員才能執行 sp_helppullsubscription 。