sp_addmergearticle (Transact-SQL)

Область применения: SQL Server Управляемый экземпляр SQL Azure

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

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

Синтаксис

sp_addmergearticle
    [ @publication = ] N'publication'
    , [ @article = ] N'article'
    , [ @source_object = ] N'source_object'
    [ , [ @type = ] N'type' ]
    [ , [ @description = ] N'description' ]
    [ , [ @column_tracking = ] N'column_tracking' ]
    [ , [ @status = ] N'status' ]
    [ , [ @pre_creation_cmd = ] N'pre_creation_cmd' ]
    [ , [ @creation_script = ] N'creation_script' ]
    [ , [ @schema_option = ] schema_option ]
    [ , [ @subset_filterclause = ] N'subset_filterclause' ]
    [ , [ @article_resolver = ] N'article_resolver' ]
    [ , [ @resolver_info = ] N'resolver_info' ]
    [ , [ @source_owner = ] N'source_owner' ]
    [ , [ @destination_owner = ] N'destination_owner' ]
    [ , [ @vertical_partition = ] N'vertical_partition' ]
    [ , [ @auto_identity_range = ] N'auto_identity_range' ]
    [ , [ @pub_identity_range = ] pub_identity_range ]
    [ , [ @identity_range = ] identity_range ]
    [ , [ @threshold = ] threshold ]
    [ , [ @verify_resolver_signature = ] verify_resolver_signature ]
    [ , [ @destination_object = ] N'destination_object' ]
    [ , [ @allow_interactive_resolver = ] N'allow_interactive_resolver' ]
    [ , [ @fast_multicol_updateproc = ] N'fast_multicol_updateproc' ]
    [ , [ @check_permissions = ] check_permissions ]
    [ , [ @force_invalidate_snapshot = ] force_invalidate_snapshot ]
    [ , [ @published_in_tran_pub = ] N'published_in_tran_pub' ]
    [ , [ @force_reinit_subscription = ] force_reinit_subscription ]
    [ , [ @logical_record_level_conflict_detection = ] N'logical_record_level_conflict_detection' ]
    [ , [ @logical_record_level_conflict_resolution = ] N'logical_record_level_conflict_resolution' ]
    [ , [ @partition_options = ] partition_options ]
    [ , [ @processing_order = ] processing_order ]
    [ , [ @subscriber_upload_options = ] subscriber_upload_options ]
    [ , [ @identityrangemanagementoption = ] N'identityrangemanagementoption' ]
    [ , [ @delete_tracking = ] N'delete_tracking' ]
    [ , [ @compensate_for_errors = ] N'compensate_for_errors' ]
    [ , [ @stream_blob_columns = ] N'stream_blob_columns' ]
[ ; ]

Аргументы

[ @publication = ] N'publication'

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

[ @article = ] N'article'

Имя статьи. Имя должно быть уникальным в пределах публикации. @article — sysname без значения по умолчанию. @article должен находиться на локальном компьютере под управлением SQL Server и должен соответствовать правилам для идентификаторов.

[ @source_object = ] N'source_object'

Объект базы данных, который будет опубликован. @source_object — sysname без значения по умолчанию. Дополнительные сведения о типах объектов, которые могут быть опубликованы с помощью репликации слиянием, см. в разделе "Публикация данных и объектов базы данных".

[ @type = ] N'type'

Тип статьи. @type — sysname, значение по умолчанию tableи может быть одним из следующих значений.

[ @description = ] N'description'

Описание статьи. @description имеет значение nvarchar(255) с значением по умолчаниюNULL.

[ @column_tracking = ] N'column_tracking'

Параметр отслеживания на уровне столбцов. @column_tracking — nvarchar(10) с значением по умолчаниюfalse. false включает отслеживание столбцов. false отключает отслеживание столбцов и оставляет обнаружение конфликтов на уровне строки. Если таблица уже опубликована в других публикациях слиянием, необходимо использовать для параметра отслеживания столбца то же значение, что и для существующих статей, основанных на данной таблице. Этот параметр применим только для статей таблиц.

[ @status = ] N'status'

Состояние статьи. @status — nvarchar(10) с значением по умолчаниюunsynced. Если activeвыполняется начальный скрипт обработки для публикации таблицы. Если unsyncedначальный скрипт обработки для публикации таблицы запускается при следующем запуске агент моментальных снимков.

[ @pre_creation_cmd = ] N'pre_creation_cmd'

Указывает действие системы, если во время применения моментального снимка таблица уже существует на подписчике. @pre_creation_cmd — nvarchar(10) и может быть одним из следующих значений.

[ @creation_script = ] N'creation_script'

Путь и имя необязательного сценария схемы статьи, используемого для создания статьи в базе данных подписки. @creation_script — nvarchar(255) с значением по умолчаниюNULL.

[ @schema_option = ] schema_option

Растровое изображение параметра создания схемы для данной статьи. @schema_option является varbinary(8), и может быть | (битовое ИЛИ) продукт одного или нескольких из этих значений.

Если это значение равно NULL, система автоматически создает допустимый параметр схемы для статьи. Таблица параметров схемы по умолчанию показывает значение, выбранное на основе типа статьи. Кроме того, не все значения @schema_option допустимы для каждого типа репликации и типа статьи. В таблице параметров допустимой схемы показаны параметры, которые можно указать для заданного типа статьи.

[ @subset_filterclause = ] N'subset_filterclause'

Предложение WHERE, указывающее горизонтальное фильтрацию статьи таблицы без включенного слова WHERE. @subset_filterclause — nvarchar(1000) с пустой строкой по умолчанию.

[ @article_resolver = ] N'article_resolver'

Сопоставитель на основе COM, используемый для устранения конфликтов в таблице или сборки платформа .NET Framework, вызываемой для выполнения пользовательской бизнес-логики в статье таблицы. @article_resolver — nvarchar(255) с значением по умолчаниюNULL. Доступные значения этого параметра перечислены в пользовательских сопоставителях Майкрософт. Если указанное значение не является одним из сопоставителей Майкрософт, SQL Server использует указанный сопоставитель вместо предоставленного системой сопоставителя. Используется sp_enumcustomresolvers для перечисления списка доступных настраиваемых сопоставителей. Дополнительные сведения см. в разделе «Выполнение бизнес-логики во время синхронизации слияния» и расширенной репликации слиянием — обнаружение конфликтов и разрешение.

[ @resolver_info = ] N'resolver_info'

Используется для указания дополнительных сведений, необходимых пользовательскому сопоставителям. Для некоторых средств разрешения Майкрософт требуется столбец, предоставленный в качестве входных данных для сопоставителя. @resolver_info — nvarchar(517) с значением по умолчаниюNULL. Дополнительные сведения см. в разделе "Расширенный конфликт репликации слиянием" — com-разрешения.

[ @source_owner = ] N'source_owner'

Имя владельца @source_object. @source_owner — sysname с значением по умолчаниюNULL. Если NULLтекущий пользователь считается владельцем.

[ @destination_owner = ] N'destination_owner'

Владелец объекта в базе данных подписки, если нет dbo. @destination_owner — sysname с значением по умолчаниюNULL. Если NULLпредполагается, dbo что он является владельцем.

[ @vertical_partition = ] N'vertical_partition'

Включает и выключает фильтрацию столбцов в статье таблицы. @vertical_partition — nvarchar(5) с значением по умолчаниюfalse.

• false указывает, что вертикальная фильтрация отсутствует и публикует все столбцы.

• false очищает все столбцы, кроме объявленного первичного ключа и ROWGUID столбцов. Столбцы добавляются с помощью sp_mergearticlecolumn.

[ @auto_identity_range = ] N'auto_identity_range'

Включает и отключает автоматическую обработку диапазона удостоверений для этой таблицы в публикации во время ее создания. @auto_identity_range — nvarchar(5) с значением по умолчаниюNULL. false включает автоматическую обработку диапазона удостоверений, а также false отключает ее.

[ @pub_identity_range = ] pub_identity_range

Управляет размером диапазона идентификаторов, выделенного подписчику с серверной подпиской, когда включено автоматическое управление диапазонами идентификаторов. Этот диапазон идентификаторов резервируется переиздающему подписчику для выделения собственным подписчикам. @pub_identity_range является bigint, с значением по умолчаниюNULL. Этот параметр необходимо указать, если @identityrangemanagementoption есть auto или false@auto_identity_range.

[ @identity_range = ] identity_range

Управляет размером диапазона идентификаторов, выделяемого для издателя и подписчика, если включено автоматическое управление диапазонами идентификаторов. @identity_range имеет большой размер с значением по умолчаниюNULL. Этот параметр необходимо указать, если @identityrangemanagementoption есть auto или false@auto_identity_range.

[ @threshold = ] пороговое значение

Процентное значение, управляющее процессом выделения агентом слияния нового диапазона идентификаторов. Если используется процент значений, указанных в @threshold, агент слияния создает новый диапазон удостоверений. @threshold имеет значение int с значением по умолчаниюNULL. Этот параметр необходимо указать, если @identityrangemanagementoption есть auto или false@auto_identity_range.

[ @verify_resolver_signature = ] verify_resolver_signature

Перед использованием сопоставителя в репликации слиянием определяет, проверена ли цифровая подпись. @verify_resolver_signature имеет значение int с значением по умолчанию1.

• 0 указывает, что подпись не проверена.

• 1 указывает, что подпись проверяется, является ли она из доверенного источника.

[ @destination_object = ] N'destination_object'

Имя объекта в базе данных подписки. @destination_object — sysname, значением по умолчанию является то, что находится в @source_object. Этот аргумент может быть указан только для статей типа «только схема», например для статей хранимых процедур, представлений или пользовательских функций. Если указанная статья является таблицей, значение в @source_object переопределяет значение в @destination_object.

[ @allow_interactive_resolver = ] N'allow_interactive_resolver'

Разрешает или запрещает использование интерактивного арбитра конфликтов для данной статьи. @allow_interactive_resolver — nvarchar(5) с значением по умолчаниюfalse. false включает использование интерактивного сопоставителя в статье; false отключает его.

[ @fast_multicol_updateproc = ] N'fast_multicol_updateproc'

Этот параметр устарел и поддерживается для обратной совместимости скриптов.

[ @check_permissions = ] check_permissions

Растровое изображение разрешений на уровне таблицы, которые проверяются, когда агент слияния применяет изменения к издателю. Если учетная запись издателя, используемая процессом слияния, не имеет правильных разрешений на таблицу, недопустимые изменения регистрируются как конфликты. @check_permissions является int и может быть | (битовое ИЛИ) продукт одного или нескольких из следующих значений.

[ @force_invalidate_snapshot = ] force_invalidate_snapshot

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

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

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

[ @published_in_tran_pub = ] N'published_in_tran_pub'

Показывает, что статья в публикации слиянием также опубликована в публикации транзакций. @published_in_tran_pub — nvarchar(5) с значением по умолчаниюfalse. false указывает, что статья также публикуется в публикации транзакций.

[ @force_reinit_subscription = ] force_reinit_subscription

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

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

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

[ @logical_record_level_conflict_detection = ] N'logical_record_level_conflict_detection'

Указывает уровень обнаружения конфликтов для статьи, входящей в состав логической записи. @logical_record_level_conflict_detection — nvarchar(5) с значением по умолчаниюfalse.

• false указывает, что конфликт обнаруживается, если изменения внесены в логическую запись.

• false указывает, что обнаружение конфликтов по умолчанию используется в соответствии с @column_tracking. Дополнительные сведения см. в статье Группирование изменений в связанных строках с помощью логических записей.

[ @logical_record_level_conflict_resolution = ] N'logical_record_level_conflict_resolution'

Указывает уровень устранения конфликтов для статьи, входящей в состав логической записи. @logical_record_level_conflict_resolution — nvarchar(5) с значением по умолчаниюfalse.

• false указывает, что вся логическая запись победы перезаписывает логическую запись.

• false указывает, что выигрышные строки не ограничены логическими записями.

Если @logical_record_level_conflict_detection естьfalse, то @logical_record_level_conflict_resolution также необходимо задать.false Дополнительные сведения см. в статье Группирование изменений в связанных строках с помощью логических записей.

[ @partition_options = ] partition_options

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

[ @processing_order = ] processing_order

Показывает порядок обработки статей в публикации слиянием. @processing_order имеет значение int с значением по умолчанию0. 0 указывает, что статья не упорядочена, а любое другое значение представляет порядковое значение порядка обработки для этой статьи. Статьи обрабатываются по номерам, от меньших к большим. Если две статьи имеют одинаковое значение, порядок обработки определяется порядком псевдонима статьи в системной таблице sysmergearticles . Дополнительные сведения см. в разделе Указание свойств репликации слиянием.

[ @subscriber_upload_options = ] subscriber_upload_options

Определяет ограничения на обновления, производимые на подписчике с клиентской подпиской. Дополнительные сведения см. в статье Оптимизация производительности репликации слиянием при работе со статьями, доступными только для загрузки. @subscriber_upload_options крошечный и может быть одним из следующих значений.

Изменение @subscriber_upload_options требует повторной инициализации подписки путем вызова sp_reinitmergepullsubscription.

[ @identityrangemanagementoption = ] N'identityrangemanagementoption'

Указывает способ управления диапазоном идентификаторов для статьи. @identityrangemanagementoption — nvarchar(10) и может быть одним из следующих значений.

Для обратной совместимости при значении @identityrangemanagementoption проверяется значение @auto_identity_rangeNULL. Однако если значение @identityrangemanagementoption не NULLравно, то значение @auto_identity_range игнорируется. Дополнительные сведения см. в статье Репликация столбцов идентификаторов.

[ @delete_tracking = ] N'delete_tracking'

Указывает, являются ли удаления реплицируемыми. @delete_tracking — nvarchar(5) с значением по умолчаниюtrue. false указывает, что удаления не реплицируются и true указывают, что удаления реплицируются, что является обычным поведением репликации слиянием. Если задано falseзначение @delete_tracking, строки, удаленные на подписчике, должны быть удалены вручную на издателе, а строки, удаленные на издателе, должны быть удалены вручную на подписчике.

[ @compensate_for_errors = ] N'compensate_for_errors'

Указывает, будут ли выполняться корректирующие действия, если во время синхронизации возникнут ошибки: @compensate_for_errors — nvarchar(5) с значением по умолчаниюfalse. Если задано значение true, изменения, которые не могут применяться на подписчике или издателе во время синхронизации, всегда приводят к компенсирующим действиям, чтобы отменить изменение. Однако один неправильно настроенный подписчик, который создает ошибку, может привести к изменению других подписчиков и издателей, которые будут отменены. false Отключает эти компенсирующие действия, однако ошибки по-прежнему регистрируются, как с компенсацией, а последующие слияния продолжают пытаться применить изменения до тех пор, пока не будет успешно выполнено.

[ @stream_blob_columns = ] N'stream_blob_columns'

Указывает, производится ли оптимизация потока данных при репликации столбцов больших двоичных объектов. @stream_blob_columns — nvarchar(5) с значением по умолчаниюfalse. true означает, что будет предпринята попытка оптимизации. @stream_blob_columns задано значение true при включении FILESTREAM. Это позволяет оптимально выполнять репликацию данных FILESTREAM и уменьшить использование памяти. Чтобы принудительно использовать потоковую передачу BLOB-объектов, @stream_blob_columns используйте sp_changemergearticle для принудительного использования таблиц FILESTREAM значение false.

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

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

Замечания

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

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

Если указать значение 3 для @partition_options:

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

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

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

При указании @processing_order рекомендуется оставить пробелы между значениями порядка статей, что упрощает настройку новых значений в будущем. Например, если у вас есть три статьи, Article1и , задайте для @processing_order 10 значение , 20а не , 2а 30не 1, и 3.Article3Article2 Дополнительные сведения см. в разделе Указание свойств репликации слиянием.

Таблица параметров схемы по умолчанию

В этой таблице описывается значение по умолчанию, которое задает хранимая процедура, если для @schema_option указано значение, которое NULL зависит от типа статьи.

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

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

Примеры

DECLARE @publication AS sysname;
DECLARE @table1 AS sysname;
DECLARE @table2 AS sysname;
DECLARE @table3 AS sysname;
DECLARE @salesschema AS sysname;
DECLARE @hrschema AS sysname;
DECLARE @filterclause AS nvarchar(1000);
SET @publication = N'AdvWorksSalesOrdersMerge'; 
SET @table1 = N'Employee'; 
SET @table2 = N'SalesOrderHeader'; 
SET @table3 = N'SalesOrderDetail'; 
SET @salesschema = N'Sales';
SET @hrschema = N'HumanResources';
SET @filterclause = N'Employee.LoginID = HOST_NAME()';

-- Add a filtered article for the Employee table.
EXEC sp_addmergearticle 
  @publication = @publication, 
  @article = @table1, 
  @source_object = @table1, 
  @type = N'table', 
  @source_owner = @hrschema,
  @schema_option = 0x0004CF1,
  @description = N'article for the Employee table',
  @subset_filterclause = @filterclause;

-- Add an article for the SalesOrderHeader table that is filtered
-- based on Employee and horizontally filtered.
EXEC sp_addmergearticle 
  @publication = @publication, 
  @article = @table2, 
  @source_object = @table2, 
  @type = N'table', 
  @source_owner = @salesschema, 
  @vertical_partition = N'true',
  @schema_option = 0x0034EF1,
  @description = N'article for the SalesOrderDetail table';

-- Add an article for the SalesOrderDetail table that is filtered
-- based on SaledOrderHeader.
EXEC sp_addmergearticle 
  @publication = @publication, 
  @article = @table3, 
  @source_object = @table3, 
  @source_owner = @salesschema,
  @description = 'article for the SalesOrderHeader table', 
  @identityrangemanagementoption = N'auto', 
  @pub_identity_range = 100000, 
  @identity_range = 100, 
  @threshold = 80,
  @schema_option = 0x0004EF1;

-- Add all columns to the SalesOrderHeader article.
EXEC sp_mergearticlecolumn 
  @publication = @publication, 
  @article = @table2, 
  @force_invalidate_snapshot = 1, 
  @force_reinit_subscription = 1;

-- Remove the credit card Approval Code column.
EXEC sp_mergearticlecolumn 
  @publication = @publication, 
  @article = @table2, 
  @column = N'CreditCardApprovalCode', 
  @operation = N'drop', 
  @force_invalidate_snapshot = 1, 
  @force_reinit_subscription = 1;

-- Add a merge join filter between Employee and SalesOrderHeader.
EXEC sp_addmergefilter 
  @publication = @publication, 
  @article = @table2, 
  @filtername = N'SalesOrderHeader_Employee', 
  @join_articlename = @table1, 
  @join_filterclause = N'Employee.BusinessEntityID = SalesOrderHeader.SalesPersonID', 
  @join_unique_key = 1, 
  @filter_type = 1, 
  @force_invalidate_snapshot = 1, 
  @force_reinit_subscription = 1;

-- Add a merge join filter between SalesOrderHeader and SalesOrderDetail.
EXEC sp_addmergefilter 
  @publication = @publication, 
  @article = @table3, 
  @filtername = N'SalesOrderDetail_SalesOrderHeader', 
  @join_articlename = @table2, 
  @join_filterclause = N'SalesOrderHeader.SalesOrderID = SalesOrderDetail.SalesOrderID', 
  @join_unique_key = 1, 
  @filter_type = 1, 
  @force_invalidate_snapshot = 1, 
  @force_reinit_subscription = 1;
GO

Разрешения

Необходимо быть членом предопределенной роли сервера sysadmin или предопределенной роли базы данных db_owner .

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

• Определение статьи
• Публикация данных и объектов базы данных
• Репликация столбцов идентификаторов
• sp_changemergearticle (Transact-SQL)
• sp_dropmergearticle (Transact-SQL)
• sp_helpmergearticle (Transact-SQL)
• Хранимые процедуры репликации (Transact-SQL)