sp_changearticle (Transact-SQL)

變更交易式或快照式發行集中之發行項的屬性。這個預存程序執行於發行集資料庫的發行者端。

Transact-SQL 語法慣例

語法

sp_changearticle [ [@publication= ] 'publication' ]
    [ , [ @article= ] 'article' ]
    [ , [ @property= ] 'property' ]
    [ , [ @value= ] 'value' ]
    [ , [ @force_invalidate_snapshot = ] force_invalidate_snapshot ]
    [ , [ @force_reinit_subscription = ] force_reinit_subscription ]
    [ , [ @publisher = ] 'publisher' ]

引數

• [ @publication = ] 'publication'
  這是包含發行項之發行集的名稱。publication 是 sysname，沒有預設值。

• [ @article = ] 'article'
  這是要變更其屬性的發行項名稱。article 是 sysname，沒有預設值。

• [ @property=] 'property'
  這是要變更的發行項屬性。property 是 nvarchar(100)。

• [ @value=] 'value'
  這是發行項屬性的新值。value 是 nvarchar(255)。

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

  屬性	值	描述
  creation_script		用於建立目標資料表之發行項結構描述指令碼的路徑和名稱。預設值是 NULL。
  del_cmd		要執行的 DELETE 陳述式；否則，便從記錄檔中建構它。
  description		發行項的新描述項目。
  dest_object		提供這個項目的目的，是為了與舊版相容。請使用 dest_table。
  dest_table		新的目的地資料表。
  destination_owner		目的地物件的擁有者名稱。
  filter		用於篩選資料表 (水平篩選) 的新預存程序。預設值是 NULL。點對點複寫發行集的這個項目不能變更。
  fire_triggers_on_snapshot	true	在套用初始快照集時，執行複寫的使用者觸發程序。 附註 為了複寫觸發程序，schema_option 的位元遮罩值必須包括 0x100 值。
  	false	在套用初始快照集時，不執行複寫的使用者觸發程序。
  identity_range		控制在訂閱者端指派的指派識別範圍大小。不支援點對點複寫使用這個項目。
  ins_cmd		要執行的 INSERT 陳述式；否則，便從記錄檔中建構它。
  pre_creation_cmd		可以在套用同步處理之前，卸除、刪除或截斷目的地資料表的預先建立命令。
  	none	不使用命令。
  	drop	卸除目的地資料表。
  	delete	刪除目的地資料表。
  	truncate	截斷目的地資料表。
  pub_identity_range		控制在訂閱者端指派的指派識別範圍大小。不支援點對點複寫使用這個項目。
  schema_option		指定給定發行項之結構描述產生選項的點陣圖。schema_option 是 binary(8)。如需詳細資訊，請參閱本主題稍後的「備註」一節。
  	0x00	停用快照集代理程式的指令碼。
  	0x01	產生物件的建立作業 (CREATE TABLE、CREATE PROCEDURE 等)。
  	0x02	如果已定義的話，便產生傳播發行項變更的預存程序。
  	0x04	識別欄位的指令碼是利用 IDENTITY 屬性來編寫的。
  	0x08	複寫 timestamp 資料行。如果未設定，timestamp 資料行會複寫為 binary。
  	0x10	產生對應的叢集索引。
  	0x20	在訂閱者端將使用者定義資料類型 (UDT) 轉換成基底資料類型。如果 UDT 資料行是主索引鍵的一部分或計算資料行參考 UDT 資料行，則當 UDT 資料行中有 CHECK 或 DEFAULT 條件約束時，就不能使用這個選項。不支援 Oracle 發行者使用這個值。
  	0x40	產生對應的非叢集索引。
  	0x80	包括主索引鍵的宣告式參考完整性。
  	0x100	複寫資料表發行項的使用者觸發程序 (如果定義的話)。
  	0x200	複寫 FOREIGN KEY 條件約束。如果參考的資料表不是發行集的一部分，便不會複寫發行資料表上任何的 FOREIGN KEY 條件約束。
  	0x400	複寫 CHECK 條件約束。
  	0x800	複寫預設值。
  	0x1000	複寫資料行層級定序。
  	0x2000	複寫與已發行之發行項來源物件相關聯的擴充屬性。
  	0x4000	如果資料表發行項上定義了唯一索引鍵，便複寫唯一索引鍵。
  	0x8000	複寫資料表發行項的主索引鍵和唯一索引鍵，來做為使用 ALTER TABLE 陳述式的條件約束。 附註 這個選項已被取代。請改用 0x80 和 0x4000。
  	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 中所導入的大型物件資料類型 (nvarchar(max)、varchar(max) 和 varbinary(max)) 轉換成 SQL Server 2000 所支援的資料類型。如需有關這些類型對應方式的詳細資訊，請參閱＜在複寫拓撲中使用多個 SQL Server 版本＞中的「針對舊版本對應新資料類型」一節。
  	0x40000000	複寫權限。
  	0x80000000	嘗試卸除對於不在發行集中之任何物件的相依性。
  	0x100000000	使用這個選項即可複寫 FILESTREAM 屬性 (如果它指定於 varbinary(max) 資料行上的話)。如果您要將資料表複寫至 SQL Server 2005 訂閱者，請勿指定這個選項。目前不支援將含有 FILESTREAM 資料行的資料表複寫至 SQL Server 2000 訂閱者，不論這個結構描述選項的設定方式為何都一樣。 請參閱相關的選項 0x800000000。
  	0x200000000	將 SQL Server 2008 中所導入的日期和時間資料類型 (date、time、datetimeoffset 和 datetime2) 轉換成舊版 SQL Server 所支援的資料類型。如需有關這些類型對應方式的詳細資訊，請參閱＜在複寫拓撲中使用多個 SQL Server 版本＞中的「針對舊版本對應新資料類型」一節。
  	0x400000000	複寫資料與索引的壓縮選項。如需詳細資訊，請參閱＜建立壓縮資料表及索引＞。
  	0x800000000	設定這個選項即可將 FILESTREAM 資料儲存在訂閱者端的檔案群組中。如果沒有設定這個選項，FILESTREAM 資料就會儲存在預設檔案群組中。複寫不會建立檔案群組。因此，如果您設定這個選項，就必須先建立檔案群組，然後再於訂閱者端套用快照集。如需有關如何在套用快照集之前建立物件的詳細資訊，請參閱＜在套用快照集的前後執行指令碼＞。 請參閱相關的選項 0x100000000。
  	0x1000000000	將大於 8000 個位元組的 Common Language Runtime (CLR) 使用者定義型別 (UDT) 轉換成 varbinary(max)，如此 UDT 類型的資料行就可以複寫至正在執行 SQL Server 2005 的訂閱者。
  	0x2000000000	將 hierarchyid 資料類型轉換成 varbinary(max)，如此 hierarchyid 類型的資料行就可以複寫至正在執行 SQL Server 2005 的訂閱者。如需有關如何在複寫資料表中使用 hierarchyid 資料行的詳細資訊，請參閱＜hierarchyid (Transact-SQL)＞。
  	0x4000000000	複寫資料表上任何已篩選的索引。如需有關已篩選之索引的詳細資訊，請參閱＜篩選索引設計指導方針＞。
  	0x8000000000	將 geography 和 geometry 資料類型轉換成 varbinary(max)，如此這些類型的資料行就可以複寫至正在執行 SQL Server 2005 的訂閱者。
  	0x10000000000	複寫 geography 和 geometry 類型之資料行的索引。
  	0x20000000000	複寫資料行的 SPARSE 屬性。如需有關這個屬性的詳細資訊，請參閱＜使用疏鬆資料行＞。
  status		指定屬性的新狀態。
  	dts horizontal partitions	僅供參考之用。不支援。我們無法保證未來的相容性。
  	include column names	資料行名稱包括在複寫的 INSERT 陳述式中。
  	no column names	資料行名稱不包括在複寫的 INSERT 陳述式中。
  	no dts horizontal partitions	發行項的水平資料分割並非由可轉換的訂閱來定義。
  	none	清除 sysarticles 資料表中的所有狀態選項，將發行項標示為非使用中。
  	parameters	利用參數化的命令，將變更傳播到訂閱者。這是新發行項的預設值。
  	string literals	利用字串常值，將變更傳播到訂閱者。
  sync_object		用於產生同步處理輸出檔之資料表或檢視的名稱。預設值是 NULL。不支援 Oracle 發行者使用這個值。
  tablespace		識別 Oracle 資料庫發行的發行項之記錄資料表所用的資料表空間。如需詳細資訊，請參閱＜管理 Oracle 資料表空間＞。
  threshold		用於控制散發代理程式指派新識別範圍之時機的百分比值。不支援點對點複寫使用這個項目。
  type		不支援 Oracle 發行者使用這個值。
  	logbased	記錄式發行項。
  	logbased manualboth	記錄式且含有手動篩選準則和手動檢視的發行項。此選項需要同時設定 sync_object 和 filter 屬性。不支援 Oracle 發行者使用這個值。
  	logbased manualfilter	記錄式且含有手動篩選準則的發行項。此選項需要同時設定 sync_object 和 filter 屬性。不支援 Oracle 發行者使用這個值。
  	logbased manualview	含有手動檢視的記錄式發行項。此選項需要同時設定 sync_object 屬性。不支援 Oracle 發行者使用這個值。
  	indexed viewlogbased	記錄式索引檢視發行項。不支援 Oracle 發行者使用這個值。這種類型的發行項不需要個別發行基底資料表。
  	indexed viewlogbased manualboth	記錄式且含有手動篩選和手動檢視的索引檢視發行項。此選項需要同時設定 sync_object 和 filter 屬性。這種類型的發行項不需要個別發行基底資料表。不支援 Oracle 發行者使用這個值。
  	indexed viewlogbased manualfilter	記錄式且含有手動篩選準則的索引檢視發行項。此選項需要同時設定 sync_object 和 filter 屬性。這種類型的發行項不需要個別發行基底資料表。不支援 Oracle 發行者使用這個值。
  	indexed viewlogbased manualview	含有手動檢視的記錄式索引檢視發行項。此選項需要同時設定 sync_object 屬性。這種類型的發行項不需要個別發行基底資料表。不支援 Oracle 發行者使用這個值。
  upd_cmd		要執行的 UPDATE 陳述式；否則，便從記錄檔中建構它。
  NULL	NULL	傳回可變更的發行項屬性清單。

• [ @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 指定發行項的變更會使現有的訂閱重新初始化，且會提供將發生之訂閱重新初始化的權限。

  請參閱「備註」一節，以了解在變更時需要重新初始化所有現有的訂閱之屬性。

• [ @publisher= ] 'publisher'
  指定非 SQL Server 發行者。publisher 是 sysname，預設值是 NULL。

  [!附註]

  當在 SQL Server 發行者上變更發行項屬性時，不應使用 publisher。

傳回碼值

0 (成功) 或 1 (失敗)

備註

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

當發行項屬於支援點對點交易式複寫的發行集時，您只能變更 description、ins_cmd、upd_cmd 和 del_cmd 屬性。

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

• del_cmd

• dest_table

• destination_owner

• ins_cmd

• pre_creation_cmd

• schema_options

• upd_cmd

變更下列中的任何屬性都需要重新初始化現有的訂閱，但您必須指定 1 值給 force_reinit_subscription 參數。

• del_cmd

• dest_table

• destination_owner

• filter

• ins_cmd

• status

• upd_cmd

在現有的發行集內，您可以利用 sp_changearticle 來變更發行項，並不需要卸除再重新建立整個發行集。

[!附註]

當變更 schema_option 的值時，系統不會執行位元更新。這表示當您利用 sp_changearticle 來設定 schema_option 時，可能會關閉現有的位元設定。若要保留現有的設定，應該在您設定的值和 schema_option 目前的值 (可以執行 sp_helparticle 來判斷它的值) 之間執行 & (位元 AND)。

有效結構描述選項

下表描述以複寫類型 (顯示在頂端) 和發行項類型 (顯示在第一個資料行之下) 為基礎，schema_option 所能使用的值。

發行項類型	複寫類型
	交易式	快照集
logbased	所有選項	0x02 以外的所有選項
logbased manualfilter	所有選項	0x02 以外的所有選項
logbased manualview	所有選項	0x02 以外的所有選項
indexed view logbased	所有選項	0x02 以外的所有選項
indexed view logbased manualfilter	所有選項	0x02 以外的所有選項
indexed view logbased manualview	所有選項	0x02 以外的所有選項
indexed view logbase manualboth	所有選項	0x02 以外的所有選項
proc exec	0x01、0x20、0x2000、0x400000、0x800000、0x2000000、0x8000000、0x10000000、0x20000000、0x40000000 和 0x80000000	0x01、0x20、0x2000、0x400000、0x800000、0x2000000、0x8000000、0x10000000、0x20000000、0x40000000 和 0x80000000
serializable proc exec	0x01、0x20、0x2000、0x400000、0x800000、0x2000000、0x8000000、0x10000000、0x20000000、0x40000000 和 0x80000000	0x01、0x20、0x2000、0x400000、0x800000、0x2000000、0x8000000、0x10000000、0x20000000、0x40000000 和 0x80000000
proc schema only	0x01、0x20、0x2000、0x400000、0x800000、0x2000000、0x8000000、0x10000000、0x20000000、0x40000000 和 0x80000000	0x01、0x20、0x2000、0x400000、0x800000、0x2000000、0x8000000、0x10000000、0x20000000、0x40000000 和 0x80000000
view schema only	0x01、0x010、0x020、0x040、0x0100、0x2000、0x40000、0x100000、0x200000、0x400000、0x800000、0x2000000、0x8000000、0x40000000 和 0x80000000	0x01、0x010、0x020、0x040、0x0100、0x2000、0x40000、0x100000、0x200000、0x400000、0x800000、0x2000000、0x8000000、0x40000000 和 0x80000000
func schema only	0x01、0x20、0x2000、0x400000、0x800000、0x2000000、0x8000000、0x10000000、0x20000000、0x40000000 和 0x80000000	0x01、0x20、0x2000、0x400000、0x800000、0x2000000、0x8000000、0x10000000、0x20000000、0x40000000 和 0x80000000
indexed view schema only	0x01、0x010、0x020、0x040、0x0100、0x2000、0x40000、0x100000、0x200000、0x400000、0x800000、0x2000000、0x8000000、0x40000000 和 0x80000000	0x01、0x010、0x020、0x040、0x0100、0x2000、0x40000、0x100000、0x200000、0x400000、0x800000、0x2000000、0x8000000、0x40000000 和 0x80000000

[!附註]

如果是佇列更新發行集，必須啟用 0x80 的 schema_option 值。支援的非 SQL Server 發行集 schema_option 值如下：0x01、0x02、0x10、0x40、0x80、0x1000 和 0x4000。

範例

DECLARE @publication AS sysname;
DECLARE @article AS sysname;
DECLARE @option AS int;
SET @publication = N'AdvWorksProductTran';
SET @article = N'Product';
SET @option = (SELECT CAST(0x0000000002030073 AS int));

-- Change the schema options to replicate schema with XML.
USE [AdventureWorks]
EXEC sp_changearticle 
  @publication = @publication,
  @article = @article, 
  @property = N'schema_option', 
  @value = @option,
  @force_invalidate_snapshot = 1;
GO

權限

只有系統管理員 (sysadmin) 固定伺服器角色或 db_owner 固定資料庫角色的成員，才能夠執行 sp_changearticle。

請參閱

工作

如何：檢視和修改發行項屬性 (複寫 Transact-SQL 程式設計)

參考

sp_addarticle (Transact-SQL)

sp_articlecolumn (Transact-SQL)

sp_droparticle (Transact-SQL)

sp_helparticle (Transact-SQL)

sp_helparticlecolumns (Transact-SQL)

概念

變更發行集與發行項屬性