sp_helpmergearticle (Transact-SQL)

  • Статья

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

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

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

Синтаксис

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

Аргументы

[ @publication = ] N'publication'

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

[ @article = ] N'article'

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

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

Имя столбца Тип данных Description
id 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.
type 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 Если включена автоматическая обработка диапазона удостоверений; where 1 is enabled and 0 is disabled.
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 = секции перекрываются, а обновления языка обработки данных (DML), сделанные на подписчике, не могут изменить секцию, к которой принадлежит строка.

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 [AdventureWorks2022]
EXEC sp_helpmergearticle
  @publication = @publication;
GO

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