sp_helpmergearticle (Transact-SQL)

Статья
05/08/2013

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

Значок ссылки на раздел Синтаксические обозначения Transact-SQL

Синтаксис

sp_helpmergearticle [ [ @publication = ] 'publication' ]
    [ , [ @article= ] 'article' ]

Аргументы

[ @publication=] 'publication'
Имя публикации, о которой будут получены данные. Аргумент publicationимеет тип sysname и значение по умолчанию %, при котором возвращаются данные обо всех статьях публикации слиянием, содержащихся во всех публикациях в текущей базе данных.
[ @article=] 'article'
Имя статьи, для которой возвращаются сведения. Аргумент articleимеет тип sysname и значение по умолчанию %, при котором возвращаются сведения обо всех статьях публикации слиянием в данной публикации.

Результирующий набор

int

Идентификатор статьи.

name

sysname

Имя статьи.

source_owner

sysname

Имя владельца исходного объекта.

source_object

sysname

Имя исходного объекта, из которого будет добавляться статья.

sync_object_owner

sysname

Имя владельца представления, определяющего опубликованную статью.

sync_object

sysname

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

description

nvarchar(255)

Описание статьи.

status

tinyint

Состояние статьи может быть одним из следующих:

1 = неактивно;

2 = активно;

5 = ожидание выполнения операции языка DDL;

6 = выполнение DDL-операции с последним созданным моментальным снимком.

Примечание
После повторной инициализации статьи значения 5 и 6 изменяются на значение 2.

creation_script

nvarchar(255)

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

conflict_table

nvarchar(270)

Имя таблицы, хранящей конфликты при операциях вставки или обновления.

article_resolver

nvarchar(255)

Пользовательский сопоставитель для статьи.

subset_filterclause

nvarchar(1000)

Предложение WHERE, задающее горизонтальную фильтрацию.

pre_creation_command

tinyint

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

0 = нет;

1 = удаление (drop);

2 = удаление (delete);

3 = усечение.

schema_option

binary(8)

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

тип

smallint

Тип статьи может быть одним из следующих:

10 = таблица;

32 = хранимая процедура;

64 = представление или индексированное представление;

128 = пользовательская функция;

160 = только схема синонима.

column_tracking

int

Параметр отслеживания на уровне столбца; значение 1 означает, что отслеживание на уровне столбца включено, а 0 — выключено.

resolver_info

nvarchar(255)

Имя сопоставителя статей.

vertical_partition

bit

Показывает, проводилось ли вертикальное секционирование статьи; значение 1 означает, что статья вертикально секционирована, 0 — не секционирована.

destination_owner

sysname

Владелец целевого объекта. Применяется только к хранимым процедурам слияния, представлениям и к статьям схемы определяемых пользователем функций.

identity_support

int

Показывает, включена ли автоматическая обработка диапазона идентификаторов; значение 1 означает, что обработка включена, а 0 — выключена.

pub_identity_range

bigint

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

identity_range

bigint

threshold

int

Значение в процентах, применяемое для подписчиков, работающих на SQL Server Compact или более ранних версиях SQL Server. От параметра threshold зависит, когда агент слияния назначит новый диапазон идентификаторов. Если использован процент значений, указанный порогом, агент слияния создает новый диапазон идентификаторов. Дополнительные сведения см. в подразделе «Репликация слиянием» раздела Репликация столбцов идентификаторов.

verify_resolver_signature

int

Показывает, выполняется ли проверка цифровой подписи перед использованием сопоставителя в репликации слиянием; значение 0 означает, что подпись не проверяется, а 1 означает, что подпись проверяется, чтобы убедиться в надежности источника.

destination_object

sysname

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

allow_interactive_resolver

int

Показывает, используется ли в статье интерактивный сопоставитель; значение 1 говорит о том, что данный сопоставитель используется, 0 — не используется.

fast_multicol_updateproc

int

Разрешает или запрещает агенту слияния применение изменений к нескольким столбцам одной строки в одной инструкции UPDATE; значение 1 означает, что одной инструкцией обновляются несколько столбцов, 0 означает, что для каждого обновляемого столбца нужна отдельная инструкция UPDATE.

check_permissions

int

Целое число, представляющее битовую карту проверенных разрешений уровня таблицы. Список возможных значений см. в описании процедуры sp_addmergearticle (Transact-SQL).

processing_order

int

Определяет порядок, в котором вносятся изменения в статьи публикации.

upload_options

tinyint

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

0 = нет ограничений для обновлений, выполняемых на подписчике с клиентской подпиской; все изменения передаются издателю.

1 = изменения на подписчике с клиентской подпиской разрешены, но они не передаются издателю.

2 = изменения на подписчике с помощью клиентской подписки не разрешены.

Дополнительные сведения см. в разделе Оптимизация производительности репликации слиянием при работе со статьями, доступными только для загрузки.

identityrangemanagementoption

int

Если включена автоматическая обработка диапазона идентификаторов, где 1 — включено, 0 — отключено.

delete_tracking

bit

Показывает, происходит ли репликация удалений; 1 означает, что репликация удалений выполняется, 0 означает, что репликации удалений не происходит.

compensate_for_errors

bit

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

partition_options

tinyint

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

0 = фильтрация статьи либо статична, либо не дает уникального подмножества данных для каждой секции, то есть происходит перекрытие секций.

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

2 = Фильтрация статьи дает неперекрывающиеся секции, но несколько подписчиков могут получать одну секцию.

3 = фильтрация статьи дает неперекрывающиеся секции, уникальные для каждой подписки.

artid

uniqueidentifier

Идентификатор, уникально определяющий статью.

pubid

uniqueidentifier

Идентификатор, уникально определяющий публикацию, в которой опубликована данная статья.

stream_blob_columns

bit

Определяет, применяется ли оптимизация потока данных во время репликации больших двоичных столбцов объекта. Значение 1 означает, что оптимизация применяется, 0 означает, что оптимизация не применяется.

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

0 (успешное завершение) или 1 (неуспешное завершение)

Замечания

Процедура sp_helpmergearticle используется при выполнении репликации слиянием.

Разрешения

Только члены предопределенной роли базы данных db_owner в базе данных публикации, роли replmonitor в базе данных распространителя или списка доступа к публикации для данной публикации могут выполнять процедуру sp_helpmergearticle.

Пример

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

USE [AdventureWorks2012]
EXEC sp_helpmergearticle
  @publication = @publication;
GO