分享方式:


sp_helpmergearticle (Transact-SQL)

適用於:SQL Server

傳回發行項的相關信息。 這個預存程式會在發行集資料庫的發行者端或訂閱資料庫的重新發行訂閱者端執行。

Transact-SQL 語法慣例

語法

sp_helpmergearticle
    [ [ @publication = ] N'publication' ]
    [ , [ @article = ] N'article' ]
[ ; ]

引數

[ @publication = ] N'publication'

要擷取信息的發行集名稱。 @publication為 sysname,預設值%為 ,其會傳回目前資料庫中所有發行集內含之所有合併發行項的相關信息。

[ @article = ] N'article'

要傳回資訊之發行項的名稱。 @article為 sysname,預設值%為 ,它會傳回指定出版物中所有合併發行項的相關信息。

結果集

資料行名稱 資料類型 描述
id int 發行項標識碼。
name sysname 發行項的名稱。
source_owner sysname 來源對象的擁有者名稱。
source_object sysname 要加入發行項的來源物件名稱。
sync_object_owner sysname 定義已發佈發行項之檢視的擁有者名稱。
sync_object sysname 用來建立數據分割之初始數據的自定義物件名稱。
description nvarchar(255) 文章的描述。
status tinyint 發行項的狀態,可以是下列其中一個值:

1 = 非使用中

2 = 作用中

5 = 資料定義語言 (DDL) 作業擱置中

6 = 具有新產生快照集的 DDL 作業

注意:重新初始化發行項目時,和 6 的值5會變更為 2
creation_script nvarchar(255) 用來在訂用帳戶資料庫中建立發行項的選擇性發行項架構腳本的路徑和名稱。
conflict_table nvarchar(270) 儲存插入或更新衝突的數據表名稱。
article_resolver nvarchar(255) 發行項的自定義解析程式。
subset_filterclause nvarchar(1000) 指定水平篩選的 WHERE 子句。
pre_creation_command tinyint 預先建立方法,可以是下列其中一個值:

0 = none

1 = drop

2 = delete

3 = 截斷
schema_option binary(8) 發行項架構產生選項的點陣圖。 如需此位圖選項的相關信息,請參閱 sp_addmergearticlesp_changemergearticle
type smallint 發行項的類型,可以是下列其中一個值:

10 = table

32 = 預存程式

64 = 檢視或索引檢視

128 = 使用者定義函數

160 = 僅限同義字架構
column_tracking int 設定數據行層級追蹤;其中 1 表示數據行層級追蹤已開啟,表示 0 數據行層級追蹤已關閉。
resolver_info nvarchar(255) 發行項解析程序的名稱。
vertical_partition bit 如果發行項垂直分割;其中 1 表示發行項是垂直分割的,表示 0 它不是。
destination_owner sysname 目的地對象的擁有者。 僅適用於合併預存程式、檢視和用戶定義函數 (UDF) 架構發行項。
identity_support int 如果已啟用自動識別範圍處理;其中 1 已啟用且 0 已停用。
pub_identity_range bigint 指派新識別值時要使用的範圍大小。 如需詳細資訊,請參閱復寫識別數據行的一節。
identity_range bigint 指派新識別值時要使用的範圍大小。 如需詳細資訊,請參閱復寫識別數據行的一節。
threshold int 用於執行 SQL Server Compact 或舊版 SQL Server 之訂閱者的百分比值。 threshold會控制 合併代理程式 指派新的識別範圍。 使用閾值中指定的值百分比時,合併代理程式 會建立新的識別範圍。 如需詳細資訊,請參閱復寫識別數據行的一節。
verify_resolver_signature int 如果在合併式複寫中使用解析程式之前先驗證數字簽名;其中 0 表示簽章未驗證,表示 1 簽章已驗證,以查看其是否來自信任的來源。
destination_object sysname 目的地對象的名稱。 僅適用於合併預存程式、檢視和UDF架構發行項。
allow_interactive_resolver int 如果在發行項上使用互動式解析程式;其中 1 表示使用這個解析程式,表示 0 不會使用此解析程式。
fast_multicol_updateproc int 啟用或停用 合併代理程式 將變更套用至一個 UPDATE 語句中相同數據列中的多個數據行;其中1表示多個數據行在一個語句中更新,而0表示每個更新的數據行都會有個別的 UPDATE 語句問題。
check_permissions int 整數值,表示已驗證之數據表層級許可權的位圖。 如需可能值的清單,請參閱 sp_addmergearticle (Transact-SQL)
processing_order int 數據變更套用至發行集中發行項的順序。
upload_options tinyint 使用用戶端訂用帳戶定義在訂閱者端所做的更新限制,這可以是下列其中一個值。

0 = 對具有用戶端訂閱的訂閱者進行的更新沒有任何限制;所有變更都會上傳至發行者。

1 = 在具有用戶端訂閱的訂閱者端允許變更,但不會上傳至發行者。

2 = 客戶端訂用帳戶的訂閱者不允許變更。

如需詳細資訊,請參閱使用僅限下載的發行項最佳化合併式複寫效能
identityrangemanagementoption int 指定是否啟用自動識別範圍處理。 1 已啟用,且 0 已停用。
delete_tracking bit 指定是否復寫刪除。 1 表示刪除會復寫,表示 0 它們不是。
compensate_for_errors bit 指出當同步處理期間發生錯誤時,是否要採取補償動作;其中 1 表示已採取補償動作,表示 0 不會採取補償動作。
partition_options tinyint 定義數據分割發行項的方式。 當所有數據列只屬於一個數據分割,或只屬於一個訂用帳戶時,此選項會啟用效能優化。 partition_options 可以是下列其中一個值。

0 = 發行項的篩選是靜態的,或不會產生每個數據分割的唯一數據子集;也就是說,這是「重疊」分割區。

1 = 分割區重疊,而且在訂閱者端進行的數據操作語言 (DML) 更新無法變更數據列所屬的數據分割。

2 = 發行項的篩選會產生非重疊的數據分割,但多個訂閱者可以接收相同的分割區。

3 = 發行項的篩選會產生每個訂用帳戶唯一的非重疊分割區。
artid uniqueidentifier 可唯一識別發行項的標識碼。
pubid uniqueidentifier 可唯一識別發行項發行集的標識碼。
stream_blob_columns bit 這是復寫二進位大型對象數據行時所使用的數據流優化。 1 表示正在使用優化,表示 0 未使用優化。

傳回碼值

0 (成功)或 1 (失敗)。

備註

sp_helpmergearticle 用於合併式複寫。

權限

只有發行集資料庫中db_owner固定資料庫角色的成員、散發資料庫中的 replmonitor 角色,或發行集的發行集存取清單可以執行 sp_helpmergearticle

範例

DECLARE @publication AS sysname;
SET @publication = N'AdvWorksSalesOrdersMerge';

USE [AdventureWorks2022]
EXEC sp_helpmergearticle
  @publication = @publication;
GO