共用方式為

sp_helparticle (Transact-SQL)

  • 發行項

適用於：SQL Server Azure SQL 受控執行個體

顯示文章的相關信息。 這個預存程式會在發行集資料庫的發行者端執行。 針對 Oracle 發行者，此預存程式會在任何資料庫的散發者端執行。

Transact-SQL 語法慣例

語法

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

引數

[ @publication = ] N'publication'

發行集的名稱。 @publication為 sysname，沒有預設值。

[ @article = ] N'article'

發行集中發行項的名稱。 @article為 sysname，預設值為 %。 如果未 提供@article ，則會傳回指定發行集之所有發行項的相關信息。

[ @returnfilter = ] returnfilter

指定是否應該傳回篩選子句。 @returnfilter為 bit，預設值為 1，其會傳回 filter 子句。

[ @publisher = ] N'publisher'

指定非 SQL Server 發行者。 @publisher為 sysname，預設值為 NULL。

當要求 SQL Server 發行者所發行之發行項的資訊時，不應該指定@publisher 。

[ @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 = 檢視 （僅限架構）。
96 = 聚合函數（僅限架構）。
128 = 函式（僅限架構）。
257 = 以記錄為基礎的索引檢視。
259 = 具有手動篩選的記錄型索引檢視。
261 = 具有手動檢視的記錄型索引檢視。
263 = 具有手動篩選和手動檢視的記錄型索引檢視。
320 = 索引檢視表（僅限架構）。
status tinyint 可以是 一或多個發行項屬性的 & （位 AND） 結果：

0x00 = 僅供參考之用識別。 不支援。 我們無法保證未來的相容性。
0x01 = 發行項為使用中。
0x08 = 在 insert 語句中包含資料行名稱。
0x16 = 使用參數化語句。
0x32 = 使用參數化語句，並在 insert 語句中包含資料行名稱。
filter nvarchar（257） 用來水平篩選數據表的預存程式。 您必須使用 FOR REPLICATION 子句建立這個預存程式。
description nvarchar(255) 文章的描述性專案。
insert_command nvarchar(255) 使用數據表發行項復寫插入時所使用的複寫命令類型。 1
update_command nvarchar(255) 使用數據表發行項復寫更新時所使用的複寫命令類型。 1
delete_command nvarchar(255) 使用數據表發行項復寫刪除時所使用的複寫命令類型。 1
creation script path nvarchar(255) 用來建立目標數據表之發行項架構腳本的路徑和名稱。
vertical partition bit 是否啟用發行項的垂直數據分割;其中的值 1 表示已啟用垂直數據分割。
pre_creation_cmd tinyint 、 DELETE TABLE或TRUNCATE TABLE的DROP TABLE預先建立命令。
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設定為 或auto_identity_range設定為 auto true，則發行者端識別範圍的範圍大小。
identity_range bigint 如果發行項已identityrangemanagementoption設定為 或auto_identity_range設定為 auto true，則訂閱者端的識別範圍範圍大小。
threshold bigint 指出 散發代理程式 指派新識別範圍的百分比值。
identityrangemanagementoption int 指出針對發行項處理的識別範圍管理。
fire_triggers_on_snapshot bit 這是如果在套用初始快照集時執行複寫的使用者觸發程式。

1 = 執行使用者觸發程式。
0 = 不會執行使用者觸發程式。

1 如需詳細資訊，請參閱 交易式發行項 - 指定變更的傳播方式。

傳回碼值

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

備註

sp_helparticle 用於快照式複寫和事務複製。

權限

只有 sysadmin 固定伺服器角色、db_owner固定資料庫角色的成員，或目前發行集的發行集存取清單可以執行 sp_helparticle。

範例

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

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

相關內容