發行項
09/24/2010

sp_helparticle (Transact-SQL)

顯示發行項的相關資訊。這個預存程序執行於發行集資料庫的發行者端。如果是 Oracle 發行者，這個預存程序執行於任何資料庫中的散發者端。

語法

sp_helparticle [ @publication = ] 'publication' 
    [ , [ @article = ] 'article' ]
    [ , [ @returnfilter = ] returnfilter ]
    [ , [ @publisher = ] 'publisher' ]
    [ , [ @found = ] found OUTPUT ]

引數

[ @publication =] 'publication'
這是發行集的名稱。publication 是 sysname，沒有預設值。
[ @article=] 'article'
這是發行集中的發行項名稱。article 是 sysname，預設值是 %。如果未提供 article，就會傳回指定發行集所有發行項的相關資訊。
[ @returnfilter=] returnfilter
指定是否應該傳回篩選子句。returnfilter 是 bit，預設值是 1，會傳回篩選子句。
[ @publisher= ] 'publisher'
指定非 MicrosoftSQL Server 發行者。publisher 是 sysname，預設值是 NULL。

[!附註]

當要求 SQL Server 發行者所發行之發行項的相關資訊時，不應指定 publisher。
[ @found= ] found OUTPUT
僅供內部使用。

結果集

資料行名稱	資料類型	描述
article id	int	發行項的識別碼。
article name	sysname	發行項的名稱。
base object	nvarchar(257)	發行項或預存程序所代表之基礎資料表的名稱。
destination object	sysname	目的地 (訂閱) 資料表的名稱。
synchronization object	nvarchar(257)	定義已發行的發行項之檢視的名稱。
type	smallint	發行項的類型： 1 = 記錄式發行項。 3 = 含有手動篩選的記錄式發行項。 5 = 含有手動檢視的記錄式發行項。 7 = 含有手動篩選和手動檢視的記錄式發行項。 8 = 預存程序執行。 24 = 可序列化的預存程序執行。 32 = 預存程序 (僅限結構描述)。 64 = 檢視 (僅限結構描述)。 128 = 函數 (僅限結構描述)。
status	tinyint	它可以是一或多個這些發行項屬性的 &(Bitwise AND) 結果： 0x00 = 僅供參考之用。不支援。我們無法保證未來的相容性。 0x01 = 發行項在使用中。 0x08 = 將資料行名稱包括在 INSERT 陳述式中。 0x16 = 使用參數化陳述式。 0x32 = 使用參數化陳述式，將資料行名稱包括在 INSERT 陳述式中。
filter	nvarchar(257)	用來水平篩選資料表的預存程序。必須已利用 FOR REPLICATION 子句來建立這個預存程序。
description	nvarchar(255)	發行項的描述項目。
insert_command	nvarchar(255)	當隨著資料表發行項而複寫插入時，所用的複寫命令類型。如需詳細資訊，請參閱＜指定交易式發行項變更的傳播方式＞。
update_command	nvarchar(255)	當隨著資料表發行項而複寫更新時，所用的複寫命令類型。如需詳細資訊，請參閱＜指定交易式發行項變更的傳播方式＞。
delete_command	nvarchar(255)	當隨著資料表發行項而複寫刪除時，所用的複寫命令類型。如需詳細資訊，請參閱＜指定交易式發行項變更的傳播方式＞。
creation script path	nvarchar(255)	用來建立目標資料表之發行項結構描述指令碼的路徑和名稱。
vertical partition	bit	這是指是否啟用發行項的垂直資料分割；1 值表示啟用垂直資料分割。
pre_creation_cmd	tinyint	DROP TABLE、DELETE TABLE 或 TRUNCATE 的預先建立命令：
filter_clause	ntext	指定水平篩選的 WHERE 子句。
schema_option	binary(8)	給定發行項的結構描述產生選項點陣圖。如需 schema_option 值的完整清單，請參閱＜sp_addarticle (Transact-SQL)＞。
dest_owner	sysname	目的地物件的擁有者名稱。
source_owner	sysname	來源物件的擁有者。
unqua_source_object	sysname	來源物件的名稱，不含擁有者名稱。
sync_object_owner	sysname	定義已發行的發行項之檢視的擁有者。.
unqualified_sync_object	sysname	定義已發行的發行項之檢視的名稱，不含擁有者名稱。
filter_owner	sysname	篩選的擁有者。
unqua_filter	sysname	篩選的名稱，不含擁有者名稱。
auto_identity_range	int	這是一個旗標，指出在前次建立發行集時，開啟了自動識別範圍處理。1 表示啟用自動識別範圍；0 表示停用。
publisher_identity_range	int	當發行項的 identityrangemanagementoption 設為 auto 或 auto_identity_range 設為 true 時，在發行者端之識別範圍的範圍大小。
identity_range	bigint	當發行項的 identityrangemanagementoption 設為 auto 或 auto_identity_range 設為 true 時，在訂閱者端之識別範圍的範圍大小。
threshold	bigint	這是一個百分比值，指出散發代理程式指派新識別範圍的時機。
identityrangemanagementoption	int	指出處理發行項的識別範圍管理。
fire_triggers_on_snapshot	bit	這是指在套用初始快照集時，是否執行複寫的使用者觸發程序。 1 = 執行使用者觸發程序。 0 = 不執行使用者觸發程序。

傳回碼值

0 (成功) 或 1 (失敗)

備註

sp_helparticle 用於快照式複寫和交易式複寫中。

權限

只有系統管理員 (sysadmin) 固定伺服器角色、db_owner 固定資料庫角色，或目前發行集之發行集存取清單的成員，才能夠執行 sp_helparticle。

範例

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

USE [AdventureWorks]
EXEC sp_helparticle
  @publication = @publication;
GO