共用方式為


sp_helpmergepullsubscription (Transact-SQL)

傳回存在於訂閱者端之提取訂閱的相關資訊。這個預存程序執行於訂閱資料庫的訂閱者端。

主題連結圖示Transact-SQL 語法慣例

語法

sp_helpmergepullsubscription [ [ @publication=] 'publication']
    [ , [ @publisher=] 'publisher']
    [ , [ @publisher_db=] 'publisher_db']
    [ , [ @subscription_type=] 'subscription_type']

引數

  • [ @publication=] 'publication'
    這是發行集的名稱。publication 是 sysname,預設值是 %。如果 publication 是 %,就會傳回目前資料庫中所有合併式發行集和訂閱的相關資訊。

  • [ @publisher=] 'publisher'
    這是發行者的名稱。publisher 是 sysname,預設值是 %

  • [ @publisher_db=] 'publisher_db'
    這是發行者資料庫的名稱。publisher_db 是 sysname,預設值是 %

  • [ @subscription_type=] 'subscription_type'
    指出是否要顯示提取訂閱。subscription_type 是 nvarchar(10),預設值是 'pull'。有效值是 'push''pull''both'

結果集

資料行名稱

資料類型

描述

subscription_name

nvarchar(1000)

訂閱的名稱。

publication

sysname

發行集的名稱。

publisher

sysname

發行者的名稱。

publisher_db

sysname

發行者資料庫的名稱。

subscriber

sysname

訂閱者的名稱。

subscription_db

sysname

訂閱資料庫的名稱。

status

int

訂閱狀態:

0 = 非使用中訂閱

1 = 使用中訂閱

2 = 已刪除的訂閱

3 = 已卸離的訂閱

4 = 已附加的訂閱

5 = 訂閱被標示為利用上載來重新初始化

6 = 附加訂閱失敗

7 = 從備份還原訂閱

subscriber_type

int

訂閱者的類型:

1 = 全域

2 = 本機

3 = 匿名

subscription_type

int

訂閱的類型:

0 = 發送

1 = 提取

2 = 匿名

priority

float(8)

訂閱優先權。這個值必須小於 100.00

sync_type

tinyint

訂閱同步處理類型:

1 = 自動

2 = 未使用快照集。

description

nvarchar(255)

這項提取訂閱的簡要描述。

merge_jobid

binary(16)

合併代理程式的作業識別碼。

enabled_for_syncmgr

int

是否能夠利用 Microsoft Synchronization Manager 同步處理訂閱。

last_updated

nvarchar(26)

合併代理程式上次成功進行訂閱同步處理的時間。

publisher_login

sysname

發行者的登入名稱。

publisher_password

sysname

發行者密碼。

publisher_security_mode

int

指定發行者的安全性模式。

0 = SQL Server 驗證

1 = Windows 驗證

distributor

sysname

散發者的名稱。

distributor_login

sysname

散發者的登入名稱。

distributor_password

sysname

散發者密碼。

distributor_security_mode

int

指定散發者的安全性模式。

0 = SQL Server 驗證

1 = Windows 驗證

ftp_address

sysname

使用這個項目的目的,只是為了與舊版相容。這是散發者的檔案傳輸通訊協定 (FTP) 服務的網路位址。

ftp_port

int

使用這個項目的目的,只是為了與舊版相容。這是散發者的 FTP 服務通訊埠編號。

ftp_login

sysname

使用這個項目的目的,只是為了與舊版相容。這是用來連接到 FTP 服務的使用者名稱。

ftp_password

sysname

使用這個項目的目的,只是為了與舊版相容。這是用來連接到 FTP 服務的使用者密碼。

alt_snapshot_folder

nvarchar(255)

當位置不是預設位置,或在預設位置之外還有其他位置時,快照集資料夾的儲存位置。

working_directory

nvarchar(255)

當指定利用 FTP 來傳送快照集檔案的選項時,傳送快照集檔案之目錄的完整路徑。

use_ftp

bit

訂閱是透過網際網路來訂閱發行集,並設定 FTP 定址屬性。如果是 0,訂閱便不使用 FTP。如果是 1,訂閱便使用 FTP。

offload_agent

bit

指定是否能從遠端啟動並執行代理程式。如果是 0,不能遠端啟動代理程式。

offload_server

sysname

遠端啟用伺服器的名稱。

use_interactive_resolver

int

傳回是否在重新調整期間使用互動式解析程式。如果是 0,就是未使用互動式解析程式。

subid

uniqueidentifier

訂閱者的識別碼。

dynamic_snapshot_location

nvarchar(255)

儲存快照集檔案之資料夾的路徑。

last_sync_status

int

同步處理狀態:

1 = 啟動中

2 = 成功

3 = 進行中

4 = 閒置

5 = 上次錯誤後重新嘗試中

6 = 失敗

7 = 驗證失敗

8 = 驗證通過

9 = 已要求關機

last_sync_summary

sysname

上次同步處理結果的描述。

use_web_sync

bit

指定是否能透過 HTTPS 來同步處理訂閱,1 表示已啟用這項功能。

internet_url

nvarchar(260)

代表 Web 同步處理之複寫接聽程式位置的 URL。

internet_login

nvarchar(128)

當利用基本驗證來連接到主控 Web 同步處理的 Web 伺服器時,合併代理程式所用的登入。

internet_password

nvarchar(524)

當利用基本驗證來連接到主控 Web 同步處理的 Web 伺服器時,合併代理程式所用的登入密碼。

internet_security_mode

int

當連接到主控 Web 同步處理的 Web 伺服器時,使用驗證模式。1 值是表示 Windows 驗證,0 值是表示 SQL Server 驗證。

internet_timeout

int

Web 同步處理要求到期之前的時間長度 (以秒為單位)。

hostname

nvarchar(128)

當這項功能用於參數化資料列篩選器的 WHERE 子句中時,為 HOST_NAME 指定多載的值。

job_login

nvarchar(512)

這是用來執行合併代理程式的 Windows 帳戶,傳回的格式如下:domain\username

job_password

sysname

基於安全性的考量,一律會傳回 "**********" 值。

傳回碼值

0 (成功) 或 1 (失敗)

備註

sp_helpmergepullsubscription 用於合併式複寫中。在結果集中,last_updated 傳回的日期格式是設定為 YYYYMMDD hh:mm:ss.fff

權限

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