sp_changemergearticle (Transact-SQL)

發行項
08/21/2024

適用於：SQL Server

變更合併發行項的屬性。這個預存程式會在發行集資料庫的發行者端執行。

語法

sp_changemergearticle
    [ @publication = ] N'publication'
    , [ @article = ] N'article'
    [ , [ @property = ] N'property' ]
    [ , [ @value = ] N'value' ]
    [ , [ @force_invalidate_snapshot = ] force_invalidate_snapshot ]
    [ , [ @force_reinit_subscription = ] force_reinit_subscription ]
[ ; ]

引數

[ @publication = ] N'publication'

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

[ @article = ] N'article'

要變更之發行項的名稱。 @article為 sysname，沒有預設值。

[ @property = ] N'property'

要變更指定發行項和發行集的屬性。 @property為 sysname，而且可以是下表所列的其中一個值。

[ @value = ] N'value'

指定之屬性的新值。 @value是 nvarchar（2000），而且可以是下表所列的其中一個值。

下表描述發行項的屬性和這些屬性的值。

屬性	值	描述
`allow_interactive_resolver`	`true`	啟用發行項的互動式解析程式使用。
	`false`	停用發行項的互動式解析程式使用。
`article_resolver`		發行項的自定義解析程式。僅適用於數據表發行項。
`check_permissions` （點陣圖）	`0x00`	不會檢查數據表層級許可權。
	`0x10`	在發行者端套用 INSERT 語句之前，會在發行者端檢查數據表層級的許可權。
	`0x20`	在發行者端套用 UPDATE 語句之前，會在發行者端檢查數據表層級許可權。
	`0x40`	在發行者端套用訂閱者的 DELETE 語句之前，會在發行者端檢查數據表層級許可權。
`column_tracking`	`true`	開啟數據行層級追蹤。僅適用於數據表發行項。注意：發行超過 246 個數據行的數據表時，無法使用數據行層級追蹤。
	`false`	關閉數據行層級追蹤，並在數據列層級留下衝突偵測。僅適用於數據表發行項。
`compensate_for_errors`	`true`	同步處理期間發生錯誤時，會執行補償動作。如需詳細資訊，請參閱 sp_addmergearticle。
	`false`	不會執行補償動作，這是預設行為。如需詳細資訊，請參閱 sp_addmergearticle。重要事項：雖然受影響數據列中的數據似乎無法聚合，但只要解決任何錯誤、可以套用變更，以及數據聚合。如果發行項的源數據表已經發行在另一個發行集中，則兩個發行項的值 `compensate_for_errors` 都必須相同。
`creation_script`		用來在訂用帳戶資料庫中建立發行項的選擇性發行項架構腳本的路徑和名稱。
`delete_tracking`	`true`	DELETE 語句會復寫，這是預設行為。
	`false`	不會復寫 DELETE 語句。重要事項：將設定 `delete_tracking` 為 `false` 會導致非聚合，而且必須手動移除已刪除的數據列。
`description`		文章的描述性專案。
`destination_owner`		如果不是 dbo，則為訂用帳戶資料庫中對象的擁有者名稱。
`identity_range`		bigint，指定當發行項設定`identityrangemanagementoption`為或 `auto_identity_range` 設定`true`為 `auto` 時，指派新識別值時要使用的範圍大小。僅適用於數據表發行項。如需詳細資訊，請參閱復寫識別數據行的一節。
`identityrangemanagementoption`	`manual`	停用自動識別範圍管理。使用 NOT FOR REPLICATION 標記識別數據行，以啟用手動識別範圍處理。如需詳細資訊，請參閱複寫識別資料欄。
	`none`	停用所有身分識別範圍管理。
`logical_record_level_conflict_detection`	`true`	如果在邏輯記錄中的任何位置進行變更，就會偵測到衝突。需要將 `logical_record_level_conflict_resolution` 設定為 `true`。
	`false`	默認衝突偵測會如所指定使用 `column_tracking`。
`logical_record_level_conflict_resolution`	`true`	整個獲勝的邏輯記錄會覆寫遺失的邏輯記錄。
	`false`	獲勝的數據列不會受限於邏輯記錄。
`partition_options`	`0`	發行項的篩選是靜態的，或不會產生每個數據分割的唯一數據子集，也就是「重疊」的數據分割。
	`1`	分割區重疊，而且訂閱者端進行的 DML 更新無法變更數據列所屬的數據分割。
	`2`	發行項的篩選會產生非重疊的數據分割，但多個訂閱者可以接收相同的分割區。
	`3`	發行項的篩選會產生每個訂用帳戶唯一的非重疊分割區。注意：如果您針對 `partition_options`指定的值`3`，該文章中每個數據分割只能有單一訂用帳戶。如果建立第二個訂用帳戶，其中新訂用帳戶的篩選準則會解析為與現有訂用帳戶相同的分割區，則會卸除現有的訂用帳戶。
`pre_creation_command`	`none`	如果數據表已存在於訂閱者端，則不會採取任何動作。
	`delete`	根據子集篩選中的 WHERE 子句發出刪除。
	`drop`	在重新建立數據表之前，請先卸除數據表。
	`truncate`	截斷目的地數據表。
`processing_order`		int ，表示合併式發行集中發行項的處理順序。
`pub_identity_range`		bigint，如果發行項已`identityrangemanagementoption`設定為或 `auto_identity_range` 設定`true`為 `auto` ，則指定配置給具有伺服器訂閱之訂閱者的範圍大小。此識別範圍會保留給重新發行的訂閱者，以配置給自己的訂閱者。僅適用於數據表發行項。如需詳細資訊，請參閱復寫識別數據行的一節。
`published_in_tran_pub`	`true`	發行項也會發行在交易式發行集中。
	`false`	發行項也不會在交易式發行集中發行。
`resolver_info`		用來指定自定義解析程式所需的其他資訊。某些Microsoft解析程式需要提供數據行做為解析程序的輸入。 `resolver_info` 是 nvarchar（255），預設值為 `NULL`。如需詳細資訊，請參閱進階合併式複寫衝突 - COM 型解析程式。
`schema_option` （點陣圖）		如需詳細資訊，請參閱備註一節。
	`0x00`	停用快照集代理程式的腳本，並使用中`creation_script`提供的腳本。
	`0x01`	產生物件建立腳本（CREATE TABLE、CREATE PROCEDURE 等等）。
	`0x10`	產生對應的叢集索引。
	`0x20`	將使用者定義的數據類型轉換成訂閱者端的基底數據類型。如果 UDT 資料行是主鍵的一部分，或是計算數據行參考 UDT 資料行，則當使用者定義類型（UDT）資料行上有 CHECK 或 DEFAULT 條件約束時，就無法使用這個選項。
	`0x40`	產生對應的非叢集索引。
	`0x80`	在主鍵上包含宣告的引用完整性。
	`0x100`	如果已定義，則復寫數據表發行項上的使用者觸發程式。
	`0x200`	復寫 FOREIGN KEY 條件約束。如果參考的數據表不是發行集的一部分，則不會復寫已發行數據表上的所有FOREIGN KEY條件約束。
	`0x400`	復寫 CHECK 條件約束。
	`0x800`	複寫預設值。
	`0x1000`	復寫數據行層級定序。
	`0x2000`	復寫與已發佈發行發行項來源對象相關聯的擴充屬性。
	`0x4000`	如果在數據表發行項上定義，則復寫唯一索引鍵。
	`0x8000`	在編寫條件約束腳本時產生 ALTER TABLE 語句。
	`0x10000`	將 CHECK 條件約束複寫為 NOT FOR REPLICATION，以便在同步處理期間不會強制執行條件約束。
	`0x20000`	將FOREIGN KEY條件約束複寫為NOT FOR REPLICATION，以便在同步處理期間不會強制執行條件約束。
	`0x40000`	復寫與數據分割數據表或索引相關聯的檔案群組。
	`0x80000`	復寫數據分割數據表的數據分割配置。
	`0x100000`	復寫數據分割索引的數據分割配置。
	`0x200000`	複寫數據表統計數據。
	`0x400000`	復寫預設系結
	`0x800000`	複寫規則系結
	`0x1000000`	複寫全文檢索索引
	`0x2000000`	系結至 xml 資料行的 XML 架構集合不會復寫。
	`0x4000000`	複寫 xml 資料行上的索引。
	`0x8000000`	建立訂閱者上尚未存在的任何架構。
	`0x10000000`	將 xml 資料行轉換成訂閱者上的 ntext 。
	`0x20000000`	將 SQL Server 2005 （9.x）中引進的大型物件數據類型（nvarchar（max）、 varchar（max）和 varbinary（max）轉換為 SQL Server 2000 （8.x）所支援的數據類型。
	`0x40000000`	複寫許可權。
	`0x80000000`	嘗試卸除不屬於發行集之任何物件的相依性。
	`0x100000000`	如果 varbinary（max）資料行上指定了 FILESTREAM 屬性，請使用此選項來復寫 FILESTREAM 屬性。如果您要將數據表復寫至 SQL Server 2005 （9.x）訂閱者，請勿指定此選項。不支援將 FILESTREAM 數據行復寫至 SQL Server 2000 （8.x）訂閱者的數據表，不論此架構選項的設定方式為何。請參閱相關選項 `0x800000000`。
	`0x200000000`	將 SQL Server 2008 （10.0.x）中引進的日期和時間資料類型（date、time、datetimeoffset 和 datetime2）轉換為舊版 SQL Server 所支援的數據類型。
	`0x400000000`	複寫數據和索引的壓縮選項。如需詳細資訊，請參閱 [資料壓縮]。
	`0x800000000`	將此選項設定為將 FILESTREAM 資料儲存在訂閱者端自己的檔案群組上。如果未設定此選項，FILESTREAM 數據會儲存在預設檔案群組上。複寫不會建立檔案群組;因此，如果您設定此選項，您必須先建立檔案群組，才能在訂閱者端套用快照集。如需如何在套用快照集之前建立對象的詳細資訊，請參閱套用快照集之前和之後執行腳本。請參閱相關選項 `0x100000000`。
	`0x1000000000`	將 Common Language Runtime （CLR）使用者定義型別（UDT）轉換為 varbinary（max），讓 UDT 類型的數據行可以復寫至執行 SQL Server 2005 （9.x）的訂閱者。
	`0x2000000000`	將hierarchyid資料類型轉換成 varbinary（max），以便將hierarchyid類型的數據行復寫至執行 SQL Server 2005 （9.x）的訂閱者。如需如何在復寫數據表中使用hierarchyid數據行的詳細資訊，請參閱hierarchyid資料類型方法參考。
	`0x4000000000`	復寫數據表上任何篩選的索引。如需已篩選索引的詳細資訊，請參閱建立篩選的索引 (機器翻譯)。
	`0x8000000000`	將 geography 和 geometry 數據類型轉換成 varbinary（max），以便將這些類型的數據行復寫至執行 SQL Server 2005 （9.x）的訂閱者。
	`0x10000000000`	復寫 geography 和 geometry 類型的數據行索引。
	`NULL`	系統會自動產生發行項的有效架構選項。
`status`	`active`	執行發行數據表的初始處理腳本。
	`unsynced`	下次執行快照集代理程式時，會執行發行數據表的初始處理腳本。
`stream_blob_columns`	`true`	復寫二進位大型物件數據行時，會使用數據流優化。不過，某些合併式複寫功能，例如邏輯記錄，仍然可以防止使用數據流優化。 `stream_blob_columns` 當啟用 FILESTREAM 時，會設定為 true。這可讓 FILESTREAM 數據的複寫以最佳方式執行，並減少記憶體使用率。若要強制 FILESTREAM 數據表發行項不使用 Blob 串流，請將設定 `stream_blob_columns` 為 false。重要事項：啟用此記憶體優化可能會損害同步處理期間合併代理程式的效能。只有當復寫包含數 MB 資料的數據行時，才應該使用此選項。
	`false`	在復寫二進位大型對象數據行時，不會使用優化。
`subscriber_upload_options`	`0`	對具有用戶端訂閱之訂閱者端的更新沒有任何限制;變更會上傳至發行者。變更此屬性可能需要重新初始化現有的訂閱者。
	`1`	用戶端訂閱的訂閱者允許變更，但不會上傳至發行者。
	`2`	用戶端訂用帳戶的訂閱者上不允許變更。
`subset_filterclause`		指定水平篩選的 WHERE 子句。僅適用於數據表發行項。重要：基於效能考慮，建議您不要將函式套用至參數化數據列篩選子句中的數據行名稱，例如 `LEFT([MyColumn]) = SUSER_SNAME()`。如果您在篩選子句中使用HOST_NAME並覆寫HOST_NAME值，您可能必須使用 CONVERT 來轉換資料類型。如需此案例最佳做法的詳細資訊，請參閱參數化篩選 - 參數化數據列篩選中的<覆寫HOST_NAME（）值>一節。
`threshold`		用於執行 SQL Server Compact 或舊版 SQL Server 之訂閱者的百分比值。 `threshold`會控制合併代理程式指派新的識別範圍。使用閾值中指定的值百分比時，合併代理程式會建立新的識別範圍。當設定為 `auto` 或 `auto_identity_range` 設定為 `true`時`identityrangemanagementoption`使用。僅適用於數據表發行項。如需詳細資訊，請參閱復寫識別數據行的一節。
`verify_resolver_signature`	`1`	自定義解析程式上的數位簽名會經過驗證，以判斷其是否來自受信任的來源。
	`0`	不會驗證自定義解析程式上的數位簽名，以判斷其是否來自信任的來源。
`NULL` (預設值)		傳回@property支援的值清單。

[ @force_invalidate_snapshot = ] force_invalidate_snapshot

確認此預存程式所採取的動作可能會使現有的快照集失效。 @force_invalidate_snapshot為 bit，預設值為 0。

0 指定合併發行項的變更不會造成快照集無效。如果預存程式偵測到變更確實需要新的快照集，就會發生錯誤，而且不會進行任何變更。
1 表示合併發行項的變更可能會導致快照集無效，而且如果有現有的訂用帳戶需要新的快照集，則為現有快照集的許可權標示為過時，併產生新的快照集。

如需變更時需要產生新快照集的屬性，請參閱<備註>一節。

[ @force_reinit_subscription = ] force_reinit_subscription

確認此預存程式所採取的動作可能需要重新初始化現有的訂用帳戶。 @force_reinit_subscription為 bit，預設值為 0。

0 指定合併發行項的變更不會使訂閱重新初始化。如果預存程式偵測到變更需要重新初始化現有的訂用帳戶，就會發生錯誤，而且不會進行任何變更。
1 表示合併發行項的變更會導致現有的訂閱重新初始化，並授與重新初始化訂閱的許可權。

如需變更時需要重新初始化所有現有訂閱的屬性，請參閱一節。

傳回碼值

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

備註

sp_changemergearticle 用於合併式複寫。

因為 sp_changemergearticle 用來變更最初使用 sp_addmergearticle 所指定的發行項屬性，請參閱 sp_addmergearticle 以取得這些屬性的詳細資訊。

變更下列屬性需要產生新的快照集，而且您必須為 @force_invalidate_snapshot 參數指定的值1：

check_permissions
column_tracking
destination_owner
pre_creation_command
schema_options
subset_filterclause

變更下列屬性需要重新初始化現有的訂閱，而且您必須為 @force_reinit_subscription 參數指定的值1：

check_permissions
column_tracking
destination_owner
pre_creation_command
identityrangemanagementoption
subscriber_upload_options
subset_filterclause
creation_script
schema_option
logical_record_level_conflict_detection
logical_record_level_conflict_resolution

當您為指定的值3partition_options時，每當執行合併代理程式且分割的快照集會更快過期時，就會清除元數據。使用此選項時，您應該考慮啟用訂閱者要求的分割快照集。如需詳細資訊，請參閱使用參數化篩選建立合併式發行集的快照集。

設定 column_tracking 屬性時，如果數據表已在其他合併式發行集中發行，則數據行追蹤必須與根據此數據表的現有發行項所使用的值相同。此參數僅適用於數據表發行項。

如果多個發行集根據相同的基礎表發行發行發行項，則變更 delete_tracking 一個發行項的屬性或 compensate_for_errors 屬性會導致對以相同數據表為基礎的其他發行項進行相同的變更。

如果合併進程所使用的發行者登入/用戶帳戶沒有正確的數據表許可權，則會將無效的變更記錄為衝突。

當您變更的值 schema_option時，系統不會執行位更新。這表示當您使用 sp_changemergearticle設定schema_option時，可能會關閉現有的位設定。若要保留現有的設定，您應該在所設定的值與目前的值之間執行和（Bitwise AND），其可藉由執行 sp_helpmergearticle 來schema_option決定。

警告

當您在出版物中執行許多（也許數百個）篇文章，且您 sp_changemergearticle 執行其中一篇文章時，可能需要很長的時間才能完成執行。

有效的架構選項數據表

下表說明允許 schema_option 的值，視發行項類型而定。

發行項類型	架構選項值
`func schema only`	`0x01` 和 `0x2000`
`indexed view schema only`	`0x01`、 `0x040`、 `0x0100`、、 `0x2000`、 `0x40000`、 `0x1000000`和 `0x200000`
`proc schema only`	`0x01` 和 `0x2000`
`table`	所有選項。
`view schema only`	`0x01`、 `0x040`、 `0x0100`、、 `0x2000`、 `0x40000`、 `0x1000000`和 `0x200000`

範例

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

-- Enable column-level conflict tracking.
-- Changing this property requires that existing subscriptions
-- be reinitialized and that a new snapshot be generated.
USE [AdventureWorks2022]
EXEC sp_changemergearticle 
  @publication = @publication,
  @article = @article, 
  @property = N'column_tracking', 
  @value = N'true',
  @force_invalidate_snapshot = 1,
  @force_reinit_subscription = 1;
GO

權限

只有系統管理員固定伺服器角色或db_owner固定資料庫角色的成員才能執行 sp_changemergearticle。

共用方式為

sp_changemergearticle (Transact-SQL)

語法

引數

[ @publication = ] N'publication'

[ @article = ] N'article'

[ @property = ] N'property'

[ @value = ] N'value'

[ @force_invalidate_snapshot = ] force_invalidate_snapshot

[ @force_reinit_subscription = ] force_reinit_subscription

傳回碼值

備註

有效的架構選項數據表

範例

權限

意見反應

其他資源

共用方式為

sp_changemergearticle (Transact-SQL)

語法

引數

[ @publication = ] N'publication'

[ @article = ] N'article'

[ @property = ] N'property'

[ @value = ] N'value'

[ @force_invalidate_snapshot = ] force_invalidate_snapshot

[ @force_reinit_subscription = ] force_reinit_subscription

傳回碼值

備註

有效的架構選項數據表

範例

權限

相關內容

意見反應

其他資源