sp_helparticle (Transact-SQL)

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

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

語法

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

引數

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

    ms187741.note(zh-tw,SQL.90).gif附註:
    當要求 SQL Server 發行者所發行之發行項的相關資訊時,不應指定 publisher
  • [ @found= ] found OUTPUT
    僅供內部使用。

傳回碼值

0 (成功) 或 1 (失敗)

結果集

資料行名稱 資料類型 描述

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>。

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 設為 autoauto_identity_range 設為 true 時,在發行者端之識別範圍的範圍大小。

identity_range

bigint

當發行項的 identityrangemanagementoption 設為 autoauto_identity_range 設為 true 時,在訂閱者端之識別範圍的範圍大小。

threshold

bigint

這是一個百分比值,指出散發代理程式指派新識別範圍的時機。

identityrangemanagementoption

int

指出處理發行項的識別範圍管理。

fire_triggers_on_snapshot

bit

這是指在套用初始快照集時,是否執行複寫的使用者觸發程序。

1 = 執行使用者觸發程序。

0 = 不執行使用者觸發程序。

備註

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

權限

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

範例

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

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

請參閱

參考

sp_addarticle (Transact-SQL)
sp_articlecolumn (Transact-SQL)
sp_changearticle (Transact-SQL)
sp_droparticle (Transact-SQL)
複寫預存程序 (Transact-SQL)

其他資源

How to: View and Modify Article Properties (Replication Transact-SQL Programming)

說明及資訊

取得 SQL Server 2005 協助