sp_changemergepublication (Transact-SQL)

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

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

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

Синтаксис

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

Аргументы

[ @publication = ] N'publication'

Имя публикации. @publication — sysname без значения по умолчанию.

[ @property = ] N'property'

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

[ @value = ] N'value'

Новое значение заданного свойства. @value — nvarchar(255) с значением по умолчаниюNULL.

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

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

[ @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_changemergepublication используется в репликации слиянием.

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

• alt_snapshot_folder
• compress_snapshot
• dynamic_filters
• ftp_address
• ftp_login
• ftp_password
• ftp_port
• ftp_subdirectory
• post_snapshot_script
• publication_compatibility_level (только для 80SP3 )
• pre_snapshot_script
• snapshot_in_defaultfolder
• sync_mode
• use_partition_groups

Изменение этих свойств потребует повторной инициализации существующих подписок. Необходимо указать значение 1 параметра @force_reinit_subscription .

• dynamic_filters
• validate_subscriber_info

Чтобы перечислить объекты публикации в Active Directory с помощью, publish_to_active_directoryобъект SQL Server должен быть уже создан в Active Directory.

Примеры

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

-- Disable DDL replication for the publication.
USE [AdventureWorks2022]
EXEC sp_changemergepublication 
  @publication = @publication, 
  @property = N'replicate_ddl', 
  @value = 0,
  @force_invalidate_snapshot = 0, 
  @force_reinit_subscription = 0;
GO

Разрешения

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

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

• Просмотр и изменение свойств публикации
• Изменение свойств публикации и статьи
• sp_addmergepublication (Transact-SQL)
• sp_dropmergepublication (Transact-SQL)
• sp_helpmergepublication (Transact-SQL)
• Хранимые процедуры репликации (Transact-SQL)