sp_changemergearticle (Transact-SQL)

Область применения: SQL Server

Изменяет свойства статьи публикации слиянием. Эта хранимая процедура выполняется на издателе в базе данных публикации.

Соглашения о синтаксисе Transact-SQL

Синтаксис

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) и может быть одним из значений, перечисленных в следующей таблице.

Эта таблица описывает свойства статей и значения этих свойств.

[ @force_invalidate_snapshot = ] force_invalidate_snapshot

Подтверждает, что действие, выполненное этой хранимой процедурой, может сделать недействительным существующий моментальный снимок. @force_invalidate_snapshot бит с значением по умолчанию0.

• 0 указывает, что изменения в статье слияния не вызывают недопустимого моментального снимка. Если хранимая процедура определяет, что изменение требует создания нового моментального снимка, возникает ошибка и изменения не выполняются.

• 1 означает, что изменения в статье слиянием могут привести к недопустимому моментальному снимку, и если существуют существующие подписки, для которых требуется новый моментальный снимок, дает разрешение для того, чтобы существующий моментальный снимок был помечен как устаревший и созданный новый моментальный снимок.

См. раздел "Примечания " для свойств, которые при изменении требуют создания нового моментального снимка.

[ @force_reinit_subscription = ] force_reinit_subscription

Подтверждает, что действие, выполняемое данной хранимой процедурой, может сделать необходимой повторную инициализацию существующих подписок. @force_reinit_subscription бит с значением по умолчанию0.

• 0 указывает, что изменения в статье слияния не приводят к повторной инициализации подписки. Если хранимая процедура определяет, что изменения потребуют повторной инициализации подписок, возникает ошибка, и изменения не выполняются.

• 1 означает, что изменения в статье слиянием приводят к повторной инициализации существующих подписок и предоставляют разрешение на повторную инициализацию подписки.

В разделе "Примечания " описаны свойства, которые при изменении требуют повторной инициализации всех существующих подписок.

Значения кода возврата

0 (успешно) или 1 (сбой).

Замечания

sp_changemergearticle используется в репликации слиянием.

Так как sp_changemergearticle используется для изменения свойств статьи, которые изначально были указаны с помощью sp_addmergearticle, см . sp_addmergearticle дополнительные сведения об этих свойствах.

Для изменения следующих свойств требуется создать новый моментальный снимок, и необходимо указать значение 1 параметра @force_invalidate_snapshot :

• check_permissions
• column_tracking
• destination_owner
• pre_creation_command
• schema_options
• subset_filterclause

Для изменения следующих свойств требуется повторно инициализировать существующие подписки, и необходимо указать значение 1 параметра @force_reinit_subscription :

• 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

При указании значения для метаданных 3 partition_optionsудаляются всякий раз, когда выполняется агент слияния, а секционированные моментальные снимки истекают быстрее. При использовании этого параметра следует разрешить запрошенный подписчиком секционированный снимок. Дополнительные сведения см. в статье Создание моментального снимка для публикации слиянием с параметризованными фильтрами.

При задании column_tracking свойства, если таблица уже опубликована в других публикациях слиянием, отслеживание столбцов должно совпадать со значением, используемым существующими статьями на основе этой таблицы. Этот параметр применим только для статей таблиц.

Если несколько публикаций публикуют статьи на основе одной базовой таблицы, изменение delete_tracking свойства или compensate_for_errors свойства для одной статьи приводит к тому же изменению других статей, основанных на одной таблице.

Если учетная запись издателя, используемая процессом слияния, не имеет правильных разрешений на таблицу, недопустимые изменения регистрируются как конфликты.

При изменении значения schema_optionсистема не выполняет побитовое обновление. Это означает, что при настройке schema_option использования sp_changemergearticleсуществующие битовые параметры могут быть отключены. Чтобы сохранить существующие параметры, следует выполнить и ( Побитовая и) между заданным значением и текущим значением schema_option, которое можно определить, выполнив sp_helpmergearticle.

Допустимая таблица параметров схемы

В следующей таблице описаны допустимые schema_option значения в зависимости от типа статьи.

Примеры

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

Разрешения

Могут выполняться только члены предопределенных ролей сервера sysadmin или db_owner предопределенных ролей базы данных.sp_changemergearticle

Связанный контент

• View and Modify Article Properties (Просмотр и изменение свойств статьи)
• Изменение свойств публикации и статьи
• sp_addmergearticle (Transact-SQL)
• sp_dropmergearticle (Transact-SQL)
• sp_helpmergearticle (Transact-SQL)
• Хранимые процедуры репликации (Transact-SQL)