共用方式為


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