sp_helpmergearticle (Transact-SQL)
傳回發行項的相關資訊。這個預存程序執行於發行集資料庫的發行者端,或訂閱資料庫的重新發行訂閱者端。
語法
sp_helpmergearticle [ [ @publication = ] 'publication' ]
[ , [ @article= ] 'article' ]
引數
- [ @publication=] 'publication'
這是要擷取相關資訊的發行集名稱。publication 是 sysname,預設值是 %,它會傳回目前資料庫中所有發行集所包含之所有合併發行項的相關資訊。
- [ @article=] 'article'
這是要傳回資訊的發行項名稱。article 是 sysname,預設值是 %,它會傳回給定發行集中所有合併發行項的相關資訊。
傳回碼值
0 (成功) 或 1 (失敗)
結果集
資料行名稱
資料類型
描述
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 作業
附註:
當重新初始化發行項時,5 和 6 這兩個值會改成 2。
creation_script
nvarchar(255)
在訂閱資料庫中,用來建立發行項的選擇性發行項結構描述指令碼的路徑和名稱。
conflict_table
nvarchar(270)
儲存插入或更新衝突的資料表名稱。
article_resolver
nvarchar(255)
自訂的發行項解析程式。
subset_filterclause
nvarchar(1000)
指定水平篩選的 WHERE 子句。
pre_creation_command
tinyint
預先建立方法,它可以是下列項目之一:
0 = 無
1 = 卸除
2 = 刪除
3 = 截斷
schema_option
binary(8)
發行項的結構描述產生選項點陣圖。如需有關這個點陣圖選項的資訊,請參閱<sp_addmergearticle>或<sp_changemergearticle>。
type
smallint
發行項的類型,它可以是下列項目之一:
10 = 資料表
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 2005 Compact Edition 或舊版 SQL Server 的訂閱者所用的百分比值。threshold 用來控制合併代理程式指派新識別範圍的時機。當使用 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>。
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 表示不使用最佳化。
備註
sp_helpmergearticle 用於合併式複寫中。
權限
只有發行集資料庫中的 db_owner 固定資料庫角色、散發資料庫中的 replmonitor 角色,或發行集之發行集存取清單的成員,才能夠執行 sp_helpmergearticle。
範例
DECLARE @publication AS sysname;
SET @publication = N'AdvWorksSalesOrdersMerge';
USE [AdventureWorks]
EXEC sp_helpmergearticle
@publication = @publication;
GO
請參閱
參考
sp_addmergearticle (Transact-SQL)
sp_changemergearticle (Transact-SQL)
sp_dropmergearticle (Transact-SQL)
複寫預存程序 (Transact-SQL)
其他資源
How to: View and Modify Article Properties (Replication Transact-SQL Programming)